跳到主要内容

USB 固件编译

开始编译​

固件编译简明指南​

注意事项​

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

SSH登录与用户切换​

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

切换用户：​

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

固件编译操作指南​

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

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

开始固件编译​

下面介绍如何编译固件：

  1. 连接到 SSH，输入下面的命令并按 Enter：

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

    其中，rm -rf ~/klipper/.config && rm -rf ~/klipper/out 用于清除之前的编译配置与固件； make menuconfig 用于打开 Klipper 固件配置界面。

  2. 按照下方顺序逐项设置，每完成一项再继续下一项。

    1启用 Enable extra low-level configuration options
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    2Micro-controller Architecture 选择 Raspberry Pi RP2040/RP235x
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->
    3Processor model 选择 rp2040
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->
    Processor model (rp2040) --->
    4Bootloader offset 选择 16KiB bootloader
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->
    Processor model (rp2040) --->
    Bootloader offset (16KiB bootloader) --->
    5Communication Interface 选择 USBSERIAL
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->
    Processor model (rp2040) --->
    Bootloader offset (16KiB bootloader) --->
    Communication Interface (USBSERIAL) --->
    6启用 Optimize stepper code for 'step on both edges'
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->
    Processor model (rp2040) --->
    Bootloader offset (16KiB bootloader) --->
    Communication Interface (USBSERIAL) --->
    USB ids --->
    [*] Optimize stepper code for 'step on both edges'
    7按 Q 键退出配置界面
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->
    Processor model (rp2040) --->
    Bootloader offset (16KiB bootloader) --->
    Communication Interface (USBSERIAL) --->
    USB ids --->
    [*] Optimize stepper code for 'step on both edges'
    () GPIO pins to set at micro-controller startup
    8出现 Save configuration 时按 Y 保存配置
    Quit
    Save configuration?
    (Y)es(N)o(C)ancel

  3. 完成上方最后两个步骤，按 Q 退出配置界面，再按 Y 保存配置。

  4. 返回命令行后输入下面的命令并按 Enter 开始编译：

    make -j4
    root@flyos-11e5f8 ~/klipper # make -j4
    Compiling out/src/rp2040/bootrom.o
    Compiling out/src/rp2040/usbserial.o
    Compiling out/src/generic/usb_cdc.o
    Compiling out/src/rp2040/chipid.o
    Compiling out/src/rp2040/hard_pwm.o
    Compiling out/src/rp2040/spi.o
    Compiling out/src/rp2040/i2c.o
    Preprocessing out/src/rp2040/rpxxxx_link.ld
    Building out/compile_time_request.o
    Version: XXXX
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

    终端末尾出现 Linking out/klipper.elf 和 Creating bin file out/klipper.bin，即表示编译成功。 实际编译时，部分 Compiling 行和 Version 会随 Klipper 与系统版本变化。

确认是否进入烧录模式​

断电操作

开始前请完全关闭打印机并断开电源供应。不要在通电状态下插拔线束、整理线序或触碰端子。

  • 使用Type-C数据线将主板连接至上位机后,双击reset按钮,此时主板上会有LED灯闪烁。
警告
  • 如果没有LED灯闪烁,请重新烧录Katapult固件:烧录Katapult固件
  • 如果没有LED灯闪烁,请在烧录完Katapult固件后,再执行下一步

烧录固件​

开始烧录​

按设备当前状态选择烧录方式：

您的下位机现在是什么状态

常见失败原因​

现象可能原因处理
搜索不到 usb-katapult_未进入 Katapult、数据线仅充电或 USB 口异常双击 RST；用 lsusb 确认 1d50:6177；更换数据线和 USB 口
Invalid firmware path '...'-f 路径不存在，或尚未编译回到编译步骤，确认 ~/klipper/out/klipper.bin 存在
Unable to open serial portKlipper 服务占用串口执行 sudo systemctl stop klipper 后重试
Device is not Katapult, exiting...设备不在 Katapult 模式双击 RST 重新进入；仍无效时参考当前产品的 Bootloader 恢复文档
Flash Tool Error 并附带 Traceback线缆、供电或固件类型不匹配保留完整输出，核对是否刷错 USB / USB 桥接 CAN 固件
烧录成功但 Klipper 连不上固件类型与接线不一致，或 [mcu] 未更新确认应出现 usb-Klipper_ 还是 canbus_uuid，并修改 [mcu]
双击 RST 无灯，始终没有 1d50:6177Katapult 可能已损坏参考当前产品的 Bootloader（Katapult）恢复文档

烧录后搜索 USB ID​

固件烧录完成并给主板重新上电后，请继续搜索 USB ID。

查看 USB ID 获取方法

Loading...