Marlin固件中STM32F407芯片的M43调试引脚报告问题分析

问题背景

在Marlin固件项目中，针对使用STM32F407芯片的MKS Monster8 V1/V2主板，用户在使用M43命令查看引脚状态时发现了两个主要问题：

1. 报告末尾出现了16行无效的重复内容
2. 模拟引脚编号从P31后出现错误跳变，本应是P32-P37的引脚被错误地显示为P18-P23

技术分析

引脚编号计算机制

Marlin固件中通过HAL/STM32/pinsDebug.h文件处理引脚编号映射。关键定义如下：

#define NUMBER_PINS_TOTAL ((NUM_DIGITAL_PINS) + TERN0(HAS_HIGH_ANALOG_PINS, NUM_ANALOG_INPUTS))

对于STM32F407芯片：

• NUM_DIGITAL_PINS定义为82
• NUM_ANALOG_INPUTS定义为16
• NUM_ANALOG_FIRST设置为83(82+1)
• 这导致HAS_HIGH_ANALOG_PINS被设置为1

最终NUMBER_PINS_TOTAL计算为82+16=98，这显然不正确，因为实际总引脚数应为82。

模拟引脚映射错误

在pinsDebug.h中，模拟引脚的编号转换逻辑存在缺陷：

if (Ard_num > NUM_DIGITAL_PINS) {
    calc_p -= NUM_ANALOG_FIRST;
    if (calc_p > 7) calc_p += 8;
}

这个逻辑对于A0-A9(前10个模拟引脚)工作正常，但对于更高编号的模拟引脚则会出现错误。

解决方案

修正总引脚数定义

建议在引脚定义文件中预定义NUMBER_PINS_TOTAL，并在pinsDebug.h中添加条件判断：

#ifndef NUMBER_PINS_TOTAL
#define NUMBER_PINS_TOTAL ((NUM_DIGITAL_PINS) + TERN0(HAS_HIGH_ANALOG_PINS, NUM_ANALOG_INPUTS))
#endif

改进模拟引脚映射算法

针对模拟引脚的编号转换，可以修改为：

if (Ard_num > NUM_DIGITAL_PINS) {
    calc_p -= NUM_ANALOG_FIRST;
    if (calc_p > 9) calc_p += 22;
    else if (calc_p > 7) calc_p += 8;
}

这个改进后的算法能够正确处理所有模拟引脚的编号映射。

问题影响

这个bug虽然不影响实际功能使用(M42/M43命令仍能正确操作引脚)，但会导致：

1. 调试信息不准确，可能误导开发者
2. 报告末尾的无效内容影响调试体验
3. 引脚编号显示错误可能导致配置混淆

总结

Marlin固件在STM32F407平台上的引脚调试功能存在计算逻辑缺陷，主要涉及总引脚数统计和模拟引脚编号映射。通过预定义总引脚数和改进映射算法，可以解决这些问题，为开发者提供更准确的调试信息。这类问题在嵌入式开发中较为常见，特别是在处理不同硬件平台的引脚映射时，需要特别注意边界条件和特殊情况的处理。