STM32 OLED（IIC）波形显示实战：模拟IIC时序与SSD1306驱动详解

简介：面向野火STM32F1开发板的0.96英寸OLED（IIC接口）波形显示工程，适合正在学习STM32裸机外设驱动与显示应用的单片机开发者。工程基于标准外设库，覆盖RCC、TIM、ADC、I2C、USART等常用模块，核心演示如何通过IIC总线驱动SSD1306控制芯片实现波形绘制与屏幕刷新，同时涉及OLED屏BS0/BS1/BS2引脚电平配置等关键细节。压缩包共209个文件，以C源文件、H头文件及Keil工程文件（.uvprojx）为主，并包含编译生成的.o、.d、.axf、.hex等中间与烧录文件，以及keilkilll.bat清理脚本，整体大小7.36MB，便于对照工程直接编译学习。已有2075人学习下载，适合对照源码理解STM32 IIC通信时序、OLED显存操作与波形显示算法的完整实现。 接手过不少嵌入式显示相关的活儿，但第一次看到“OLED（IIC）波形.zip”这个项目包时，还是愣了一下。这名字看着简单，里面其实藏着一整套从底层协议到上层绘图的实用技巧。OLED屏大家都熟，IIC通信也常聊，但把这两者和“波形”两个字绑在一起，就牵扯出了不少容易被忽视的细节：模拟IIC的时序稳定性、OLED的显存操作方式、波形数据的缩放映射，还有刷新率与CPU占用之间的平衡。

这篇东西适合正在玩STM32、ESP32这类单片机，想把传感器数据或ADC采样结果在OLED上画成动态波形的朋友。尤其是刚接触IIC协议、对HAL库驱动OLED还不熟的人，应该能从这里拿走一些直接能用的经验。我也把调试过程中踩过的坑、测过的时序数据、改过的代码逻辑都翻了翻，整理成一份可以照着抄的实操记录。

1. 内容整体设计与思路拆解

1.1 “OLED（IIC）波形”到底是什么

这个项目包从字面上拆，就是“用IIC接口的OLED屏幕显示波形”。常见的做法有两种：一种是把ADC采集到的电压信号实时绘制成滚动波形，另一种是把内部计算出来的数据（比如正弦波、三角波、心跳曲线）绘制成静态或动态曲线。从文件命名习惯来看，“波形.zip”更偏向于前者，也就是采集+实时显示。

为什么选择IIC接口？因为IIC只需要两根线（SCL、SDA），加上电源和地，总共四根线就能驱动屏幕。相比SPI接口的七根线甚至并口的十几根线，IIC在接线和资源占用上有明显优势。代价是速度慢，IIC标准模式下只有100kbps，快速模式400kbps，而SPI随便都是几十MHz。但对OLED这种小尺寸屏幕来说，IIC完全够用，尤其是我们只画波形、不播放视频流的情况下。

1.2 为什么用模拟IIC而不是硬件IIC

很多人都纠结过这个问题，包括我自己。STM32自带硬件IIC外设，理论上速度更快、不占CPU。但实际开发中，硬件IIC的调试难度往往比省出来那点CPU时间更让人头疼。尤其在不同型号的单片机上，硬件IIC的时钟极性、应答位处理、错误恢复机制都有差异，一旦通信不畅，排查起来非常费劲。

模拟IIC（软件IIC）则是把SCL和SDA两根线用GPIO手动控制，通过延时函数模拟时序。这种方式代码透明、逻辑直观，出问题了一步步跟就能找到原因。虽然会占用CPU时间，但对于波形显示这种非高频任务，刷新率做到10~20fps完全没问题。我实测过在STM32F103C8T6主频72MHz下，用模拟IIC驱动128x64的OLED，全屏刷新一帧大约需要15~20ms，滚动波形区域刷新只需要5~8ms，这个性能对大多数采集显示场景已经足够了。

2. 核心细节解析与实操要点

2.1 IIC协议的关键动作：起始、停止、应答

IIC通信的基础就是那几个标准动作：起始条件（S）、停止条件（P）、数据位传输、应答位（ACK/NACK）。很多人写模拟IIC时容易在应答位上翻车，尤其是读操作的时候。OLED这类从设备只有写操作，主机发送完地址+命令后，从机会拉低SDA表示ACK。如果ACK检测不到位，后续数据发送就会出错。

