STM32驱动OLED屏：I2C与SPI接口硬件连接与软件驱动全解析-平芜编程栈

1. 项目缘起：为什么是OLED与STM32？

在嵌入式开发的世界里，给项目加上一块“眼睛”——也就是显示屏，是让设备从“黑盒子”变成“智能终端”的关键一步。我最早接触显示屏时，用的还是1602液晶，那会儿要显示个汉字都得费老大劲去取模。后来，OLED（有机发光二极管）屏开始流行，它自发光、对比度高、可视角度广、功耗低，最关键的是，它不像传统LCD需要背光，这让它在电池供电的设备上大放异彩。

而STM32，作为意法半导体推出的基于ARM Cortex-M内核的32位微控制器，以其丰富的外设、强大的性能和极高的性价比，几乎成了嵌入式工程师的“瑞士军刀”。将OLED与STM32结合，就成了一个非常经典且实用的入门到进阶项目。无论是做一个桌面时钟、一个传感器数据显示终端，还是一个简单的游戏机，这个组合都能胜任。

市面上常见的OLED模块，接口上主要有两种：一种是四线（四针脚）的I2C接口，另一种是七线（七针脚）的SPI接口。很多新手朋友拿到模块后，面对这两种接口会有点懵：我该选哪个？它们的区别是什么？代码怎么写？硬件怎么连？这篇文章，我就结合自己多次在项目中实际使用这两种接口的经验，从硬件连接到软件驱动，从原理到避坑，为你彻底讲清楚STM32与这两种OLED屏的通信。

2. 硬件接口详解：四针脚I2C vs 七针脚SPI

在动手写代码之前，我们必须先搞清楚手里的OLED模块是哪种接口。这直接决定了你的硬件连接方式和后续的驱动选择。

2.1 四针脚I2C接口：简约派的代表

I2C（Inter-Integrated Circuit）总线是一种两线式、半双工、同步的串行通信总线。它最大的特点就是引脚少，只需要两根线（SDA和SCL）就能挂载多个设备，非常适合引脚资源紧张的应用。

一个典型的四针脚OLED模块，其引脚定义通常是：

GND：电源地。
VCC：电源正极，通常是3.3V或5V，具体看模块规格。
SCL：I2C时钟线。
SDA：I2C数据线。

有些模块可能还会有一个RES（复位）引脚，但很多I2C模块将其在内部上拉或通过软件复位，所以常见的商品模块就是这四个引脚。I2C通信是主从模式，STM32作为主机（Master），OLED屏作为从机（Slave）。每个I2C设备都有一个唯一的7位或10位地址，常见的OLED屏I2C地址是0x78（写地址）或0x7A，这取决于模块上SA0（地址选择）引脚的电平。

硬件连接（以STM32F103C8T6为例）：

OLED_VCC->3.3V
OLED_GND->GND
OLED_SCL->STM32的PB6（I2C1_SCL）或PB10（I2C2_SCL）
OLED_SDA->STM32的PB7（I2C1_SDA）或PB11（I2C2_SDA）

注意：I2C总线需要上拉电阻。好消息是，STM32的I2C引脚可以配置为开漏输出模式，并启用内部上拉电阻（通常约40kΩ），对于低速、短距离通信（比如驱动OLED），这通常就足够了。如果通信不稳定（表现为屏幕不显示或乱码），可以在SCL和SDA线上各加一个4.7kΩ到10kΩ的外部上拉电阻到3.3V，这是最稳妥的做法。

2.2 七针脚SPI接口：性能派的担当

SPI（Serial Peripheral Interface）是一种全双工、同步的串行通信总线。它比I2C速度快得多，但需要更多的引脚。对于需要快速刷新屏幕（比如动画、菜单快速切换）的场景，SPI是更好的选择。

一个典型的七针脚OLED模块（以常见的SSD1306驱动芯片为例），其引脚定义通常是：

