跳到主要内容

工具板 MCU 添加与跨板配置

本页用于主 MCU 已经连接成功后的工具板添加、多 MCU 验证和跨板引脚配置。

添加工具板 MCU​

主 MCU 验证成功后，即可添加工具板：

  1. 重新连接工具板：将工具板的数据线重新连接到上位机或主板上。
  2. 编辑配置文件：在 printer.cfg 文件的最下方添加工具板配置。
  3. 配置工具板 ID：根据工具板的固件类型，在新增的配置段中添加对应的 ID。
MCU 命名说明

配置中的 mcu1、mcu2 等名称仅用于临时区分不同设备，您可以完全自定义这些名称，只需确保在配置文件中保持唯一性即可。

配置格式：

[mcu mcu1]
# 在此处添加工具板的 ID 配置

配置示例：

[mcu mcu1]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

注意事项：

  • 每个 MCU 必须使用唯一的 ID，请确保工具板 ID 与主 MCU 及其他设备均不相同。
  • MCU 名称可完全自定义，例如 toolboard、extruder_mcu 等，只需在配置中保持唯一性。
  • 请务必使用通过前述步骤验证有效的工具板 ID。
  • RS232 设备必须配置 baud: 250000 和 restart_method: command 参数。
  • 配置多个工具板时，请为每个设备设置不同的名称以便区分。

多工具板跨板引脚配置​

当使用多个工具板时，可能会遇到引脚跨板分配的需求。例如：加热功能使用第一个工具板的加热口，但温度传感器连接到主板或第二个工具板。

核心原则

在 Klipper 多 MCU 配置中，任何配置段的引脚都可以直接通过 <mcu名称>:<引脚号> 格式引用任意已定义 MCU 上的引脚，无需额外配置。Klipper 会自动通过通信总线（CAN/USB/串口）将指令发送到对应的 MCU。

典型场景：加热在工具板，温度传感器在主板

假设系统配置如下：

  • 主 MCU：运行上位机 Klipper 主机固件，温度传感器接在主板上。
  • toolboard1：工具板，加热棒和挤出机步进接在工具板上。

步骤一：定义所有 MCU

[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

[mcu toolboard1]
canbus_uuid: e51d5c71a901

步骤二：在配置中直接跨板引用引脚

[extruder]
# 步进和加热使用工具板引脚
step_pin: toolboard1:<step_pin>
dir_pin: toolboard1:<dir_pin>
enable_pin: !toolboard1:<enable_pin>
heater_pin: toolboard1:<heater_pin>

# 温度传感器使用主板引脚
sensor_type: ATC Semitec 104GT-2
sensor_pin: <sensor_pin>

rotation_distance: 22.44
gear_ratio: 50:17
microsteps: 16
full_steps_per_rotation: 200
nozzle_diameter: 0.400
filament_diameter: 1.75
min_temp: -235
max_temp: 350
max_power: 1.0
min_extrude_temp: 170
control: watermark
引脚命名规则
  • 工具板引脚格式为 <mcu名称>:<引脚号>，例如 toolboard1:<heater_pin>。
  • 主 MCU 引脚可以直接写实际引脚名。
  • 同一个配置段中的引脚可以来自不同的 MCU，Klipper 会自动处理跨板通信。

更多跨板配置示例​

加热棒在第一工具板，温度传感器在第二工具板：

[extruder]
step_pin: toolboard1:<step_pin>
heater_pin: toolboard1:<heater_pin>
sensor_type: ATC Semitec 104GT-2
sensor_pin: toolboard2:<sensor_pin>
注意事项
  • 跨板引用引脚时，请确保对应 MCU 已在配置文件中通过 [mcu <名称>] 正确定义。
  • 建议将功能关联紧密的设备（如加热棒和温度传感器）尽量接在同一个工具板上，以获得最佳的响应速度和可靠性。

验证所有 MCU 连接​

添加工具板并重启 Klipper 后，需要重新验证所有 MCU 的连接状态：

  1. 打开 Fluidd 界面，点击左侧菜单中的 System。
  2. 在 Mcu Information 下方确认所有 MCU 都已正确识别。
  3. 核对主 MCU 和工具板都显示为连接状态。
Loading...

检查固件版本​

完成所有 MCU 连接后，需要验证固件版本兼容性：

  1. 打开 Fluidd 界面，点击左侧菜单中的 System。
  2. 在 Mcu Information 下方找到 Version 字段。
  3. 确认所有 MCU 的固件版本与上位机 Klipper 版本匹配。
版本兼容性说明
  • 除预配置的定制设备外，所有自行编译的固件必须与上位机 Klipper 版本保持一致。
  • FAST 系统的固件版本与系统版本保持一致，编译出来的 Klipper 固件与系统版本一致。
  • 不同版本的固件可能导致功能异常、通信失败或系统不稳定。

恢复并更新配置文件​

确认所有 MCU 连接正常后，需要恢复原始配置文件并更新 MCU 配置：

  1. 在配置文件管理界面删除当前临时 printer.cfg。
  2. 将之前备份的 printer_Backup.cfg 文件重命名为 printer.cfg。
  3. 打开恢复后的 printer.cfg，找到原有 [mcu] 配置段，并根据前面步骤获取的 ID 进行更新。
  4. 如果配置多个工具板，请逐一更新每个 [mcu <名称>] 段的 ID。
  5. 完成所有 MCU 配置更新后，点击 SAVE & RESTART 保存并重启 Klipper。

USB 主 MCU 示例：

[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

CAN 主 MCU 示例：

[mcu]
canbus_uuid: 688e89f0e401

RS232 工具板示例：

[mcu toolboard]
serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
baud: 250000
restart_method: command
重要提醒
  • 确保使用本次连接测试中实际搜索到的正确 ID。
  • RS232 工具板必须包含 baud: 250000 和 restart_method: command 参数。
  • 恢复配置后，原有的打印机参数（如步进电机、限位开关等设置）将保持不变。
Loading...