跳到主要内容

有线连接Klipper配置

须知
  • 需要给STM32F072刷固件后连接到Klipper否则不支持有线连接操作

开始编译​

固件编译简明指南​

注意事项​

  • 网络: 确保上位机(树莓派等)已联网
  • 登录方式: 必须使用 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 选择 STMicroelectronics STM32
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    3Processor model 选择 STM32F072
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    4Bootloader offset 选择 No bootloader
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    5Clock Reference 选择 8 MHz crystal
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    6Communication interface 选择 USB (on PA11/PA12)
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    Communication interface (USB (on PA11/PA12)) --->
    7启用 Optimize stepper code for 'step on both edges'
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    Communication interface (USB (on PA11/PA12)) --->
    USB ids --->
    [*] Optimize stepper code for 'step on both edges'
    8按 Q 键退出配置界面
    (Top)
    Klipper Firmware Configuration
    [*] Enable extra low-level configuration options
    Micro-controller Architecture (STMicroelectronics STM32) --->
    Processor model (STM32F072) --->
    Bootloader offset (No bootloader) --->
    Clock Reference (8 MHz crystal) --->
    Communication interface (USB (on PA11/PA12)) --->
    USB ids --->
    [*] Optimize stepper code for 'step on both edges'
    () GPIO pins to set at micro-controller startup
    9出现 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/stm32/stm32f0_adc.o
    Compiling out/src/stm32/spi.o
    Compiling out/src/stm32/stm32f0_i2c.o
    Compiling out/src/stm32/usbfs.o
    Compiling out/src/stm32/chipid.o
    Compiling out/src/generic/usb_cdc.o
    Compiling out/src/stm32/hard_pwm.o
    Preprocessing out/src/generic/armcm_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 与系统版本变化。

进入烧录模式​

  • 在AirClick断电情况下按住STM32的BOOT将STM32的烧录口通过Type-C与上位机进行连接
    Loading...

烧录固件​

  1. 安装烧录工具
  • FLY上位机无需安装烧录工具
  • 如果你需要安装请注意：上位机需要能上网才可以正常安装
  • 如果已经安装过则无需安装
sudo apt update
sudo apt install dfu-util -y
  1. 执行下面的命令查看是否连接成功。
lsusb

  • 如果没有DFU设备请尝试重新进入烧录模式

  • 因系统版本问题可能显示其他名字，如果有0483:df11则代表进入烧录模式

    Loading...
  1. 烧录固件
  • 执行下方代码开始烧录，请将 <固件文件完整路径> 替换为实际固件文件路径
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D <固件文件完整路径>
  1. 出现下图内容File downloaded successfully则烧录成功
Loading...
提示

烧录完成后，需要给主板彻底断电一次。

搜索USBID​

  • 需要将AirClick的烧录口与上位机的USB口进行连接,请不要按住BOOT按钮否则无法搜索ID
    Loading...

主板 USB ID 获取​

注意事项​

断电操作

需要连接或重新插拔主板 USB 线时，请先完全关闭打印机并断开电源供应。不要在通电状态下插拔线束。

使用范围
  • 必须通过 SSH 登录上位机后执行搜索命令。
  • 操作前请确认主板已经刷入 USB 固件，并通过 Type-C 数据线连接到上位机的 USB 接口。
  • 本教程仅用于搜索主板 USB ID，不适用于搜索工具板 ID。
  • 工具板设备请使用对应产品文档中的 USB 或 CAN ID 获取教程。

操作步骤​

搜索 USB 设备 ID​

通过 SSH 登录上位机，然后执行以下命令列出所有 USB 串口设备 ID：

ls /dev/serial/by-id/*
不可用的 ID​

执行命令后，请避免使用以下两类 ID：

ID 特征原因说明示例
usb-1a86_USB_Serial-if00-port0CH340 等通用串口芯片的默认名称，不能作为 Klipper 主板连接地址/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
包含 katapult设备处于 Katapult 烧录模式，需要先刷写 Klipper 固件/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx
搜索结果​

正常情况下，终端会显示类似下图的设备路径，图片中的 ID 仅作为格式示例。

Loading...

没有找到可用 ID：查看设备固件与连接问题排查

出现多个 ID

如果命令返回多个可用 ID，请结合主板 MCU 型号以及插拔前后的设备列表变化，确认主板对应的完整设备路径。

将 USB ID 填写到配置中​

在 Fluidd 或 Mainsail 中打开 printer.cfg：

Fluidd：点击左侧的 {…} 图标，然后打开 printer.cfg。

Loading...

Mainsail：点击左侧的“机器”，然后打开 printer.cfg。

Loading...
ID 必须使用实际搜索结果

文档中的设备路径均为示例。每块主板的 USB ID 都可能不同，请完整复制 SSH 命令返回的实际路径。

找到 [mcu] 配置段，将 serial 修改为刚才查询到的完整设备路径：

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

使用 USB 固件时应配置 serial，不要在同一个 [mcu] 配置段中同时填写 canbus_uuid。

配置位置可参考下图：

Fluidd 配置示例
Loading...
Mainsail 配置示例
Loading...

修改完成后，点击右上角的 SAVE & RESTART，保存配置并重新启动 Klipper。

Loading...