重要说明
注意事项
- 本教程专门介绍工具板的接线与搜索ID,相关步骤不适用于主板,请注意区分。
- 如果您不使用工具板,请忽略本教程。
工具板ID读取查看
- USB ID获取
- CANBus UUID获取
- RS232使用方法
- 请准备一条具有数据传输功能的数据线,如果长度特别长建议使用带磁环的数据线
- 将工具板通过USB数据线连接到上位机
注意事项
重要须知
- 必须通过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
-
搜索ID前使用XT30数据线将工具板连接到UTOC或者刷了桥接固件的主板,下方是参考接线图
-
请注意拨码是否拨到对应地方
Loading... -
请确保CAN H与CAN L在断电情况下使用万用表测量阻值在
60Ω左右,如果是120Ω则需要接上120Ω跳线,如果是40Ω左右需要将跳线移除Loading...CAN工具板设置完整指南
准备工作
重要前提- 工具板状态:确保工具板已刷入
Klipper-can固件或处于Katapult-can模式 - 注意事项:本教程仅用于工具板ID搜索,不适用于主板ID搜索
- 连接要求:工具板必须连接到以下任一设备:
UTOC模块- 刷有
USB桥接CAN固件的主板
- 最终连接:上述设备需连接到上位机
CAN网络配置要求
- 默认配置:本教程假设上位机已配置好CAN网络
- Fly用户:如果使用Fly上位机并运行Fly-FAST系统,CAN已默认配置(速率1Mbps)
- 首次使用:请务必先阅读下方教程: CAN配置教程
连接SSH
- 通过网络登录到SSH(请勿使用串口登录)
- 确保上位机与CAN网络设备连接正常
搜索CAN ID
- 普通上位机搜索指令
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0 - FLY上位机搜索指令
python3 ~/klipper/scripts/canbus_query.py can0
搜索结果说明
CANID- 注意事项: 主板ID已经在之前文档中配置到了Klipper中, 正常情况是无法搜索出来主板的
CANID - 快速验证方法：若需确认, 请先断开主板与工具板之间的 CAN 连接线, 然后重新执行搜索
- 执行搜索命令后,可能出现以下几种情况:
结果显示 状态说明 后续操作 Application: Klipper设备已刷入Klipper固件 可直接使用该ID Application: CANBOOT或Katapult设备处于Bootloader模式 需刷写Klipper固件后才能使用 Total 0 uuids found未找到任何设备 请检查以下问题:
1. CAN网络配置是否正确
2. CAN速率是否一致(默认1Mbps)
3. 是否已在配置中使用该ID(需先屏蔽然后保存断电重启)Loading...关于重复ID如果设备ID已在
printer.cfg中配置,则不会显示在搜索结果中。如需重新搜索,请:- 在配置文件中注释掉该设备ID
- 保存配置并重启Klipper
- 断电重启所有设备
配置CAN设备ID
1. 获取配置文件
根据使用的Web界面,找到
printer.cfg配置文件:Fluidd
点击左侧导航栏的{...}printer.cfgLoading...Mainsail
点击顶部导航栏的机器,找到printer.cfgLoading...2. 添加设备配置
在
printer.cfg中添加工具板配置:[mcu toolboard]
canbus_uuid: <这里填写查询到的ID>配置说明toolboard为工具板名称,请根据实际情况修改- 如果是主板ID,配置段应为
[mcu] - 正常配置中,主板使用
[mcu],工具板使用[mcu toolboard]
3. 保存并重启
- 点击右上角的 SAVE & RESTART 按钮
- 系统将自动保存配置并重启Klipper
Loading...注意文档中所出现的所有ID均为示例,实际每个主板的ID均不一致,请根据实际获取到的ID修改填写。
- 工具板状态:确保工具板已刷入
- 搜索ID前使用XT30数据线将工具板连接到UTOR或者G2T,下方是参考接线图
- 请注意拨码是否拨到对应地方
Loading...
搜索工具板的RS232 ID
注意事项
重要准备
- 固件要求:
工具板必须刷入RS232固件,否则无法通信 - 强制共地:
⚠️ 连接工具板前,必须确保其将工具板与主板的GND相连(共用同一个24V/12V电源即可实现)
RS232注意事项
- 除了D8、D8PRO与C8P支持RS232接口外,其他主板均不支持RS232接口
- 不支持的主板需要使用
G2T或者UTOR进行链接
搜索RS232 ID
- 打开浏览器,在网址栏中输入上位机的IP地址,比如我上位机IP是
192.168.101.179直接输入然后回车即可
Loading...
- 打开上位机的WEB界面,在左侧边栏的配置选项里找到:
Loading... |
Loading... |
3.点击printer.cfg 进去后,在点击右上方的DEVICES
Loading... | Loading... |
4.点击SERIAL ,然后刷新
Loading... |
Loading... |
5.复制ID,点击箭头所指即可复制
Loading... |
Loading... |
注意事项
- 使用
UTOR连接工具板时,通常会出现两个RS232_ID,请逐一尝试。
填写工具板RS232 ID
-
下方是参考配置
注意事项- 下方配置中的
toolboard是指工具板名称,如果是其他名称请替换为对应名称
危险[mcu toolboard]
serial: <这里替换为你刚刚查询到的ID>
baud: 250000
restart_method: command- 添加工具板的
ID则一定是[mcu toolboard]再加上serial:在加上你搜索到工具板的ID
- 下方是参考配置
- 请注意本教程是针对工具板ID搜索与配置,正常情况是已经正常连接到主板了
- 主板一定是
[mcu],工具板才是[mcu toolboard] - 点击右上角的
SAVE & RESTART点击后会自动保存并重启klipper
- 下方配置中的
危险
注意:文档中所出现的所有ID均为示例,实际每个主板的ID均不相同,请填写实际获取到的ID。
Loading...