GND：电源地。
VCC：电源正极（3.3V/5V）。
D0(SCLK)：SPI时钟线。
D1(MOSI)：SPI主机输出从机输入线（数据线）。
RES：复位引脚，低电平有效。这是硬件复位，非常重要。
DC：数据/命令选择引脚。这个引脚决定了你发送的是命令（配置屏幕）还是数据（要显示的像素点）。高电平为数据，低电平为命令。
CS：片选引脚，低电平有效。当总线上有多个SPI设备时，用来选择当前要通信的设备。即使只有一个设备，也需要控制。

硬件连接（以STM32F103C8T6的SPI1为例）：

OLED_VCC->3.3V
OLED_GND->GND
OLED_D0/SCLK->STM32的PA5（SPI1_SCK）
OLED_D1/MOSI->STM32的PA7（SPI1_MOSI）
OLED_RES->STM32的任意GPIO（如PB0），配置为推挽输出。
OLED_DC->STM32的任意GPIO（如PB1），配置为推挽输出。
OLED_CS->STM32的任意GPIO（如PA4），配置为推挽输出。也可以直接接地（永久选中），但用GPIO控制更规范。

接口选择的核心考量：

引脚数量：如果你的STM32引脚非常紧张，I2C是唯一选择。
刷新速度：如果需要快速更新画面（>30fps），SPI优势明显。
代码复杂度：I2C协议本身比SPI稍复杂（有地址、应答位），但成熟的驱动库已经封装好了。SPI的底层时序更简单直接。
通信距离：I2C抗干扰能力较弱，适合板内通信。SPI同样适合板内，但速率高时布线要求更高。

我个人经验是，对于大多数静态信息显示（如温度、时间），I2C足够用且省心。如果你要做菜单交互、动画效果，或者屏幕尺寸较大（如1.3寸以上），SPI带来的流畅体验是值得的。

3. 软件驱动核心：理解SSD1306的显存与通信协议

市面上绝大多数小尺寸（0.96寸、1.3寸）OLED模块，使用的驱动芯片都是SSD1306（或兼容芯片如SH1106）。因此，无论硬件接口是I2C还是SPI，我们最终都是在和SSD1306这颗芯片对话。理解它的工作原理，是写好驱动的关键。

3.1 SSD1306的显存结构

SSD1306支持最大128x64的分辨率。它的显存（GDDRAM）结构比较特殊，是以“页”（Page）为单位组织的。

整个屏幕在垂直方向被分成8个“页”（Page0到Page7），每个页有128列。
每个页的每一列，对应一个8位的字节数据。这个字节的每一个bit，就对应着屏幕上垂直方向的一个像素点（Bit0对应页的最上方像素，Bit7对应页的最下方像素）。

举个例子，如果你想在屏幕坐标(X=10, Y=20)的位置画一个点：

计算页地址：Y坐标20除以8（每页8行），商为2，余数为4。所以这个点在Page 2上。
计算列地址：X坐标就是10。
计算数据位：在Page 2的第10列对应的字节中，将第4位（从0开始，对应余数4）置1。

这种结构意味着，我们更新屏幕，本质上就是向SSD1306的显存特定地址写入数据。而“清屏”操作，就是向所有显存地址写入0x00。

3.2 I2C与SPI的通信数据格式

虽然物理层不同，但上层发给SSD1306的数据包格式是相似的，都遵循“控制字节+数据”的格式。

对于I2C：一次完整的I2C传输始于起始信号，然后是7位从机地址+1位读写位，接着是应答，之后才是数据。发送给OLED的数据流是：[I2C起始信号] + [从机地址(0x78) + 写位(0)] + [应答] + [控制字节] + [应答] + [数据字节1] + [应答] + [数据字节2] + ... + [I2C停止信号]。这里的控制字节非常关键：它的最高位（Co bit）决定了后续一串数据是命令还是数据。

如果Co=0，后续的字节都是命令（Command），用于配置屏幕（如对比度、扫描方式、开关显示等）。
如果Co=1，后续的字节都是数据（Data），会被写入GDDRAM（显存）。

