STM32驱动SSD1306 OLED显示原理与HAL库实现

1. OLED显示原理与驱动实现基础

OLED（Organic Light-Emitting Diode）作为一种自发光显示技术，其核心物理特性决定了它在嵌入式系统中的独特价值：无需背光、高对比度、宽视角、响应速度快、可柔性化设计。在STM32应用中，我们通常使用SSD1306或SH1106等主流OLED控制器芯片，它们通过I²C或SPI接口与MCU通信，内部集成显示RAM（GRAM）、行/列驱动器、振荡器及电荷泵电路，构成一个完整的显示子系统。

SSD1306控制器的GRAM为128×64位映射结构，即128列×64行，每个bit对应一个像素点的亮/灭状态。其内存组织采用页（Page）模式：64行被划分为8个页（Page 0–Page 7），每页8行；每页内128列按字节（8列/字节）寻址，因此每页需16字节（128÷8）存储，整屏GRAM共需128×8=1024字节。这种分页结构直接决定了OLED驱动库的数据写入逻辑——必须按页为单位进行操作，而非线性地址递增。

从硬件连接角度看，I²C接口方案因其仅需SCL/SDA两根信号线、占用GPIO资源少、布线简洁，成为多数入门级开发板的首选。典型接线为：OLED模块VCC接3.3V，GND接地，SCL接MCU任意支持I²C的SCL引脚（如PB6），SDA接对应SDA引脚（如PB7）。值得注意的是，OLED模块内部通常已集成上拉电阻（4.7kΩ），若MCU端口内部上拉已使能，则可能形成双上拉，虽一般不影响通信，但在高速I²C（>100kHz）或长线场景下易导致上升沿过缓，此时应禁用MCU内部上拉，仅保留模块侧上拉。

SPI接口则提供更高带宽，适用于需要频繁刷新或显示动画的场景。其典型四线制连接包括：SCLK（时钟）、MOSI（数据输