重要说明

注意事项

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

工具板ID读取查看

USB ID获取

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

注意事项

须知

• 操作前请确保工具板已经刷入USB固件；
• 本教程仅适用于工具板ID搜索,非主板ID搜索；
• 请在上位机与工具板正确连接后,再进行后续操作；

连接到SSH

• 请先通过网络登录到SSH
• 请注意需要确保是使用网络登录到SSH而不是使用串口登录

搜索设备

• 请确保上位机可以正常联网,并确保下位机连接上位机的数据线具有数据传输功能。
• SSH连接连接到上位机后输入lsusb并且回车,如果出现下方图片中圈起来的信息,就可以进行下一步。
  • 如果没有任何信息反馈,这是上位机的系统问题,这边无能为力,你需要更换确定正常的系统或者更换上位机。
  • 提示没有lsusb指令,可以执行此命令安装

    sudo apt-get install usbutils

    
• 1d50:614e 属于本次你要用到的设备。
  • 部分上位机可能因为系统问题,显示不全或者不显示。
  • 如果输入lsusb指令能够显示设备,但是没有 1d50:614e,请尝试更换数据线,尝试将主板连接到上位机的其他USB口。

注意事项

必须在查询到其中一个1d50:614e设备之后,才能进行下一步

搜索USBID

