主板ID读取查看
重要提示
- 本教程仅适用于主板的 ID 读取与查看方法。
若您使用的是工具板,请参考对应产品的 ID 搜索教程。 - 如果您正在使用工具板,可直接点击下方按钮跳转:
连接工具板 - 若您已刷写 USB 固件,请查看 USB-ID 获取 部分。
- 若您已刷写 USB 桥接固件,请查看 CAN-ID 获取 部分。
- USB ID获取
- CANBus UUID获取
注意事项
重要须知
- 必须通过SSH连接到上位机,请使用网络登录方式连接上位机(树莓派等设备)
- 操作前请确保主板已刷入 USB固件
- 本教程仅适用于主板ID搜索,不适用于工具板ID搜索
- 请确认主板使用TYPEC连接到上位机的USB口
- 如需查看工具板ID,请至对应产品目录下查阅相关教程
操作步骤
搜索USB设备ID
- 执行以下命令列出所有USB串口设备ID:
ls /dev/serial/by-id/*
⚠️ 重要提示:不可用的ID
执行命令后,请注意识别并避免使用以下两类ID:
| ID 特征 | 原因说明 | 示例 |
|---|---|---|
usb-1a86_USB_Serial-if00-port0 | 此为CH340等通用串口芯片的默认名称,不可用于配置。 | /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0 |
包含 katapult 字样 | 表示设备处于烧录模式, 需先刷写Klipper固件后方可使用。 | /dev/serial/by-id/usb-katapult_xxxxxxxxxxxx |
执行结果说明:
- 正常情况: 终端会显示类似下方的ID(下图仅为示例)
Loading...
- 异常问题排查
多个ID的处理
如果出现多个ID,请根据您主板的 MCU型号 选择相对应的ID
将USB的ID,填写到到配置里面
Loading... |
Loading... |
注意:文档中所出现的所有ID均为示例,实际每个主板的ID均不一致,请根据实际获取到的ID修改填写。
填写USB ID
- 找到
[mcu],然后替换
须知
- 请将配置文件中的:
- 请不要配置
canbus_uuid:
[mcu]
serial: <这里替换为你刚刚查询到的ID>
- 参考
Loading... |
Loading... |
- 点击右上角的
SAVE & RESTART点击后会自动保存并重启klipper
注意事项
重要须知
- 必须通过SSH连接到上位机,请使用网络登录方式连接上位机(树莓派等设备)
- 操作前请确保主板已经刷入
USB桥接CAN固件; - 本教程仅适用于主板ID搜索,不适用于工具板ID搜索
- 请确认上位机与主板已正确连接
- 如需查看工具板ID,请至对应产品目录下查阅相关教程
CAN注意事项
- 本教程默认您的上位机已经进行CAN配置
- 如果您使用
Fly的上位机则默认已经配置好CAN并且CAN的速率为1M - 如果您是第一次使用
CAN,请务必先阅读下方教程 - CAN配置教程
搜索CAN ID
-
普通上位机搜索指令
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 -
FLY上位机搜索指令
python3 ~/klipper/scripts/canbus_query.py can0- 执行搜索指令后,将会以下几种情况,请根据您的情况进行排查与判断
- 如果出现ID并在最后面的
Application:显示Klipper则代表此ID可以直接使用 - 如果出现ID并在最后面的
Application:显示CANBOOT或者Katapult则代表需要刷固件才可以使用 - 出现
Total 0 uuids found则有以下几种情况- CAN网络配置有问题
- CAN速率不一致,请确保上位机CAN速率与主板,工具板等是否一致
- 已经在
Klipper配置了对应ID则,需要在系统配置里面先屏蔽ID后关机,断电在开机Loading...
- 如果出现ID并在最后面的
- 执行搜索指令后,将会以下几种情况,请根据您的情况进行排查与判断
将CAN的ID,填写到到配置里面
-
将查询到的UUID复制,然后到
printer.cfg配置 -
如果
Application:显示Canboot则无法配置到配置里面,需要刷Klipper固件才能进行下一步Loading...危险注意:文档中所出现的所有ID均为示例,实际每个主板的ID均不一致,请根据实际获取到的ID修改填写。
Loading... |
Loading... |
- 下方是参考配置
危险
[mcu]
canbus_uuid: <这里替换为你刚刚查询到的ID>- 主板ID则一定是
[mcu]再加上canbus_uuid:在加上你搜索到的ID - 请不要配置
serial:
Loading...- 点击右上角的
SAVE & RESTART点击后会自动保存并重启klipper
- 主板ID则一定是
Loading...