简介一份基于意法半导体STM32F407微控制器的零点九六英寸OLED屏IIC总线驱动示例工程源码包面向嵌入式入门及进阶开发者着重解决IIC总线外设初始化、SSD1306控制器指令控制、文本与图形显示功能等常见问题。压缩包共三十五个文件包含C语言源码、H头文件、HEX烧录文件、原理图PDF、尺寸图PNG等整体大小仅二点一九MB内含MDK完整工程可直接导入Keil或STM32CubeIDE编译。工程代码结构清晰采用HAL库编写OLED显示驱动函数封装完整便于移植附带的原理图与连接说明可辅助硬件调试。资源已有五百三十三人学习适合想快速掌握STM32软硬件IIC总线通信及OLED显示原理的读者。通过该工程可理解从GPIO配置到帧缓冲刷新的全流程并在此基础上扩展显示菜单或传感器数据等功能。 前阵子整理硬盘翻出一个名为stm32_iic_096oled.zip的工程包点开一看正是当年调 0.96 寸 SSD1306 OLED 屏的老项目。用 STM32 通过 IIC 驱动 0.96 寸 OLED几乎是每个嵌入式玩家绕不开的第一块屏便宜、接线少、显示效果直观调好了非常有成就感。这篇就当一份完整的复盘笔记从工程结构、IIC 时序、驱动代码到避坑方案都过一遍适合刚接触 STM32或者正准备用 OLED 做显示界面、但还没理清 IIC 通信细节的同学参考。1. 工程包拆解一个最小可用的显示系统1.1 zip 里面通常装了什么这类命名stm32_iic_096oled.zip的工程大多是一个 Keil 工程模板目录结构大致如下USER包含main.c、stm32f1xx_it.c、系统配置文件HARDWARE / BSPoled.c、oled.h、i2c.c、i2c.hCORE启动文件startup_stm32f10x_hd.sSYSTEMdelay.c、sys.c、usart.cOBJ编译输出目录如果用的是标准库工程里多半有stm32f10x_gpio.c、stm32f10x_rcc.c这些外设库文件如果用的是 HAL 库则会看到stm32f1xx_hal_gpio.c、stm32f1xx_hal_rcc.c。我自己的习惯是把驱动单独放在 HARDWARE 目录这样以后换芯片、换板子直接把这个目录拷过去改两行引脚宏就能复用。1.2 为什么选 IIC 来驱动 OLED0.96 寸 OLED 常见驱动芯片是 SSD1306接口方式有 6800、8080 并口、SPI 和 IIC。多数模块默认通过背面的电阻焊桥设置为 IIC 模式因为只用到 SCL、SDA 两根线加上 VCC、GND一共四根线杜邦线一插就能用。相比 SPIIIC 速度确实慢一些但 128x64 的单色屏显示静态菜单、传感器数据完全够用。我做过粗略估算SSD1306 一屏显存是 128×64 bit也就是 1024 字节在 400kHz 速率下光传输这 1024 字节的数据理论上需要约 20ms加上命令开销和应答位整屏刷新大概 30ms 上下。对大多数界面显示来说这个刷新率没有任何问题。还有人担心 STM32 的硬件 IIC 不好用所以我干脆用软件模拟 IIC两个 GPIO 翻转电平时序完全可控排查问题也更直观移植到其他 MCU 几乎零成本。2. IIC 通信核心时序、电阻与设备地址2.1 起始条件、停止条件与 ACKIIC 是一种两线制、半双工、同步通信协议跟我常跟朋友打的比方一样SCL 是节拍器告诉双方什么时候该开口SDA 是话筒说话的内容就在这根线上按位传输。空闲时两根线都是高电平起始条件是在 SCL 保持高电平时 SDA 由高变低停止条件是在 SCL 保持高电平时 SDA 由低变高。数据传输时SDA 必须在 SCL 低电平期间变化SCL 高电平期间保持稳定否则会被误判为起始或停止信号。每次传输 8 位数据后接收方需要回复一个 ACK在第 9 个时钟周期如果接收方把 SDA 拉低表示“收到了继续发”如果 SDA 保持高电平就是 NACK一般表示地址错误、设备忙或者不想接收更多数据。对 OLED 模块来说写入操作每次发送完控制字节都必须检查 ACK如果连续收到 NACK大概率就是 IIC 地址写错了或者 SDA 线没接上。2.2 设备地址0x78 还是 0x7AIIC 总线上的每个从机都有一个 7 位地址。SSD1306 的 7 位地址基本是0x3C或0x3D具体由 SA0 引脚的电平决定。在 8 位写地址里最低位补 0所以常见的写地址是0x78如果 SA0 接高电平写地址就是0x7A。很多模块默认是0x78但也有部分淘宝模块出厂时 SA0 拉到高电平或者板上没有默认电阻导致屏幕没反应。为了避免在这上面浪费时间我拿到新模块的第一件事就是写一个两分钟的 IIC 扫描程序遍历 0x3C、0x3D 两个 7 位地址看谁回复 ACK然后把地址打印在串口上。实测下来90% 的模块都能通过这种方式快速定位地址比对着原理图猜靠谱得多。2.3 上拉电阻怎么选4.7k 还是 10kIIC 协议要求输出端必须是开漏结构所以 SCL 和 SDA 线上必须接上拉电阻。电阻大小直接影响总线上升沿速度和功耗。上拉电阻适用场景注意事项1k~2.2k长线、高速模式、总线上挂多个设备功耗略大灌电流要算一下4.7k3.3V 系统、常规杜邦线连接最常用大多数开发板都标配这个值10k短线、低速、对功耗敏感的场景上升沿偏慢线一长容易出错如果模块已经自带 4.7k 上拉到 VCC那就不用再外接如果模块上没焊上拉电阻或者你用的是自己画的最小系统板一定要在 SCL、SDA 上各加一个 4.7k 电阻到 3.3V。我试过不接外部上拉、只开 STM32 内部上拉近距离确实能跑但换一根 20cm 杜邦线就开始随机花屏加了 4.7k 之后再没出过问题。另外EMC 方面有个很实用的做法在靠近 MCU 一端的 SCL、SDA 线上各串联一个 22Ω~33Ω 的电阻可以抑制过冲电源引脚附近放一个 100nF 瓷片电容必要时再并一个 10uF 电解电容对显示稳定性帮助很大。2.4 软件 IIC 的实现框架软件模拟 IIC 本质上就是用 GPIO 翻转电平加上微秒级延时。这里我贴一段基于标准库的代码HAL 库思路一样只需要把 GPIO 操作换成HAL_GPIO_WritePin和HAL_GPIO_ReadPin。#define IIC_SCL GPIO_Pin_6 #define IIC_SDA GPIO_Pin_7 #define IIC_PORT GPIOB #define SCL_H() GPIO_SetBits(IIC_PORT, IIC_SCL) #define SCL_L() GPIO_ResetBits(IIC_PORT, IIC_SCL) #define SDA_H() GPIO_SetBits(IIC_PORT, IIC_SDA) #define SDA_L() GPIO_ResetBits(IIC_PORT, IIC_SDA) #define SDA_READ() GPIO_ReadInputDataBit(IIC_PORT, IIC_SDA) void I2C_Start(void) { SDA_H(); SCL_H(); delay_us(5); SDA_L(); delay_us(5); SCL_L(); } void I2C_Stop(void) { SDA_L(); SCL_H(); delay_us(5); SDA_H(); delay_us(5); } uint8_t I2C_WriteByte(uint8_t dat) { uint8_t i; for (i 0; i 8; i) { if (dat 0x80) SDA_H(); else SDA_L(); dat 1; SCL_H(); delay_us(2); SCL_L(); delay_us(2); } SDA_H(); // 释放 SDA等待从机应答 SCL_H(); delay_us(2); i SDA_READ(); SCL_L(); return (i 0) ? 0 : 1; // 返回 0 表示收到 ACK }注意一个细节GPIO 要配置成开漏输出而不是推挽输出。开漏模式下当代码写 1 时引脚实际是高阻态由外部上拉电阻拉高这样读 ACK 的时候才能正确读到从机拉低的电平如果配成推挽从机根本拉不动你的引脚读回来的永远是 1通信就会失败。3. OLED 驱动与显示SSD1306 与显存操作3.1 SSD1306 初始化序列SSD1306 内部是一块 128×64 的点阵显存主机通过命令寄存器设置显示参数通过数据寄存器写入显示数据。初始化序列网上有很多版本核心动作是关闭显示、设置显示时钟分频、设置多路复用比例、设置显示偏移、设置起始行、开启电荷泵、设置段重映射、设置 COM 扫描方向、设置对比度、设置预充电周期、设置 VCOMH 电平、清屏、打开显示。特别注意“开启电荷泵”这一步很多 OLED 模块的屏幕不亮就是因为初始化时没有把电荷泵打开。SSD1306 内部需要产生一个比 VCC 更高的电压来驱动 OLED 发光如果 charge pump 没有开启屏幕就会一片黑。我的初始化序列里靠后有一个命令0x8D, 0x14就是开启电荷泵。3.2 显存、页地址与寻址模式SSD1306 的显存按 8 行一组分成 8 页每页 128 列正好对应 128×64 点阵。写显存时通常先发送命令设置页地址0xB0~0xB7再设置列地址低四位和高四位然后连续写入显示数据。列地址会随着写入自动加 1但页地址不会自动加写满 128 列后如果想换页必须手动重新发页地址命令。很多新手在这里踩坑把一屏数据连续写进去结果只显示了第一行或者显示内容错位、上下半屏颠倒。我的建议是在 MCU 内部维护一个 1024 字节的显存数组GRAM[8][128]所有画点、画线、显示字符的操作都先修改这个数组最后再用一个OLED_Refresh()函数把整个数组一次性送到 SSD1306。这样做的好处有两个一是避免频繁调用 IIC 写命令导致刷屏闪烁二是做局部刷新时可以先改数组再选择性地只刷某一页效率明显更高。3.3 显示字符、数字和汉字的思路SSD1306 内部没有字库显示字符需要自己准备字模。ASCII 字符常做成 8×16 点阵一个字符 16 字节汉字常用 16×16 点阵一个汉字 32 字节。取模软件建议用“纵向取模、字节倒序”或“列行式”具体设置根据你的字模数组格式来定否则很容易出现镜像或者上下颠倒。以 8×16 字符为例在 GRAM 里的显示方式是把字符拆成上半部分 8 行和下半部分 8 行分别写入相邻两页。定位时确定page y / 8column x然后发送页地址和列地址再把字模数组按页写入。显示字符串就是循环调用字符函数显示浮点数可以通过sprintf先把数字转成字符串再逐字符显示。3.4 一个最简 main 函数流程配合软件 IIC最小系统跑起来大致是这样int main(void) { delay_init(); I2C_GPIO_Init(); OLED_Init(); OLED_Clear(); OLED_ShowString(0, 0, Hello STM32, 16); OLED_ShowString(0, 16, IIC OLED OK, 16); OLED_Refresh(); while (1) { // 主循环更新数据修改 GRAM再 OLED_Refresh() } }OLED_Init()里面会把 SSD1306 的命令序列发一遍OLED_ShowString只改写内部的 GRAM最后OLED_Refresh()统一刷屏。这样即使后面加上菜单、进度条、波形显示只要遵循“写数组统一刷新”这个模式代码结构都不会乱。4. 常见问题排查与调试实录4.1 OLED 不亮、花屏、亮一半速查现象常见原因排查方法完全不亮背光无反应无电源、接线错误、IIC 地址不对、电荷泵未开启先查 VCC/GND 电压用万用表测屏供电试 0x78/0x7A 两个地址检查初始化里有无 0x8D, 0x14有背光但无文字对比度太低、显示数据全 0、GRAM 未刷新增大对比度命令 0x81 的值确保调用了 OLED_Refresh检查 GRAM 是否被意外清零花屏、乱码总线速度太快、上拉电阻过大、线太长或干扰降低 IIC 延时改用 4.7k 或更小上拉缩短杜邦线电源加电容半屏不亮或上下颠倒页地址设置错误、COM 扫描方向配置不对检查初始化中 0xC0/0xC8 的方向设置检查页地址是否在 0xB0~0xB7有残影或亮点清屏不彻底、上一帧数据残留全屏写 0 后再刷新给 OLED_Clear 加上 OLED_Refresh4.2 IIC 总线卡死不是玄学软件模拟 IIC 时如果程序意外中断或者复位发生在发送过程当中SDA 可能正好停在半高半低的位置或者从机一直拉着 SDA 不放导致总线锁死。处理办法是初始化 GPIO 时先把 SCL 和 SDA 都拉高然后连续产生 9 个时钟脉冲让从机释放 SDA最后再来一个 START 信号。我在OLED_Init前面加了一个I2C_Bus_Reset()实测能解决大部分“之前还好的重启之后屏幕没反应”的情况。STM32 的硬件 IIC 外设偶尔也会出现总线状态错误Bus Fault特别是通信中间被中断打断的时候。如果你正在用硬件 IIC可以考虑在错误处理回调里重新初始化 IIC 外设或者像我一样干脆用软件 IIC完全绕开这个坑。4.3 顺手排一个烧录报错问题热搜词里总有“error: no stm32 target found”虽然和 OLED 显示无关但很多人是焊好屏幕、插上 ST-Link 之后才发现根本烧不进程序。遇到这个提示我建议按顺序检查目标板是否上电、ST-Link 与 SWDIO/SWCLK/GND 接线是否正常、BOOT0 是否被拉高、复位电容是不是太大、调试器固件是否需要升级。某些新型号芯片如果开启了调试保护也需要先解除但这个属于芯片安全配置和普通项目关系不大更多时候只是杜邦线接触不良重插一下就好。4.4 提升稳定性的几个小习惯我自己在用过几块不同厂商的 0.96 OLED 后总结了几个对稳定性提升很明显的做法供电尽量用 3.3V不要拿 5V 直接怼如果模块带稳压电路还好不带的话长期 5V 对寿命有影响。OLED 的 SDA、SCL 不要和电机、继电器驱动线绑在一起走感性负载切换瞬间会对总线产生严重干扰。IIC 初始化代码放在外设时钟使能之后先让 GPIO 输出模式稳定再操作总线。每次写完 GRAM 数据后可以加一个几微秒的延时别让 IIC 总线一直处于忙状态给 OLED 内部电路一点缓冲时间。5. 从这块屏走向更完整的项目5.1 让 OLED 变成调试输出口身边不少朋友做项目时习惯用串口助手看调试信息但手里没有 USB-TTL 的时候就很尴尬。OLED 可以作为第二调试通道把printf重定向到一个自定义函数把关键变量、系统状态直接显示在屏上。比如显示 ADC 采样值、电池电压、传感器温度甚至 RTC 时间这样手里只要有一块屏就能随时看到内部的运行情况。我在调试 MPU6050 姿态数据时就靠着在 OLED 上实时刷新角度省了一台逻辑分析仪。5.2 拓展菜单、动画、进度条拥有一块全权控制的 GRAM 数组后显示能力其实超出你的想象。画点、画线、画矩形、画圆、位图、进度条、翻页动画统统可以基于点阵操作实现。比如要做开机动画就准备几帧图像数组逐帧写入 GRAM 并刷新要做进度条就在特定页里按比例填充显存数据要做多级菜单就用变量记录当前选中项刷新时只改变对应行的高亮状态。OLED 的响应速度很快只要刷新率控制得当动画看起来非常流畅。当然软件 IIC 的速率有限动画帧率不用追求太高每秒 20 帧左右足够而且不会占用太多 CPU 时间。5.3 工程文件打包前的几个建议既然项目叫stm32_iic_096oled.zip说明以后很可能还会分享给别人或留作模板。打包工程前我强烈建议做三件事一是把Obj、List等编译中间目录删掉zip 体积能小很多二是在工程根目录放一个readme.txt写清楚开发环境、芯片型号、接线定义和初始化顺序三是把 Keil 工程里的芯片型号、Flash 下载算法核对一遍避免别人拿到手打开工程直接报错。这些动作花不了两分钟但能帮后来者省一晚上时间。最后再分享一个小技巧我每次拿到一块新的 OLED 模块第一件事就是用 IIC 扫描程序把地址找出来打印到屏幕或串口上然后再去调显示。这个习惯帮我避开了无数次“屏幕为什么不亮”的陷阱。希望这篇文章也能让大家的屏幕一次点亮少走我之前走过的弯路。本文还有配套的精品资源点击获取