对于SPI： SPI没有地址概念，通过CS片选引脚选中设备。DC引脚直接充当了控制字节的角色：

拉低DC引脚，接下来通过MOSI发送的字节被视为命令。
拉高DC引脚，接下来通过MOSI发送的字节被视为数据。

所以，在软件层面，我们需要为两种接口抽象出相同的底层操作函数：

Write_Command(uint8_t cmd): 发送一个命令。
Write_Data(uint8_t data): 发送一个数据。对于I2C，这两个函数内部需要组装包含控制字节的数据包。对于SPI，这两个函数内部则是先设置DC引脚电平，再通过SPI外设发送数据。

理解了这一点，我们就可以基于这两个最基础的函数，构建出初始化序列、清屏、画点、显示字符等高级功能了。

4. 实战驱动编写：从零构建OLED驱动库

下面，我将分别以STM32标准外设库（或HAL库）为例，展示如何为两种接口编写驱动。为了清晰，我会先讲SPI版本，因为它逻辑更直白，再讲I2C版本，并指出关键差异。

4.1 SPI接口驱动实现

首先，我们需要初始化相关的GPIO和SPI外设。

步骤1：硬件初始化

// oled_spi.h #define OLED_SPI_PORT SPI1 #define OLED_CS_PIN GPIO_Pin_4 #define OLED_CS_PORT GPIOA #define OLED_DC_PIN GPIO_Pin_1 #define OLED_DC_PORT GPIOB #define OLED_RES_PIN GPIO_Pin_0 #define OLED_RES_PORT GPIOB // oled_spi.c void OLED_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; SPI_InitTypeDef SPI_InitStructure; // 1. 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB | RCC_APB2Periph_SPI1, ENABLE); // 2. 初始化CS, DC, RES为推挽输出 GPIO_InitStructure.GPIO_Pin = OLED_CS_PIN; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(OLED_CS_PORT, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = OLED_DC_PIN; GPIO_Init(OLED_DC_PORT, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = OLED_RES_PIN; GPIO_Init(OLED_RES_PORT, &GPIO_InitStructure); // 默认置高CS（不选中），置低DC（准备发命令） GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN); GPIO_ResetBits(OLED_DC_PORT, OLED_DC_PIN); // 3. 初始化SPI引脚 (SCK和MOSI) GPIO_InitStructure.GPIO_Pin = GPIO_Pin_5 | GPIO_Pin_7; // SCK, MOSI GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 4. 配置SPI1 SPI_InitStructure.SPI_Direction = SPI_Direction_1Line_Tx; // 单线发送模式 SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_Low; // 时钟极性，根据模块手册调整 SPI_InitStructure.SPI_CPHA = SPI_CPHA_1Edge; // 时钟相位 SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; // 软件控制NSS（即我们的CS） SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_32; // 分频，决定速率 SPI_InitStructure.SPI_FirstBit = SPI_FirstBit_MSB; SPI_Init(OLED_SPI_PORT, &SPI_InitStructure); SPI_Cmd(OLED_SPI_PORT, ENABLE); }

步骤2：实现底层写命令/写数据函数

