Klipper Z轴自动校准插件完整使用指南
项目地址: https://gitcode.com/gh_mirrors/kl/klipper_z_calibration Klipper Z轴自动校准插件是一个功能强大的工具，能够自动校准3D打印机的Z轴偏移，确保每次打印的第一层都完美贴合。无论您更换喷嘴还是使用新的柔性打印板，都能获得一致的打印质量。
项目文件结构详解
核心文件
- z_calibration.py - 核心插件脚本，实现智能Z轴偏移自动校准算法
- README.md - 项目说明文档和使用指南
- LICENSE - GPL v3.0开源许可协议
- install.sh - 自动化安装脚本
图片资源目录
- pictures/ - 包含项目相关的示意图和说明图片
安装与配置
安装步骤
- 克隆项目到Klipper配置目录：
git clone https://gitcode.com/gh_mirrors/kl/klipper_z_calibration
- 运行安装脚本：
cd klipper_z_calibration
./install.sh
配置文件设置
在Klipper的printer.cfg文件中添加以下配置：
[z_calibration]
switch_offset: 1.5
speed: 50.0
samples: 3
samples_tolerance: 0.006
samples_tolerance_retries: 3
samples_result: median
lift_speed: 10.0
safe_z_height: 20.0
nozzle_xy_position: 100,100
switch_xy_position: 150,150
bed_xy_position: 100,100
主要功能详解
CALIBRATE_Z 命令
这是核心校准命令，自动执行完整的Z轴偏移校准流程。它会：
- 在喷嘴位置探测Z轴限位开关
- 在开关位置探测Z轴限位开关
- 在床面位置进行探测
- 计算新的Z轴偏移值并应用
PROBE_Z_ACCURACY 命令
用于测试Z轴限位开关在喷嘴位置的精度，提供详细的统计信息：
- 最大/最小值
- 测量范围
- 平均值和中位数
- 标准偏差
CALCULATE_SWITCH_OFFSET 命令
基于当前Z轴位置计算开关偏移值，适用于手动调整后的偏移更新。
关键配置参数说明
switch_offset
开关偏移值，表示喷嘴与开关触发点之间的垂直距离。较小的值表示喷嘴离床面较远。
offset_margins
偏移容差范围，默认值为"-1.0,1.0"，表示可接受的偏移变化范围。
探测参数
- samples: 探测采样次数
- samples_tolerance: 样本间允许的最大差异
- samples_tolerance_retries: 超出容差时的重试次数
使用流程
1. 准备工作
确保打印机已完成以下操作：
- 所有轴已完成归零
- 探测传感器已正确安装
- 床面已预热到工作温度
2. 执行校准
在Klipper控制台或网页界面中输入：
CALIBRATE_Z
3. 验证结果
使用以下命令验证Z轴精度：
PROBE_Z_ACCURACY
高级功能
多点探测支持
插件支持在多个位置进行探测，确保整个打印区域的Z轴偏移一致性。
自动重试机制
当探测样本超出容差范围时，系统会自动重试，提高校准的可靠性。
故障排除
常见问题
-
"must home axes first"错误
- 确保所有轴已完成归零操作
-
"probe switch not closed"错误
- 检查探测传感器是否正确连接
- 验证开关位置配置
重要提示
- 开关偏移值越小，喷嘴离床面越远
- 首次使用时建议手动验证校准结果
- 定期运行校准以确保打印质量
技术原理
该插件通过比较三个关键位置的探测结果来计算Z轴偏移：
- 喷嘴位置的Z轴限位开关探测
- 开关位置的Z轴限位开关探测
- 床面位置的探测传感器探测
最佳实践
- 定期校准：建议每次更换喷嘴或打印板后运行校准
- 温度稳定：确保在床面和喷嘴达到工作温度后进行校准
- 参数优化：根据具体打印机特性调整采样次数和容差值
通过合理配置和使用Klipper Z轴自动校准插件，您可以显著提高3D打印的第一层质量，减少手动调整的时间和精力。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
