简介这是一份面向STC12C5A60S2单片机开发者的0.96寸OLED显示驱动例程演示通过IIC总线控制SSD1306/SH1106驱动芯片的完整流程。压缩包共14个文件以3个C头文件、2个C源文件为主另含Keil工程文件、STARTUP.A51启动文件、编译生成的Hex固件及调试配置整个压缩包仅139KB结构非常精简特别适合直接下载学习或烧录验证。当前已有1282人学习下载。例程覆盖IIC接口初始化、OLED模式配置、清屏、坐标设置、像素写入、文本显示等关键操作并保留了完整的Keil工程目录开发者可对照电路连接快速理解引脚、时钟速度和设备地址的配置方法也能在自己的项目中移植复用或继续扩展滚动文本、动画等显示效果。推荐给嵌入式初学者、实验项目制作者以及需要为小型设备增加屏幕显示功能的人群对刚接触单片机的用户尤为友好。1. 拿例程点亮 0.96 寸 OLED 前先想清楚这三件事我见过不少开发者拿到一块 0.96 寸 OLED 和一份 STC12C5A60S2 的 IIC 例程第一反应就是“把代码烧进去屏幕应该就亮了”。结果往往是白屏、花屏、或者编译报错连 HEX 都生成不出来。这套 0.96 寸 OLED 显示屏 STC12C5A60S2 IIC 例程实际上是把你从硬件接线、IIC 时序到 SSD1306 初始化、字模取模的全流程圈好了范围你只需要改引脚宏定义、确认地址、把取模数据喂进去就能用。适合正在做智能小车、温湿度记录仪、简易示波器或者只是想把手头这枚 51 系芯片玩明白的人。不过在开始之前我先提醒三句话先看协议地址再看供电逻辑最后才看代码。2. 硬件底子与例程资源结构SSD1306、IIC 与 STC12C5A60S2 的搭配逻辑2.1 SSD1306 控制器与 0.96 寸屏的关键参数这块屏的外观是 0.96 寸分辨率 128×64背后的驱动芯片最常见的是 SSD1306。手里这套例程针对的就是 SSD1306 控制器的 IIC 版本模块上一般会引出来 4 个或者 6 个引脚IIC 模式下至少用到 VCC、GND、SCL、SDA。SSD1306 内部有一块 128×64 bit合计 1024 字节的显存单片机要做的事很简单把要显示的内容写入这块显存屏幕会自动刷新成对应的点阵。我拿到例程后会先看一眼模块丝印确认它是不是带稳压和上拉电阻的版本。多数市售模块的 VCC 可以直接接 5V因为板载了稳压电路逻辑电平也做了处理但仍有少数精简版模块只支持 3.3V接 5V 会直接冒烟。这点和例程本身无关却是第一个值得确认的硬件参数。SSD1306 的 IIC 从机地址通常是 0x78 或 0x7A这取决于模块上 SA0 引脚的电平。例程里如果写死 0x78另一块屏大概率就白屏了。2.2 为什么这个例程选 IIC 而不是 SPI0.96 寸 OLED 的驱动接口常见两种IIC 和 SPI。IIC 只占用两根 IO 线SCL 和 SDA这在 STC12C5A60S2 这类引脚不算多的 51 系芯片上很实用。SPI 接口虽然能拿到更快的刷新速度但一般需要 CS、DC、RES、SCLK、MOSI 五根线对线材长度和焊接都有更高要求。这套例程选 IIC我认为主要考量就是省引脚和方便接线。从速度角度说IIC 标准模式 100kHz、快速模式 400kHz而 STC12C5A60S2 是 1T 单片机主频 11.0592MHz 或更高用 IO 模拟 IIC 跑到 200kHz 左右很轻松。显示静态文字、传感器数值完全够用但如果想做 60 帧动画IIC 就力不从心了。我在实际调试时测过纯文本页面 40ms 内刷完一帧没有压力这个结论放到后面再展开。2.3 例程包里的文件与接线把下载好的例程包解开后通常能看到这几个文件文件作用是否需要改动main.c主循环调用 OLED 初始化与显示测试函数按需修改显示内容oled.cSSD1306 初始化、IIC 读写、显示字符与图片函数主要改动引脚宏和地址oled.h宏定义、函数声明、取模数据声明可能改动引脚定义取模说明.txt字模软件参数设置说明只读参考原理图或接线图引脚连接示意只读参考我见过不少例程直接把引脚定义写在 oled.c 开头像是这样// IIC 引脚定义 sbit OLED_SCL P1^6; sbit OLED_SDA P1^7;在 51 单片机里sbit 就是把某个 IO 口的某一位单独命名。STM32 移植过来的代码通常不会这么写因为那属于寄存器操作。这套例程既然面向 STC12C5A60S2用 sbit 映射 P1 口的两个引脚是最直观的做法。你可以把屏幕的 SCL 接到 P1.6、SDA 接到 P1.7这样改宏定义就能适配你自己的板子。还有一种接线方案是 SCL 接 P2.0、SDA 接 P2.1但要注意你板子上的其它外设是否占用了同一组 IO比如外挂 EEPROM 的 IIC 总线共用时就要考虑器件地址冲突的问题。建议一开始就把 OLED 单独挂在空闲的 IO 上等调试通过再合并总线。3. 驱动代码怎么移植把 IIC 时序、初始化序列和取模函数串起来3.1 从 IIC 起始/停止时序开始看协议实现IIC 通信最关键的是时序说白了就是 SCL 和 SDA 谁先动、谁后动。例程里 IIC_Start 函数的常见实现是void IIC_Start(void) { OLED_SDA 1; OLED_SCL 1; delay_us(5); // 保证 SCL、SDA 都是高电平稳定 OLED_SDA 0; // SCL 为高时SDA 拉低产生起始信号 delay_us(5); OLED_SCL 0; // 拉低 SCL准备发送数据 }起始信号的定义就是在 SCL 保持高电平期间SDA 产生一个下降沿。停止信号则是反过来SCL 高电平期间 SDA 产生上升沿。这里的 delay_us 不能省STC12C5A60S2 是 1T 指令周期如果删掉延时整个 IIC 时序会快到 SSD1306 跟不上结果是屏幕偶发乱码。换个说法IIC 在 51 上模拟最忌讳“裸奔式”翻转引脚STC12C5A60S2 比老款 89C52 快大约 12 倍很多从老平台移植来的例程延时没改就会翻车。我一般会保留 3–10us 延时既不至于慢到可见闪烁也能保证时序稳定。停止函数和发送字节函数同样重要发送一字节的核心逻辑是从高位到低位逐位发送void IIC_WriteByte(unsigned char dat) { unsigned char i; for(i 0; i 8; i) { OLED_SCL 0; // 拉低时钟准备改 SDA if(dat 0x80) // 从最高位开始判断 OLED_SDA 1; else OLED_SDA 0; delay_us(3); OLED_SCL 1; // 拉高时钟让从机采样 delay_us(3); dat 1; // 移到下一位 } OLED_SCL 0; }这个函数每次循环都先拉低 SCL再改 SDA然后拉高 SCL 让从设备锁存数据。用户在移植时一般不需要改动这个函数除非你打算把 IIC 速度再调快一点那可以缩短 delay_us 到 1–2us但我不建议贴边跑留一点余量对长走线更友好。3.2 SSD1306 初始化序列逐条说明SSD1306 上电后不会自动显示必须先通过 IIC 发送一串配置命令。例程里的 OLED_Init 函数通常包含以下关键序列命令字节含义0xAE关闭显示0xD5, 0x80设置显示时钟分频因子0xA8, 0x3F设置复用率128×64 屏用 0x3F0xD3, 0x00显示偏移设为 00x40起始行 00x8D, 0x14开启内部电荷泵0x20, 0x00设置内存寻址模式为水平寻址0xA1段重映射左右方向0xC8扫描方向上下翻转0xDA, 0x12设置 COM 引脚硬件配置0x81, 0xCF设置对比度0xD9, 0xF1预充电周期0xDB, 0x40VCOMH 电平0xA4显示内容来自显存0xA6正常显示不反色0xAF开启显示这个序列不是随便抄的里面有两个坑0x8D 后面必须跟 0x14 来开启电荷泵否则屏幕背光虽然亮但内容不显示0x20 后面的 0x00 表示水平寻址模式这会直接影响你往显存填数据的顺序改错了显示就会错位。发送命令和发送数据的区别在于 IIC 传输中的控制字节。SSD1306 规定控制字节 0x00 表示后续字节是命令0x40 表示后续字节是数据。例程里会分别封装成 OLED_Write_Cmd 和 OLED_Write_Data本质上都是先发设备地址再发控制字节最后发内容。移植时建议保留这两个函数的分离不要混用否则后面写图形功能时一定会返工。3.3 移植时最不容易出错的两个函数清屏和光标定位清屏函数是例程里最早被调用的显示函数作用是往全部 1024 字节显存写 0x00void OLED_Clear(void) { unsigned char i, j; for(i 0; i 8; i) // 共 8 页每页 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); // 清空该字节 } } }这段代码的逻辑比较好理解SSD1306 的显存被分成 8 页每页对应屏幕上的 8 行像素每页有 128 列。先设置当前页地址0xB0i再设置列地址低地址 0x00高地址 0x10然后连续写 128 个 0x00。这个函数同时也是你验证 IIC 通信是否正常的试金石如果调用完屏幕能整个变黑说明地址和时序都没问题。往指定位置写一个字符的函数一般叫 OLED_ShowChar参数是行列坐标和字符 ASCII 码。坐标 x 取 0–127y 取 0–7这里 y 的单位是页而不是像素行。新手最容易在这里踩坑想显示在第 16 行像素结果写成 y16最后屏幕上什么都没有因为 y 超过 7 后被写到了显示范围之外。正确写法是 y2表示第三页。3.4 完整点亮把测试程序烧进去发光的第一步把例程里的 main.c 编译下载前建议先做一件事用 STC-ISP 软件里的串口助手或者示波器确认一下单片机在跑最简单的办法是写一个 LED 闪烁程序测试延时函数是否正常。整套例程烧录后如果屏幕亮起并显示字符说明 IIC 驱动和初始化序列都没问题如果白屏先检查接线是否接触可靠再检查模块地址是否与代码一致。有一些模块的 IIC 地址默认是 0x7A而例程写的是 0x78这时候画面不会显示。在 51 的 IIC 驱动里发送地址通常是先左移一位再拼接读写标志0x78 对应的 7 位地址是 0x3C0x7A 对应 0x3D。所以你在代码里如果看到 OLED_WriteByte(0x78)说明驱动层已经把地址转换好了如果看到 0x3C说明后面还有一步移位。这是移植手册上容易混淆的地方后面专门写一条避坑记录。4. 取模工具与显示速度中文字模怎么生成、刷屏速率是否够用4.1 用取模软件生成字模时参数怎么选例程包通常会附带一个取模工具常见的是 PCtoLCD2002。打开软件后输入一个汉字比如“传”然后设置点阵参数。这里面的参数选择直接决定显示是否正确我把常用设置列出来参数项推荐选择原因点阵格式阴码OLED 点亮像素对应二进制 1阴码的 1 正好表示点亮取模走向逆向低位在前配合驱动函数里的移位方式取模方式逐列式常见 51 驱动函数按字节写入逐列式与页地址行方向一致每行显示数168×16 汉字一次显示一行字模宽度16常用汉字宽度字模高度16常用汉字高度这里最让人头大的是“逐列式”和“逐行式”的差别。逐列式取出来的数据在水平寻址模式下一列一列地填进显存字符能正常竖排显示逐行式取出来的数据填进去字就会被打散或者左右错位。我在实际中见过很多开发者把取模软件里的“逐行式”和“阴码 逆向”混在一起用结果拿到屏幕上成了完全不可读的噪点。判断方法很简单取模后预览窗口看一眼如果单个汉字呈 45 度斜向排布多半是取模方式和驱动不匹配。换一种取模方式再试通常就能解决。4.2 汉字数组与为例程扩展的显示 API在例程的 oled.c 里汉字字模一般放成 const 数组。以 16×16 点阵为例每个汉字占用 32 字节。显示汉字函数的常见实现是void OLED_ShowChinese(unsigned char x, unsigned char y, unsigned char no) { unsigned char i, j; unsigned char *addr (unsigned char *)(Chinese_16x16 no * 32); for(i 0; i 2; i) // 16 像素高度分两页写 { OLED_Write_Cmd(0xB0 y i); // 设置页地址 OLED_Write_Cmd(x 0x0F); // 列地址低 4 位 OLED_Write_Cmd(0x10 | (x 4)); // 列地址高 4 位 for(j 0; j 16; j) { OLED_Write_Data(addr[i * 16 j]); } } }这个函数的逻辑是把汉字拆成上下两半每半占用一页 16 列字节。参数 x 是起始列y 是起始页字体越大y 连续占用的页数越多。例程自带的 Chinese_16x16 数组在 oled.h 里定义通常只包含“电工”或“欢迎”这类测试词实际项目里你需要用取模软件重新生成自己需要的汉字数组替换或者追加在数组尾部。4.3 判断显示速度纯 IIC 400kHz 刷一帧需要多久有人问 0.96 OLED 用 IIC 会不会卡。算一笔账一帧画面 1024 字节每个字节在 IIC 传输中实际是 1 字节数据位 1 位 ACK加上地址帧和控制帧大约要传 11000 位左右。如果 IIC 跑在 400kHz理论时间大约是 28ms。实际加上函数调用、延时和初始化命令一帧 30–45ms也就是每秒能刷 20–30 帧。这个速度对显示文本、数字、简单曲线完全够用。但如果你要做动画或者波形滚动就有优化空间不要每次刷新都调用清屏函数改成只更新变化区域的坐标和内容刷新率可以从 20 帧提到接近 30 帧以上。例程本身没有做这部分优化但代码结构是分层的你可以直接调用底层的 OLED_ShowChar 配合坐标变化来实现局部刷新。5. 五个常见坑位与排查流程白屏、花屏、卡死在初始化5.1 背光亮但屏幕全白一个字都没有现象上电后屏幕背景是亮的看起来像是白光板但不管烧什么程序都无显示。原因我排查过几次后发现最常见是模块的 RES 引脚悬空或者例程初始化之前没有给 SSD1306 足够的上电稳定时间。部分精简模块把 RES 引出来需要外部拉高否则芯片一直处于复位状态。另一个原因是初始化命令里的电荷泵没有打开也就是 0x8D 命令后跟的 0x14 被改掉了。解决先确认模块 RES 引脚是否接到单片机 IO 或直接接 VCC我一般会在 OLED_Init 开头加一段 100ms 延时再执行初始化命令序列。电荷泵开启命令确认无误后重新上电再看效果。5.2 显示正常但几十秒后花屏像是被干扰现象刚烧录时屏幕显示正常过一会儿字开始乱跳、花屏按下复位键又能恢复短暂正常。原因这类现象大多是看门狗在捣乱。STC12C5A60S2 如果开启了看门狗定时器而主循环里喂狗不及时或延时函数影响了喂狗周期单片机就会被周期性复位。还有一种可能是在主循环里调用了过长延时比如 delay_ms(500)看门狗溢出后强制复位。解决把例程里 WDT_CONTR 寄存器的相关初始化注释掉或者在主循环中定时喂狗。最简单直接的方法是下载时在 STC-ISP 软件的硬件选项中关闭看门狗烧录后不再软件开启问题一般就消失了。5.3 用 USB 转串口下载程序时 OLED 反复重启现象连着 OLED 的时候下载程序下载完成后屏幕不能正常显示拔掉屏幕重新上电就正常。原因STC 单片机下载用的是串口 P3.0/P3.1而部分例程把 OLED 的 SCL 或 SDA 接在和串口有关的引脚附近下载握手时串口引脚的电平翻转影响了 OLED 模块甚至电流被分走导致模块供电不稳。解决下载时把 OLED 的排线拔掉烧录完成断电再插上屏幕重新上电。如果你非要带着屏幕下载就把 OLED 的 VCC 和 GND 单独接到主板上的独立电源引脚避免和 USB 转串口共用一路供电。5.4 画面出现镜像或字符反着显示现象屏幕能点亮但字是左右颠倒的就像照镜子一样。原因SSD1306 的段重映射命令 0xA1 和 0xA0 控制显示方向。例程厂家不同默认的重映射方向也不一样。如果你的取模数据是按照从左到右取的点而驱动里用的是 0xA0不重映射视觉上就会镜像。解决把初始化序列里的 0xA1 改成 0xA0或者反过来改再重新烧录。同样的道理适用于 0xC8 和 0xC0这是上下翻转的开关。某些模块用的屏幕玻璃安装方向不同镜像问题只能靠调命令解决软件明显比改硬件靠谱得多。5.5 IIC 总线上拉电阻缺失导致偶发乱码现象屏幕多数时间正常但用手摸一下排线或者电机一转画面就出现雪花点。原因IIC 的 SCL 和 SDA 在总线上是开漏输出正常工作需要外部上拉电阻。大多数成品 OLED 模块板载了上拉但如果你用的是裸屏转接板或者自己画的 PCB上拉电阻没贴或者贴了 10k 而线长超过 20cm干扰就会显现。解决测量 SCL 和 SDA 对地电压静态下应该接近 VCC。如果只有零点几伏说明上拉缺失或单片机 IO 没有配置成准双向口。贴 4.7k 上拉电阻到 VCC问题一般能消除。STC12C5A60S2 的 IO 默认是准双向口可以直接外接上拉不需要改寄存器配置。6. 练手后的验证法用逻辑分析仪看波形、把画面刷成动图一套例程跑通之后我建议你花半天时间做两个进阶动作这样以后再碰 OLED 类项目心里就有底了。第一个是用逻辑分析仪抓 IIC 波形。你不需要买昂贵的设备一个 8 通道逻辑分析仪配合免费软件就够了。把 SCL 接到通道 0SDA 接到通道 1采样率设为 1MHz触发条件选下降沿。按下复位键后屏幕上会清晰地看到一帧完整的 IIC 通信先是一段起始信号然后地址字节 0x78接着控制字节 0x00 或 0x40后面跟一串数据。软件会自动协议解码直接列出每个字节的值。这个验证手段最大的价值是能立刻区分“时序写错”和“模块故障”——如果地址字节后面没有 ACK问题一定在模块地址或硬件连接如果有 ACK 但画面不对问题在初始化命令或取模方式。第二个进阶是做一个简单的动画验证刷新能力。在例程中加一个变量 angle让屏幕上画一条从左边移动到右边的竖线void OLED_DrawLine(unsigned char x) { unsigned char y; for(y 0; y 8; y) { OLED_Write_Cmd(0xB0 y); OLED_Write_Cmd(x 0x0F); OLED_Write_Cmd(0x10 | (x 4)); OLED_Write_Data(0xFF); // 整列像素点亮 } if(x 0) // 擦除上一列 { // 定位到 x-1 列写入 0x00 } }但你会发现这样一帧一帧刷新还是不够快。真正提升 IIC 显示效率的关键在于减少重复发送命令。SSD1306 在水平寻址模式下连续写数据会自动递增列地址所以你要做的不是每写一个字节都重新定位而是把一行的 128 个字节一次性写完只在换页时发送页地址和列地址。例程里的 ShowChar 函数是逐字定位的效率不高用来显示文本没问题但做动画就得自己写一个整帧缓冲区刷新函数。从那以后我每次拿到一块新的 OLED 模块或者换了一颗单片机型号第一件事不是去翻代码里的显示函数而是先看它的取模方式和地址宏再用逻辑分析仪确认起始波形最后才跑显示测试。这套流程虽然多花十分钟但确实帮我避开了很多白屏、花屏、乱码的“玄学”问题。希望帮到你。本文还有配套的精品资源点击获取