工具板ID读取查看
主板 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-port0 | CH340 等通用串口芯片的默认名称，不能作为 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：点击左侧的 Loading... | Mainsail：点击左侧的“机器”，然后打开 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...