Klipper进阶配置指南

固件 Klipper 进阶 宏

掌握了基本的Klipper安装和配置后，本指南将带你深入探索Klipper的高级功能，包括宏编写、自定义G代码、多挤出机配置、远程监控等。

宏编写基础

Klipper的宏系统是最强大的功能之一。宏允许你定义自定义命令，实现复杂的自动化操作。

基本宏语法

[gcode_macro HOME_ALL]
gcode:
    G90  ; 绝对定位
    G28  ; 归零所有轴
    G1 X150 Y150 Z20 F3000  ; 移动到热床中心上方

带参数的宏

[gcode_macro PREHEAT]
gcode:
    {% set temp = params.TEMP|default(100)|int %}
    M104 S{temp}  ; 设置热端温度
    M140 S{temp - 20}  ; 设置热床温度为temp-20
    M117 预热中...温度: {temp}°C

高级宏示例

自动校准流程

[gcode_macro FULL_CALIBRATION]
gcode:
    G28  ; 归零
    QUAD_GANTRY_LEVEL  ; QGL调平
    G28 Z  ; 重新归零Z轴
    PROBE_CALIBRATE  ; 校准探针
    SAVE_CONFIG  ; 保存配置
    M117 校准完成

filament更换宏

[gcode_macro FILAMENT_CHANGE]
gcode:
    M117 正在更换filament...
    G91  ; 相对定位
    G1 E-20 F300  ; 回抽filament
    G90  ; 绝对定位
    G1 X150 Y250 Z50 F6000  ; 移动到换料位置
    M117 请装入新filament
    M0  ; 暂停等待
    G91
    G1 E20 F300  ; 挤出少量filament
    G90
    M117 filament更换完成

多挤出机配置

Voron可以通过某些改装支持多材料打印。Klipper原生支持多挤出机配置：

• 定义多个 [extruder] 段：[extruder], [extruder1], [extruder2]
• 配置工具头切换的G代码宏
• 设置各挤出机的独立温度和挤出参数
• 使用Mainsail的Dashboard监控多挤出机状态

远程监控配置

Moonraker API

Moonraker是Klipper的API服务，提供RESTful接口用于远程监控：

• 默认端口：7125
• 常用端点：/api/printer, /api/server, /machine/proc_stats
• 可以集成Home Assistant等智能家居平台
• 配置防火墙开放端口用于外网访问（注意安全！）

摄像头设置

在Mjpg-Streamer或crowsnest配置摄像头：

• 安装：sudo apt install mjpg-streamer
• 配置USB摄像头或树莓派Camera Module
• 通过Mainsail/Fluidd的Webcam面板查看实时画面
• 启用延时摄影功能监控长时间打印过程

性能优化

输入整形（Input Shaper）高级设置

• MZV：最平衡的模式，适用大多数情况
• ZV：最严格，适合高精度打印
• EI 3Hump：最激进，适合高速打印
• 为X/Y轴分别测量共振频率，设置不同滤波模式

加速度控制

• 正方形加速度：10000-15000mm/s²（V2.4典型值）
• 使用 SET_VELOCITY_LIMIT 在打印过程中动态调整
• 为不同轴设置不同加速度（X/Y通常比Z高）

安全配置

• 启用热失控保护：[verify_heater] 段配置最大温度和加热时间
• 配置MCU看门狗：防止主板死机
• 设置温度告警：Moonraker的Telegram Bot通知
• 配置自动关机宏：打印完成后通过智能插座或Relay切断电源