跳到主要内容

重要说明

注意事项
  • 本教程专门介绍工具板的接线与搜索ID,相关步骤不适用于主板,请注意区分。
  • 如果您不使用工具板,请忽略本教程。

工具板ID读取查看

  • 请准备一条具有数据传输功能的数据线,如果长度特别长建议使用带磁环的数据线
  • 将工具板通过USB数据线连接到上位机

主板 USB ID 获取​

注意事项​

断电操作

需要连接或重新插拔主板 USB 线时，请先完全关闭打印机并断开电源供应。不要在通电状态下插拔线束。

使用范围
  • 必须通过 SSH 登录上位机后执行搜索命令。
  • 操作前请确认主板已经刷入 USB 固件，并通过 Type-C 数据线连接到上位机的 USB 接口。
  • 本教程仅用于搜索主板 USB ID，不适用于搜索工具板 ID。
  • 工具板设备请使用对应产品文档中的 USB 或 CAN ID 获取教程。

操作步骤​

搜索 USB 设备 ID​

通过 SSH 登录上位机，然后执行以下命令列出所有 USB 串口设备 ID：

ls /dev/serial/by-id/*
不可用的 ID​

执行命令后，请避免使用以下两类 ID：

ID 特征原因说明示例
usb-1a86_USB_Serial-if00-port0CH340 等通用串口芯片的默认名称，不能作为 Klipper 主板连接地址/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
包含 katapult设备处于 Katapult 烧录模式，需要先刷写 Klipper 固件/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx
搜索结果​

正常情况下，终端会显示类似下图的设备路径，图片中的 ID 仅作为格式示例。

Loading...

没有找到可用 ID：查看设备固件与连接问题排查

出现多个 ID

如果命令返回多个可用 ID，请结合主板 MCU 型号以及插拔前后的设备列表变化，确认主板对应的完整设备路径。

将 USB ID 填写到配置中​

在 Fluidd 或 Mainsail 中打开 printer.cfg：

Fluidd：点击左侧的 {…} 图标，然后打开 printer.cfg。

Loading...

Mainsail：点击左侧的“机器”，然后打开 printer.cfg。

Loading...
ID 必须使用实际搜索结果

文档中的设备路径均为示例。每块主板的 USB ID 都可能不同，请完整复制 SSH 命令返回的实际路径。

找到 [mcu] 配置段，将 serial 修改为刚才查询到的完整设备路径：

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

使用 USB 固件时应配置 serial，不要在同一个 [mcu] 配置段中同时填写 canbus_uuid。

配置位置可参考下图：

Fluidd 配置示例
Loading...
Mainsail 配置示例
Loading...

修改完成后，点击右上角的 SAVE & RESTART，保存配置并重新启动 Klipper。

Loading...