从零到一：手把手实现OLED的IIC四线驱动与内容显示
1. 硬件连接与IIC通信基础
第一次接触OLED屏幕时，我被它仅需四根线就能驱动的特性惊艳到了。这种简约的硬件设计特别适合嵌入式开发新手，尤其是使用STM32这类资源有限的微控制器。让我们从最基础的硬件连接开始，一步步搭建起整个显示系统。
IIC通信只需要两根信号线：SCL（时钟线）和SDA（数据线），加上电源VCC和地线GND，总共四根线就能完成所有通信。实际接线时，我习惯用杜邦线将OLED的SCL接单片机PB6，SDA接PB7，这是STM32的硬件IIC默认引脚。不过为了教学目的，我们今天要重点讲解更通用的GPIO模拟IIC方式。
这里有个容易踩坑的地方：不同厂家的OLED模块供电电压可能不同。常见的有3.3V和5V两种规格，一定要确认好自己模块的电压需求。我有次不小心把5V模块接到3.3V电源上，结果显示效果非常暗淡，调试了半天才发现是供电问题。
2. IIC时序模拟实战
很多初学者觉得IIC时序很难，其实把它想象成两个人对话就简单多了。SCL相当于打拍子的节拍器，SDA就是在每个拍子上传递的信息。下面这段代码是我在多个项目中验证过的稳定实现：
// 定义GPIO操作宏 #define OLED_SCL_HIGH() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET) #define OLED_SCL_LOW() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET) #define OLED_SDA_HIGH() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET) #define OLED_SDA_LOW() HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_RESET) // 起始信号 void I2C_Start(void) { OLED_SDA_HIGH(); OLED_SCL_HIGH(); delay_us(5); OLED_SDA_LOW(); delay_us(5); OLED_SCL_LOW(); } // 停止信号 void I2C_Stop(void) { OLED_SCL_LOW(); OLED_SDA_LOW(); delay_us(5); OLED_SCL_HIGH(); delay_us(5); OLED_SDA_HIGH(); }实际调试时，我强烈建议用逻辑分析仪抓取波形。这是我调试IIC通信的必备工具，能直观看到每个起始位、数据位和停止位的时序。常见问题包括时序延迟不足（需要适当增加delay_us）、信号线干扰（加上拉电阻）等。
3. OLED初始化与显存管理
拿到一块新OLED，首先要进行正确的初始化。这个过程就像给显示器做"体检"，告诉它如何工作。以下是经过优化的初始化命令序列：
void OLED_Init(void) { // 硬件初始化代码... // 关键初始化命令 const uint8_t init_cmds[] = { 0xAE, // 关闭显示 0xD5, 0x80, // 设置时钟分频 0xA8, 0x3F, // 设置复用率 0xD3, 0x00, // 设置显示偏移 0x40, // 设置起始行 0x8D, 0x14, // 电荷泵设置 0x20, 0x00, // 内存地址模式 0xA1, // 段重定向 0xC8, // 输出扫描方向 0xDA, 0x12, // COM引脚配置 0x81, 0xCF, // 对比度设置 0xD9, 0xF1, // 预充电周期 0xDB, 0x30, // VCOMH设置 0xA4, // 全亮显示 0xA6, // 正常显示 0xAF // 开启显示 }; for(uint8_t i=0; i<sizeof(init_cmds); i++) { OLED_Write_Command(init_cmds[i]); } OLED_Clear(); }OLED的显存管理是个重点。128x64的屏幕实际上被分为8页（Page），每页8行，共64行。每页有128列。这种结构意味着写入数据时要特别注意坐标计算。我常用的做法是先设置页地址，再设置列地址，然后连续写入该行的多个列数据。
4. 字符与图形显示实现
显示字符是OLED最基础的功能。我建议先实现ASCII字符显示，再扩展中文显示。下面这个8x16字体显示函数是我项目中验证过的：
// 显示一个ASCII字符 void OLED_ShowChar(uint8_t x, uint8_t y, char chr) { uint8_t c = chr - ' '; // 计算字体数组偏移 if(x > 120) { x = 0; y++; } // 自动换行 OLED_Set_Pos(x, y); for(uint8_t i=0; i<8; i++) { OLED_Write_Data(Font8x16[c*16+i]); } OLED_Set_Pos(x, y+1); for(uint8_t i=0; i<8; i++) { OLED_Write_Data(Font8x16[c*16+i+8]); } }中文显示原理类似，但需要更大的字模。我通常使用16x16点阵字库，每个汉字需要32字节数据。实际项目中，我会根据需求裁剪字库，只保留用到的汉字，节省Flash空间。
图形显示方面，BMP图片显示是个实用功能。我开发过一个PC端工具，可以把图片转换成C数组，直接放入代码中使用。显示图片时要注意OLED的显存结构，按页写入效率最高。
5. 性能优化与调试技巧
经过几个项目的积累，我总结出几个提升OLED显示性能的关键点：
批量写入：单次写入多个数据比多次写入单字节快得多。我通常一次写入整行（128字节）数据。
局部刷新：只更新需要改变的区域，而不是全屏刷新。这在动态显示时特别有效。
双缓冲：在RAM中建立显示缓存，完成所有修改后一次性写入OLED。这能避免闪烁现象。
调试时最常见的三个问题是：白屏（检查初始化序列）、显示错位（检查坐标计算）、显示残影（适当调整预充电参数）。我习惯准备一个测试模式函数，可以快速验证OLED的各项功能。
6. 项目实战：温湿度监测显示
最后，我们用一个完整的项目来整合所学知识。这个温湿度监测器使用DHT11传感器，将数据实时显示在OLED上：
void main() { OLED_Init(); DHT11_Init(); while(1) { if(DHT11_Read()) { OLED_Clear(); OLED_ShowString(0, 0, "Temp:", 16); OLED_ShowNum(40, 0, DHT11_Temp, 2, 16); OLED_ShowString(80, 0, "C", 16); OLED_ShowString(0, 2, "Humi:", 16); OLED_ShowNum(40, 2, DHT11_Humi, 2, 16); OLED_ShowString(80, 2, "%", 16); } HAL_Delay(2000); } }这个项目虽然简单，但涵盖了硬件连接、IIC通信、字符显示等核心知识点。我在实际教学中发现，通过这样的完整案例，学生能更快掌握OLED驱动的精髓。