STM32F103驱动OLED显示：从底层驱动到波形绘制的嵌入式实践

1. 项目缘起：从点亮到绘制的跨越

最近在整理一个基于STM32F103的老项目，核心任务是在一块0.96寸的OLED屏幕上显示一些静态图像和动态波形。这听起来像是嵌入式开发的“Hello World”，但真正动手时，你会发现从“点亮屏幕”到“稳定、高效地绘制出想要的图形”，中间隔着不少需要琢磨的细节。网上资料很多，但要么是简单的点灯例程，要么是复杂的GUI框架，对于只想在资源紧张的MCU上实现特定显示功能的朋友来说，总感觉隔着一层。我这次的目标很明确：抛开复杂的库和框架，从最底层的驱动开始，一步步构建一个轻量、可控的图像与波形显示方案，把过程中的关键选择、避坑经验和优化技巧都记录下来。

OLED屏幕以其高对比度、自发光、响应速度快和超薄特性，在嵌入式领域应用广泛，尤其是SSD1306驱动的128x64分辨率型号，因其性价比高、接口简单（I2C/SPI）而成为STM32F103这类经典MCU的黄金搭档。显示图像和波形，本质上是对屏幕像素点的精确控制。图像是静态像素数据的映射，而波形则是动态数据在时间维度上的可视化。这个项目将围绕如何组织图像数据、如何高效刷新屏幕、以及如何将抽象的ADC采样值或计算数据转换为直观的波形曲线这三个核心问题展开。

2. 硬件选型与驱动层构建：SPI还是I2C？

拿到一块OLED屏，第一步是让它听我们的话。市面上最常见的0.96寸OLED模块大多使用SSD1306驱动芯片，它支持6800/8080并行接口、SPI串行接口和I2C串行接口。对于STM32F103C8T6这类引脚资源不算特别宽裕的芯片，I2C和SPI是更主流的选择。

2.1 接口协议抉择：速度与资源的权衡

这里就需要做一个关键的权衡。I2C通常只需要两根线（SCL， SDA），有时再加一根复位线（RST），节省GPIO资源，接线简单。但其速度受限于标准模式（100kHz）或快速模式（400kHz），在需要全屏刷新或快速更新波形时，可能会成为瓶颈。SPI通常需要四根线（SCK， MOSI， DC， CS），有时也需要RST，占用引脚稍多，但其通信速率可以轻松达到几兆甚至十几兆赫兹，刷屏速度有质的提升。

在我的项目中，因为需要显示动态波形，对刷新率有一定要求，所以我选择了SPI接口。STM32F103的硬件SPI（如SPI1）效率很高，可以大大减轻CPU负担。如果项目对引脚数量极其敏感，且显示内容以静态为主、更新不频繁，那么I2C是更经济的选择。这个选择直接影响后续驱动函数和刷新策略的设计。

2.2 底层驱动函数编写：与SSD1306对话

无论选择哪种接口，驱动层的目的都是向SSD1306发送命令和数据。SSD1306有一整套命令集，用于初始化、设置对比度、显示开关、寻址模式等。

首先，需要实现几个最基本的底层函数：

• OLED_WR_Byte(uint8_t dat, uint8_t cmd): 核心发送函数。cmd参数用于区分当前发送的是命令（cmd=0）还是数据（cmd=1）。在SPI模式下，这通常通过一个额外的DC（数据/命令）引脚来控制。
• OLED_Init(void): 初始化函数。这里需要严格按照SSD1306的数据手册，依次发送一系列初始化命令。常见的顺序包括：关闭显示、设置时钟分频和振荡频率、设置多路复用率、设置显示偏移、设置起始行、开启电荷泵、设置内存地址模式、设置对比度、设置预充电周期、设置VCOMH电平、开启显示等。一个常见的坑是忘记“开启电荷泵”命令，这会导致屏幕不亮或亮度异常。
• OLED_Set_Pos(uint8_t x, uint8_t y): 设置光标（即下一个写入数据的GRAM起始地址）。SSD1306的GRAM是128x64比特，通常被组织为8页（Page0-Page7），每页128列，每列8行（一个字节）。所以坐标(x, y)中，x是列地址（0-127），y是页地址（0-7）。这个函数内部就是组合发送设置列地址和页地址的命令。

