做过单片机开发的都知道硬件调试有多磨人。我以前带过几个新手最夸张的一次有人把0.96寸OLED的VCC和GND接反屏幕当场报废一排引脚全烧黑。这种事碰多了我现在但凡要验证一个新的显示方案或者I2C时序都会先打开Proteus仿真软件把逻辑跑通再动实物。今天这篇博文我就用Proteus仿真 STM32F103C8T6 OLED显示这个经典组合完整演示一遍从建工程、搭原理图、写代码到仿真调试的全过程。全程不需要硬件适合刚入手STM32的同学也适合想快速验证驱动逻辑的工程师。代码我会给全照着敲就能跑。1. 项目整体设计与思路拆解1.1 为什么我会选择先在Proteus里跑通再碰实物很多人觉得Proteus仿真只是学生玩具实际做项目用不上这个看法其实偏了。Proteus的价值不在于替代真实的硬件验证而在于把成本最低、迭代最快的一轮调试前置到上电之前。一个OLED模块加一块最小系统板虽然单价不高但反复插拔、接线错误、引脚冲突累积起来的时间和损耗一点也不少。更关键的是Proteus里能直接挂虚拟示波器、逻辑分析仪、I2C调试器这些在实物环境里要么得额外买设备要么就得靠LED点灯慢慢猜。我在Proteus里看SCL、SDA的波形一眼就能判断是时序问题还是地址问题定位速度比实物快一个量级。当然仿真不是万能的。Proteus里的SSD1306模型是行为级仿真它对时序的宽容度比真实芯片高。这意味着你在仿真里能跑通的代码拿到实物上可能还需要微调延时。但反过来如果仿真里都跑不通实物基本没戏。所以这个流程的核心是先用仿真把逻辑彻底理顺再上实物做最终验证。1.2 为什么选STM32F103C8T6这颗芯片STM32F103C8T6是ST的经典Cortex-M3芯片48引脚64KB Flash20KB RAM主频最高72MHz。这颗芯片在入门市场上几乎是统治级的存在网上教程多到看不完资料好找工具链成熟。另外它有两个I2C外设、三个USART、一个SPI对OLED这类显示外设来说资源完全过剩。C8T6的国产替代型号也很多很多在引脚和软件层面可以直接替换程序基本不用改这让它在未来的批量项目里也有不错的延续性。要提醒一点C8T6的Flash只有64KB如果使用标准库加HAL库混用工程会显得臃肿但驱动OLED这种小型项目完全没压力。真正需要注意的是一些国产型号在Proteus中和ST原厂模型行为略有差异所以本文统一用ST原厂模型来做仿真。1.3 显示方案对比OLED凭什么胜出写显示驱动可选方案很多。我把最常见的几种拉出来对比一下显示方案接口方式优点缺点适合场景LCD1602并口 / I2C(PCF8574)便宜、资料极多字符型不能显示图形和汉字需要多根线只显示简单字符的场合OLED 0.96寸I2C / SPI两线驱动I2C、自发光、对比度高、可显示中文和图形屏幕小、刷新全屏时速度一般小型仪表、桌面摆件、设备状态屏TFT彩屏SPI / 并口彩色、分辨率高、界面表现力强接口多、占用资源大、Proteus模型少复杂人机界面从Proteus仿真角度看LCD1602在Proteus里仿真效果其实也不错但它只能显示字符可玩性有限。TFT彩屏在Proteus里的模型不算丰富很多封装需要自己找对新手不友好。OLED的模型在Proteus 8.13以上版本已经比较成熟搜索OLED就能找到基于SSD1306的0.96寸模块引脚只有VCC、GND、SCL、SDA连起来非常省心。从实际效果看OLED全黑背景上显示亮色字符或图形视觉冲击力比LCD强太多。而且SSD1306控制器的驱动逻辑很有代表性搞懂它之后再去看其他I2C传感器或屏幕基本是举一反三。1.4 通讯接口选型为什么用软I2C而不是硬件I2COLED 0.96寸模块有两种常见接口SPI和I2C。SPI速度更快但需要四根信号线在Proteus里连线麻烦。I2C只需要SCL和SDA两根线逻辑也直观所以我选I2C。但这里有个更关键的选型我用的是软件模拟I2C不是STM32的硬件I2C外设。原因有三。第一标准库的硬件I2C存在事件标志处理繁琐、总线错误恢复麻烦的问题新手经常卡在EV5、EV6这些状态标志上半天调不通。第二软件I2C把时钟线、数据线的每一个电平变化都放在明面上初学者看代码就能理解I2C时序的本质。第三软件I2C不绑定特定引脚以后换芯片、改引脚分配只需要改几个宏定义就行移植成本很低。在Proteus中仿真时两种方式都能用但软件I2C在时序上完全由代码控制排查问题更直观。所以本文的代码统一采用GPIO模拟I2C方案。2. 开发环境准备与工具链搭建2.1 需要的软件清单和版本建议在开始操作之前先把工具备齐。我的使用习惯如下软件版本建议用途Proteus8.13及以上原理图设计、VSM仿真、虚拟仪器Keil MDK5.x代码编辑、编译、生成HEX文件STM32标准外设库V3.5提供寄存器封装和启动文件字模软件PCtoLCD2002生成中英文字符点阵数据Proteus的安装很简单一路Next就行但有几个坑要注意。安装路径不要带中文否则部分老版本会出莫名其妙的问题。新版Proteus打开后会自动加载内置示例工程如果你只是想新建一个干净的工程直接在首页选择新建空白设计即可。关于汉化我的建议是能不用就不用。Proteus的英文界面术语不算复杂而且很多报错信息在网上搜到的都是英文原文汉化包反而容易引入不稳定因素。如果从没接触过Proteus花半小时熟悉一下英文界面后面收益很大。2.2 Keil MDK工程配置要点Keil MDK的安装这里不细说重点讲工程配置。新建工程时器件选择STM32F103C8T6编译器会提示是否需要添加启动文件选择是然后手动添加标准库V3.5的核心文件。在Options for Target里Output选项卡勾选Create HEX File这是生成HEX文件的开关很多人程序写完了却找不到HEX就是因为这里没勾。在C/C选项卡里需要在Define栏填写两行宏STM32F10X_MD和USE_STDPERIPH_DRIVER。前者告诉标准库当前芯片是中等容量型号后者启用外设驱动库。启动文件选择startup_stm32f10x_md.s这个文件在标准库的CMSIS目录下能找到。启动文件的作用是配置堆栈、设置中断向量表、调用SystemInit完成时钟初始化然后再跳转到main函数。如果不添加这个文件程序编译再正确也跑不起来。2.3 标准库和HAL库怎么选目前STM32的新开发方式大多是STM32CubeMX加HAL库但本文我还是用标准库V3.5。原因很简单标准库的函数风格接近寄存器操作一个GPIO_Init结构体里模式、速度、引脚一目了然非常适合理解底层原理。HAL库为了兼容全系列芯片做了很多抽象层代码量明显偏大对新手反而增加理解成本。如果你已经在用CubeMX拖拽生成代码那换成HAL库也能实现同样的功能。但需要注意HAL库的I2C在部分版本的默认实现里有超时机制仿真环境下如果响应不及时可能报HAL_BUSY解决办法是调整超时时间或改用阻塞模式。本文后面的代码基于标准库逻辑上更简单直接。2.4 Proteus中STM32的时钟设置细节这个细节很容易被忽略。在Proteus里双击STM32F103C8T6芯片弹出的属性对话框中有一项Crystal Frequency或Clock Frequency默认是8MHz。这个值对应的是外部晶振频率代码里的SystemInit会把系统时钟倍频到72MHz。实际仿真时只要这个频率设置合理代码里的软件延时就能基本对应上。如果发现OLED刷新速度和你预期差很多先检查这个频率有没有被改乱。另外Proteus的仿真速度是可以调的如果感觉系统运行太慢或太快在Debug菜单里可以设置运行速度档位。3. 核心原理拆解SSD1306与I2C通信3.1 SSD1306控制器的显存结构OLED 0.96寸屏幕的驱动芯片通常是SSD1306它内部有一块128x64位的显存也就是说有128列、64行总共有128*64/81024字节。SSD1306把这64行划分成了8个页每页8行。在页寻址模式下写入操作按页进行。我们可以把显存想象成这样一个布局横向128个点是一行纵向每8个点组成一页。当你往一页中的某一列写一个字节时这个字节的8个位分别对应这页内的8行像素位为1就亮为0就灭。理解了这个映射关系就能解释为什么显示代码里总是出现0xB0到0xB7这几个命令它们就是在选择要写的页面。SSD1306支持三种寻址模式页寻址、水平寻址、垂直寻址。最常用的是页寻址因为操作简单先指定页面再指定列地址然后连续写入数据列地址会自动递增。虽然水平寻址在某些应用里刷新效率更高但对入门项目来说页寻址已经够用。3.2 OLED上电必须开启电荷泵SSD1306的驱动方式有点特殊它需要内部电荷泵产生一个比电源更高的电压才能驱动OLED像素发光。如果初始化序列里没有开启电荷泵屏幕就会表现为全黑但单片机明明在正常发送命令。电荷泵的开关由命令0x8D控制后面跟的参数0x14是开0x10是关。不少初学者写了初始化代码屏幕死活不亮排查半天结果就是漏了这条命令。我在下面的代码里会把它放在初始化序列中并且特意加注释。如果你用的是某些精简版驱动务必检查一下有没有这一条。3.3 I2C协议的极简拆解I2C总线上的通信本质就三件事起始条件、停止条件、字节传输。起始条件是SCL为高电平时SDA从高拉低停止条件是SCL为高电平时SDA从低拉高。数据传输时SDA在SCL高电平期间必须保持稳定在SCL低电平期间才能变化。SSD1306作为I2C从设备7位地址通常是0x3C换算成8位写地址就是0x78。发送字节时地址字节后面紧跟一个控制字节0x00表示接下来发送的是命令0x40表示接下来发送的是数据。这一点非常关键很多I2C通信异常都是因为控制字节用错导致OLED把数据处理成命令显示乱七八糟。在I2C总线上每个字节发送完后接收方需要在第9个时钟周期拉低SDA作为应答信号。软件模拟I2C时如果MCU引脚配置为推挽输出在第9个时钟必须把SDA切换成输入模式释放总线否则会和从机的应答信号产生冲突。这个细节下面代码里也会体现。3.4 字模取模的本质OLED显示字符或汉字本质是把文字的点阵数据逐列写入显存。取模软件做的就是这件事把图形或字符转换为字节数组。以8x16字符为例每个字符占16字节前8字节对应字符上半部分的8列后8字节对应下半部分的8列。取模方向非常关键。PCtoLCD2002这类软件不同的设置输出来的数据排列完全不同。常见的选择是纵向取模、字节正序、行前序。如果取模方向和显示代码不匹配最典型的表现是字符左右镜像或者上下颠倒。我在实际项目中吃过这个亏所以代码里会明确标注取模参数。4. 实操过程Proteus工程搭建与仿真运行4.1 新建工程文件打开Proteus在首页选择新建工程输入工程名称比如STM32_OLED_Demo选择保存路径。路径中尽量不要有中文字符和空格否则某些版本的VSM仿真器在加载HEX文件时可能出问题。工程类型选择Schematic Design不需要生成PCB Layout。如果你不想让Proteus自动创建一大堆文件夹可以在新建时取消相关选项用单文件工程就够用了。新版本的Proteus会询问是否创建PCB这里直接跳过仿真项目用不到。新建完成后进入原理图编辑界面把默认的图纸尺寸调整到合适大小然后准备添加元件。4.2 放置核心元件在Proteus左侧工具栏点击Component Mode图标再点击Pick from Libraries按钮或者直接按快捷键P打开元件搜索库。第一个要搜的是STM32F103C8T6。输入关键字后在Microprocessor libraries下能找到对应的模型。选中后放到原理图中央。第二个搜OLED不同版本的Proteus里OLED模型的命名不完全一样有的叫OLED_096有的叫OLED_I2C还有的叫SSD1306搜索到带SCL、SDA引脚的0.96寸单色屏就是它注意看引脚定义不要选成SPI接口的型号。此外如果OLED模型带有RES引脚把RES接到VCC高电平即可如果带有DC引脚在I2C模式下把它接GND或VCC都行因为I2C的控制字节已经区分了命令和数据DC引脚不参与控制。4.3 元件布局与连线先把STM32F103C8T6放在原理图中心OLED放在右侧这样供电线和信号线走起来更清晰。STM32的供电必须接全。VDD和VDDA接3.3VVSS和VSSA接GND。Proteus中的STM32模型如果有些电源引脚没接仿真时会直接报错或有未知行为。Boot0引脚接GND让它从Flash启动。NRST引脚建议通过一个10K电阻上拉到3.3V虽然仿真环境不一定严格要求但这样更接近真实电路。OLED的接线非常简单VCC接3.3VGND接GNDSCL接STM32的PB6SDA接PB7。这里选PB6和PB7是因为它们恰好是STM32的I2C1引脚以后如果你想切换到硬件I2C不用改版。连线完成后建议在两根信号线上各放一个标注用的网络标签比如SCL、SDA这样原理图看起来很规范后续排查也方便。4.4 Keil工程编译并生成HEX文件确认Keil中的工程没有问题后先执行编译。编译完成后到工程的Output目录下找STM32_OLED_Demo.hex文件。如果找不到先检查Options for Target里的Output选项卡有没有勾选Create HEX File。然后回到Proteus双击原理图中的STM32芯片在Program File一栏点击文件图标选择刚才生成的HEX文件。这里要注意HEX文件的路径不要中文不要移动位置否则VSM仿真器加载时会找不到文件。CLK频率确认设置为8MHz然后把HEX文件加载好点击左下角的运行按钮。如果一切正常OLED屏幕上会出现自动刷新的正弦波和进度条。如果在仿真中没有任何反应下一步就要进入排查环节。4.5 使用虚拟示波器验证I2C时序Proteus里最强大的调试工具就是虚拟示波器。把示波器的CH1接到SCL网络CH2接到SDA网络运行仿真后再点击暂停你就能看到I2C总线的电平变化。正常抓到的波形应该是SCL大概是规律的方波SDA在SCL高电平时保持稳定每个字节传输完成后有一个明显的ACK被拉低过程。如果SDA上没有任何跳变说明MCU根本没执行到I2C发送代码如果SDA波形看起来乱成一团可能是在SCL高电平期间SDA发生了跳变也就是时序不对。虚拟示波器还能用来测量信号频率如果SCL频率远低于预期可能是软件空循环延时过长需要调小delay_us的参数。5. 完整代码实现与逐段解析5.1 代码整体结构工程代码分为三个文件oled.h、oled.c、main.c。oled.h负责对外暴露APIoled.c实现I2C通信和SSD1306驱动main.c编写演示逻辑。由于采用软件I2C代码里不需要调用STM32硬件I2C外设相关的寄存器核心逻辑都是GPIO电平的控制。这种设计的好处是代码几乎可以直接搬到其他MCU上使用只要改一下引脚宏定义和GPIO初始化函数即可。我在代码里维护了一个1024字节的显示缓冲区oledGrap所有画点、画线操作都先修改缓冲区然后再通过OLED_Refresh函数一次性刷新到屏幕。这样既能避免频繁I2C操作导致屏幕闪烁也方便实现更复杂的绘图功能。5.2 引脚定义与延时函数打开oled.h先定义引脚。我这里选用PB6作为SCLPB7作为SDA#ifndef __OLED_H #define __OLED_H #include stm32f10x.h #include string.h #define OLED_SCL_PIN GPIO_Pin_6 #define OLED_SDA_PIN GPIO_Pin_7 #define OLED_PORT GPIOB #define OLED_SCL_H() GPIO_SetBits(OLED_PORT, OLED_SCL_PIN) #define OLED_SCL_L() GPIO_ResetBits(OLED_PORT, OLED_SCL_PIN) #define OLED_SDA_H() GPIO_SetBits(OLED_PORT, OLED_SDA_PIN) #define OLED_SDA_L() GPIO_ResetBits(OLED_PORT, OLED_SDA_PIN) void OLED_Init(void); void OLED_Clear(void); void OLED_ClearBuffer(void); void OLED_Refresh(void); void OLED_SetPixel(uint8_t x, uint8_t y, uint8_t on); void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2); void OLED_DrawRect(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t fill); #endif延时在这里先用简单的for循环。72MHz主频下一个NOP大约14纳秒但for循环的编译优化会改变循环周期所以这个延时函数精度一般。对于软件I2C这种低速通信只要不是给到极端参数都能正常工作。static void delay_us(uint32_t us) { volatile uint32_t i; for (i 0; i us * 8; i) { __NOP(); } } static void delay_ms(uint32_t ms) { volatile uint32_t i; for (i 0; i ms * 7200; i) { __NOP(); } }5.3 软件I2C底层与SDA方向切换这段是整个驱动的核心。在发送数据过程中第9个时钟是应答周期我必须把SDA切换成输入模式避免推挽输出和从机的应答信号打架。static void OLED_SDA_SetMode(uint8_t out) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin OLED_SDA_PIN; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; if (out) GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; else GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; GPIO_Init(OLED_PORT, GPIO_InitStructure); } static void I2C_Start(void) { OLED_SDA_SetMode(1); OLED_SDA_H(); OLED_SCL_H(); delay_us(5); OLED_SDA_L(); delay_us(5); OLED_SCL_L(); } static void I2C_Stop(void) { OLED_SDA_SetMode(1); OLED_SCL_L(); OLED_SDA_L(); OLED_SCL_H(); delay_us(5); OLED_SDA_H(); delay_us(5); } static void I2C_SendByte(uint8_t dat) { uint8_t i; OLED_SDA_SetMode(1); for (i 0; i 8; i) { if (dat 0x80) OLED_SDA_H(); else OLED_SDA_L(); dat 1; OLED_SCL_H(); delay_us(2); OLED_SCL_L(); delay_us(2); } OLED_SDA_SetMode(0); OLED_SCL_H(); delay_us(2); OLED_SCL_L(); OLED_SDA_SetMode(1); }这里要注意OLED_SDA_SetMode(0)配置为内部上拉输入后在第9个时钟的高电平期间如果从机正常应答SDA会被从机拉低呈现一个ACK低电平如果从机不应答SDA保持高电平。我在代码里没有检测ACK而是直接忽略这是为了简化代码。实测中SSD1306在正常通信下都会应答所以不会出问题。5.4 OLED命令写入与初始化序列向OLED写入命令和数据的区别就在于地址字节之后紧跟的控制字节是0x00还是0x40。#define OLED_ADDR 0x78 static void OLED_WriteCmd(uint8_t cmd) { I2C_Start(); I2C_SendByte(OLED_ADDR); I2C_SendByte(0x00); I2C_SendByte(cmd); I2C_Stop(); } static void OLED_WriteData(uint8_t dat) { I2C_Start(); I2C_SendByte(OLED_ADDR); I2C_SendByte(0x40); I2C_SendByte(dat); I2C_Stop(); } static void OLED_SetPos(uint8_t x, uint8_t y) { OLED_WriteCmd(0xB0 y); OLED_WriteCmd(((x 0xF0) 4) | 0x10); OLED_WriteCmd(x 0x0F); }OLED_Init函数里我逐条发送初始化命令每一条的作用我都在注释里标注清楚。特别强调第2条命令0x8D 0x14这一对命令是开启电荷泵漏掉它屏幕就是黑的。void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin OLED_SCL_PIN | OLED_SDA_PIN; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(OLED_PORT, GPIO_InitStructure); delay_ms(100); OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0x20); // 设置内存寻址模式 OLED_WriteCmd(0x02); // 选择页寻址模式 OLED_WriteCmd(0xB0); // 设置页起始地址为0 OLED_WriteCmd(0xC8); // COM扫描方向从上到下 OLED_WriteCmd(0x00); // 设置列地址低4位 OLED_WriteCmd(0x10); // 设置列地址高4位 OLED_WriteCmd(0x40); // 设置起始行 OLED_WriteCmd(0x81); // 设置对比度 OLED_WriteCmd(0x7F); OLED_WriteCmd(0xA1); // 段重映射左右不镜像 OLED_WriteCmd(0xA6); // 正常显示不反色 OLED_WriteCmd(0xA8); // 设置多路复用比 OLED_WriteCmd(0x3F); OLED_WriteCmd(0xA4); // 输出跟随RAM内容 OLED_WriteCmd(0xD3); // 设置显示偏移 OLED_WriteCmd(0x00); OLED_WriteCmd(0xD5); // 设置时钟分频因子 OLED_WriteCmd(0x80); OLED_WriteCmd(0xD9); // 设置预充电周期 OLED_WriteCmd(0xF1); OLED_WriteCmd(0xDA); // 设置COM引脚硬件配置 OLED_WriteCmd(0x12); OLED_WriteCmd(0xDB); // 设置VCOMH电压 OLED_WriteCmd(0x40); OLED_WriteCmd(0x8D); // 设置电荷泵 OLED_WriteCmd(0x14); // 开启电荷泵这里漏了屏幕不亮 OLED_WriteCmd(0xAF); // 开启显示 OLED_Refresh(); }5.5 缓冲区的操作清屏、画点、画线我维护了一个1024字节的缓冲区oledGrap映射关系和SSD1306的显存一致。static uint8_t oledGrap[128 * 64 / 8]; void OLED_ClearBuffer(void) { memset(oledGrap, 0x00, sizeof(oledGrap)); } void OLED_Clear(void) { OLED_ClearBuffer(); OLED_Refresh(); } void OLED_SetPixel(uint8_t x, uint8_t y, uint8_t on) { uint8_t page; if (x 128 || y 64) return; page y / 8; if (on) oledGrap[x page * 128] | (0x01 (y % 8)); else oledGrap[x page * 128] ~(0x01 (y % 8)); } void OLED_Refresh(void) { uint8_t page, col; for (page 0; page 8; page) { OLED_SetPos(0, page); for (col 0; col 128; col) OLED_WriteData(oledGrap[col page * 128]); } }OLED_SetPixel是画点函数OLED_DrawRect和OLED_DrawLine在这基础上实现。完整代码里我用了一个简单的Bresenham直线算法画出的线在低分辨率OLED上效果足够平滑void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2) { int dx (x2 x1) ? (x2 - x1) : (x1 - x2); int dy (y2 y1) ? (y2 - y1) : (y1 - y2); int sx (x1 x2) ? 1 : -1; int sy (y1 y2) ? 1 : -1; int err (dx dy ? dx : -dy) / 2; int curErr; for (;;) { OLED_SetPixel(x1, y1, 1); if (x1 x2 y1 y2) break; curErr err; if (curErr -dx) { err - dy; x1 sx; } if (curErr dy) { err dx; y1 sy; } } } void OLED_DrawRect(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t fill) { uint8_t x, y; if (fill) { for (y y1; y y2; y) OLED_DrawLine(x1, y, x2, y); } else { OLED_DrawLine(x1, y1, x2, y1); OLED_DrawLine(x1, y2, x2, y2); OLED_DrawLine(x1, y1, x1, y2); OLED_DrawLine(x2, y1, x2, y2); } }5.6 文字显示的扩展思路上面的代码已经能画点和线条但如果要显示字符串还需要字模数组。完整的ASCII 8x16字模表有96个字符数据量比较大通常放在oledfont.h文件里单独维护网上有很多现成版本可以直接下载。这里给出文字显示的实现框架void OLED_ShowChar(uint8_t x, uint8_t y, char ch) { uint8_t i; const uint8_t *p; // F8x16数组需要从外部字模文件中引入顺序为ASCII码从空格开始 p F8x16[(ch - ) * 16]; OLED_SetPos(x, y); for (i 0; i 8; i) OLED_WriteData(p[i]); OLED_SetPos(x, y 1); for (i 0; i 8; i) OLED_WriteData(p[i 8]); } void OLED_ShowString(uint8_t x, uint8_t y, char *str) { while (*str ! \0) { OLED_ShowChar(x, y, *str); x 8; if (x 120) { x 0; y 2; } str; } }使用字模软件时取模参数选择纵向取模、字节正序、行前序生成的数据就能直接用在F8x16数组里。如果你只需要显示固定的几个字符也可以只生成这几个字符的字模减小Flash占用。5.7 main.c完整演示程序main函数里我用画线的方式实现一个动态正弦波和一个进度条不需要字模下载后就能直接看到效果。这里还加了一个简单的count计数器让进度条周期性变化#include stm32f10x.h #include oled.h #include math.h static void delay_ms(uint32_t ms) { volatile uint32_t i; for (i 0; i ms * 7200; i) { __NOP(); } } int main(void) { uint16_t count 0; uint8_t x, i; uint8_t progress; uint8_t y1, y2; OLED_Init(); OLED_Clear(); while (1) { OLED_ClearBuffer(); OLED_DrawRect(0, 0, 127, 63, 0); for (x 1; x 127; x) { y1 32 (uint8_t)(20 * sin((x - 1) * 2 * 3.14159 / 64)); y2 32 (uint8_t)(20 * sin(x * 2 * 3.14159 / 64)); OLED_DrawLine(x - 1, y1, x, y2); } progress (count / 50) % 100; OLED_DrawRect(20, 50, 108, 57, 1); for (i 0; i 86 * progress / 100; i) OLED_DrawLine(21 i, 51, 21 i, 56); OLED_Refresh(); count; delay_ms(100); } }从代码里可以看到每次刷新全屏需要写1024个数据字节加上I2C地址帧和控制帧一帧大概需要1100个I2C周期。按照软件I2C的工作频率刷新一帧的时间大约在几十毫秒这个速度对动态波形来说已经够用了。6. 常见问题与排查技巧实录6.1 OLED全黑的排查顺序如果仿真运行时OLED没有任何显示别急着怀疑代码。先看电源OLED的VCC和STM32的VDD是否都接到3.3VGND是否有公共地。Proteus里如果只改了网络标签但忘了连GND会导致I2C信号完全没有回流路径。然后检查初始化序列里有没有0x8D 0x14这条开启电荷泵的命令。这是OLED不亮的第一大原因。接着检查I2C器件地址。我这里用了0x78对应SSD1306的7位地址0x3C。如果你的Proteus模型或实物模块地址是0x3D那要把OLED_ADDR改成0x7A。最后在Keil里确认程序正常编译到main函数。可以在startup文件或者main开头设一个断点运行仿真后看PC指针是否停在断点处。如果根本没进main问题就在启动文件或者HEX文件加载上。6.2 如何确认I2C总线在正常工作在Proteus中调试I2C问题最好的办法是抓波形。运行仿真打开虚拟示波器把CH1接SCLCH2接SDA设置合适的时基观察波形。正常波形应该满足几个特征总线上有周期性的活动SCL是干净的数字方波SDA只在SCL低电平时跳变。如果SDA在SCL高电平时跳变说明起始条件或停止条件位置不对重点检查I2C_Start和I2C_Stop函数的先后顺序。还有一种情况是SDA一直保持低电平。这通常是因为某个字节发送后MCU没有把SDA从推挽输出切换成输入模式从机拉低的应答信号无法释放总线导致整个总线卡死在ACK周期。检查I2C_SendByte里有没有在最后把SDA设置为输入模式。6.3 显示内容镜像、颠倒、乱码如果屏幕上能显示内容但方向不对问题基本出在初始化命令的0xA1和0xC8两条上。0xA1是段重映射决定水平方向是否左右镜像0xC8是COM扫描方向决定垂直方向是否上下颠倒。把这两个参数互换就能改变显示方向。乱码则通常是因为控制字节用错。当你发送数据时用了0x00SSD1306会把数据当作命令执行结果屏幕出现一堆看不懂的线条和方块。检查一下OLED_WriteData函数里的控制字节是不是0x40。如果你在初始化时设置了反色显示命令0xA7那么整个屏幕的黑白会反过来这也是显示异常的一种常见原因排查时可以留意。6.4 仿真速度异常或定时不准Proteus在仿真时会尽量模拟真实时间但复杂工程下运行速度可能变慢。如果正弦波和进度条的刷新速度明显偏慢可以在Debug菜单里调高仿真速度或者把DSP、示波器这类虚拟仪器关闭。软件延时函数受编译优化影响很大。如果Keil优化等级开到了-O2或更高for空循环可能被优化掉一部分导致延时大幅缩短。我的建议是优化等级控制在缺省或-O1以内必要的时候用volatile修饰循环变量防止编译器把延时循环优化掉。如果换了主频也要同步修改delay_ms里的7200这个常量。它的计算思路是72MHz主频下一次for循环大概10个周期1毫秒就是72000除以10等于7200。这个值是经验值实际会有偏差但对I2C时序来说足够。6.5 从Proteus转到实物前的三个检查仿真跑通只是第一步真正做实物之前有几个点必须检查到位。第一确认OLED模块工作在I2C模式很多模块背面有电阻焊盘可以选择I2C或SPI模式出厂一般默认I2C但还是要看一眼。第二实物接线上SCL、SDA不要接反不少模块上丝印不清晰最好用万用表蜂鸣档顺着排针量一遍。第三实物建议在SDA和SCL上各加一个4.7K上拉电阻到VCC有些模块板子上已经有上拉如果已经有了就不用再加。另外实物的I2C时序对延时更敏感。Proteus里用2微秒延时能跑通实物可能因为线材寄生电容导致信号边沿变缓适当增加延时参数往往能解决问题。做嵌入式这些年我的体会是仿真和实物是两条腿走路谁也不能替代谁。Proteus能帮你把逻辑层面的问题快速暴露出来但到了实物阶段电源纹波、信号完整性、芯片个体差异这些真实世界的干扰才会浮现。先仿真后实物不是逃避硬件而是把精力集中在真正需要解决的部分。希望这篇文章能让你少踩几个我踩过的坑如果你在操作中遇到别的奇怪问题也欢迎按照文中的排查思路自己动手试试。
Proteus仿真+STM32驱动OLED显示：软I2C从零到跑通
做过单片机开发的都知道硬件调试有多磨人。我以前带过几个新手最夸张的一次有人把0.96寸OLED的VCC和GND接反屏幕当场报废一排引脚全烧黑。这种事碰多了我现在但凡要验证一个新的显示方案或者I2C时序都会先打开Proteus仿真软件把逻辑跑通再动实物。今天这篇博文我就用Proteus仿真 STM32F103C8T6 OLED显示这个经典组合完整演示一遍从建工程、搭原理图、写代码到仿真调试的全过程。全程不需要硬件适合刚入手STM32的同学也适合想快速验证驱动逻辑的工程师。代码我会给全照着敲就能跑。1. 项目整体设计与思路拆解1.1 为什么我会选择先在Proteus里跑通再碰实物很多人觉得Proteus仿真只是学生玩具实际做项目用不上这个看法其实偏了。Proteus的价值不在于替代真实的硬件验证而在于把成本最低、迭代最快的一轮调试前置到上电之前。一个OLED模块加一块最小系统板虽然单价不高但反复插拔、接线错误、引脚冲突累积起来的时间和损耗一点也不少。更关键的是Proteus里能直接挂虚拟示波器、逻辑分析仪、I2C调试器这些在实物环境里要么得额外买设备要么就得靠LED点灯慢慢猜。我在Proteus里看SCL、SDA的波形一眼就能判断是时序问题还是地址问题定位速度比实物快一个量级。当然仿真不是万能的。Proteus里的SSD1306模型是行为级仿真它对时序的宽容度比真实芯片高。这意味着你在仿真里能跑通的代码拿到实物上可能还需要微调延时。但反过来如果仿真里都跑不通实物基本没戏。所以这个流程的核心是先用仿真把逻辑彻底理顺再上实物做最终验证。1.2 为什么选STM32F103C8T6这颗芯片STM32F103C8T6是ST的经典Cortex-M3芯片48引脚64KB Flash20KB RAM主频最高72MHz。这颗芯片在入门市场上几乎是统治级的存在网上教程多到看不完资料好找工具链成熟。另外它有两个I2C外设、三个USART、一个SPI对OLED这类显示外设来说资源完全过剩。C8T6的国产替代型号也很多很多在引脚和软件层面可以直接替换程序基本不用改这让它在未来的批量项目里也有不错的延续性。要提醒一点C8T6的Flash只有64KB如果使用标准库加HAL库混用工程会显得臃肿但驱动OLED这种小型项目完全没压力。真正需要注意的是一些国产型号在Proteus中和ST原厂模型行为略有差异所以本文统一用ST原厂模型来做仿真。1.3 显示方案对比OLED凭什么胜出写显示驱动可选方案很多。我把最常见的几种拉出来对比一下显示方案接口方式优点缺点适合场景LCD1602并口 / I2C(PCF8574)便宜、资料极多字符型不能显示图形和汉字需要多根线只显示简单字符的场合OLED 0.96寸I2C / SPI两线驱动I2C、自发光、对比度高、可显示中文和图形屏幕小、刷新全屏时速度一般小型仪表、桌面摆件、设备状态屏TFT彩屏SPI / 并口彩色、分辨率高、界面表现力强接口多、占用资源大、Proteus模型少复杂人机界面从Proteus仿真角度看LCD1602在Proteus里仿真效果其实也不错但它只能显示字符可玩性有限。TFT彩屏在Proteus里的模型不算丰富很多封装需要自己找对新手不友好。OLED的模型在Proteus 8.13以上版本已经比较成熟搜索OLED就能找到基于SSD1306的0.96寸模块引脚只有VCC、GND、SCL、SDA连起来非常省心。从实际效果看OLED全黑背景上显示亮色字符或图形视觉冲击力比LCD强太多。而且SSD1306控制器的驱动逻辑很有代表性搞懂它之后再去看其他I2C传感器或屏幕基本是举一反三。1.4 通讯接口选型为什么用软I2C而不是硬件I2COLED 0.96寸模块有两种常见接口SPI和I2C。SPI速度更快但需要四根信号线在Proteus里连线麻烦。I2C只需要SCL和SDA两根线逻辑也直观所以我选I2C。但这里有个更关键的选型我用的是软件模拟I2C不是STM32的硬件I2C外设。原因有三。第一标准库的硬件I2C存在事件标志处理繁琐、总线错误恢复麻烦的问题新手经常卡在EV5、EV6这些状态标志上半天调不通。第二软件I2C把时钟线、数据线的每一个电平变化都放在明面上初学者看代码就能理解I2C时序的本质。第三软件I2C不绑定特定引脚以后换芯片、改引脚分配只需要改几个宏定义就行移植成本很低。在Proteus中仿真时两种方式都能用但软件I2C在时序上完全由代码控制排查问题更直观。所以本文的代码统一采用GPIO模拟I2C方案。2. 开发环境准备与工具链搭建2.1 需要的软件清单和版本建议在开始操作之前先把工具备齐。我的使用习惯如下软件版本建议用途Proteus8.13及以上原理图设计、VSM仿真、虚拟仪器Keil MDK5.x代码编辑、编译、生成HEX文件STM32标准外设库V3.5提供寄存器封装和启动文件字模软件PCtoLCD2002生成中英文字符点阵数据Proteus的安装很简单一路Next就行但有几个坑要注意。安装路径不要带中文否则部分老版本会出莫名其妙的问题。新版Proteus打开后会自动加载内置示例工程如果你只是想新建一个干净的工程直接在首页选择新建空白设计即可。关于汉化我的建议是能不用就不用。Proteus的英文界面术语不算复杂而且很多报错信息在网上搜到的都是英文原文汉化包反而容易引入不稳定因素。如果从没接触过Proteus花半小时熟悉一下英文界面后面收益很大。2.2 Keil MDK工程配置要点Keil MDK的安装这里不细说重点讲工程配置。新建工程时器件选择STM32F103C8T6编译器会提示是否需要添加启动文件选择是然后手动添加标准库V3.5的核心文件。在Options for Target里Output选项卡勾选Create HEX File这是生成HEX文件的开关很多人程序写完了却找不到HEX就是因为这里没勾。在C/C选项卡里需要在Define栏填写两行宏STM32F10X_MD和USE_STDPERIPH_DRIVER。前者告诉标准库当前芯片是中等容量型号后者启用外设驱动库。启动文件选择startup_stm32f10x_md.s这个文件在标准库的CMSIS目录下能找到。启动文件的作用是配置堆栈、设置中断向量表、调用SystemInit完成时钟初始化然后再跳转到main函数。如果不添加这个文件程序编译再正确也跑不起来。2.3 标准库和HAL库怎么选目前STM32的新开发方式大多是STM32CubeMX加HAL库但本文我还是用标准库V3.5。原因很简单标准库的函数风格接近寄存器操作一个GPIO_Init结构体里模式、速度、引脚一目了然非常适合理解底层原理。HAL库为了兼容全系列芯片做了很多抽象层代码量明显偏大对新手反而增加理解成本。如果你已经在用CubeMX拖拽生成代码那换成HAL库也能实现同样的功能。但需要注意HAL库的I2C在部分版本的默认实现里有超时机制仿真环境下如果响应不及时可能报HAL_BUSY解决办法是调整超时时间或改用阻塞模式。本文后面的代码基于标准库逻辑上更简单直接。2.4 Proteus中STM32的时钟设置细节这个细节很容易被忽略。在Proteus里双击STM32F103C8T6芯片弹出的属性对话框中有一项Crystal Frequency或Clock Frequency默认是8MHz。这个值对应的是外部晶振频率代码里的SystemInit会把系统时钟倍频到72MHz。实际仿真时只要这个频率设置合理代码里的软件延时就能基本对应上。如果发现OLED刷新速度和你预期差很多先检查这个频率有没有被改乱。另外Proteus的仿真速度是可以调的如果感觉系统运行太慢或太快在Debug菜单里可以设置运行速度档位。3. 核心原理拆解SSD1306与I2C通信3.1 SSD1306控制器的显存结构OLED 0.96寸屏幕的驱动芯片通常是SSD1306它内部有一块128x64位的显存也就是说有128列、64行总共有128*64/81024字节。SSD1306把这64行划分成了8个页每页8行。在页寻址模式下写入操作按页进行。我们可以把显存想象成这样一个布局横向128个点是一行纵向每8个点组成一页。当你往一页中的某一列写一个字节时这个字节的8个位分别对应这页内的8行像素位为1就亮为0就灭。理解了这个映射关系就能解释为什么显示代码里总是出现0xB0到0xB7这几个命令它们就是在选择要写的页面。SSD1306支持三种寻址模式页寻址、水平寻址、垂直寻址。最常用的是页寻址因为操作简单先指定页面再指定列地址然后连续写入数据列地址会自动递增。虽然水平寻址在某些应用里刷新效率更高但对入门项目来说页寻址已经够用。3.2 OLED上电必须开启电荷泵SSD1306的驱动方式有点特殊它需要内部电荷泵产生一个比电源更高的电压才能驱动OLED像素发光。如果初始化序列里没有开启电荷泵屏幕就会表现为全黑但单片机明明在正常发送命令。电荷泵的开关由命令0x8D控制后面跟的参数0x14是开0x10是关。不少初学者写了初始化代码屏幕死活不亮排查半天结果就是漏了这条命令。我在下面的代码里会把它放在初始化序列中并且特意加注释。如果你用的是某些精简版驱动务必检查一下有没有这一条。3.3 I2C协议的极简拆解I2C总线上的通信本质就三件事起始条件、停止条件、字节传输。起始条件是SCL为高电平时SDA从高拉低停止条件是SCL为高电平时SDA从低拉高。数据传输时SDA在SCL高电平期间必须保持稳定在SCL低电平期间才能变化。SSD1306作为I2C从设备7位地址通常是0x3C换算成8位写地址就是0x78。发送字节时地址字节后面紧跟一个控制字节0x00表示接下来发送的是命令0x40表示接下来发送的是数据。这一点非常关键很多I2C通信异常都是因为控制字节用错导致OLED把数据处理成命令显示乱七八糟。在I2C总线上每个字节发送完后接收方需要在第9个时钟周期拉低SDA作为应答信号。软件模拟I2C时如果MCU引脚配置为推挽输出在第9个时钟必须把SDA切换成输入模式释放总线否则会和从机的应答信号产生冲突。这个细节下面代码里也会体现。3.4 字模取模的本质OLED显示字符或汉字本质是把文字的点阵数据逐列写入显存。取模软件做的就是这件事把图形或字符转换为字节数组。以8x16字符为例每个字符占16字节前8字节对应字符上半部分的8列后8字节对应下半部分的8列。取模方向非常关键。PCtoLCD2002这类软件不同的设置输出来的数据排列完全不同。常见的选择是纵向取模、字节正序、行前序。如果取模方向和显示代码不匹配最典型的表现是字符左右镜像或者上下颠倒。我在实际项目中吃过这个亏所以代码里会明确标注取模参数。4. 实操过程Proteus工程搭建与仿真运行4.1 新建工程文件打开Proteus在首页选择新建工程输入工程名称比如STM32_OLED_Demo选择保存路径。路径中尽量不要有中文字符和空格否则某些版本的VSM仿真器在加载HEX文件时可能出问题。工程类型选择Schematic Design不需要生成PCB Layout。如果你不想让Proteus自动创建一大堆文件夹可以在新建时取消相关选项用单文件工程就够用了。新版本的Proteus会询问是否创建PCB这里直接跳过仿真项目用不到。新建完成后进入原理图编辑界面把默认的图纸尺寸调整到合适大小然后准备添加元件。4.2 放置核心元件在Proteus左侧工具栏点击Component Mode图标再点击Pick from Libraries按钮或者直接按快捷键P打开元件搜索库。第一个要搜的是STM32F103C8T6。输入关键字后在Microprocessor libraries下能找到对应的模型。选中后放到原理图中央。第二个搜OLED不同版本的Proteus里OLED模型的命名不完全一样有的叫OLED_096有的叫OLED_I2C还有的叫SSD1306搜索到带SCL、SDA引脚的0.96寸单色屏就是它注意看引脚定义不要选成SPI接口的型号。此外如果OLED模型带有RES引脚把RES接到VCC高电平即可如果带有DC引脚在I2C模式下把它接GND或VCC都行因为I2C的控制字节已经区分了命令和数据DC引脚不参与控制。4.3 元件布局与连线先把STM32F103C8T6放在原理图中心OLED放在右侧这样供电线和信号线走起来更清晰。STM32的供电必须接全。VDD和VDDA接3.3VVSS和VSSA接GND。Proteus中的STM32模型如果有些电源引脚没接仿真时会直接报错或有未知行为。Boot0引脚接GND让它从Flash启动。NRST引脚建议通过一个10K电阻上拉到3.3V虽然仿真环境不一定严格要求但这样更接近真实电路。OLED的接线非常简单VCC接3.3VGND接GNDSCL接STM32的PB6SDA接PB7。这里选PB6和PB7是因为它们恰好是STM32的I2C1引脚以后如果你想切换到硬件I2C不用改版。连线完成后建议在两根信号线上各放一个标注用的网络标签比如SCL、SDA这样原理图看起来很规范后续排查也方便。4.4 Keil工程编译并生成HEX文件确认Keil中的工程没有问题后先执行编译。编译完成后到工程的Output目录下找STM32_OLED_Demo.hex文件。如果找不到先检查Options for Target里的Output选项卡有没有勾选Create HEX File。然后回到Proteus双击原理图中的STM32芯片在Program File一栏点击文件图标选择刚才生成的HEX文件。这里要注意HEX文件的路径不要中文不要移动位置否则VSM仿真器加载时会找不到文件。CLK频率确认设置为8MHz然后把HEX文件加载好点击左下角的运行按钮。如果一切正常OLED屏幕上会出现自动刷新的正弦波和进度条。如果在仿真中没有任何反应下一步就要进入排查环节。4.5 使用虚拟示波器验证I2C时序Proteus里最强大的调试工具就是虚拟示波器。把示波器的CH1接到SCL网络CH2接到SDA网络运行仿真后再点击暂停你就能看到I2C总线的电平变化。正常抓到的波形应该是SCL大概是规律的方波SDA在SCL高电平时保持稳定每个字节传输完成后有一个明显的ACK被拉低过程。如果SDA上没有任何跳变说明MCU根本没执行到I2C发送代码如果SDA波形看起来乱成一团可能是在SCL高电平期间SDA发生了跳变也就是时序不对。虚拟示波器还能用来测量信号频率如果SCL频率远低于预期可能是软件空循环延时过长需要调小delay_us的参数。5. 完整代码实现与逐段解析5.1 代码整体结构工程代码分为三个文件oled.h、oled.c、main.c。oled.h负责对外暴露APIoled.c实现I2C通信和SSD1306驱动main.c编写演示逻辑。由于采用软件I2C代码里不需要调用STM32硬件I2C外设相关的寄存器核心逻辑都是GPIO电平的控制。这种设计的好处是代码几乎可以直接搬到其他MCU上使用只要改一下引脚宏定义和GPIO初始化函数即可。我在代码里维护了一个1024字节的显示缓冲区oledGrap所有画点、画线操作都先修改缓冲区然后再通过OLED_Refresh函数一次性刷新到屏幕。这样既能避免频繁I2C操作导致屏幕闪烁也方便实现更复杂的绘图功能。5.2 引脚定义与延时函数打开oled.h先定义引脚。我这里选用PB6作为SCLPB7作为SDA#ifndef __OLED_H #define __OLED_H #include stm32f10x.h #include string.h #define OLED_SCL_PIN GPIO_Pin_6 #define OLED_SDA_PIN GPIO_Pin_7 #define OLED_PORT GPIOB #define OLED_SCL_H() GPIO_SetBits(OLED_PORT, OLED_SCL_PIN) #define OLED_SCL_L() GPIO_ResetBits(OLED_PORT, OLED_SCL_PIN) #define OLED_SDA_H() GPIO_SetBits(OLED_PORT, OLED_SDA_PIN) #define OLED_SDA_L() GPIO_ResetBits(OLED_PORT, OLED_SDA_PIN) void OLED_Init(void); void OLED_Clear(void); void OLED_ClearBuffer(void); void OLED_Refresh(void); void OLED_SetPixel(uint8_t x, uint8_t y, uint8_t on); void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2); void OLED_DrawRect(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t fill); #endif延时在这里先用简单的for循环。72MHz主频下一个NOP大约14纳秒但for循环的编译优化会改变循环周期所以这个延时函数精度一般。对于软件I2C这种低速通信只要不是给到极端参数都能正常工作。static void delay_us(uint32_t us) { volatile uint32_t i; for (i 0; i us * 8; i) { __NOP(); } } static void delay_ms(uint32_t ms) { volatile uint32_t i; for (i 0; i ms * 7200; i) { __NOP(); } }5.3 软件I2C底层与SDA方向切换这段是整个驱动的核心。在发送数据过程中第9个时钟是应答周期我必须把SDA切换成输入模式避免推挽输出和从机的应答信号打架。static void OLED_SDA_SetMode(uint8_t out) { GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin OLED_SDA_PIN; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; if (out) GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; else GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; GPIO_Init(OLED_PORT, GPIO_InitStructure); } static void I2C_Start(void) { OLED_SDA_SetMode(1); OLED_SDA_H(); OLED_SCL_H(); delay_us(5); OLED_SDA_L(); delay_us(5); OLED_SCL_L(); } static void I2C_Stop(void) { OLED_SDA_SetMode(1); OLED_SCL_L(); OLED_SDA_L(); OLED_SCL_H(); delay_us(5); OLED_SDA_H(); delay_us(5); } static void I2C_SendByte(uint8_t dat) { uint8_t i; OLED_SDA_SetMode(1); for (i 0; i 8; i) { if (dat 0x80) OLED_SDA_H(); else OLED_SDA_L(); dat 1; OLED_SCL_H(); delay_us(2); OLED_SCL_L(); delay_us(2); } OLED_SDA_SetMode(0); OLED_SCL_H(); delay_us(2); OLED_SCL_L(); OLED_SDA_SetMode(1); }这里要注意OLED_SDA_SetMode(0)配置为内部上拉输入后在第9个时钟的高电平期间如果从机正常应答SDA会被从机拉低呈现一个ACK低电平如果从机不应答SDA保持高电平。我在代码里没有检测ACK而是直接忽略这是为了简化代码。实测中SSD1306在正常通信下都会应答所以不会出问题。5.4 OLED命令写入与初始化序列向OLED写入命令和数据的区别就在于地址字节之后紧跟的控制字节是0x00还是0x40。#define OLED_ADDR 0x78 static void OLED_WriteCmd(uint8_t cmd) { I2C_Start(); I2C_SendByte(OLED_ADDR); I2C_SendByte(0x00); I2C_SendByte(cmd); I2C_Stop(); } static void OLED_WriteData(uint8_t dat) { I2C_Start(); I2C_SendByte(OLED_ADDR); I2C_SendByte(0x40); I2C_SendByte(dat); I2C_Stop(); } static void OLED_SetPos(uint8_t x, uint8_t y) { OLED_WriteCmd(0xB0 y); OLED_WriteCmd(((x 0xF0) 4) | 0x10); OLED_WriteCmd(x 0x0F); }OLED_Init函数里我逐条发送初始化命令每一条的作用我都在注释里标注清楚。特别强调第2条命令0x8D 0x14这一对命令是开启电荷泵漏掉它屏幕就是黑的。void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin OLED_SCL_PIN | OLED_SDA_PIN; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_Init(OLED_PORT, GPIO_InitStructure); delay_ms(100); OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0x20); // 设置内存寻址模式 OLED_WriteCmd(0x02); // 选择页寻址模式 OLED_WriteCmd(0xB0); // 设置页起始地址为0 OLED_WriteCmd(0xC8); // COM扫描方向从上到下 OLED_WriteCmd(0x00); // 设置列地址低4位 OLED_WriteCmd(0x10); // 设置列地址高4位 OLED_WriteCmd(0x40); // 设置起始行 OLED_WriteCmd(0x81); // 设置对比度 OLED_WriteCmd(0x7F); OLED_WriteCmd(0xA1); // 段重映射左右不镜像 OLED_WriteCmd(0xA6); // 正常显示不反色 OLED_WriteCmd(0xA8); // 设置多路复用比 OLED_WriteCmd(0x3F); OLED_WriteCmd(0xA4); // 输出跟随RAM内容 OLED_WriteCmd(0xD3); // 设置显示偏移 OLED_WriteCmd(0x00); OLED_WriteCmd(0xD5); // 设置时钟分频因子 OLED_WriteCmd(0x80); OLED_WriteCmd(0xD9); // 设置预充电周期 OLED_WriteCmd(0xF1); OLED_WriteCmd(0xDA); // 设置COM引脚硬件配置 OLED_WriteCmd(0x12); OLED_WriteCmd(0xDB); // 设置VCOMH电压 OLED_WriteCmd(0x40); OLED_WriteCmd(0x8D); // 设置电荷泵 OLED_WriteCmd(0x14); // 开启电荷泵这里漏了屏幕不亮 OLED_WriteCmd(0xAF); // 开启显示 OLED_Refresh(); }5.5 缓冲区的操作清屏、画点、画线我维护了一个1024字节的缓冲区oledGrap映射关系和SSD1306的显存一致。static uint8_t oledGrap[128 * 64 / 8]; void OLED_ClearBuffer(void) { memset(oledGrap, 0x00, sizeof(oledGrap)); } void OLED_Clear(void) { OLED_ClearBuffer(); OLED_Refresh(); } void OLED_SetPixel(uint8_t x, uint8_t y, uint8_t on) { uint8_t page; if (x 128 || y 64) return; page y / 8; if (on) oledGrap[x page * 128] | (0x01 (y % 8)); else oledGrap[x page * 128] ~(0x01 (y % 8)); } void OLED_Refresh(void) { uint8_t page, col; for (page 0; page 8; page) { OLED_SetPos(0, page); for (col 0; col 128; col) OLED_WriteData(oledGrap[col page * 128]); } }OLED_SetPixel是画点函数OLED_DrawRect和OLED_DrawLine在这基础上实现。完整代码里我用了一个简单的Bresenham直线算法画出的线在低分辨率OLED上效果足够平滑void OLED_DrawLine(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2) { int dx (x2 x1) ? (x2 - x1) : (x1 - x2); int dy (y2 y1) ? (y2 - y1) : (y1 - y2); int sx (x1 x2) ? 1 : -1; int sy (y1 y2) ? 1 : -1; int err (dx dy ? dx : -dy) / 2; int curErr; for (;;) { OLED_SetPixel(x1, y1, 1); if (x1 x2 y1 y2) break; curErr err; if (curErr -dx) { err - dy; x1 sx; } if (curErr dy) { err dx; y1 sy; } } } void OLED_DrawRect(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2, uint8_t fill) { uint8_t x, y; if (fill) { for (y y1; y y2; y) OLED_DrawLine(x1, y, x2, y); } else { OLED_DrawLine(x1, y1, x2, y1); OLED_DrawLine(x1, y2, x2, y2); OLED_DrawLine(x1, y1, x1, y2); OLED_DrawLine(x2, y1, x2, y2); } }5.6 文字显示的扩展思路上面的代码已经能画点和线条但如果要显示字符串还需要字模数组。完整的ASCII 8x16字模表有96个字符数据量比较大通常放在oledfont.h文件里单独维护网上有很多现成版本可以直接下载。这里给出文字显示的实现框架void OLED_ShowChar(uint8_t x, uint8_t y, char ch) { uint8_t i; const uint8_t *p; // F8x16数组需要从外部字模文件中引入顺序为ASCII码从空格开始 p F8x16[(ch - ) * 16]; OLED_SetPos(x, y); for (i 0; i 8; i) OLED_WriteData(p[i]); OLED_SetPos(x, y 1); for (i 0; i 8; i) OLED_WriteData(p[i 8]); } void OLED_ShowString(uint8_t x, uint8_t y, char *str) { while (*str ! \0) { OLED_ShowChar(x, y, *str); x 8; if (x 120) { x 0; y 2; } str; } }使用字模软件时取模参数选择纵向取模、字节正序、行前序生成的数据就能直接用在F8x16数组里。如果你只需要显示固定的几个字符也可以只生成这几个字符的字模减小Flash占用。5.7 main.c完整演示程序main函数里我用画线的方式实现一个动态正弦波和一个进度条不需要字模下载后就能直接看到效果。这里还加了一个简单的count计数器让进度条周期性变化#include stm32f10x.h #include oled.h #include math.h static void delay_ms(uint32_t ms) { volatile uint32_t i; for (i 0; i ms * 7200; i) { __NOP(); } } int main(void) { uint16_t count 0; uint8_t x, i; uint8_t progress; uint8_t y1, y2; OLED_Init(); OLED_Clear(); while (1) { OLED_ClearBuffer(); OLED_DrawRect(0, 0, 127, 63, 0); for (x 1; x 127; x) { y1 32 (uint8_t)(20 * sin((x - 1) * 2 * 3.14159 / 64)); y2 32 (uint8_t)(20 * sin(x * 2 * 3.14159 / 64)); OLED_DrawLine(x - 1, y1, x, y2); } progress (count / 50) % 100; OLED_DrawRect(20, 50, 108, 57, 1); for (i 0; i 86 * progress / 100; i) OLED_DrawLine(21 i, 51, 21 i, 56); OLED_Refresh(); count; delay_ms(100); } }从代码里可以看到每次刷新全屏需要写1024个数据字节加上I2C地址帧和控制帧一帧大概需要1100个I2C周期。按照软件I2C的工作频率刷新一帧的时间大约在几十毫秒这个速度对动态波形来说已经够用了。6. 常见问题与排查技巧实录6.1 OLED全黑的排查顺序如果仿真运行时OLED没有任何显示别急着怀疑代码。先看电源OLED的VCC和STM32的VDD是否都接到3.3VGND是否有公共地。Proteus里如果只改了网络标签但忘了连GND会导致I2C信号完全没有回流路径。然后检查初始化序列里有没有0x8D 0x14这条开启电荷泵的命令。这是OLED不亮的第一大原因。接着检查I2C器件地址。我这里用了0x78对应SSD1306的7位地址0x3C。如果你的Proteus模型或实物模块地址是0x3D那要把OLED_ADDR改成0x7A。最后在Keil里确认程序正常编译到main函数。可以在startup文件或者main开头设一个断点运行仿真后看PC指针是否停在断点处。如果根本没进main问题就在启动文件或者HEX文件加载上。6.2 如何确认I2C总线在正常工作在Proteus中调试I2C问题最好的办法是抓波形。运行仿真打开虚拟示波器把CH1接SCLCH2接SDA设置合适的时基观察波形。正常波形应该满足几个特征总线上有周期性的活动SCL是干净的数字方波SDA只在SCL低电平时跳变。如果SDA在SCL高电平时跳变说明起始条件或停止条件位置不对重点检查I2C_Start和I2C_Stop函数的先后顺序。还有一种情况是SDA一直保持低电平。这通常是因为某个字节发送后MCU没有把SDA从推挽输出切换成输入模式从机拉低的应答信号无法释放总线导致整个总线卡死在ACK周期。检查I2C_SendByte里有没有在最后把SDA设置为输入模式。6.3 显示内容镜像、颠倒、乱码如果屏幕上能显示内容但方向不对问题基本出在初始化命令的0xA1和0xC8两条上。0xA1是段重映射决定水平方向是否左右镜像0xC8是COM扫描方向决定垂直方向是否上下颠倒。把这两个参数互换就能改变显示方向。乱码则通常是因为控制字节用错。当你发送数据时用了0x00SSD1306会把数据当作命令执行结果屏幕出现一堆看不懂的线条和方块。检查一下OLED_WriteData函数里的控制字节是不是0x40。如果你在初始化时设置了反色显示命令0xA7那么整个屏幕的黑白会反过来这也是显示异常的一种常见原因排查时可以留意。6.4 仿真速度异常或定时不准Proteus在仿真时会尽量模拟真实时间但复杂工程下运行速度可能变慢。如果正弦波和进度条的刷新速度明显偏慢可以在Debug菜单里调高仿真速度或者把DSP、示波器这类虚拟仪器关闭。软件延时函数受编译优化影响很大。如果Keil优化等级开到了-O2或更高for空循环可能被优化掉一部分导致延时大幅缩短。我的建议是优化等级控制在缺省或-O1以内必要的时候用volatile修饰循环变量防止编译器把延时循环优化掉。如果换了主频也要同步修改delay_ms里的7200这个常量。它的计算思路是72MHz主频下一次for循环大概10个周期1毫秒就是72000除以10等于7200。这个值是经验值实际会有偏差但对I2C时序来说足够。6.5 从Proteus转到实物前的三个检查仿真跑通只是第一步真正做实物之前有几个点必须检查到位。第一确认OLED模块工作在I2C模式很多模块背面有电阻焊盘可以选择I2C或SPI模式出厂一般默认I2C但还是要看一眼。第二实物接线上SCL、SDA不要接反不少模块上丝印不清晰最好用万用表蜂鸣档顺着排针量一遍。第三实物建议在SDA和SCL上各加一个4.7K上拉电阻到VCC有些模块板子上已经有上拉如果已经有了就不用再加。另外实物的I2C时序对延时更敏感。Proteus里用2微秒延时能跑通实物可能因为线材寄生电容导致信号边沿变缓适当增加延时参数往往能解决问题。做嵌入式这些年我的体会是仿真和实物是两条腿走路谁也不能替代谁。Proteus能帮你把逻辑层面的问题快速暴露出来但到了实物阶段电源纹波、信号完整性、芯片个体差异这些真实世界的干扰才会浮现。先仿真后实物不是逃避硬件而是把精力集中在真正需要解决的部分。希望这篇文章能让你少踩几个我踩过的坑如果你在操作中遇到别的奇怪问题也欢迎按照文中的排查思路自己动手试试。