跳到主要内容

主板ID读取查看

重要提示
  • 本教程仅适用于主板的 ID 读取与查看方法。
    若您使用的是工具板,请参考对应产品的 ID 搜索教程。
  • 如果您正在使用工具板,可直接点击下方按钮跳转:
    连接工具板
  • 若您已刷写 USB 固件,请查看 USB-ID 获取 部分。
  • 若您已刷写 USB 桥接固件,请查看 CAN-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-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...