注意：很多例程的初始化序列是“黑魔法”，直接从别处复制。我建议至少对照数据手册理解几个关键命令的含义，比如内存地址模式（Horizontal/Vertical/Page），这直接影响你后续更新显存的方式。我通常使用页地址模式，因为它编程逻辑更直观，适合逐行或局部更新。

2.3 显存映射与刷新策略

STM32F103内部RAM有限（C8T6只有20KB），而128x64的显存需要1024字节。我们通常在MCU内开辟一个同样大小的数组作为显存缓冲区OLED_GRAM[8][128]。这个数组的组织方式与屏幕物理GRAM的页模式对应：[页][列]。

所有绘图操作（画点、画线、显示字符）都只修改这个OLED_GRAM数组。当需要将更改呈现在屏幕上时，再调用刷新函数OLED_Refresh()，将整个数组或局部区域的数据通过SPI发送到SSD1306的真实GRAM中。

这种双缓冲策略避免了直接操作硬件GRAM时可能带来的屏幕闪烁，并且为局部刷新提供了可能。例如，当只需要更新屏幕的一部分区域（如一个不断变化的波形区域）时，可以只刷新对应的几页或几列数据，而不是全屏刷新，这能显著提升效率。对于动态波形显示，局部刷新是保证流畅度的关键。

3. 基础绘图引擎：从点到字

有了驱动层和显存缓冲区，我们就可以在“画布”上创作了。一切图形的基础是点。

3.1 最核心的函数：画点

OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t mode)函数是基石。x(0-127),y(0-63)，mode为1表示点亮（置1），为0表示熄灭（置0）。 其实现逻辑是：

1. 根据y坐标确定位于哪一页（page = y / 8）和在该页中的位偏移（bit = y % 8）。
2. 定位到显存缓冲区OLED_GRAM[page][x]。
3. 根据mode，使用位操作（与、或）来设置或清除对应的比特位。

这个函数的效率直接影响整体绘图性能。应避免使用乘除和浮点数，尽量用移位和与或运算。

3.2 字符与字符串显示：字库的奥秘

显示字符是基本需求。OLED本身不含字库，需要我们在代码中嵌入。常见的是8x16点阵的ASCII码字库和16x16点阵的中文字库。

• 字库数组：本质上是一个二维数组，比如const uint8_t ASCII_8x16[][16]，每个字符用16个字节描述其点阵。
• 显示函数：OLED_ShowChar(uint8_t x, uint8_t y, char chr)。函数根据字符chr，从字库数组中取出对应的16个字节，然后循环调用画点函数，或者更高效地，直接通过位运算将字节数据写入OLED_GRAM的对应位置。显示字符串函数则循环调用显示字符函数。

这里的一个实操心得是关于字库的存储。如果项目只需要英文和数字，一个8x16的ASCII字库大约占用95*16=1520字节，可以接受。但如果需要显示中文，GB2312字库动辄几百KB，STM32F103的Flash可能吃不消。通常有两种解决方案：

1. 取模软件生成特定汉字：使用PC端取模软件（如PCtoLCD2002），只将项目中用到的汉字生成点阵数组嵌入代码。这是最节省空间的方法。
2. 使用外部存储器：如果汉字量大，可以将完整字库存放到外部SPI Flash或SD卡中，需要时再读取。但这会增加硬件复杂度和读取时间。

3.3 绘制几何图形与图像

基于画点函数，我们可以构建更高级的图形函数：

• OLED_DrawLine: 使用布雷森汉姆直线算法，高效绘制直线。
• OLED_DrawRectangle: 绘制矩形框或填充矩形。
• OLED_DrawCircle: 使用中点圆算法绘制圆。

显示图像，则是将一张预先处理好的位图点阵数据（同样由取模软件生成）写入显存。图像取模时要注意方向（水平/垂直扫描，顺/逆序），必须与你的显示函数逻辑匹配，否则图片会是颠倒或错乱的。

