Marlin固件在ESP32平台使用LCD时触发ISR崩溃问题分析

问题背景

在Marlin固件项目中，当用户尝试将ZONESTAR_LCD显示屏适配到基于ESP32的MKS TinyBee主控板时，系统会出现异常崩溃现象。该问题表现为ESP32进入"bootloop"状态，并通过串口输出异常信息。

问题现象

系统崩溃时产生的异常信息显示，问题发生在中断服务程序(ISR)内部。通过分析异常堆栈，可以确定崩溃与ADC(模数转换器)操作相关，特别是在读取ADC_KEYPAD_PIN引脚时触发。

技术分析

根本原因

经过深入排查，发现问题源于以下技术细节：

1. ADC通道配置错误：ESP32平台具有两个ADC单元(ADC1和ADC2)，而用户尝试使用的引脚属于ADC2单元，但代码中仅配置了ADC1单元的特性参数。

2. 中断上下文限制：在ISR中执行复杂的ADC操作时，由于ESP32的实时性要求，某些操作(如获取锁)可能导致系统不稳定。

3. 电压衰减设置：当代码尝试为ADC2通道设置衰减参数时，由于未正确初始化，导致内存访问越界。

解决方案验证

通过以下修改可临时解决问题：

void MarlinHAL::adc_start(const pin_t pin) {
  if (pin == ADC_KEYPAD_PIN) return; // 跳过问题引脚
  // 原有ADC操作代码
}

这验证了问题确实与特定ADC引脚的操作相关。

完整解决方案

最终的完整修复方案需要考虑以下方面：

1. 正确识别ADC单元：在使用ADC前，应先判断引脚属于ADC1还是ADC2单元。

2. 初始化所有ADC通道：确保为所有可能使用的ADC通道正确配置特性参数。

3. 引脚重映射：在硬件设计允许的情况下，优先使用ADC1单元的引脚。

4. 中断安全：在ISR中避免执行可能导致阻塞或需要获取锁的操作。

适配建议

对于需要在ESP32平台上使用ZONESTAR_LCD的用户，建议：

1. 确认使用的ADC引脚属于ADC1单元
2. 检查所有ADC相关引脚的电压等级(3.3V)
3. 在配置中正确定义ADC_KEYPAD_PIN
4. 考虑添加ADC单元检测逻辑

总结

该案例展示了在嵌入式系统开发中硬件外设与中断处理之间的复杂交互关系。特别是在实时性要求高的场景下，需要特别注意外设初始化的完整性和中断上下文的操作限制。对于Marlin固件开发者而言，这提醒我们在支持新硬件平台时，要充分考虑其外设架构的特殊性。