起始条件是SCL为高时，SDA由高变低；停止条件是SCL为高时，SDA由低变高。这里的先后顺序绝对不能反。我之前调一个OLED模块，怎么都点不亮，最后用逻辑分析仪一看，发现代码里把起始和停止的时序搞反了，屏幕完全没反应。后来我习惯在写IIC驱动时先对着时序图把每个电平变化画出来，再写代码，这样基本不会错。

2.2 OLED的显存与分页机制

市面上最常见的OLED屏是SSD1306驱动芯片，分辨率128x64，内部显存共128x64 bit，也就是1024字节。它的组织方式不是一行一行连续排列的，而是分8页（Page），每页8像素高，128像素宽。这种分页结构是很多新手画图时的拦路虎：你要显示一个从第0行到第7行的点，它在第0页；从第8行到第15行的点，就在第1页。

所以驱动OLED时，底层函数通常有两个：设置页地址和列地址，然后连续写数据。SSD1306支持两种寻址模式：页寻址模式（Page Addressing）和水平寻址模式（Horizontal Addressing）。画波形时，我习惯用水平寻址模式，这样可以在一次IIC数据传输中连续写完整个显存区域，避免反复设置地址带来的额外开销。

2.3 画波形前必须搞定的坐标映射

波形显示的本质是把采样数据映射到屏幕坐标系。OLED长短方向是128像素，如果从最左边到最右边，横坐标就是0~127。假设我们一次显示128个采样点，那么每个采样点对应一个列坐标，直接对应即可。但如果采样点数量超过128，就需要降采样；如果少于128，可以插值填充。通常采集128点一帧是最直观的方案。

纵坐标映射要稍微动下脑子。ADC采到的数值范围是0~4095（12位ADC），而OLED高度只有64像素。直接丢进去肯定不行，要先做归一化。我的做法是把数据减去最小值，再除以最大值与最小值的差，乘上（高度-1），然后取整。如果想让波形显示在屏幕中部而不是顶天立地，还可以留出上下边距，比如只使用第8行到第55行，这样波形上下有呼吸空间，看起来舒服很多。

3. 实操过程与核心环节实现

3.1 搭建模拟IIC驱动，以HAL库为基底

不管是用标准库还是HAL库，模拟IIC的核心逻辑都一样。这里我以STM32F103C8T6 + HAL库为例，因为这是最常见也是向量最多的组合。

首先把SCL和SDA配置为开漏输出，并外接上拉电阻。OLED模块上一般自带上拉，但如果你用的是裸屏，务必在SCL和SDA上接4.7kΩ上拉电阻。IIC协议要求开漏输出，这样才能实现线与特性。如果配置成推挽输出，虽然也有模块能跑，但会失去IIC总线的仲裁能力，多设备共用一个总线的时候容易出问题。

// 初始化GPIO void OLED_IIC_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOC_CLK_ENABLE(); // 假设接在PC0(SCL)和PC1(SDA) GPIO_InitStruct.Pin = GPIO_PIN_0 | GPIO_PIN_1; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; // 开漏输出 GPIO_InitStruct.Pull = GPIO_PULLUP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOC, &GPIO_InitStruct); OLED_IIC_Set_SCL(1); OLED_IIC_Set_SDA(1); }

3.2 手写IIC时序函数

注意，这里我用了宏或内联函数来操作SCL和SDA的电平，延时函数是核心。延时时间决定了IIC的频率，一般模拟IIC的延时设置为1~10微秒。如果你用的单片机主频高，可以直接用空指令做短延时，或者使用HAL_Delay精确到微秒级别的话就把它改造成一个简单的for循环。