注意：在资源受限的MCU上，应避免在绘图函数中进行复杂的浮点运算或动态内存分配。所有算法都应使用整数运算实现。例如，画圆算法中判断下一个点的位置，应使用整数增量计算，而不是浮点距离公式。

4. 波形显示的实现：数据到图形的转换

这是项目的核心挑战之一。波形显示的本质是将一系列随时间变化的采样值（如ADC值）实时地绘制在屏幕上，形成一条连续的曲线。

4.1 波形显示的基本模型

我们可以把屏幕的显示区域看作一个坐标系：X轴代表时间（或采样点序号），Y轴代表幅值。假设我们划定屏幕上一块宽度为W、高度为H的矩形区域用于显示波形。

实现流程如下：

1. 数据缓冲区：开辟一个长度为W的数组WaveBuffer[W]，用于存储最新的W个采样数据。这是一个环形缓冲区。
2. 坐标映射：当一个新的采样值new_val到来时，我们需要将其映射到屏幕Y坐标。假设ADC是12位（0-4095），我们希望将其显示在区域Y坐标y_top到y_bottom之间。
   • 首先进行幅值缩放：mapped_val = (new_val - val_min) * H / (val_max - val_min)。这里val_min和val_max是你希望显示的幅值范围。关键点：所有计算应使用整数，并注意运算顺序防止溢出。例如，先做乘法再做除法。
   • 然后进行坐标翻转：因为屏幕坐标原点通常在左上角，而波形通常希望时间向右，幅值向上。所以屏幕Y坐标y_screen = y_bottom - mapped_val。
3. 绘制策略：
   • 简单点绘法：将WaveBuffer中的每个点（i,WaveBuffer[i]）直接画在屏幕上。这种方法简单，但波形是离散的点，看起来不连贯。
   • 连线法：将WaveBuffer中相邻的点用直线连接起来。这能形成连续的曲线，观感更好。实现时，从i=0到i=W-2，调用OLED_DrawLine(i, WaveBuffer[i], i+1, WaveBuffer[i+1])。这是更常用的方法。

4.2 动态推进与局部刷新

波形是动态的。新数据不断到来，旧数据需要被抛弃，波形需要向右滚动。最笨的方法是每次新数据到来就清除整个波形区域，然后重新绘制全部W个点。这在W较大时（如128点）会导致严重的闪烁和CPU占用。

优化策略：局部滚动刷新

1. 我们只维护一个WaveBuffer。每次新数据new_val到来时：
   • 将整个WaveBuffer数组向左移动一位（WaveBuffer[i] = WaveBuffer[i+1]， 对于i=0到W-2）。
   • 将最新的new_val放入WaveBuffer[W-1]。
2. 在屏幕上，我们不需要重画整个波形。只需要：
   • 清除最旧的一列：将X坐标为0的那一列像素（在波形显示区域内）全部清除。
   • 将整个波形图像向左平移一列：这可以通过将显存缓冲区OLED_GRAM中波形区域的对应数据块整体向左移动一位来实现（使用memmove函数，注意操作的是显存缓冲区）。这比逐点画线快得多。
   • 绘制最新的一列：在X坐标为W-1的位置，根据WaveBuffer[W-1]计算出的Y坐标，画一个点（或者与WaveBuffer[W-2]的点连成线）。

这种方法将每次更新的绘图操作从O(W)降低到了O(1)（平移列）加上一次画点或画短线，效率提升巨大，可以实现非常流畅的波形滚动效果。

4.3 触发与稳定显示

对于周期性信号（如正弦波），直接连续滚动即可。但对于非周期性或想观察稳定波形的信号（如音频），需要触发功能。一个简单的电平触发实现思路是：持续监测采样数据，当发现数据值从低于触发电平变为高于触发电平（上升沿触发）时，将当前的WaveBuffer内容冻结并显示，直到下一次触发到来再更新。这需要在代码中增加一个触发状态机。

5. 基于STM32F103的工程整合与优化

现在，我们将驱动、图形库和波形逻辑整合到一个实际的STM32F103工程中。

5.1 外设配置：以SPI和DMA为例

使用CubeMX初始化非常方便：

