Klipper3D微步漂移问题分析与解决方案

问题概述

在Klipper3D固件的Z轴探测操作中，发现了一个长期存在的微步漂移问题。该问题会导致在连续探测过程中，触发位置与停止位置之间存在微步级别的差异，这种差异会随着探测次数的增加而累积，最终影响打印质量，特别是床面网格补偿的准确性。

问题表现

当使用高分辨率Z轴（如TR8*4导螺杆，步进角1.8度，64微步）和较快的探测速度（如3mm/s）时，每次探测操作都会产生1个微步的漂移。这种漂移会不断累积，导致：

1. 床面网格补偿数据出现系统性误差
2. 第一层打印高度不一致
3. 打印几何形状失真
4. 多轴校准结果不准确

技术背景

Klipper3D的探测机制包含两个关键参数：

• ENDSTOP_SAMPLE_TIME：端停止采样时间
• ENDSTOP_SAMPLE_COUNT：端停止采样次数

这些参数原本是为了解决老式打印机端停止信号噪声问题而设计的，采样机制会在触发后继续运行(ENDSTOP_SAMPLE_COUNT - 1)次采样，以确保触发信号的可靠性。

问题根源

经过深入分析，发现问题出在MCU_endstop.home_wait()函数的实现上。该函数返回触发时间，但没有考虑端停止过采样带来的延迟。具体表现为：

1. 触发位置(trig_pos)来自压缩步数
2. 停止位置(halt_pos)来自迭代求解器(使用stepper.get_mcu_position())
3. 两者之间的差异被错误地添加到stepper.get_commanded_position()

这种实现导致了每次探测都会产生微步级别的误差积累。

解决方案

核心开发者提出了修正方案，主要修改点在klippy/mcu.py文件中：

1. 添加_oversample_ticks变量来跟踪过采样时间
2. 在_build_config方法中计算并存储sample_ticks
3. 修改home_wait方法，在返回时间时考虑过采样延迟

该修正确保：

• 单MCU探测中，trig_pos和halt_pos保持一致
• 多MCU探测中，仍能正确反映通信延迟带来的"过步"

影响范围

该问题影响所有使用以下配置的用户：

• 高分辨率Z轴（小导程螺杆或高微步设置）
• 较快探测速度
• ENDSTOP_SAMPLE_COUNT大于1（默认值为4）

特别影响依赖精确Z轴定位的功能，如：

• 床面网格补偿
• Z轴校准
• 第一层高度控制
• 多轴同步校准

验证结果

经过社区成员测试验证：

1. 修正后微步漂移现象完全消失
2. 床面网格补偿准确性显著提高
3. 多轴校准结果更加稳定可靠

技术建议

对于暂时无法升级固件的用户，可采取以下临时解决方案：

1. 降低微步设置（如从64降至16）
2. 减小探测速度
3. 设置ENDSTOP_SAMPLE_COUNT=1（牺牲噪声过滤）

但建议尽快应用官方修正，以获得最佳打印效果。

总结

这个长期存在的微步漂移问题的发现和解决，体现了开源社区协作的力量。它不仅解决了困扰用户多年的打印精度问题，也为Klipper3D的持续改进提供了宝贵经验。建议所有受影响用户及时更新固件，以获得更稳定、更精确的打印体验。