重要说明

注意事项

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

工具板ID读取查看

• USB ID获取
• CANBus UUID获取

注意事项

重要前提

在开始搜索工具板 ID 前，请务必确认满足以下所有条件：

• 固件准备: 工具板已刷入 USB 固件，或正处于 USB 烧录模式。
• 目标明确: 本教程仅用于搜索工具板的 ID，不适用于主板 ID。
• 硬件连接: 工具板已通过USB正确连接到上位机的USB-A接口。
• 登录方式: 请通过网络 SSH 登录到上位机进行操作，请勿使用串口登录。

搜索USBID

ls /dev/serial/by-id/*

• 正常情况: 终端会显示类似下方的ID(下图仅为示例)
  Loading...

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

注意事项

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

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

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

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

危险

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

填写工具板USB ID

• 下方是参考配置

  注意事项

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

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

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

  fluidd的参考 Loading...

  mainsail的参考 Loading...

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

• CAN参考接线

  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 中配置,则不会显示在搜索结果中。如需重新搜索,请:

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

  配置CAN设备ID

  1. 获取配置文件

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

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

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

  2. 添加设备配置

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

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

  配置说明

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

  3. 保存并重启

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

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