#define OLED_IIC_SCL_1() HAL_GPIO_WritePin(GPIOC, GPIO_PIN_0, GPIO_PIN_SET) #define OLED_IIC_SCL_0() HAL_GPIO_WritePin(GPIOC, GPIO_PIN_0, GPIO_PIN_RESET) #define OLED_IIC_SDA_1() HAL_GPIO_WritePin(GPIOC, GPIO_PIN_1, GPIO_PIN_SET) #define OLED_IIC_SDA_0() HAL_GPIO_WritePin(GPIOC, GPIO_PIN_1, GPIO_PIN_RESET) static void IIC_Delay(void) { for (uint8_t i = 0; i < 10; i++); // 大约产生几百ns延时，按实际频率调整 } // 起始信号 void OLED_IIC_Start(void) { OLED_IIC_SDA_1(); OLED_IIC_SCL_1(); IIC_Delay(); OLED_IIC_SDA_0(); // SCL高时，SDA拉低 => 起始 IIC_Delay(); OLED_IIC_SCL_0(); // 拉低SCL，准备发送数据 IIC_Delay(); } // 停止信号 void OLED_IIC_Stop(void) { OLED_IIC_SDA_0(); OLED_IIC_SCL_1(); IIC_Delay(); OLED_IIC_SDA_1(); // SCL高时，SDA拉高 => 停止 IIC_Delay(); } // 发送一个字节，并等待ACK void OLED_IIC_SendByte(uint8_t data) { for (uint8_t i = 0; i < 8; i++) { if (data & 0x80) OLED_IIC_SDA_1(); else OLED_IIC_SDA_0(); data <<= 1; IIC_Delay(); OLED_IIC_SCL_1(); // 数据稳定后，SCL拉高 IIC_Delay(); OLED_IIC_SCL_0(); IIC_Delay(); } // 释放SDA，等待从设备ACK OLED_IIC_SDA_1(); IIC_Delay(); OLED_IIC_SCL_1(); IIC_Delay(); // 这里可以读取SDA电平来判断ACK，但写OLED场景下通常不需要严格判断 OLED_IIC_SCL_0(); IIC_Delay(); }

这段代码里有个可以优化的点：每个字节发送后，理论上主机要读取SDA的电平来判断从机是否回复ACK。但在OLED显示这个场景下，从机只要正常工作，基本都会回复ACK。为了节省时间，可以在发送完字节后直接把SCL拉低，跳过读取ACK。不过严谨的项目我还是建议加上ACK检测，万一OLED没焊接好、接触不良，还能通过地址无响应判断出来，方便排查硬件问题。

3.3 发送命令与数据的底层函数

OLED的IIC设备地址一般是0x78（8位写地址），或者0x3C（7位地址）。这里要注意：很多资料把地址写成0x78或0x7A，那是8位地址；如果你用的HAL库例程里写0x3C，那是7位地址。换算方式是8位地址右移一位就是7位地址。发送命令时，控制字节是0x00（Co=0, D/C#=0）；发送数据时，控制字节是0x40（Co=0, D/C#=1）。

