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

F411-WeAct实战：IIC驱动SSD1306 OLED显示模块（0.96寸）

news 2026/6/1 23:09:21

1. 硬件准备与环境搭建

第一次拿到WeAct的STM32F411CEU6开发板和0.96寸OLED屏幕时，我花了半小时研究接线。这里有个小技巧：OLED的IIC接口只需要4根线，但VCC接3.3V千万别搞错，有次我误接5V差点烧芯片。具体接线如下：

VCC→ 开发板3.3V引脚
GND→ 任意GND引脚
SCL→ PB6（I2C1_SCL）
SDA→ PB7（I2C1_SDA）

用CubeMX配置时发现个坑：默认I2C时钟速度是100kHz，但SSD1306实际支持400kHz。在i2c.h里修改I2C_TIMINGR寄存器值为0x00303D5B即可提速，实测显示刷新明显流畅。

2. CubeMX配置详解

配置时钟树时，我习惯先用内部HSI（16MHz）快速验证。等驱动调通后再切到外部晶振，这时要注意：

在RCC选项卡启用HSE
在Clock Configuration将PLLM设为8，PLLN设96，PLLP设2
最终系统时钟会达到96MHz

I2C配置页面有三个关键点：

模式选"I2C"
地址宽度保持7位
记得勾选"I2C Fast Mode"

注意：PB6/PB7默认是复用开漏模式，不需要额外配置上拉电阻，开发板已经内置4.7kΩ上拉。

3. 驱动代码编写实战

3.1 基础通信函数

在oled.c里最核心的是这两个底层函数：

// 写命令函数 void OLED_Write_Cmd(uint8_t cmd) { uint8_t buf[2] = {0x00, cmd}; // 控制字节+命令 HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDRESS, buf, 2, 100); } // 写数据函数 void OLED_Write_Data(uint8_t dat) { uint8_t buf[2] = {0x40, dat}; // 数据头字节+数据 HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDRESS, buf, 2, 100); }

这里有个易错点：SSD1306的I2C地址通常是0x78（7位地址），但有些模块是0x7A。如果通信失败，先用逻辑分析仪抓波形确认地址。

3.2 显存管理技巧

SSD1306内部没有显存，需要自己维护一个128x8字节的缓存数组。我优化过的显存操作方案：

uint8_t OLED_GRAM[128][8]; // 定义显存 // 更新局部显存并刷新 void OLED_Refresh(uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2) { for(uint8_t y=y1; y<=y2; y++) { OLED_Set_Pos(x1, y); for(uint8_t x=x1; x<=x2; x++) { OLED_Write_Data(OLED_GRAM[x][y]); } } }

4. 高级显示功能实现

4.1 中文字库移植

制作字库时推荐用PCtoLCD2002软件，取模方式选"阴码+逐列式+顺向"，设置16x16点阵。在oledfont.h中添加：

// 中文"测试"的字模数据 const unsigned char Hzk[][32] = { {0x00,0x40,0x20,0xF8,0x07,0x40,0x20...}, // 测 {0x20,0x10,0x08,0xFC,0x03,0x00,0x00...} // 试 };

显示时要注意汉字占两个字符宽度，Y坐标按页寻址：

void OLED_ShowCN(uint8_t x, uint8_t y, uint8_t index) { uint8_t i; OLED_Set_Pos(x, y); for(i=0; i<16; i++) OLED_Write_Data(Hzk[index*2][i]); OLED_Set_Pos(x, y+1); for(i=0; i<16; i++) OLED_Write_Data(Hzk[index*2+1][i]); }

4.2 图片显示优化

用Image2Lcd生成BMP数组时，记得勾选"黑白两色"和"数据水平扫描"。我常用的显示函数支持局部刷新：

void OLED_DrawBMP(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1, const uint8_t *bmp) { uint16_t j=0; for(uint8_t y=y0; y<y1; y++) { OLED_Set_Pos(x0, y); for(uint8_t x=x0; x<x1; x++) { OLED_Write_Data(bmp[j++]); OLED_GRAM[x][y] = bmp[j]; // 同步更新显存 } } }

5. 性能优化技巧

双缓冲技术：创建两个显存缓冲区，切换显示时无闪烁
局部刷新：修改OLED_Refresh()函数，只刷新变化区域
硬件加速：启用DMA传输，实测刷屏速度提升3倍

// DMA版本写数据函数 void OLED_Write_DMA(uint8_t *data, uint16_t len) { HAL_I2C_Master_Transmit_DMA(&hi2c1, OLED_ADDRESS, data, len); }

6. 常见问题排查

问题1：屏幕只亮不显示内容

检查初始化序列是否完整
用逻辑分析仪确认I2C是否有ACK响应

问题2：显示乱码

确认字库取模方式是否正确
检查显存数组是否越界

问题3：屏幕闪烁

降低刷新频率到30Hz以下
检查电源是否稳定

7. 项目实战案例

结合DHT11温湿度传感器，我做了个环境监测显示终端。核心逻辑：

while(1) { DHT11_ReadData(&temp, &humi); OLED_ClearArea(0, 0, 127, 2); // 局部清屏 sprintf(str, "Temp:%dC Humi:%d%%", temp, humi); OLED_ShowString(0, 0, str, 16); HAL_Delay(2000); // 绘制温度曲线 static uint8_t temp_arr[128]; temp_arr[127] = temp; for(uint8_t i=0; i<127; i++) temp_arr[i] = temp_arr[i+1]; OLED_DrawWaveform(0, 3, 127, 7, temp_arr); }

这个项目完整代码已放在GitHub，包含PCB设计和3D打印外壳文件。后续我还会添加Wi-Fi上传功能，实现物联网远程监控。

查看全文

http://www.cnnetsun.cn/news/2595142.html