Klipper固件设置指南

固件 Klipper 配置

Klipper是现代3D打印机的首选固件，尤其适合Voron打印机。它利用树莓派等Linux主控板来执行复杂的运动计算，让8位主板也能实现高性能打印。

安装前准备

硬件要求

• 树莓派（Pi 3B+或更高，或CB1/CM4等替代品）
• 支持Klipper的主板（BTT Octopus/SKR系列、Manta系列等）
• microSD卡（16GB以上，建议使用高速卡）
• 5V电源适配器（树莓派专用）

第一步：安装系统

使用Raspberry Pi Imager

推荐使用Mainsail OS或Fluidd OS — 这两个都是Klipper专用系统，开箱即用。下载后用Raspberry Pi Imager写入SD卡。

如果你已有树莓派系统，也可以手动安装：

• 安装依赖：sudo apt update && sudo apt install python3 python3-pip git
• 克隆Klipper：git clone https://github.com/Klipper3d/klipper
• 运行安装脚本：cd klipper && ./scripts/install-ubuntu.sh

第二步：编译Klipper固件

配置内核

运行 make menuconfig，根据你的主板选择配置。以BTT Octopus Pro为例：

• Microcontroller Architecture: STMicroelectronics STM32
• Processor model: STM32F446
• Bootloader offset: 32KiB bootloader
• Communication interface: USB (on PA11/PA12)

运行 make 编译，生成 klipper.bin 文件。将文件复制到SD卡并重命名为 firmware.bin，然后插入主板并通电升级。

第三步：配置打印机

Klipper的配置文件位于 ~/printer_data/config/printer.cfg。Voron官方提供了针对各机型的标准配置文件，可以从Voron GitHub下载。关键配置项：

• [stepper_x/y/z]：步进电机参数（步进值、方向、限位）
• [extruder]：热端配置（加热器、热敏电阻型号、PID参数）
• [heater_bed]：热床配置
• [mcu]：主板串口地址（可通过 ls /dev/serial/by-id/ 查找）

第四步：安装Web界面

Mainsail和Fluidd是目前最流行的Klipper Web界面。安装方式：

• 使用KIAUH脚本一键安装：git clone https://github.com/dw-0/kiauh && cd kiauh && ./kiauh.sh
• 选择Install → Mainsail，按照提示完成安装
• 安装完成后通过 http://<树莓派IP>:80 访问Web界面

第五步：验证和测试

上传配置后，在Web界面点击"保存并重启"。如果配置正确，你将在状态面板看到所有传感器读数。依次测试：

• 各轴运动（注意限位开关方向）
• 热端加热和温度读取
• 热床加热
• 风扇控制