Marlin固件中Z轴运动异常问题的分析与解决

问题现象描述

在使用Marlin固件的3D打印机上，用户报告了一个关于Z轴运动的异常现象：打印机在开始打印时能够正常工作，但在完成最初几层后，Z轴停止运动，而X轴和Y轴仍能正常移动。用户注意到这个问题似乎与BLTouch传感器的Z偏移值有关，当Z轴达到该偏移值时便停止运动。

环境配置

该问题出现在以下硬件配置中：

• 打印机型号：Creality CR10S
• 主板：Bigtreetech SKR MINI E3 V3.0
• 显示模块：Bigtreetech TFT35-E3
• 传感器：BLTouch自动调平传感器
• 固件版本：Marlin bugfix-2.1.x (2024-09-13版本)

问题排查过程

初步验证

Marlin开发团队首先在测试平台上尝试复现该问题。测试使用了相同的主板和LCD配置，但采用了固定式探头(FIX_MOUNTED_PROBE)替代BLTouch。测试结果表明，Z轴能够正常运动至Z10高度，未出现用户描述的问题。

测试过程中对用户提供的配置文件做了以下调整：

1. 使用了模拟热敏电阻设置
2. 移除了加热相关G代码
3. 修改了限位开关的触发状态设置

用户进一步反馈

用户提供了额外信息：

1. 使用原厂Creality主板时一切正常
2. 尝试过Bigtreetech提供的预编译固件(针对Ender 3)，虽然尺寸参数不正确，但Z轴运动正常
3. 尝试编译Marlin-lts-2.0.9版本也未能解决问题

配置差异分析

用户最终通过重新配置解决了问题，并提供了工作与非工作配置的差异文件。关键差异点包括：

1. 运动参数设置
2. 探头相关配置
3. 限位开关逻辑
4. 步进电机驱动参数

问题根源分析

虽然未能完全确定具体原因，但推测可能与以下因素有关：

1. Z偏移处理逻辑：BLTouch的Z偏移可能在特定配置下导致固件计算错误
2. 运动规划参数：非工作配置中可能设置了不合理的加速度或速度限制
3. 限位开关逻辑：错误的限位开关状态设置可能导致运动异常
4. 步进电机驱动配置：不匹配的步进驱动参数可能导致运动停止

解决方案建议

对于遇到类似问题的用户，建议采取以下步骤：

1. 完整重新配置：从基础配置开始，逐步添加功能，而非直接修改现有配置
2. 检查运动参数：特别注意Z轴的最大速度、加速度和步数/mm设置
3. 验证限位设置：确保所有限位开关的触发状态与实际硬件匹配
4. 逐步测试功能：先测试基本运动功能，再逐步启用高级功能如自动调平
5. 参考官方示例：使用与硬件匹配的官方示例配置作为起点

经验总结

这个案例展示了3D打印机固件配置的复杂性，特别是当更换主板和添加额外传感器时。配置文件中看似微小的差异可能导致完全不同的行为。建议用户在修改配置时：

1. 保持详细的修改记录
2. 每次只修改一个参数并测试效果
3. 准备多个已知可用的配置备份
4. 理解每个参数的实际意义，而非盲目复制他人配置

通过系统性的配置管理和测试，可以有效避免类似运动异常问题的发生。