手把手教你用STM32F103驱动4针OLED屏（I2C接口，附完整代码）-程序员充电站

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

1. 硬件准备与电路连接

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

硬件连接步骤如下：

将OLED的VCC引脚连接到STM32的3.3V电源输出
将OLED的GND引脚连接到STM32的地线
将OLED的SCL引脚连接到STM32的PB8引脚
将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模块可能有略微不同的初始化序列，但大体上都包含以下配置步骤：

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

以下是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); } }