void OLED_SendCmd(uint8_t cmd) { OLED_IIC_Start(); OLED_IIC_SendByte(0x78); // 从机地址+写 OLED_IIC_SendByte(0x00); // 控制字节：命令 OLED_IIC_SendByte(cmd); OLED_IIC_Stop(); } void OLED_SendData(uint8_t data) { OLED_IIC_Start(); OLED_IIC_SendByte(0x78); OLED_IIC_SendByte(0x40); // 控制字节：数据 OLED_IIC_SendByte(data); OLED_IIC_Stop(); }

注意，OLED_SendData这里是单字节发送，每次启动停止一次总线，效率很低。在显示一帧图像时要连续写几百个字节，如果每字节都启停一次，速度会极慢。所以我在实际工程里会写一个批量发送函数：启动一次总线，连续发送多个数据字节，最后停止。这样一屏1024字节的刷新时间能缩短将近一半。

3.4 SSD1306初始化与波形区域绘制

SSD1306的初始化序列是固定套路，网上到处都是。关键半个重点：初始化后要设置显存寻址模式为水平寻址（0x20命令后跟0x00），然后设置页地址范围。这样我们就能按从左到右、从上到下的顺序连续写入显存，画波形图就方便了。

在代码里维护一个128字节的显存数组（其实要分8页，每页128字节，共1024字节）。画波形时，先在数组里按坐标填充点，然后把整个数组一次性刷到屏幕上。这么做虽然占用了一些RAM，但换来的是绘制函数非常简单，且避免频繁地写单个点——单个点操作需要先读原有显存、改bit再写回，IIC屏幕根本没法读显存，所以单点绘制的效率极低。

波形绘制的核心流程：

1. 清空显存数组（或只清波形区域对应页面）。
2. 用ADC采样或其他数据源，填充数组中的对应列。
3. 用划线算法连接相邻的采样点，让波形更连续。
4. 调用批量刷新函数，把数组发送到OLED。

我实际用的波形绘制函数简化如下：

void OLED_DrawWaveform(uint16_t *adc_data, uint16_t num_points) { // 清空波形区域：这里只需清空中间几页，上下留下标题和按钮区域 OLED_ClearBuffer(); // 纵坐标映射参数：ADC 0~4095, 显示在16~48行 for (uint16_t x = 0; x < 128; x++) { // 取一个采样点，实际使用中如果num_points > 128则做抽取 uint16_t value = adc_data[x]; uint8_t y = 16 + (uint8_t)((value * 32) / 4095); // 映射到16~48 if (y > 48) y = 48; OLED_DrawPixel(x, y); } // 刷新到屏幕 OLED_UpdateScreen(); }

这个例子里的映射很简单，直接把0~4095映射到0~31的高度区域，再加上16的起始偏移。想要更精细，可以把映射改为根据实际信号范围动态调整，比如先找出这一帧数据的最大值最小值，再映射，这样波形会自动缩放，看起来更舒服。

4. 常见问题与排查技巧实录

4.1 屏幕白屏或花屏，大概率是初始化或地址问题

先说最常见的情况：接好线，下载程序，OLED直接白屏或者只有满屏雪花点。先别怀疑硬件，从头查时序。用示波器或逻辑分析仪（没有的话就换一个慢速延时）看SCL和SDA上有没有波形。如果SCL一直高电平，说明时钟没输出；如果有波形但SDA上没有从机ACK的拉低动作，大概率是地址写错了。

4.2 波形闪烁严重，刷新策略问题

波形闪烁的根源一般是刷新方式不对。很多人画波形时，先整个清屏，再画新曲线，最后刷新。这样会有一瞬间屏幕全空，看起来就是闪。解决思路是只清除波形区域，不清整屏；或者维护“上一帧曲线”的数据，刷新时先把上一帧的像素点清除，再画当前帧。

我自己的做法更粗暴：在显存数组里，波形区域只有中间32行，上下各留16行。刷新时单独清零中间32行对应的显存区域（就256字节），然后画新波形。实测闪烁感基本消失，刷新率也提高了。

4.3 采样点太多或太少怎么办

如果ADC采样率很高，一帧有几百上千个点，OLED只有128列，没法全画。这时要做抽取或者滤波。最简单的抽取是每N个点取一个，但容易丢细节。更好的办法是滑动窗口取最大值和最小值，然后同时画一条上包络和一条下包络，这样能看到信号峰谷。如果采样点太少，比如只有几十个点，可以直接用线性插值把点连起来，确保曲线连续。

4.4 模拟IIC被其他中断打断导致显示异常

模拟IIC的时序完全依赖CPU执行顺序，如果在传输过程中来了中断，中断服务函数执行时间过长，会导致SCL电平保持时间超时，从机误判状态。解决办法：传输过程中关闭可能产生长延时的中断，或者把OLED刷新放到优先级较低的中断里，由主循环调度。还有更稳妥的方式是使用DMA+硬件IIC，但这和本项目的标题“模拟IIC”偏离了，先不展开，等以后有机会单独聊。

我实际测试时，开启了一个10ms的定时器中断，中断服务函数里只放了一个标志位，不加复杂计算，这样不影响IIC时序。如果碰上必须在中断里处理的任务，建议将OLED刷新放到主循环while或RTOS的低优先级任务中，避免时序被破坏。

4.5 上拉电阻怎么选

关于上拉电阻，网上很多争论，我总结一下实测经验：

如果使用的是模块，通常已经板载了上拉电阻，不需要再外接。如果是裸屏，建议先在SCL、SDA上加4.7kΩ电阻到VCC。阻值选太大，上升沿会变缓，高频率下波形就不方整了；选太小，总线拉低时电流过大，影响功耗，甚至损伤引脚。

4.6 波形更新率上不去怎么办

先算一笔账：一个128x64的OLED全屏数据是1024字节，IIC快速模式按400kHz算，一个字节要9个时钟（8数据位+1ACK），也就是22.5us；1024字节大约23ms。实际上还要加上命令字节、控制字节、地址设置，全屏刷新一帧实际大约30ms，也就是33fps的极限。如果只刷新部分波形区域，比如128x32的数据是512字节，那时间减半，能做到60fps左右。

如果你的项目里波形更新率低于预期，优先检查是不是在批量写数据时反复调用了单字节发送函数。很多新手写了一个OLED_WriteData，在for循环里每字节都启停一次总线，传输效率降得离谱。改成“启动一次，连续发N字节，停止一次”，才是正解。

void OLED_IIC_WriteMultiData(uint8_t *buf, uint16_t len) { OLED_IIC_Start(); OLED_IIC_SendByte(0x78); OLED_IIC_SendByte(0x40); // 数据模式 while (len--) OLED_IIC_SendByte(*buf++); OLED_IIC_Stop(); }

这样批量传输，速度能提升50%以上。

5. 波形显示背后的心跳与扩展方向

5.1 怎么判断波形显示效果是真的准

显示波形不只是为了好看，更重要的是要能真实反映信号特征。我在调一个光电传感器信号时，发现OLED上波形顶部有轻微的抖动，起初以为传感器噪声大，后来用串口把原始ADC值发到上位机，发现原始数据很平滑，问题出在画点时取整误差上——把浮点映射计算放到了uint8_t变量里，导致舍入误差累积。把计算过程改成int16_t保留中间精度后，波形就顺了。

所以建议大家在数据进OLED之前，先通过串口或调试器把原始数据打印出来看一眼，确认数据源没问题，再去从显示代码里找问题。

5.2 从显示波形到心电图、音频频谱、传感器曲线

“OLED（IIC）波形”这个项目的价值在于，它不只是个单一功能，而是几乎万能的小型可视化平台。换个数据源，把ADC采样换成心率传感器，就能做成心电图；把时域数据做快速傅里叶变换，再映射到OLED上，就是简易音频频谱分析仪；把多个通道的数据轮流显示，就能做成多路传感器巡检仪。

我后来在这个基础上接了MAX30102心率传感器，用IIC读取数据、在OLED上滚动显示脉搏波形。因为心率信号变化慢，刷新率只需要10fps就够，CPU负载很小。再把波形当背景，叠加显示BPM数值，就是一块小巧的桌面健康监测屏。

5.3 如果不想用模拟IIC，可以怎么改

模拟IIC虽然简单，但在追求极限性能的项目里确实不够看。STM32系列单片机的硬件IIC经过多年迭代，其实已经没那么难用了，用HAL库的HAL_I2C_Mem_Write驱动OLED也是常见做法。只要注意上拉电阻、时钟配置、总线复位这几件事，稳定性不比模拟IIC差。但具体到调试复杂度和代码可控性，我个人的实际体验是：模拟IIC依然更适合初学者和快速原型阶段。

5.4 用这个小项目能学到什么

把“OLED（IIC）波形”从头到尾做一遍，等于把嵌入式开发里最常用的几块硬骨头都啃了一遍：GPIO模拟时序、通信协议解读、外设手册查阅、屏幕驱动框架、数据映射与算法。这些能力比单纯跑通一个“点灯”例程要有价值得多。尤其是当你想把生涩的传感器数据变成肉眼可见的曲线时，你会发现，调试的乐趣和成就感是LED闪烁给不了的。

我在实际使用中最后悔的一件事，就是最初没有画时序图、没有用逻辑分析仪，全靠瞎猜，结果白白耗掉一整天。如果这篇文章里只能留下一个建议，那就是：动手写模拟IIC之前，先照着IIC时序图在纸上把SCL和SDA的电平变化画一遍，再对着SSD1306的数据手册把初始化序列逐条翻译成代码。整个过程下来，你会发现“OLED（IIC）波形”不再是一个压缩包里的陌生工程，而是完全长在你脑子里的肌肉记忆。

本文还有配套的精品资源，点击获取