ls /dev/serial/by-id/*

• 输入下方指令回车。如果一切正常,则会出现下面一行蓝色的ID。(下方只是参考)

• 如果输入下方后没有ID出来,但是lsusb有设备请更换上位机或者更换上位机系统

注意事项

如果出现多个ID,请根据你的主板MCU型号选择相对应的ID。

将USB的ID,填写到到配置里面

fluidd为: {…} ,点击进去,即可找到 printer.cfg

mainsail为:机器,点击进去,即可找到 printer.cfg

危险

注意:文档中所出现的所有ID均为示例,实际每个主板的ID均不一致,请根据实际获取到的ID修改填写。

填写工具板USB ID

• 下方是参考配置

  注意事项

  • 下方配置中的toolboard是指工具板名称,如果是其他名称请替换为对应名称
  危险

  [mcu toolboard]
  serial: <这里替换为你刚刚查询到的ID>

  • 添加工具板的ID则一定是[mcu toolboard] 再加上serial:在加上你搜索到工具板的ID
  • 下方是参考配置
  • 请注意本教程是针对工具板ID搜索与配置,正常情况是已经正常连接到主板了
  • 并且主板一定是[mcu],工具板才是[mcu toolboard]

  fluidd的参考

  mainsail的参考

  • 点击右上角的SAVE & RESTART点击后会自动保存并重启klipper

CANBus UUID获取

• 搜索ID前使用XT30数据线将工具板连接到UTOC或者刷了桥接固件的主板,下方是参考接线图

• 请注意拨码是否拨到对应地方

  

• 请确保CAN H与CAN L在断电情况下使用万用表测量阻值在60Ω左右,如果是120Ω则需要接上120Ω跳线,如果是40Ω左右需要将跳线移除

  

  CAN工具板设置完整指南

  准备工作

  重要前提

  • 工具板状态:确保工具板已刷入 Klipper-can 固件或处于 Katapult-can 模式
  • 适用范围:本教程仅用于工具板ID搜索,不适用于主板ID搜索
  • 连接要求:工具板必须连接到以下任一设备:
    • UTOC 模块
    • 刷有 USB桥接CAN 固件的主板
  • 最终连接:上述设备需连接到上位机

  硬件连接与终端电阻配置

  安全第一

  • 完全断电:所有接线操作必须在设备完全断电的情况下进行
  • 防止短路:操作前请断开所有设备的电源

  连接规范表

  设备类型	终端电阻要求	配置方式
  CAN工具板	需要120Ω终端电阻	通过跳线帽或拨码开关启用
  主板CAN接口	需要120Ω终端电阻	通过跳线帽或拨码开关启用
  UTOC模块	已内置120Ω电阻	无需额外连接

  配置与测量步骤

  1. 硬件配置

     • 检查主板CAN接口旁的120Ω跳线帽或者拨码是否接上或者打开
     • 检查工具板上的120Ω跳线帽或者拨码是否接上或者打开

  2. 电阻测量(断电状态下)

     • 测量点:CAN-H与CAN-L之间
     • 工具:万用表

  电阻值故障排查表

  注意事项

  • 测量时候必须要在断电情况下测试
  • 如果测量范围到达140Ω左右则可能是CAN-H与CAN-L接反

  测量值	状态	可能原因	解决方案
  60Ω左右	✅ 正常	两端电阻正确连接	配置完成
  120Ω左右	❌ 异常	线路断开或未连接	检查所有接线
  40Ω左右	❌ 异常	有三端连接了电阻	移除中间的电阻
  90Ω左右	❌ 异常	只有一端连接了电阻	检查另一端跳线帽

  重要注意事项

  • UTOC模块:已内置电阻,连接时主板无需再连接终端电阻
  • 连接场景:
    • 工具板 ↔ 主板(两端都需要终端电阻)
    • 工具板 ↔ UTOC ↔ 上位机(仅工具板需要终端电阻)
  • 故障排查流程:

    测量电阻 → 60Ω → 正常使用
           ↓
       异常值 → 查上表 → 调整后重测

  硬件检查清单

  • 所有设备完全断电
  • 主板CAN接口终端电阻已连接(UTOC除外)
  • 工具板终端电阻已连接
  • 万用表测量电阻值≈60Ω
  • CAN-H与CAN-L接线正确牢固
  专业建议

  正确的终端电阻配置对CAN总线通信质量至关重要,电阻值偏差可能导致通信不稳定或数据丢失。

  CAN网络配置要求

  • 默认配置:本教程假设上位机已配置好CAN网络
  • Fly系统用户:如果使用Fly上位机并运行Fly-FAST或Fly-Armbian系统,CAN已默认配置(速率1Mbps)
  • 首次使用:请务必先阅读下方教程: CAN配置教程

  总结流程

  1. 硬件准备:断电状态接线,配置终端电阻,测量确认60Ω
  2. 网络确认:确保上位机CAN网络已正确配置
  3. 连接上位机:通过UTOC或USB桥接主板连接上位机
  4. 固件状态:确认工具板为Klipper-can或Katapult-can模式
  5. 后续操作:按后续教程进行ID搜索和配置

  至此,您的CAN工具板硬件连接和网络环境已准备就绪,可以进行ID搜索和配置操作。

  连接SSH

  • 通过网络登录到SSH(请勿使用串口登录)
  • 确保上位机与CAN网络设备连接正常

  搜索设备

  • 现在你已经正常登录到上位机了可以输入lsusb搜索设备,将会以下几种情况之一
    • 输入lsusb提示找不到ls指令,则可以输入下方指令来安装指令

      sudo apt-get install usbutils

    • 输入lsusb后什么反应都没有,这是系统问题这边无能为力,你需要更换系统或者使用确定正常的系统
    • 出现下方图片中的信息,请注意这只是参考。你只需要确定有出现1d50:606f即可
      
  • 1d50:606f 属于本次你要用到的设备
  • 如果有多个1d50:606f,需要排除一个,否则会影响后续烧录与固件连接,如FLY MINI PAD则建议使用板载UTOC不要使用其他CAN桥接设备
  • 如果没有,请自行检查数据线是否接好,固件有没有刷对。
  注意事项

  有1d50:606f时候才能去搜索CAN ID

  搜索CAN ID

  Fly-Armbian / 通用系统

  执行以下命令搜索CAN设备ID:

  ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

  Fly-FAST系统

  执行以下命令搜索CAN设备ID:

  python ~/klipper/scripts/canbus_query.py can0

  搜索结果说明

  执行搜索命令后,可能出现以下几种情况:

  结果显示	状态说明	后续操作
  Application: Klipper	设备已刷入Klipper固件	可直接使用该ID
  Application: CANBOOT 或 Katapult	设备处于Bootloader模式	需刷写Klipper固件后才能使用
  Total 0 uuids found	未找到任何设备	请检查以下问题: 1. CAN网络配置是否正确 2. CAN速率是否一致(默认1Mbps) 3. 是否已在配置中使用该ID(需先屏蔽然后保存断电重启)

  
  关于重复ID

  如果设备ID已在 printer.cfg 中配置,则不会显示在搜索结果中。如需重新搜索,请:

  1. 在配置文件中注释掉该设备ID
  2. 保存配置并重启Klipper
  3. 断电重启所有设备

  配置CAN设备ID

  1. 获取配置文件

  根据使用的Web界面,找到 printer.cfg 配置文件:

  Fluidd 点击左侧导航栏的 {...} 图标,找到 printer.cfg

  Mainsail 点击顶部导航栏的 机器,找到 printer.cfg

  2. 添加设备配置

  在 printer.cfg 中添加工具板配置:

  [mcu toolboard]
  canbus_uuid: <这里填写查询到的ID>

  配置说明

  • toolboard 为工具板名称,请根据实际情况修改
  • 如果是主板ID,配置段应为 [mcu]
  • 正常配置中,主板使用 [mcu],工具板使用 [mcu toolboard]

  3. 保存并重启

  1. 点击右上角的 SAVE & RESTART 按钮
  2. 系统将自动保存配置并重启Klipper
  
  注意

  文档中所出现的所有ID均为示例,实际每个主板的ID均不一致,请根据实际获取到的ID修改填写。

RS232使用方法

• 搜索ID前使用XT30数据线将工具板连接到UTOR或者G2T,下方是参考接线图

• 请注意拨码是否拨到对应地方

  

  搜索工具板的RS232 ID

  注意事项

  重要准备

  1. 固件要求:
     工具板必须刷入RS232固件,否则无法通信
  2. 强制共地:
     ⚠️ 连接工具板前,必须确保其将工具板与主板的GND相连(共用同一个24V/12V电源即可实现)

  RS232注意事项

  • 除了D8、D8PRO与C8P支持RS232接口外,其他主板均不支持RS232接口
  • 不支持的主板需要使用G2T或者UTOR进行链接,本教程使用UTOR进行链接

  搜索RS232 ID

  1. 打开浏览器,在网址栏中输入上位机的IP地址,比如我上位机IP是192.168.101.179直接输入然后回车即可
  
  2. 打开上位机的WEB界面,在左侧边栏的配置选项里找到:

  fluidd为: {…} ,点击进去,即可找到 printer.cfg

  mainsail为:机器,点击进去,即可找到 printer.cfg

  3.点击printer.cfg 进去后,在点击右上方的DEVICES

  4.点击SERIAL ,然后刷新

  fluidd的刷新

  mainsail的刷新

  5.复制ID,点击箭头所指即可复制

  fluidd需要是否存在ttyUSB,并且确保Path_by_hardware存在,这个是RS232_ID

  mainsail需要是否存在ttyUSB,并且确保Path_by_hardware存在,这个是RS232_ID

  注意事项

  • 使用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。

  危险

  请注意下方ID不可以使用!!!!

  serial: /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0

  ---