跳到主要内容

CAN 固件编译

开始编译​

固件编译简明指南​

注意事项​

  • 网络: 确保上位机(树莓派等)已联网
  • 登录方式: 必须使用 SSH 通过网络登录,禁用串口
  • 输入法: 保持键盘为英文半角模式

SSH登录与用户切换​

使用 MobaXterm、PuTTY 等工具 SSH 登录上位机。

切换用户:​

  • 普通系统(树莓派官方系统等)
    禁止使用 root,需切换到普通用户: 
    su <用户名>
  • FLY上位机(FlyOS-FAST系统)
    仅支持 root 用户登录(密码: mellow)

固件编译操作指南​

在 Klipper 固件配置界面中仅支持键盘操作,无法使用鼠标。

按键功能
↑ / ↓上下移动光标,选择菜单项
Enter / 空格确认选择、勾选选项或进入子菜单
ESC返回上一级菜单
Q退出配置界面
Y退出时,如有提示则按 Y 保存配置

开始固件编译​

下面介绍如何编译固件:

  • 连接到SSH后输入下面的命令并回车:

    cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

  • 其中 rm -rf ~/klipper/.config && rm -rf ~/klipper/out是删除之前编译数据与固件

  • make menuconfig是编译固件,执行后应该出现下方界面

    Loading...

  • 选择Enable extra low-level configuration options并且回车

    Loading...

  • 进入菜单Micro-controller Architecture然后选择Raspberry Pi RP2040/RP235x回车

    Loading...

  • 选择Bootloader offset,选择:16KiB bootloader

    Loading...

  • 选择Communication interface,选择:CAN bus

    Loading...
  • 选择GPIO pins to set at micro-controller startup,输入:gpio17
    Loading...
  • 按 Q 键,出现 Save configuration,这时再按 Y 键
    Loading...
  • 现在应该保存了配置并且退出到了命令行界面
  • 输入下方指令开始编译,时间有点长
make -j4
Loading...
  • 最后输出下面的内容则编译成功
  • 因Klipper版本问题只需要出现out/klipper.bin则代表成功 
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

接线​

  • 烧录固件前使用XT30数据线将工具板连接到UTOC或者刷了桥接固件的主板,下方是参考接线图
    Loading...
  • 请确保CAN H与CAN L在断电情况下使用万用表测量阻值在60Ω左右,如果是120Ω则需要接上120Ω跳线,如果是40Ω左右需要将跳线移除
    Loading...
  • 使用XT30数据线将工具板连接至UTOR或者刷了USB桥接CAN的主板后,此时主板上会有LED灯闪烁。
警告
  • 如果没有LED灯闪烁,请重新烧录katapult固件:烧录katapult固件
  • 如果没有LED灯闪烁,请在烧录完katapult固件后,再执行下一步

搜索ID并且烧录​

查询CANBus UUID​

操作前须知
  • 建议在非打印状态下执行ID查询和固件刷写操作,避免干扰打印过程。
  • 同一主板/工具板的Katapult(CANBoot)固件与Klipper固件使用相同的CAN ID。
前提条件

请确保满足以下条件,否则可能无法正常搜索到CAN ID:

  1. 上位机CAN网络已正确配置
  2. 工具板CAN速率与上位机完全一致(速率不一致将无法通信)
  3. 执行 lsusb 命令后能看到 1d50:606f 设备(USB-CAN适配器)

搜索命令(根据系统选择)​

  • 普通上位机搜索指令 
    ~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
  • FLY上位机搜索指令 
    python3 ~/klipper/scripts/canbus_query.py can0

搜索结果说明​

情况一:已刷Klipper固件的主板/工具板​

  • 显示效果:显示一个CAN ID,并提示 Application: Klipper
  • 说明:设备已运行Klipper固件,可以直接使用。此ID可能是主板ID也有可能是工具板ID。
  • 区分方法:断开工具板的CAN连接线后重新搜索。如果该ID消失,则属于工具板；如果该ID仍在,则属于主板。
Loading...

情况二:主板 + 待烧录工具板​

  • 显示效果:显示两个CAN ID
  • 说明:主板运行Klipper固件,工具板运行CanBoot固件,等待烧录。
Loading...

情况三:UTOC + 待烧录工具板​

  • 显示效果:UTOC本身不显示ID,只显示工具板的ID
  • 说明:UTOC仅作为桥接器,需确保工具板处于CanBoot模式。
Loading...

情况四:无ID显示​

  • 显示效果:无任何ID显示
  • 可能原因:
    1. CAN总线被Klipper占用
    2. 上位机CAN0速率配置错误
    3. 物理接线异常
    4. 设备未进入CanBoot模式
Loading...
重要提示
  • 待烧录状态:工具板处于CanBoot模式时会显示 Application: CanBoot 且固件灯闪烁,此时可进行固件烧录。
  • ID占用处理:如果设备已运行Klipper固件且ID已填入配置文件,ID将不会显示(被Klipper占用)。如需重新显示,需在配置中屏蔽该ID并彻底断电重启。
故障排查

如果无法查询到UUID,请参考: CAN问题排查指南

固件烧录​

烧录命令​

  1. 将下方命令中的 241696050c56 替换为您实际查询到的UUID
  2. 注意:-u 参数后需有空格
python3 ~/klipper/lib/canboot/flash_can.py -u 241696050c56

烧录成功确认​

出现 CAN Flash Success 提示即表示烧录成功:

Loading...

固件更新​

更新方法​

当需要更新固件时,只需:

  1. 重新编译固件
  2. 确保能查询到设备CAN ID(或Klipper已连接设备)
  3. 执行相同的烧录命令
python3 ~/klipper/lib/canboot/flash_can.py -u <MCU ID>

更新成功示例​

Loading...

确认固件是否启动​

  • 如果固件正常启动LED会亮起来
    Loading...
Loading...