Marlin固件升级后Z轴偏移问题的分析与解决

问题背景

在3D打印领域，Marlin固件作为最流行的开源固件之一，其稳定性和功能性备受用户信赖。然而，在从Marlin 2.1.1升级到2.1.3-b1版本的过程中，部分用户遇到了Z轴偏移设置异常的问题。本文将深入分析这一问题的成因，并提供详细的解决方案。

问题现象

升级后的固件表现出以下异常行为：

1. 设置Z轴偏移后，实际喷嘴高度与显示数值不符
2. 执行G28归位命令后，喷嘴停留在距离打印平台约1.4mm的高度
3. 显示界面报告的Z轴位置与物理位置存在明显差异
4. 虽然显示异常，但实际打印过程却能正常进行

技术分析

固件行为变更

经过对比2.1.1和2.1.3-b1版本的代码，发现Z轴归位后的处理逻辑发生了以下变化：

1. Z_AFTER_HOMING参数现在被赋值给Z_POST_CLEARANCE变量
2. 归位完成后调用do_move_after_z_homing()函数
3. 当Z_POST_CLEARANCE被定义时，会调用do_z_clearance()函数
4. 新增了探头触发高度的计算逻辑，以防止探头碰撞障碍物

根本原因

问题的核心在于2.1.3-b1版本中新增的安全保护机制。当使用探头进行Z轴归位时，固件会自动添加探头触发高度作为安全余量，导致喷嘴无法完全下降到打印平台表面。这一设计变更虽然提高了安全性，但改变了原有的Z轴偏移行为模式。

解决方案

推荐方案：使用探头偏移向导

Marlin 2.1.3-b1版本引入了更精确的PROBE_OFFSET_WIZARD功能：

1. 在配置文件中启用PROBE_OFFSET_WIZARD
2. 通过菜单运行向导程序
3. 向导会在探头正上方进行精确校准
4. 自动计算并保存最优的Z轴偏移值

这种方法比传统的手动设置更加准确可靠。

高级配置方案

对于需要精确控制Z轴行为的用户，可以考虑以下配置调整：

1. 修改Z_POST_CLEARANCE行为：

do_z_clearance(Z_POST_CLEARANCE,
  ALL(HOMING_Z_WITH_PROBE, HAS_STOWABLE_PROBE)
    && TERN0(HAS_BED_PROBE, endstops.z_probe_enabled), true);

2. 调整Z_PROBE_OFFSET_RANGE_MIN参数
3. 必要时禁用MIN_SOFTWARE_ENDSTOP_Z限制

注意事项

1. 使用负值Z轴偏移时，必须确保Z_PROBE_OFFSET_RANGE_MIN设置允许负值
2. 负值偏移需要禁用Z轴软件限位(MIN_SOFTWARE_ENDSTOP_Z)
3. 建议在调整参数前进行完整的热床校准
4. 对于BLTouch等可伸缩探头，需特别注意探头触发高度的设置

结论

Marlin 2.1.3-b1版本的Z轴偏移行为变化并非bug，而是安全机制增强的结果。通过使用新的探头偏移向导功能，用户可以获取更精确的校准结果。对于高级用户，通过适当调整配置参数，仍然可以实现对Z轴行为的精细控制。理解这些变更背后的设计理念，有助于用户更好地利用Marlin固件的高级功能，提升3D打印体验。