Marlin固件中Z轴微调偏移量问题的分析与解决

问题背景

在Marlin固件bugfix-2.1.x分支中，用户报告了一个关于Z轴微调偏移量(Babystepping Z-Offset)功能异常的问题。当用户尝试通过LCD界面调整Z轴探针偏移量时，系统没有按照设定的微调步长(如0.01mm)移动，而是使用了轴移动的步长设置(如10mm)，导致打印头移动距离远大于预期。

问题现象

1. 在调整Z轴探针偏移量时，界面显示正确的微调步长(如0.01mm)
2. 但实际执行时却使用了轴移动的步长设置(如10mm)
3. 在打印过程中调整偏移量时，可能导致打印头过度下压或出现异常移动

技术分析

这个问题源于Marlin固件中LCD/TFT界面处理微调偏移量的逻辑缺陷。具体来说：

1. 在ui_common.cpp文件的moveAxis函数中，系统计算移动距离时直接使用了motionAxisState.currentStepSize
2. 对于Z轴探针偏移量调整，这个值应该被覆盖或重置，但原始代码没有正确处理
3. 导致系统在计算实际移动距离时，错误地使用了轴移动的步长而非微调步长

解决方案

开发团队通过以下修改解决了这个问题：

1. 将diff变量从const改为可修改的变量
2. 在检测到是Z轴探针偏移量调整时，将diff重置为0
3. 确保系统只执行babystepping而不执行额外的轴移动

核心修改如下：

float diff = motionAxisState.currentStepSize * direction;  // 改为非const变量

// 在Z轴探针偏移量调整时
if (axis == Z_AXIS && motionAxisState.z_selection == Z_SELECTION_Z_PROBE) {
    diff = 0;  // 重置移动距离
}

注意事项

1. 用户需要正确设置BABYSTEP_MULTIPLICATOR_Z和BABYSTEP_ZPROBE_OFFSET参数
2. 典型的Z轴步进电机设置约为400步/mm
3. 每个微调步长实际移动距离约为0.01mm，可能需要多次点击才能观察到明显移动

结论

这个问题展示了固件开发中界面交互与底层控制逻辑之间协调的重要性。通过这次修复，Marlin固件确保了Z轴微调偏移量功能的准确性和可靠性，为3D打印过程中的精细调平提供了更好的支持。

建议用户更新到包含此修复的最新bugfix-2.1.x分支代码，以获得稳定的打印体验。对于自行编译固件的用户，可以手动应用上述修改或等待官方发布包含此修复的版本。