当前位置：首页 > news >正文

1. Klipper从安装到运行

news 2025/6/28 11:57:42

本文记录Klipper固件从安装，配置到运行的详细过程

Klipper是3D打印机固件之一，它通常运行在linux系统（常使用Debian，其它的linux版本也可以）上，因此需要一个能运行Linux系统的硬件，比如电脑，树莓派，瑞芯微/全志等SOC系列的开发板或相应的主板等。

1. 安装klipper

kiauh是klipper及相关配套软件的一个安装管理脚本，提供一个字符的类图形管理界面，它可以自动下载和安装相关依赖软件，因此，使用kiauh安装klipper比较方便，不易出错。

1.1 下载git

sudo apt-get update && sudo apt-get install git -y

kiauh是开源在github上的脚本，因此需要先安装git工具

1.2 下载kiauh

kiauh源码地址：https://github.com/dw-0/kiauh，可以手动下载也可以使用下面命令下载，下到家目录下

cd ~ && git clone https://github.com/dw-0/kiauh.git

1.3 下载完后，执行命令：

./kiauh/kiauh.sh

就可以打开kiauh安装管理界面：

1.4 安装klipper

从上图可见，有很多软件都是Not installed的，输入1，进入Install界面，这里可以安装很多软件。

其中：

Klipper：klipper主体软件，必须安装，手动下载地址：GitHub - Klipper3d/klipper: Klipper is a 3d-printer firmware
Moonraker：klipper主服务，为所有网页和人机界面提供控制和信息接口，必须安装，手动下载地址：https://github.com/Arksine/moonraker
Mainsail或Fluidd（二选一）：内置网页接口，安装其中一个，端口为80，需要网页上进行操作的安装，手动下载地址：

Fluidd: https://github.com/fluidd-core/fluidd

Mainsail: https://github.com/mainsail-crew/mainsail

KlipperScreen：klipper默认显示屏操作界面，需要在显示屏上操作的安装，手动下载地址：https://github.com/KlipperScreen/KlipperScreen
Crowsnest：摄像头服务（旧版使用MJPG-Streamer：https://github.com/jacksonliam/mjpg-streamer）老版本，需要接USB摄像头的安装，手动下载地址：GitHub - mainsail-crew/crowsnest: Webcam Service for multiple Cams

根据需求，安装上面的若干软件，一般情况下，上面5个都安装。

2.编译下位机

通常Klipper运行在一上位机，若干下位机的模式，运行Klipper主服务的是上位机，主要执行打印文件读取-解析，运动控制序列生成，通信，人机交互等，通常由带系统的主板执行；下位机则执行运动，信号检测，温度测试等，通常由MCU主板执行。

所以，需要编译klipper固件，并烧录到MCU，通过通信口（uart,USB,can等）和上位机连接，以实现上下位机配合，完成3D打印整个控制。

编译下位机klipper固件，需要查看下位机MCU的芯片类型，通信方式等，如我使用的下位机是芯片是STM32H723ZET6，通信是uart1，klipper默认uart波特率是250000，因此，需要配置klipper固件：

cd ~/klipper
make menuconfig

上述命令会打开配置界面，需要根据下位机硬件进行配置，比如我的硬件是STM32H723，晶振是25MHz，使用串口和上位机通信，采用波特率115200（默认是250000），则我的配置如下：

注意，可能原始的配置上没有电路板上的串口，比如原始没有USART1(PB15,PB14），这时需要自己手动修改kconfig文件，比如STM32的在klipper/src/stm32下，增加电路板上的串口进去：

同时需要修改驱动文件（klipper/src/stm32/stm32f0_serial.c或者serial.c）相关位置，以适配电路串口。

如此修改后，就可以执行make命令编译了，编译的结果在out/klipper.bin中，将其烧录到主板上，即可。

3.配置文件

3.1 klipper配置文件默认在printer_data/config下，通常在网页上配置比较方便。

moonraker.conf：与moonraker服务有关，通常不需要去改

mainsail.cfg：与内置网页设备和行为有关，可以根据网页上操作需求进行一些配置，刚开始不用改

crowsnest.conf：USB摄像头配置文件，装USB摄像头时，需要配置它

printer.cfg：打印机配置文件，这是klipper打印机配置的核心文件，需要详细配置

3.2 通信接口配置

首先要配置的是上下位机通信接口，修改的是printer.cfg。

很多采用串口与下位机通信，首先在上位机系统中找到/dev/serial/，看看里面有没有下位机生成的by-id或by-path，通常是有的，我的是/dev/serial/by-path，波特率默认是250000，但是上面我们配置的下位机，波特率是115200，因此，在mcu字段配置如下：