1. 配置SPI1为全双工主模式，选择合适的波特率预分频（如PCLK2/8， 得到9MHz）。数据大小8位，MSB先行。
2. 配置相关GPIO：PA5(SCK)， PA7(MOSI) 为复用推挽输出；另外配置两个普通输出引脚：PA4(CS)和PA2(DC)。RST引脚（如PA1）也配置为输出。
3. （高级优化）启用SPI的DMA传输。为SPI_Tx配置一个DMA通道（如DMA1_Channel3）。这样，在刷新屏幕时（尤其是全屏刷新），可以将OLED_GRAM数组的数据通过DMA自动发送，CPU在此期间可以处理其他任务，极大提高效率。

5.2 主程序框架与任务调度

一个典型的程序框架如下：

int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_SPI1_Init(); MX_DMA_Init(); // 如果使用DMA MX_ADC1_Init(); // 用于波形采样 OLED_Init(); OLED_Clear(); // 显示静态界面，如标题、坐标轴、网格 OLED_ShowString(0, 0, "Waveform Demo", 16); OLED_DrawRectangle(10, 10, 118, 54); // 波形显示区域框 // 初始化波形缓冲区 Wave_Init(); while (1) { // 1. 采集数据（例如使用ADC DMA连续采样，或定时器触发采样） uint16_t adc_value = ADC_GetValue(); // 2. 处理数据，更新波形缓冲区 Wave_Update(adc_value); // 3. 刷新波形显示区域（使用局部滚动刷新优化） Wave_Refresh(); // 4. 其他任务，如按键扫描、更新状态栏等 Key_Scan(); // 更新状态栏时间等 // ... // 5. 控制刷新率，避免过快 HAL_Delay(20); // 约50Hz刷新 } }

5.3 常见问题排查与心得

• 屏幕不亮或花屏：

  • 检查硬件连接：电源（VCC， GND）、复位引脚时序（上电后需一个低脉冲）、DC引脚电平是否正确。
  • 检查初始化序列：确认发送了“开启电荷泵”（0x8D, 0x14）和“开启显示”（0xAF）命令。可以尝试一个已知可用的初始化序列。
  • 检查SPI时序：用逻辑分析仪抓取SPI波形，看时钟、数据线是否正常。确认CPOL和CPHA设置（SSD1306通常模式0）。

• 显示内容错位或镜像：

  • 检查OLED_Set_Pos函数和显存坐标映射逻辑。
  • SSD1306有命令可以设置扫描方向（COM Scan Direction）和段重映射（Segment Re-map），如果屏幕上下或左右颠倒，可以通过发送命令0xA0/0xA1和0xC0/0xC8来调整。

• 波形显示闪烁严重：

  • 确保使用了显存缓冲区OLED_GRAM，并且只在完整绘制一帧后才调用OLED_Refresh()。
  • 尝试使用局部刷新，避免全屏刷新。
  • 如果使用了DMA，确保在DMA传输完成中断中再进行下一次刷新操作，避免冲突。

• 波形刷新速度慢，CPU占用高：

  • 优化画点、画线函数，使用寄存器操作替代HAL库函数进行GPIO模拟（如果用的是软件SPI）。
  • 启用硬件SPI和DMA进行数据传输。
  • 采用上文提到的“局部滚动刷新”算法，避免重绘整个波形。

• 内存不足：

  • 优化字库，只嵌入需要的字符。
  • 检查显存缓冲区OLED_GRAM是否放在了合适的内存区域（默认全局变量在堆栈，没问题）。
  • 如果使用了大的数组作为波形缓冲区，注意栈空间大小，必要时将其定义为静态全局变量。

我个人在实现中的体会是，前期花时间搭建一个清晰、模块化的驱动和图形基础层非常重要。将OLED驱动、图形算法、波形逻辑分层，使得调试和功能扩展变得容易。例如，当我想从显示正弦波测试数据切换到显示真实的ADC麦克风数据时，只需要替换数据源，而无需改动底层的显示和绘图代码。另外，对于STM32F103，合理利用硬件外设（SPI DMA）和优化软件算法（整数运算、局部刷新）是保证项目流畅运行的关键，这能让这个经典的MCU在有限的资源下，依然胜任实时波形显示的任务。