当前位置： 首页 > news >正文

手把手教你用STM32F103驱动4针OLED屏（I2C接口，附完整代码）

news 2026/4/27 15:11:14

STM32F103驱动4针OLED屏实战指南：从硬件连接到动态显示

1. 硬件准备与电路连接

拿到一块4针I2C接口的OLED模块时，首先要确认它的引脚定义。常见的0.96寸OLED模块通常有四个引脚：VCC（3.3V）、GND（地线）、SCL（时钟线）和SDA（数据线）。对于STM32F103C8T6这款性价比极高的Cortex-M3内核微控制器，我们选择PB8和PB9作为I2C接口引脚，这是因为它内置了硬件I2C功能，同时这两个引脚也方便在开发板上连接。

硬件连接步骤如下：

  1. 将OLED的VCC引脚连接到STM32的3.3V电源输出
  2. 将OLED的GND引脚连接到STM32的地线
  3. 将OLED的SCL引脚连接到STM32的PB8引脚
  4. 将OLED的SDA引脚连接到STM32的PB9引脚

注意：部分OLED模块需要上拉电阻（通常4.7kΩ），但大多数模块已经内置了这些电阻，直接连接即可工作。

硬件连接完成后，我们需要在STM32上配置I2C接口。STM32的I2C接口有两种使用方式：硬件I2C和软件模拟I2C。考虑到不同型号STM32的硬件I2C可能存在兼容性问题，本教程采用更可靠的软件模拟方式。

2. 软件I2C时序模拟实现

I2C总线协议是一种简单、高效的双线制串行总线协议，由Philips公司开发。它只需要两根线（SCL和SDA）就能实现多个设备之间的通信。以下是I2C协议的关键时序模拟代码：

// 引脚定义 #define OLED_SCL_PIN GPIO_Pin_8 #define OLED_SDA_PIN GPIO_Pin_9 #define OLED_PORT GPIOB // 初始化I2C引脚 void OLED_I2C_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // 配置SCL和SDA为开漏输出模式 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Pin = OLED_SCL_PIN; GPIO_Init(OLED_PORT, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = OLED_SDA_PIN; GPIO_Init(OLED_PORT, &GPIO_InitStructure); // 初始状态拉高 OLED_SCL(1); OLED_SDA(1); } // I2C起始信号 void OLED_I2C_Start(void) { OLED_SDA(1); OLED_SCL(1); OLED_SDA(0); OLED_SCL(0); } // I2C停止信号 void OLED_I2C_Stop(void) { OLED_SDA(0); OLED_SCL(1); OLED_SDA(1); } // 发送一个字节 void OLED_I2C_SendByte(uint8_t Byte) { uint8_t i; for(i=0; i<8; i++) { OLED_SDA(Byte & (0x80 >> i)); OLED_SCL(1); OLED_SCL(0); } // 额外时钟周期用于应答 OLED_SCL(1); OLED_SCL(0); }

这段代码实现了I2C通信的基本时序，包括起始信号、停止信号和字节发送。开漏输出模式确保了总线可以正确实现"线与"逻辑，这是I2C总线多设备通信的基础。

3. OLED驱动初始化与基础功能

OLED显示屏的初始化需要按照特定的时序发送一系列命令来配置显示参数。不同型号的OLED模块可能有略微不同的初始化序列，但大体上都包含以下配置步骤：

  1. 关闭显示
  2. 设置时钟分频和振荡器频率
  3. 设置多路复用率
  4. 设置显示偏移
  5. 设置显示起始行
  6. 设置对比度
  7. 配置充电泵
  8. 设置内存地址模式
  9. 设置正常/反色显示
  10. 开启显示

以下是OLED初始化的关键代码：

