STM32F407硬件IIC实战：用库函数驱动OLED屏幕（附完整代码）

张

张建站

2026/6/2 4:00:57

10分钟阅读

STM32F407硬件IIC实战用库函数驱动OLED屏幕附完整代码在嵌入式开发中OLED屏幕因其高对比度、低功耗和快速响应等特性成为许多项目的首选显示设备。而STM32F407作为一款高性能的ARM Cortex-M4微控制器其内置的硬件IIC接口为OLED驱动提供了高效稳定的通信方案。本文将带你从零开始通过硬件IIC接口驱动SSD1306 OLED屏幕并实现动态显示效果。1. 硬件准备与IIC基础1.1 所需硬件组件STM32F407开发板如Discovery或Nucleo系列0.96寸SSD1306 OLED屏幕IIC接口杜邦线若干USB转TTL模块用于调试1.2 IIC通信基础回顾IICInter-Integrated Circuit是一种两线制的同步串行通信协议由Philips公司开发。它具有以下特点两线制SCL时钟线和SDA数据线多主多从支持多个主设备和从设备地址寻址每个从设备有唯一的7位或10位地址速度分级标准模式100kHz快速模式400kHz高速模式3.4MHz在STM32F407中硬件IIC控制器负责处理底层通信协议开发者只需配置相关寄存器即可实现通信。2. 硬件连接与初始化2.1 引脚连接配置STM32F407的IIC1接口默认使用PB6(SCL)和PB7(SDA)但也可以通过重映射使用PB8(SCL)和PB9(SDA)。本文采用后者STM32F407引脚OLED引脚功能PB8SCL时钟线PB9SDA数据线3.3VVCC电源GNDGND地线2.2 IIC1初始化代码void IIC1_Config(void) { GPIO_InitTypeDef GPIO_InitStructure; I2C_InitTypeDef I2C_InitStructure; // 使能GPIOB和I2C1时钟 RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); // 配置GPIO GPIO_InitStructure.GPIO_Pin GPIO_Pin_8 | GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF; GPIO_InitStructure.GPIO_OType GPIO_OType_OD; GPIO_InitStructure.GPIO_PuPd GPIO_PuPd_UP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); // 引脚复用为I2C1 GPIO_PinAFConfig(GPIOB, GPIO_PinSource8, GPIO_AF_I2C1); GPIO_PinAFConfig(GPIOB, GPIO_PinSource9, GPIO_AF_I2C1); // 配置I2C I2C_DeInit(I2C1); I2C_InitStructure.I2C_Mode I2C_Mode_I2C; I2C_InitStructure.I2C_DutyCycle I2C_DutyCycle_2; I2C_InitStructure.I2C_OwnAddress1 0x00; I2C_InitStructure.I2C_Ack I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_ClockSpeed 400000; // 400kHz I2C_Init(I2C1, I2C_InitStructure); I2C_Cmd(I2C1, ENABLE); }注意SSD1306 OLED的IIC地址通常为0x787位地址模式或0x3C8位地址模式具体取决于模块设计。3. SSD1306驱动实现3.1 OLED初始化序列SSD1306需要一系列初始化命令才能正常工作。以下是典型的初始化流程void OLED_Init(void) { // 延时确保电源稳定 Delay(100); // 发送初始化命令序列 OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); // 设置显示时钟分频比/振荡器频率 OLED_WriteCmd(0x80); OLED_WriteCmd(0xA8); // 设置多路复用率 OLED_WriteCmd(0x3F); OLED_WriteCmd(0xD3); // 设置显示偏移 OLED_WriteCmd(0x00); OLED_WriteCmd(0x40); // 设置显示起始行 OLED_WriteCmd(0x8D); // 电荷泵设置 OLED_WriteCmd(0x14); OLED_WriteCmd(0x20); // 内存地址模式 OLED_WriteCmd(0x00); // 水平地址模式 OLED_WriteCmd(0xA1); // 段重映射设置 OLED_WriteCmd(0xC8); // 行输出扫描方向 OLED_WriteCmd(0xDA); // COM引脚硬件配置 OLED_WriteCmd(0x12); OLED_WriteCmd(0x81); // 对比度控制 OLED_WriteCmd(0xCF); OLED_WriteCmd(0xD9); // 预充电周期 OLED_WriteCmd(0xF1); OLED_WriteCmd(0xDB); // VCOMH取消选择级别 OLED_WriteCmd(0x40); OLED_WriteCmd(0xA4); // 显示全部点亮恢复 OLED_WriteCmd(0xA6); // 正常显示 OLED_WriteCmd(0xAF); // 开启显示 OLED_Clear(); // 清屏 }3.2 基本读写函数实现写命令函数void OLED_WriteCmd(uint8_t cmd) { I2C_GenerateSTART(I2C1, ENABLE); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, OLED_ADDRESS, I2C_Direction_Transmitter); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); I2C_SendData(I2C1, 0x00); // 控制字节命令模式 while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTING)); I2C_SendData(I2C1, cmd); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_GenerateSTOP(I2C1, ENABLE); }写数据函数void OLED_WriteData(uint8_t data) { I2C_GenerateSTART(I2C1, ENABLE); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, OLED_ADDRESS, I2C_Direction_Transmitter); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); I2C_SendData(I2C1, 0x40); // 控制字节数据模式 while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTING)); I2C_SendData(I2C1, data); while(!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); I2C_GenerateSTOP(I2C1, ENABLE); }4. 高级显示功能实现4.1 显示缓存管理SSD1306内部没有足够的RAM来存储整个显示内容因此我们需要在MCU端维护一个显示缓存uint8_t OLED_Buffer[128][8]; // 128x64分辨率8页 void OLED_UpdateScreen(void) { for(uint8_t page 0; page 8; page) { OLED_WriteCmd(0xB0 page); // 设置页地址 OLED_WriteCmd(0x00); // 设置列地址低4位 OLED_WriteCmd(0x10); // 设置列地址高4位 for(uint8_t col 0; col 128; col) { OLED_WriteData(OLED_Buffer[col][page]); } } } void OLED_Clear(void) { memset(OLED_Buffer, 0, sizeof(OLED_Buffer)); OLED_UpdateScreen(); }4.2 基本绘图函数画点函数void OLED_DrawPixel(uint8_t x, uint8_t y, uint8_t color) { if(x 128 || y 64) return; uint8_t page y / 8; uint8_t bit y % 8; if(color) { OLED_Buffer[x][page] | (1 bit); } else { OLED_Buffer[x][page] ~(1 bit); } }画线函数void OLED_DrawLine(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1, uint8_t color) { int dx abs(x1 - x0); int dy abs(y1 - y0); int sx (x0 x1) ? 1 : -1; int sy (y0 y1) ? 1 : -1; int err dx - dy; while(1) { OLED_DrawPixel(x0, y0, color); if(x0 x1 y0 y1) break; int e2 2 * err; if(e2 -dy) { err - dy; x0 sx; } if(e2 dx) { err dx; y0 sy; } } }4.3 字符显示实现ASCII字符显示void OLED_ShowChar(uint8_t x, uint8_t y, char chr, uint8_t size, uint8_t mode) { uint8_t temp, t1, t; uint8_t y0 y; chr chr - ; for(t 0; t size; t) { if(size 12) { temp oled_asc2_1206[chr][t]; } else { temp oled_asc2_1608[chr][t]; } for(t1 0; t1 8; t1) { if(temp 0x80) { OLED_DrawPixel(x, y, mode); } else { OLED_DrawPixel(x, y, !mode); } temp 1; y; if((y - y0) size) { y y0; x; break; } } } } void OLED_ShowString(uint8_t x, uint8_t y, char *str, uint8_t size, uint8_t mode) { while(*str ! \0) { if(x 120) { x 0; y size; } OLED_ShowChar(x, y, *str, size, mode); x size / 2; str; } }中文字符显示void OLED_ShowChinese(uint8_t x, uint8_t y, uint8_t no, uint8_t mode) { uint8_t t1, temp; uint8_t y0 y; for(t1 0; t1 16; t1) { temp oled_Hzk[2 * no][t1]; for(uint8_t t 0; t 8; t) { if(temp 0x80) { OLED_DrawPixel(x, y, mode); } else { OLED_DrawPixel(x, y, !mode); } temp 1; y; } x; y y0; } x x - 16; y0 y0 8; y y0; for(t1 0; t1 16; t1) { temp oled_Hzk[2 * no 1][t1]; for(uint8_t t 0; t 8; t) { if(temp 0x80) { OLED_DrawPixel(x, y, mode); } else { OLED_DrawPixel(x, y, !mode); } temp 1; y; } x; y y0; } }5. 动态效果与项目应用5.1 实现动态图表void OLED_DrawWaveform(uint8_t *values, uint8_t count) { // 清除图表区域 for(uint8_t x 0; x 128; x) { for(uint8_t page 2; page 6; page) { OLED_Buffer[x][page] 0; } } // 绘制坐标轴 for(uint8_t y 16; y 48; y) { OLED_DrawPixel(0, y, 1); } for(uint8_t x 0; x 128; x) { OLED_DrawPixel(x, 32, 1); } // 绘制波形 for(uint8_t i 0; i count; i) { uint8_t y 32 - (values[i] / 8); OLED_DrawPixel(i, y, 1); if(i 0) { uint8_t prev_y 32 - (values[i-1] / 8); OLED_DrawLine(i-1, prev_y, i, y, 1); } } OLED_UpdateScreen(); }5.2 简易菜单系统实现typedef struct { char *text; void (*action)(void); } MenuItem; MenuItem menuItems[] { {显示温度, ShowTemperature}, {显示波形, ShowWaveform}, {系统设置, SystemSettings}, {关于, ShowAbout} }; uint8_t currentSelection 0; void DrawMenu(void) { OLED_Clear(); for(uint8_t i 0; i sizeof(menuItems)/sizeof(MenuItem); i) { if(i currentSelection) { // 反白显示选中项 OLED_FillRect(0, i*16, 128, 16, 1); OLED_ShowString(4, i*16 4, menuItems[i].text, 12, 0); } else { OLED_ShowString(4, i*16 4, menuItems[i].text, 12, 1); } } OLED_UpdateScreen(); } void MenuUp(void) { if(currentSelection 0) { currentSelection--; DrawMenu(); } } void MenuDown(void) { if(currentSelection sizeof(menuItems)/sizeof(MenuItem) - 1) { currentSelection; DrawMenu(); } } void MenuSelect(void) { if(menuItems[currentSelection].action ! NULL) { menuItems[currentSelection].action(); } }5.3 温度显示示例void ShowTemperature(void) { float temperature ReadTemperature(); // 假设有温度读取函数 OLED_Clear(); // 绘制温度计图标 OLED_FillRect(10, 10, 8, 44, 1); OLED_FillRect(8, 52, 12, 4, 1); OLED_FillCircle(14, 58, 6, 1); // 根据温度填充 uint8_t fillHeight (uint8_t)(44 * (temperature / 50.0)); OLED_FillRect(10, 10 (44 - fillHeight), 8, fillHeight, 1); // 显示温度值 char tempStr[16]; sprintf(tempStr, %.1f C, temperature); OLED_ShowString(40, 20, 当前温度:, 16, 1); OLED_ShowString(40, 40, tempStr, 16, 1); OLED_UpdateScreen(); }6. 性能优化与调试技巧6.1 IIC通信优化时钟速度调整I2C_InitStructure.I2C_ClockSpeed 400000; // 可尝试提高到800kHzDMA传输对于大量数据传输可以使用DMA来减轻CPU负担void OLED_UpdateScreen_DMA(void) { // 配置DMA... DMA_InitTypeDef DMA_InitStructure; // 启动DMA传输... DMA_Cmd(DMA1_Stream6, ENABLE); // 等待传输完成... while(DMA_GetFlagStatus(DMA1_Stream6, DMA_FLAG_TCIF6) RESET); }6.2 常见问题排查OLED不显示检查电源连接确认IIC地址正确用逻辑分析仪检查IIC信号显示乱码检查初始化序列是否正确确认显示缓存管理无误检查字符编码是否匹配通信不稳定降低IIC时钟速度检查上拉电阻通常4.7kΩ缩短连接线长度6.3 功耗优化void OLED_Sleep(void) { OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0x8D); // 关闭电荷泵 OLED_WriteCmd(0x10); Delay(100); } void OLED_Wakeup(void) { OLED_WriteCmd(0x8D); // 开启电荷泵 OLED_WriteCmd(0x14); Delay(100); OLED_WriteCmd(0xAF); // 开启显示 }7. 完整项目集成将上述功能整合到一个完整的项目中通常包括以下模块硬件抽象层oled_i2c.c/hIIC通信和OLED基本驱动oled_graphics.c/h图形绘制函数oled_fonts.c/h字库管理应用层menu_system.c/h菜单管理sensor_interface.c/h传感器数据获取ui_components.c/hUI组件主程序流程int main(void) { // 硬件初始化 SystemInit(); IIC1_Config(); OLED_Init(); // 显示启动画面 OLED_ShowStartupScreen(); // 主循环 while(1) { // 处理用户输入 HandleUserInput(); // 更新传感器数据 UpdateSensorData(); // 刷新显示 RefreshDisplay(); // 低功耗处理 EnterLowPowerIfIdle(); } }在实际项目中我发现合理组织代码结构对于后期维护至关重要。将硬件驱动、图形库和业务逻辑分离可以大大提高代码的可重用性和可维护性。例如当需要更换显示设备时只需修改硬件抽象层即可上层应用代码几乎不需要改动。