0.91寸OLED彩屏（SSD1306驱动）基于STM32的IIC接口移植实战

0.91寸OLED彩屏SSD1306驱动基于STM32的IIC接口移植实战最近在做一个需要小型显示界面的项目选来选去发现0.91寸的OLED彩屏是个不错的选择。它尺寸小巧功耗低显示效果又很清晰。不过从网上买回来的模块厂家给的例程往往不能直接在自己的STM32开发板上跑通需要自己动手移植。今天我就以手头这块STM32F103C8T6核心板为例带大家走一遍完整的移植流程把这块0.91寸、SSD1306驱动的彩屏用IIC接口点亮。咱们的目标很明确拿到厂家资料把驱动代码“搬”到自己的工程里修改引脚和时序最后在屏幕上显示出字符。整个过程我会手把手讲解即使你是刚接触嵌入式不久的朋友跟着做也能成功。1. 准备工作认识你的屏幕与获取资料在开始敲代码之前咱们先得把“家伙事儿”备齐并了解要驱动的对象。1.1 屏幕规格与硬件连接我用的这块屏幕关键信息如下你在购买时也可以参考这些参数型号0.91寸OLED彩屏分辨率128 x 32 像素驱动芯片SSD1306这是一款非常常见的OLED驱动IC通信接口IIC也叫I2C工作电压3.3V - 5VSTM32的IO口一般是3.3V直接连接即可接口引脚通常只有4个VCC接3.3V或5VGND接地SCLIIC时钟线SDAIIC数据线硬件连接非常简单用杜邦线把屏幕和开发板对应引脚连起来就行。注意IIC通信需要上拉电阻不过很多模块已经在板上集成好了如果你的模块没有需要在SCL和SDA线上各接一个4.7K-10K的电阻到VCC。1.2 获取原始驱动资料移植的起点是厂家提供的原始代码。我这次使用的模块资料可以通过以下方式获取资料来源于原始文章可供参考资料下载链接https://pan.baidu.com/s/1fKmD5lr4bA0WB54ukonI-A提取码1111下载后你会找到一个压缩包解压后里面应该有一个OLED文件夹这个文件夹里就是最核心的驱动源码oled.c和oled.h以及一些示例。我们的移植工作主要就是围绕这两个文件展开。2. 移植第一步将源码加入你的工程拿到厂家代码后别急着改。第一步是先把它放到你的STM32工程里并解决最基本的编译问题。2.1 文件放置与工程添加在你的STM32工程目录下找一个合适的地方存放外设驱动通常可以放在Drivers、BSP或User文件夹里。我这里按照习惯在工程根目录下新建了一个BSP文件夹。将厂家资料里的整个【OLED】文件夹复制到你刚建好的BSP文件夹里。打开你的IDE比如Keil MDK或STM32CubeIDE在项目管理器中将oled.c文件添加到你的工程组例如User组中。同时记得在IDE的配置里把头文件路径也加上指向你放oled.h的目录即BSP/OLED。2.2 基础适配与宏定义修改厂家的代码为了通用性可能用了自己的类型定义和头文件我们需要把它改成STM32标准库能识别的。首先打开oled.h文件。你可能会发现它包含了sys.h这样的非标准头文件。我们需要将其替换为STM32的标准头文件。找到类似#include “sys.h”的语句将其改为#include stm32f10x.h // 根据你的芯片系列可能是 stm32f1xx.h 等接着厂家代码里可能用u8、u16、u32来定义变量类型。为了兼容性我们可以在oled.h文件的开头在包含头文件之后其他代码之前自己定义一下#ifndef u8 #define u8 uint8_t #endif #ifndef u16 #define u16 uint16_t #endif #ifndef u32 #define u32 uint32_t #endif这样当代码中遇到u8时编译器就知道它指的是uint8_t无符号8位整数依此类推。然后打开oled.c文件。找到包含delay.h的语句将其改为你工程里实际使用的延时头文件。例如如果你的工程里有一个board.h集中管理板级支持或者直接使用delay.h就相应修改。例如#include board.h // 或 #include delay.h做完这几步尝试编译一下工程。可能还会有一些错误但基础的语法和类型错误应该解决了。接下来就是重头戏配置硬件引脚。3. 核心移植配置IIC引脚与时序这块屏幕使用IIC通信厂家提供的驱动是用软件模拟的IIC时序即用两个普通的GPIO口通过程序控制高低电平来模拟SCL时钟和SDA数据线。这种方式非常灵活不占用硬件IIC外设但需要我们正确配置这两个GPIO口。3.1 修改引脚宏定义我们需要告诉程序你把屏幕的SCL和SDA线接到了STM32的哪两个引脚上。假设我连接的是SCL- PA2SDA- PA0打开oled.h文件找到引脚和端口宏定义的地方通常在文件靠后的部分将其修改为你的实际连接//-----------------OLED端口移植---------------- //GND - GND //VCC - 3.3V //SCL - PA2 //SDA - PA0 #define RCC_GPIO RCC_APB2Periph_GPIOA // GPIOA的时钟使能宏 #define PORT_LCD GPIOA // 端口定义为GPIOA //SCL引脚定义 #define GPIO_LCD_SCL GPIO_Pin_2 //SDA引脚定义 #define GPIO_LCD_SDA GPIO_Pin_0注意RCC_APB2Periph_GPIOA是STM32标准库中使能GPIOA端口时钟的宏。如果你用的是HAL库或其他开发方式这里的写法会不同核心思想是“打开对应GPIO端口的时钟”。3.2 修改引脚操作宏同样在oled.h文件中我们需要找到控制引脚高低电平的宏定义。软件IIC就是通过拉高、拉低这些引脚来实现通信的。将其修改为使用我们上面定义的端口和引脚//-----------------OLED端口定义---------------- #define OLED_SCL_Clr() GPIO_WriteBit(PORT_LCD, GPIO_LCD_SCL, Bit_RESET) //将SCL引脚置低 #define OLED_SCL_Set() GPIO_WriteBit(PORT_LCD, GPIO_LCD_SCL, Bit_SET) //将SCL引脚置高 #define OLED_SDA_Clr() GPIO_WriteBit(PORT_LCD, GPIO_LCD_SDA, Bit_RESET) //将SDA引脚置低 #define OLED_SDA_Set() GPIO_WriteBit(PORT_LCD, GPIO_LCD_SDA, Bit_SET) //将SDA引脚置高这里GPIO_WriteBit是STM32标准库的函数。有些例程可能会用GPIO_ResetBits和GPIO_SetBits原理是一样的。3.3 修改GPIO初始化函数现在需要修改引脚的初始化代码。打开oled.c找到OLED_Init(void)函数。这个函数开头部分通常是配置GPIO的。我们需要将其替换为适合我们引脚配置的代码。找到原来的初始化部分替换为如下代码void OLED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; // 1. 使能GPIOA的时钟因为我们用了PA2和PA0 RCC_APB2PeriphClockCmd(RCC_GPIO, ENABLE); // 2. 配置SCL和SDA引脚为开漏输出模式 GPIO_InitStructure.GPIO_Pin GPIO_LCD_SCL | GPIO_LCD_SDA; // 要初始化的引脚 GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_OD; // 开漏输出模式 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; // 输出速度50MHz足够 GPIO_Init(PORT_LCD, GPIO_InitStructure); // 应用配置 // 3. 后续是SSD1306芯片的初始化命令序列保持不变 // delay_ms(200); // 有些初始化需要延时根据实际情况决定是否保留 OLED_WR_Byte(0xAE,OLED_CMD); /*display off*/ // ... 其余初始化命令 OLED_Clear(); OLED_WR_Byte(0xAF,OLED_CMD); /*display ON*/ }关键点解释GPIO_Mode_Out_OD这里设置为开漏输出模式。这是IIC总线标准的要求之一。开漏输出可以方便地实现“线与”功能当总线上的任何一个设备拉低SDA线时整条线就是低电平。RCC_APB2PeriphClockCmd这是STM32标准库的时钟使能函数。在操作任何外设包括GPIO之前必须先打开它的时钟这是STM32编程里非常容易忘记但又至关重要的一步3.4 调整IIC延时软件模拟IIC的通信速度依赖于delay_us()这样的微秒级延时函数。通信时序比如SCL高电平的保持时间必须满足SSD1306芯片数据手册的要求。在oled.c文件中找到一个名为IIC_delay(void)或类似名称的函数它控制着IIC的基本时钟周期。根据原始资料我们需要将其修改为//IIC延时函数 void IIC_delay(void) { delay_us(2); // 延时2微秒 }这个delay_us(2)决定了IIC的通信速率。2微秒的延时意味着SCL周期大约4微秒对应频率约250kHz。对于SSD1306来说这个速度是兼容的。如果你的工程里没有精准的delay_us函数需要先实现一个。通常可以用SysTick定时器来实现。4. 上电测试点亮屏幕并显示字符经过上面的步骤驱动移植的核心工作就完成了。现在让我们写一个简单的main函数来测试一下。在你的main.c文件中包含必要的头文件并编写如下测试代码#include stm32f10x.h #include board.h // 你的板级支持头文件包含系统初始化和延时函数 #include oled.h int main(void) { // 1. 初始化系统时钟、外设等 board_init(); // 2. 初始化OLED屏幕 OLED_Init(); // 3. 清屏 OLED_Clear(); // 4. 在屏幕上不同位置显示不同大小的字符串 while(1) { OLED_ShowString(0, 0, (uint8_t *)Hello, 8, 1); // 在(0,0)坐标显示8号字体“Hello” OLED_ShowString(10, 8, (uint8_t *)OLED, 12, 1); // 在(10,8)坐标显示12号字体“OLED” OLED_ShowString(20, 18, (uint8_t *)STM32, 16, 1);// 在(20,18)坐标显示16号字体“STM32” OLED_ShowString(60, 36, (uint8_t *)OK!, 24, 1); // 在(60,36)坐标显示24号字体“OK!” // 5. 刷新显示将显存数据发送到屏幕 OLED_Refresh(); // 延时一段时间你可以观察显示效果 delay_ms(1000); // 可选清屏后再显示实现闪烁效果 // OLED_Clear(); // delay_ms(500); } }编译并下载程序到你的开发板。如果一切顺利你应该能看到屏幕上清晰地显示出“Hello OLED STM32 OK!”这些字符。5. 常见问题与调试心得第一次移植很可能不会那么顺利这里分享几个我踩过的坑屏幕完全不亮检查电源首先用万用表量一下屏幕的VCC和GND引脚确认是否有3.3V电压。检查接线确认SCL、SDA、GND、VCC四根线没有接错、没有虚焊。检查上拉电阻如果屏幕模块本身没有集成上拉电阻一定要在SCL和SDA上各接一个4.7K-10K的电阻到3.3V。屏幕亮但无显示白屏或花屏检查初始化序列OLED_Init()函数里那一长串OLED_WR_Byte命令是初始化SSD1306芯片的不要随意删减。确保它们被正确执行。检查IIC时序最大的可能性是IIC通信失败。可以用逻辑分析仪或者示波器抓一下SCL和SDA的波形看是否有数据在传输。如果没有仪器可以尝试将IIC_delay()函数里的延时调大比如改成delay_us(10)降低通信速度试试。检查引脚模式务必确认GPIO初始化为开漏输出GPIO_Mode_Out_OD并且使能了GPIO端口的时钟。显示乱码或错位检查字库OLED_ShowString等显示函数依赖于字库数据。确保oledfont.h等字库文件已正确添加到工程并且字库数组没有损坏。检查坐标OLED的坐标原点(0,0)通常是在屏幕左上角。确保你传递的坐标值没有超出屏幕范围128x32。移植成功的关键在于耐心和细心。按照“电源-接线-时钟-初始化-通信”的顺序一步步排查问题总能解决。当你看到自己点亮的第一个OLED屏幕时那种成就感就是驱动开发最大的乐趣。希望这篇教程能帮你顺利搞定这块小彩屏