Marlin固件中ZONESTAR_12864OLED显示屏兼容性问题解析

问题背景

在Marlin固件从2.0.7版本升级到2.1.x bugfix分支的过程中，用户报告了ZONESTAR Z6打印机(ZM3E2主板)上的12864OLED显示屏无法正常工作的问题。显示屏表现为完全黑屏，没有任何显示内容，而其他功能如打印操作均正常。

技术分析

该问题源于Marlin 2.1.x版本中对OLED显示屏驱动实现的变更。在2.0.7版本中，ZONESTAR_12864OLED显示屏针对STM32F1平台有专门的软件SPI实现，但在2.1.x版本中这一特殊处理被移除，导致兼容性问题。

具体表现为：

1. 2.0.7版本中，针对STM32F1平台使用了特殊的U8GLIB_SH1106_128X64_SW_SPI_HAL驱动类
2. 2.1.x版本中，这一特殊处理被统一为标准实现，导致与ZONESTAR硬件不兼容

解决方案

经过开发者社区的分析和测试，确定了以下修复方案：

1. 在HAL_LCD_class_defines.h中添加针对STM32F1平台的专用SH1106驱动类实现
2. 修改marlinui_DOGM.h中的显示驱动选择逻辑，针对STM32F1平台使用专用驱动
3. 确保u8g_dev_ssd1306_sh1106_128x64_SWSPI.cpp驱动文件正确实现

修复后的代码结构如下：

#ifdef U8GLIB_SH1106
extern u8g_dev_t u8g_dev_sh1106_128x64_HAL_sw_spi;
class U8GLIB_SH1106_128X64_SW_SPI_HAL : public U8GLIB {
public:
  U8GLIB_SH1106_128X64_SW_SPI_HAL() : U8GLIB() { }
  U8GLIB_SH1106_128X64_SW_SPI_HAL(pin_t sck, pin_t mosi, pin_t cs, pin_t reset = U8G_PIN_NONE) {init(sck, mosi, cs, reset); }
  void init(pin_t sck, pin_t mosi, pin_t cs, pin_t reset=U8G_PIN_NONE) {
    U8GLIB::init(&u8g_dev_sh1106_128x64_HAL_sw_spi, (uint8_t)sck, (uint8_t)mosi, (uint8_t)cs, U8G_PIN_NONE, (uint8_t)reset);
  }
};
#endif

兼容性考虑

值得注意的是，这一修复需要特别考虑对其他I2C SH1106显示屏的影响。开发者社区在实现修复时确保了：

1. 仅针对ZONESTAR特定硬件平台应用此修复
2. 不影响其他STM32控制器上的I2C SH1106显示屏
3. 保持与标准实现的兼容性

其他相关修复

在解决显示屏问题的过程中，还发现了ZM3E2主板其他需要适配的问题：

1. 需要添加特定热敏电阻配置文件(thermistor_56.h和thermistor_57.h)
2. 需要更新热敏电阻主配置文件(thermistors.h)
3. 需要为PlatformIO构建系统添加特定主板配置文件
4. 需要处理微步进控制逻辑的特殊实现

这些适配工作确保了ZONESTAR Z6打印机在Marlin 2.1.x版本上的完整功能支持。

总结

这一问题的解决展示了开源固件开发中硬件兼容性维护的重要性。通过分析特定硬件平台的实现差异，开发者能够提供针对性的解决方案，同时保持对标准硬件的支持。对于使用ZONESTAR打印机的用户，建议关注Marlin官方仓库的更新，以获取经过充分测试的稳定修复版本。