static void OLED_SPI_WriteByte(uint8_t data) { while (SPI_I2S_GetFlagStatus(OLED_SPI_PORT, SPI_I2S_FLAG_TXE) == RESET); // 等待发送缓冲区空 SPI_I2S_SendData(OLED_SPI_PORT, data); while (SPI_I2S_GetFlagStatus(OLED_SPI_PORT, SPI_I2S_FLAG_RXNE) == RESET); // 等待接收完成（全双工，读回数据） volatile uint8_t temp = SPI_I2S_ReceiveData(OLED_SPI_PORT); // 读走数据，清除标志 (void)temp; } void OLED_Write_Cmd(uint8_t cmd) { GPIO_ResetBits(OLED_DC_PORT, OLED_DC_PIN); // DC=0，命令模式 GPIO_ResetBits(OLED_CS_PORT, OLED_CS_PIN); // CS=0，选中设备 OLED_SPI_WriteByte(cmd); GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN); // CS=1，取消选中 } void OLED_Write_Data(uint8_t data) { GPIO_SetBits(OLED_DC_PORT, OLED_DC_PIN); // DC=1，数据模式 GPIO_ResetBits(OLED_CS_PORT, OLED_CS_PIN); OLED_SPI_WriteByte(data); GPIO_SetBits(OLED_CS_PORT, OLED_CS_PIN); }

步骤3：OLED初始化序列这是驱动屏幕最关键的一步，一系列命令用来配置SSD1306的工作模式、对比度、扫描方向等。这些命令序列通常可以在屏幕的数据手册或卖家提供的例程中找到。

void OLED_Init(void) { // 1. 硬件复位 GPIO_ResetBits(OLED_RES_PORT, OLED_RES_PIN); Delay_ms(100); // 复位低电平保持至少3us，这里给100ms确保稳定 GPIO_SetBits(OLED_RES_PORT, OLED_RES_PIN); Delay_ms(100); // 等待复位完成 // 2. 发送初始化命令序列 OLED_Write_Cmd(0xAE); // 关闭显示 OLED_Write_Cmd(0xD5); // 设置显示时钟分频比/振荡器频率 OLED_Write_Cmd(0x80); // 建议值 OLED_Write_Cmd(0xA8); // 设置多路复用率 OLED_Write_Cmd(0x3F); // 对于128x64的屏幕，值是63 (0x3F) OLED_Write_Cmd(0xD3); // 设置显示偏移 OLED_Write_Cmd(0x00); // 无偏移 OLED_Write_Cmd(0x40); // 设置显示起始行，从0开始 OLED_Write_Cmd(0x8D); // 电荷泵设置 OLED_Write_Cmd(0x14); // 启用内部电荷泵（必须，否则不亮） OLED_Write_Cmd(0x20); // 设置内存地址模式 OLED_Write_Cmd(0x00); // 水平地址模式（方便后续打点） OLED_Write_Cmd(0xA1); // 段重映射设置，0xA1左右反置，0xA0正常 OLED_Write_Cmd(0xC8); // 扫描方向设置，0xC8上下反置，0xC0正常 OLED_Write_Cmd(0xDA); // 设置COM引脚硬件配置 OLED_Write_Cmd(0x12); // 对于128x64，通常是0x12 OLED_Write_Cmd(0x81); // 设置对比度控制 OLED_Write_Cmd(0xCF); // 对比度值，0-255 OLED_Write_Cmd(0xD9); // 设置预充电周期 OLED_Write_Cmd(0xF1); // 建议值 OLED_Write_Cmd(0xDB); // 设置VCOMH电压倍率 OLED_Write_Cmd(0x40); // 建议值 OLED_Write_Cmd(0xA4); // 输出跟随RAM内容 OLED_Write_Cmd(0xA6); // 设置正常显示（非反显） OLED_Write_Cmd(0xAF); // 开启显示 // 3. 清屏 OLED_Clear(); }

步骤4：实现清屏与刷新函数

void OLED_Clear(void) { uint8_t i, j; for (i = 0; i < 8; i++) { // 遍历8个页 OLED_Write_Cmd(0xB0 + i); // 设置页地址 OLED_Write_Cmd(0x00); // 设置列地址低4位 OLED_Write_Cmd(0x10); // 设置列地址高4位 for (j = 0; j < 128; j++) { // 遍历128列 OLED_Write_Data(0x00); // 写入0，熄灭所有像素 } } } void OLED_Refresh(void) { // 在水平地址模式下，我们可以一次性更新整个屏幕区域 // 通常我们会维护一个128x8字节的显存缓冲区（buffer）， // 修改buffer后，调用此函数将整个buffer刷到屏幕。 // 这里以刷新整个buffer为例： uint8_t i, j; for (i = 0; i < 8; i++) { OLED_Write_Cmd(0xB0 + i); // 页地址 OLED_Write_Cmd(0x00); // 列地址低位 OLED_Write_Cmd(0x10); // 列地址高位 for (j = 0; j < 128; j++) { OLED_Write_Data(OLED_Buffer[i][j]); // 假设OLED_Buffer是全局缓冲区 } } }

4.2 I2C接口驱动实现

I2C驱动的核心在于Write_Command和Write_Data函数的实现，它们需要按照I2C协议打包数据。

步骤1：I2C硬件初始化

// oled_i2c.h #define OLED_I2C_PORT I2C1 #define OLED_I2C_ADDR 0x78 // 7位地址左移一位后，最低位0表示写 // oled_i2c.c void OLED_I2C_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; I2C_InitTypeDef I2C_InitStructure; // 1. 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); // 2. 初始化GPIO (PB6: SCL, PB7: SDA) GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_OD; // 复用开漏输出，非常重要！ GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); // 3. 配置I2C1 I2C_InitStructure.I2C_Mode = I2C_Mode_I2C; I2C_InitStructure.I2C_DutyCycle = I2C_DutyCycle_2; I2C_InitStructure.I2C_OwnAddress1 = 0x00; // STM32自身地址，作为主机可任意设置，不冲突即可 I2C_InitStructure.I2C_Ack = I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_ClockSpeed = 400000; // 400kHz，标准快速模式 I2C_Init(OLED_I2C_PORT, &I2C_InitStructure); I2C_Cmd(OLED_I2C_PORT, ENABLE); }

步骤2：实现I2C发送单字节函数这是最底层、最容易出错的环节。我们需要模拟I2C的起始、发送地址、等待应答、发送数据、停止等时序。

static void OLED_I2C_WriteByte(uint8_t data) { // 等待总线空闲 while (I2C_GetFlagStatus(OLED_I2C_PORT, I2C_FLAG_BUSY)); // 发送起始条件 I2C_GenerateSTART(OLED_I2C_PORT, ENABLE); while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_MODE_SELECT)); // 发送从机地址（写） I2C_Send7bitAddress(OLED_I2C_PORT, OLED_I2C_ADDR, I2C_Direction_Transmitter); while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); // 发送数据 I2C_SendData(OLED_I2C_PORT, data); while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); // 发送停止条件 I2C_GenerateSTOP(OLED_I2C_PORT, ENABLE); }

步骤3：实现I2C的写命令/写数据函数关键点在于控制字节的组装。

void OLED_Write_Cmd(uint8_t cmd) { // I2C模式下，发送一个命令需要先发送控制字节0x00，再发送命令字节 OLED_I2C_WriteByte(0x00); // Co=0, D/C#=0， 表示后续是命令流 OLED_I2C_WriteByte(cmd); } void OLED_Write_Data(uint8_t data) { // I2C模式下，发送一个数据需要先发送控制字节0x40，再发送数据字节 OLED_I2C_WriteByte(0x40); // Co=0, D/C#=1， 表示后续是数据流 OLED_I2C_WriteByte(data); }

重要提示：很多I2C OLED模块的驱动芯片支持“连续写”模式。即发送一次起始信号和地址后，可以连续发送多个“控制字节+数据”对，最后再发停止信号。这能显著提高刷新效率。上面的函数是单字节写，效率较低。优化时，可以将OLED_Write_Data函数改为连续发送整个缓冲区数据。

步骤4：OLED初始化序列I2C和SPI的初始化命令序列是完全一样的！因为命令是发给SSD1306芯片的，与物理接口无关。所以，OLED_Init()函数内部的命令列表可以直接复用SPI版本的那一套。只需要确保OLED_Write_Cmd和OLED_Write_Data函数正确实现即可。

步骤5：I2C模式下的清屏与刷新优化由于I2C单字节写效率低，清屏或刷新全屏时，连续发送数据至关重要。这里提供一个优化版本的清屏函数：

void OLED_Clear_Fast(void) { uint8_t i, j; // 发送起始信号和地址 while (I2C_GetFlagStatus(OLED_I2C_PORT, I2C_FLAG_BUSY)); I2C_GenerateSTART(OLED_I2C_PORT, ENABLE); while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(OLED_I2C_PORT, OLED_I2C_ADDR, I2C_Direction_Transmitter); while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); for (i = 0; i < 8; i++) { // 设置页地址和列地址（发送命令） I2C_SendData(OLED_I2C_PORT, 0x00); // 控制字节：命令流 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(OLED_I2C_PORT, 0xB0 + i); // 页地址命令 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(OLED_I2C_PORT, 0x00); // 控制字节：命令流 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(OLED_I2C_PORT, 0x00); // 列地址低位 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(OLED_I2C_PORT, 0x00); // 控制字节：命令流 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_SendData(OLED_I2C_PORT, 0x10); // 列地址高位 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); // 开始连续发送数据（128个0x00） I2C_SendData(OLED_I2C_PORT, 0x40); // 控制字节：数据流 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); for (j = 0; j < 128; j++) { I2C_SendData(OLED_I2C_PORT, 0x00); // 注意：这里在发送最后一个字节前不能等待BYTE_TRANSMITTED，否则会卡住。 // 更稳健的做法是检查TXE标志。这里为简化，仅作示意。 if (j < 127) { while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); } } // 等待最后一个字节发送完成 while (!I2C_CheckEvent(OLED_I2C_PORT, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); } // 发送停止条件 I2C_GenerateSTOP(OLED_I2C_PORT, ENABLE); }

这个函数将设置地址和发送数据的过程在一次I2C通信中完成，大大减少了起始/停止信号的次数，效率提升明显。实际项目中，建议维护一个显存缓冲区，修改缓冲区后，调用一个类似的OLED_Refresh_Fast()函数一次性刷到屏幕。

5. 高级应用与避坑指南

驱动调通只是第一步，要让OLED在你的项目中真正好用，还需要一些技巧和注意事项。

5.1 建立显存缓冲区与画点函数

直接操作显存地址来画点非常麻烦。标准的做法是在STM32的RAM中开辟一个二维数组作为显存缓冲区（OLED_Buffer[8][128]），所有绘图操作（画点、画线、显示字符）都先修改这个缓冲区，最后调用OLED_Refresh()函数将整个缓冲区刷到屏幕。这就是“双缓冲”思想，能避免屏幕闪烁。

画点函数实现：

void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t mode) { // mode: 1点亮，0熄灭 if (x >= 128 || y >= 64) return; // 边界检查 uint8_t page = y / 8; uint8_t bit_pos = y % 8; if (mode) { OLED_Buffer[page][x] |= (1 << bit_pos); } else { OLED_Buffer[page][x] &= ~(1 << bit_pos); } // 可以选择立即刷新该点，或等待批量刷新 // OLED_Write_Cmd(0xB0 + page); // OLED_Write_Cmd(((x & 0xF0) >> 4) | 0x10); // OLED_Write_Cmd(x & 0x0F); // OLED_Write_Data(OLED_Buffer[page][x]); }

5.2 显示字符与汉字（取模）

显示字符的本质就是向显存缓冲区写入预先设计好的点阵数据。对于ASCII字符，常用8x16或6x8的点阵。对于汉字，常用16x16的点阵。你需要一个取模软件（如PCtoLCD2002）来生成这些点阵数组。

显示一个8x16字符示例：

// 字模数据（例如字符'A'的8x16点阵） const uint8_t Font8x16[][16] = {...}; void OLED_ShowChar(uint8_t x, uint8_t y, char chr) { uint8_t i, page; uint8_t *pFont = (uint8_t*)&Font8x16[(chr - ' ') * 16]; // 假设字库从空格开始 for (i = 0; i < 16; i++) { // 16行 page = (y + i) / 8; if (page < 8) { OLED_Buffer[page][x] = pFont[i]; } // 如果字符高度跨页，需要处理下一页的数据 if ((y + i) % 8 > 0 && page + 1 < 8) { OLED_Buffer[page + 1][x] = pFont[i] >> (8 - ((y + i) % 8)); // 处理跨页数据 } } // 刷新受影响的两页区域 // ... 刷新代码 }

避坑点1：跨页处理。这是显示字符最容易出错的地方。当字符的起始Y坐标不是8的整数倍时，一个字符的点阵数据可能会分布在两个相邻的“页”里。上面的示例简化了处理，实际代码需要仔细处理字节的拆分与合并。

5.3 常见问题排查（屏幕不亮、乱码、花屏）

屏幕完全不亮（无任何显示）：
- 检查电源：首先用万用表测量VCC和GND之间电压是否为3.3V。有些模块标称5V但实际3.3V也能工作，反之则可能烧毁。
- 检查复位：对于SPI屏，确保RES引脚有正确的上电复位时序（先低后高）。可以尝试在初始化前手动拉低RES至少1ms，再拉高。
- 检查电荷泵：确认初始化序列中发送了0x8D, 0x14命令来开启内部电荷泵。没有这个，OLED没有驱动电压，肯定不会亮。
- 检查I2C地址：用逻辑分析仪或示波器抓取I2C波形，看发送的地址是否正确。尝试地址0x78和0x7A。
屏幕全亮或显示乱码/花屏：
- 检查通信时序：SPI的时钟极性和相位（CPOL/CPHA）设置错误是常见原因。SSD1306通常模式是CPOL=0, CPHA=0。如果不对，尝试其他三种组合。
- 检查初始化序列：命令顺序或某个命令值错误可能导致屏幕工作模式异常。务必对照数据手册或可靠的例程。
- 检查显存操作：确保画点、显示字符函数正确操作了缓冲区，并且刷新函数正确设置了页地址和列地址。
- 电源噪声：OLED对电源比较敏感。在VCC和GND之间并联一个10uF的电解电容和一个0.1uF的瓷片电容，可以有效滤除噪声。
- 上拉电阻：I2C通信不稳定，尝试在SCL和SDA上加4.7kΩ上拉电阻到3.3V。
显示内容错位或镜像：
- 这是初始化命令中段重映射（0xA0/A1）和扫描方向（0xC0/C8）设置的结果。根据你的屏幕安装方向，调整这两个命令即可。

5.4 性能优化与进阶思路

局部刷新：如果只修改了屏幕一小部分区域，不要刷新整个屏幕。只刷新受影响的那一页或几页，可以极大提高效率，降低功耗。
使用DMA：对于SPI接口，可以使用DMA来搬运显存缓冲区数据到SPI数据寄存器，实现“无CPU干预”的刷新，解放CPU去做其他任务。
驱动芯片差异：除了SSD1306，还有SH1106。SH1106的显存是132x64，但屏幕仍是128x64。它的初始化序列和部分命令（如设置列地址）与SSD1306略有不同。如果你的屏幕是SH1106，需要调整对应的命令。
使用现有库：如果你不想从零造轮子，可以移植成熟的第三方库，如u8g2。u8g2库功能极其强大，支持几乎所有单色屏和多种接口，提供了丰富的绘图和字体API。移植u8g2的关键是实现其硬件抽象层（u8x8）的几个回调函数（如字节发送、引脚控制、延时函数）。

我个人在多个项目中，对于快速原型开发，倾向于使用u8g2库，省时省力。但对于资源极其紧张（Flash/RAM很小）或者需要极致性能控制的场合，自己编写精简的驱动仍然是更好的选择。理解本文所述的底层原理，无论是自己写驱动还是移植库，都能让你游刃有余。