Marlin固件中额外轴命名不一致问题解析

问题概述

在Marlin固件中，当使用M914和M906等G代码命令时，存在一个关于额外轴(如A、B、C轴)命名不一致的问题。具体表现为：

• 当用户通过G代码设置参数时，需要使用配置文件中定义的轴名(如A、B等)
• 但当固件报告这些参数值时，却使用内部命名(如I、J等)

这种不一致性可能导致用户在使用额外轴功能时产生混淆。

技术背景

Marlin固件支持在标准XYZ三轴之外添加额外的运动轴。这些额外轴在配置文件中通过AXISn_NAME宏定义其名称(通常设为A、B、C等)。然而，在固件内部，这些额外轴有另一套命名规则：

• 第4轴：I
• 第5轴：J
• 第6轴：K

这种双重命名机制是设计上的选择，目的是保持G代码命令的易用性(使用用户熟悉的A、B、C命名)，同时在内部保持一致的轴标识。

问题影响

这种命名不一致主要影响以下场景：

1. 当用户使用M914命令设置归位灵敏度时：

   • 设置时使用：M914 A100
   • 但查询时显示：I homing sensitivity: 100

2. 同样的问题也存在于M906(电机电流设置)等涉及额外轴的G代码命令中

虽然这不影响功能实现，但会给用户带来困惑，特别是当用户需要频繁查看和调整这些参数时。

解决方案探讨

针对这个问题，社区提出了几种可能的解决方案：

1. 保持现状：认为这是有意设计，用户需要适应这种命名差异
2. 修改固件代码：使报告输出使用与设置时相同的轴名

其中一种代码修改方案是调整tmc_util.h文件中的printLabel()函数，使其在输出时使用配置文件中定义的轴名而非内部命名。这种修改可以让输出更加一致，但需要考虑对其他功能的影响。

最佳实践建议

对于Marlin用户，特别是使用额外轴功能的用户，建议：

1. 在配置文件中明确定义额外轴名称
2. 了解固件内部命名规则，避免混淆
3. 在文档中记录自己使用的轴名对应关系
4. 如需修改固件行为，可以尝试社区提出的补丁，但需充分测试

对于开发者，这个问题提出了一个值得思考的设计问题：如何在保持代码内部一致性的同时，提供用户友好的接口。这需要权衡技术实现的简洁性和用户体验的直观性。

总结

Marlin固件中额外轴命名的差异反映了开源固件在功能扩展过程中面临的典型挑战。虽然当前实现方式有其技术合理性，但也确实存在改进空间。用户在使用这些功能时，理解这种设计选择有助于更好地利用额外轴功能，而开发者社区也在持续探索更优的解决方案。