void OLED_Init(void) { // 上电延时，等待OLED电源稳定 Delay_ms(500); OLED_I2C_Init(); // 初始化I2C接口 // 发送初始化命令序列 OLED_WriteCommand(0xAE); // 关闭显示 OLED_WriteCommand(0xD5); // 设置显示时钟分频比/振荡器频率 OLED_WriteCommand(0x80); OLED_WriteCommand(0xA8); // 设置多路复用率 OLED_WriteCommand(0x3F); OLED_WriteCommand(0xD3); // 设置显示偏移 OLED_WriteCommand(0x00); OLED_WriteCommand(0x40); // 设置显示开始行 OLED_WriteCommand(0xA1); // 设置段重映射 OLED_WriteCommand(0xC8); // 设置COM输出扫描方向 OLED_WriteCommand(0xDA); // 设置COM引脚硬件配置 OLED_WriteCommand(0x12); OLED_WriteCommand(0x81); // 设置对比度控制 OLED_WriteCommand(0xCF); OLED_WriteCommand(0xD9); // 设置预充电周期 OLED_WriteCommand(0xF1); OLED_WriteCommand(0xDB); // 设置VCOMH取消选择级别 OLED_WriteCommand(0x30); OLED_WriteCommand(0xA4); // 设置整个显示打开/关闭 OLED_WriteCommand(0xA6); // 设置正常/反色显示 OLED_WriteCommand(0x8D); // 设置充电泵 OLED_WriteCommand(0x14); OLED_WriteCommand(0xAF); // 开启显示 OLED_Clear(); // 清屏 }

初始化完成后，我们需要实现一些基本功能，如清屏、设置光标位置等：

// 清屏函数 void OLED_Clear(void) { uint8_t i, j; for(j=0; j<8; j++) { OLED_SetCursor(j, 0); for(i=0; i<128; i++) { OLED_WriteData(0x00); // 写入0x00表示熄灭所有像素 } } } // 设置光标位置 void OLED_SetCursor(uint8_t Page, uint8_t Column) { OLED_WriteCommand(0xB0 | Page); // 设置页地址 OLED_WriteCommand(0x10 | (Column >> 4)); // 设置列地址高4位 OLED_WriteCommand(0x00 | (Column & 0x0F)); // 设置列地址低4位 }

4. 字符与图形显示实现

OLED显示的核心是将字符或图形的点阵数据写入到显示内存中。对于ASCII字符，我们通常使用8x16的点阵字库。下面我们实现字符显示功能：

// 显示一个字符 void OLED_ShowChar(uint8_t Line, uint8_t Column, char Char) { uint8_t i; OLED_SetCursor((Line-1)*2, (Column-1)*8); // 设置光标位置在上半部分 for(i=0; i<8; i++) { OLED_WriteData(OLED_F8x16[Char-' '][i]); // 显示上半部分 } OLED_SetCursor((Line-1)*2+1, (Column-1)*8); // 设置光标位置在下半部分 for(i=0; i<8; i++) { OLED_WriteData(OLED_F8x16[Char-' '][i+8]); // 显示下半部分 } } // 显示字符串 void OLED_ShowString(uint8_t Line, uint8_t Column, char *String) { uint8_t i; for(i=0; String[i]!='\0'; i++) { OLED_ShowChar(Line, Column+i, String[i]); } }

为了显示数字，我们需要实现数字到字符的转换：

// 显示无符号数字 void OLED_ShowNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length) { uint8_t i; for(i=0; i<Length; i++) { OLED_ShowChar(Line, Column+i, Number/OLED_Pow(10,Length-i-1)%10+'0'); } } // 显示有符号数字 void OLED_ShowSignedNum(uint8_t Line, uint8_t Column, int32_t Number, uint8_t Length) { uint8_t i; uint32_t Number1; if(Number >= 0) { OLED_ShowChar(Line, Column, '+'); Number1 = Number; } else { OLED_ShowChar(Line, Column, '-'); Number1 = -Number; } for(i=0; i<Length; i++) { OLED_ShowChar(Line, Column+i+1, Number1/OLED_Pow(10,Length-i-1)%10+'0'); } }

对于更高级的显示需求，如显示图形或自定义图案，我们可以直接操作显示内存：

// 显示BMP图片 void OLED_ShowBMP(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1, uint8_t BMP[]) { uint32_t j = 0; uint8_t x, y; for(y=y0; y<=y1; y++) { OLED_SetCursor(y, x0); for(x=x0; x<=x1; x++) { OLED_WriteData(BMP[j++]); } } }

5. 高级功能与性能优化

在基本显示功能实现后，我们可以进一步优化代码并添加一些高级功能：

显示缓冲区的使用： 直接操作OLED显示内存虽然简单，但在频繁更新显示内容时会导致闪烁。引入显示缓冲区可以解决这个问题：

uint8_t OLED_DisplayBuf[8][128]; // 8页 x 128列 // 刷新整个显示屏 void OLED_Refresh(void) { uint8_t i, j; for(j=0; j<8; j++) { OLED_SetCursor(j, 0); for(i=0; i<128; i++) { OLED_WriteData(OLED_DisplayBuf[j][i]); } } } // 在缓冲区中设置像素点 void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t mode) { if(x>127 || y>63) return; if(mode) { OLED_DisplayBuf[y/8][x] |= 1<<(y%8); } else { OLED_DisplayBuf[y/8][x] &= ~(1<<(y%8)); } }

动画效果实现： 利用显示缓冲区，我们可以实现平滑的动画效果：

// 水平滚动效果 void OLED_ScrollHorizontal(uint8_t direction, uint8_t start_page, uint8_t end_page, uint8_t speed) { OLED_WriteCommand(0x2E); // 关闭滚动 OLED_WriteCommand(0x26 + direction); // 26=向右，27=向左 OLED_WriteCommand(0x00); // 虚拟字节 OLED_WriteCommand(start_page); OLED_WriteCommand(speed); OLED_WriteCommand(end_page); OLED_WriteCommand(0x00); OLED_WriteCommand(0xFF); OLED_WriteCommand(0x2F); // 开启滚动 }

低功耗优化： 对于电池供电的应用，我们可以实现以下低功耗功能：

// 进入低功耗模式 void OLED_SleepMode(uint8_t enable) { if(enable) { OLED_WriteCommand(0xAE); // 关闭显示 OLED_WriteCommand(0xAD); // 进入睡眠模式 OLED_WriteCommand(0x8A); // 设置内部电源关闭 } else { OLED_WriteCommand(0x8B); // 设置内部电源开启 OLED_WriteCommand(0xAF); // 开启显示 } }

显示对比度调节： 根据环境光线调整显示对比度可以改善可视性并节省功耗：

// 设置对比度 (0-255) void OLED_SetContrast(uint8_t contrast) { OLED_WriteCommand(0x81); OLED_WriteCommand(contrast); }

6. 实际应用示例

将上述功能整合到一个完整的应用中，我们可以创建一个简单的信息显示界面：

int main(void) { // 初始化系统和外设 SystemInit(); Delay_Init(); OLED_Init(); // 显示静态内容 OLED_ShowString(1, 1, "System Monitor"); OLED_ShowString(2, 1, "Temp: "); OLED_ShowString(3, 1, "Humidity: "); OLED_ShowString(4, 1, "Status: OK"); // 模拟动态数据更新 uint32_t counter = 0; while(1) { // 更新温度显示 OLED_ShowNum(2, 7, 25 + (counter % 10), 2); OLED_ShowString(2, 9, "C"); // 更新湿度显示 OLED_ShowNum(3, 10, 40 + (counter % 30), 2); OLED_ShowString(3, 12, "%"); // 简单的动画效果 if(counter % 20 < 10) { OLED_ShowString(4, 9, "->"); } else { OLED_ShowString(4, 9, "<-"); } counter++; Delay_ms(100); } }

对于更复杂的应用，如菜单系统，我们可以实现以下功能：

// 简单的菜单结构 typedef struct { char *title; void (*function)(void); } MenuItem; MenuItem mainMenu[] = { {"Display Test", menuDisplayTest}, {"Settings", menuSettings}, {"Info", menuInfo}, {"Exit", NULL} }; // 显示菜单 void showMenu(MenuItem *menu, uint8_t count, uint8_t selected) { uint8_t i; OLED_Clear(); for(i=0; i<count; i++) { if(i == selected) { OLED_ShowString(i+1, 1, "> "); } else { OLED_ShowString(i+1, 1, " "); } OLED_ShowString(i+1, 3, menu[i].title); } }

7. 常见问题与调试技巧

在开发过程中，可能会遇到各种问题。以下是一些常见问题及其解决方法：

问题1：OLED屏幕无任何显示

  • 检查电源连接是否正确，确保VCC接3.3V，GND接地
  • 确认I2C引脚连接正确（SCL和SDA）
  • 检查初始化序列是否正确发送
  • 尝试调整对比度设置

问题2：显示内容错乱或部分显示

  • 检查I2C时序是否正确，特别是起始和停止条件
  • 确保数据传输速率不过快（软件模拟I2C时适当增加延时）
  • 检查字库数据是否正确
  • 确认显示缓冲区操作没有越界

问题3：显示内容闪烁

  • 实现显示缓冲区，减少直接操作显示内存的次数
  • 优化刷新逻辑，只更新变化的部分
  • 考虑使用双缓冲技术

调试技巧：

  1. 使用逻辑分析仪或示波器检查I2C信号波形
  2. 分阶段测试：先测试I2C基本通信，再测试OLED初始化，最后测试显示功能
  3. 实现简单的测试模式，如全屏点亮、棋盘格图案等，快速验证硬件功能
  4. 添加调试输出，通过串口打印关键步骤的执行状态

性能优化建议：

  1. 将频繁使用的函数声明为内联函数（inline）
  2. 优化字库存储方式，使用const关键字将字库放在Flash而非RAM中
  3. 对于固定内容，考虑直接操作显示内存而非通过缓冲区
  4. 合理使用DMA传输数据，减少CPU开销（如果使用硬件I2C）

通过以上步骤和技巧，即使是嵌入式开发新手也能快速掌握STM32驱动OLED显示屏的方法，为项目添加直观的信息显示功能。

http://www.jsqmd.com/news/709093/

相关文章：

  • 在Ubuntu 22.04上用VMware搞定OpenFOAM-v2206：新手避坑全记录（从编译到跑通算例）
  • Docker Sandbox不是万能的！3个被CNCF Security SIG列为P0风险的AI隔离盲区，现在修复还来得及
  • 2026年全国重型货架厂家优选 覆盖华中西北区域 适配各类仓储作业需求 - 深度智识库
  • 如何利用AutoUnipus实现U校园自动化学习：3种模式深度解析与实战指南
  • 2026年广州、佛山注塑机制造企业排名，海添注塑机性价比如何？ - 工业设备
  • 第6章： 汽车软件信息安全
  • MQTT客户端开发避坑指南：paho-mqtt连接EMQX时常见的5个错误及解决方法
  • 2026年Geo专家综合能力与执行效果深度评测：AI时代下的信任重构
  • 解锁学术新姿势：书匠策AI——毕业论文的“全能智囊团”
  • GitMem：基于Git的开发者代码片段与知识管理工具实践指南
  • 为什么你的Python国密模块过不了等保三级？（SM2椭圆曲线参数硬编码、SM3初始向量未加盐等5类高危漏洞实录）
  • 市面上的高纯度铝焊剂哪个口碑好，淄博汉昇产品受青睐 - 工业设备
  • AI大模型时代全面到来！论文查重、降重、AIGC检测，选对AI工具才不翻车 - 逢君学术-AI论文写作
  • Mina zkApp实战：手把手教你用CLI创建账户、更新状态与权限（附完整命令与JSON解析）
  • 如何利用5大Android UI模板库在3天内完成专业级应用界面开发
  • 安卓手机上的蓝牙自动化测试神器：nRF Connect宏录制功能保姆级教程（附XML脚本示例）
  • 2026年盐城上海等地伸缩缝墙体水下堵漏公司排行，选哪家更靠谱 - 工业设备
  • 3招让PDF“暴瘦“70%：开源工具的降维打击
  • HPM6750 RISC-V开发实战：用Segger Embedded Studio搞定从工程构建到OpenOCD调试的全流程
  • Cursor免费试用重置实战：3步解决“You‘ve reached your trial request limit“问题
  • ShopClaw MCP：为AI智能体接入3.64亿Shopify商品数据的开源方案
  • 2026年亚克力盒厂家推荐排行榜：圆形/方形/异形定制，透明防尘、高透加厚，潮玩/饰品/藏品/珠宝适用！ - 速递信息
  • 2026年全球薪酬管理调研报告
  • 2026年扬州靠谱的水下安装拆除品牌机构，费用多少钱 - 工业设备
  • 生存分析分组避坑指南：X-tile软件与R的surv_cutpoint，到底该选哪个？
  • 创意改造指南：如何将废弃电视盒子转变为Linux服务器的完整方案
  • 深度解析开源自动化框架：从图像识别到黑盒测试的完整技术实践
  • 别再手动拖拽了！用NX二次开发实现点到点移动复制，效率提升不止一倍
  • 解锁论文新姿势：书匠策AI，你的毕业论文“超级外脑”！
  • 2026年合肥口碑好的伸缩缝墙体解决止水公司推荐，专业服务全解析 - 工业设备