Marlin固件中MKS SGen L V2.0与TS35 V2.0显示屏的SPI配置问题解析

问题背景

在Marlin固件项目中，用户报告了一个关于MKS SGen L V2.0主板与MKS TS35 V2.0触摸屏的兼容性问题。当用户尝试编译最新版本的Marlin固件时，遇到了"Invalid TFT SPI configuration"的错误提示，导致编译失败。

问题分析

这个错误源于SPI显示配置的不匹配。深入分析后发现，问题主要出在以下几个方面：

1. SPI设备定义错误：原始配置文件中将触摸按钮的SPI设备错误地定义为1，而实际上应该为2。

2. 引脚映射问题：主板与显示屏之间的引脚映射存在不匹配的情况，特别是EXP端口的连接方式。

3. 电压兼容性问题：MKS TS35 V2.0显示屏的EXP2端口设计为3.3V工作电压，如果错误连接到主板的EXP1端口(提供5V电压)，可能导致显示屏损坏。

解决方案

开发团队通过以下步骤解决了这个问题：

1. 修正SPI设备定义：将TOUCH_BUTTONS_HW_SPI_DEVICE的值从1改为2。

2. 重新设计引脚映射：更新了pins_MKS_SGEN_L_V2.h文件中的引脚定义，确保与TS35 V2.0显示屏兼容。

3. 连接方式验证：强调了正确的连接方式：

   • 显示屏的EXP1必须连接到主板的EXP1
   • 显示屏的EXP2必须连接到主板的EXP2

注意事项

用户在安装和使用时需要注意以下几点：

1. EEPROM错误处理：在升级大版本固件后出现EEPROM错误是正常现象，这通常意味着需要重新校准和设置打印机参数。

2. 显示屏连接安全：切勿将显示屏的EXP2端口连接到主板的EXP1端口，这会导致3.3V电路接收5V电压，可能损坏显示屏。

3. 编译验证：虽然修正后的代码可以成功编译，但在实际硬件上的功能验证仍然必要。

技术细节

对于开发者而言，这个问题的核心在于：

1. SPI总线配置必须与硬件设计严格匹配
2. 不同版本的显示屏可能有不同的电压要求和引脚定义
3. 主板与外围设备的接口标准必须一致

这个问题展示了在开源固件开发中硬件兼容性的重要性，也提醒开发者在支持新硬件时需要仔细验证每个接口定义。

总结

通过这次问题的解决，Marlin固件对MKS SGen L V2.0主板与TS35 V2.0显示屏的兼容性得到了提升。这个案例也展示了开源社区协作解决问题的典型流程：用户报告问题、开发者分析原因、提出解决方案、验证并合并修复。