简介这份资料面向嵌入式硬件与驱动开发初学者及工程师围绕0.5寸微型OLED显示屏的选型、电路设计与程序驱动展开适用于穿戴设备、微型仪器等紧凑型产品的开发场景。压缩包共3.74MB内含显示屏与驱动芯片规格书及配套源码等文件规格书用于查阅尺寸、分辨率、亮度对比度、工作电压电流、接口定义与工作温度等关键参数控制器文档则说明灰度控制、时序、引脚与功耗特性源码文件可用于初始化显示、刷新内容与触控处理。已有152人学习下载可帮助读者快速完成硬件选型、接口对接与驱动调试缩短从规格理解到系统集成的开发周期。1. 0.5寸OLED资料到底包含什么小屏点亮的第一个门槛0.5寸OLED资料指的是围绕 0.5 英寸单色 OLED 模组常见 64×32 或 48×64 分辨率的驱动代码、初始化序列、字库取模工具、接线定义和主控适配例程这一整套东西。很多人第一次拿到这种屏以为和 0.96 寸 I2C OLED 一样接上就能亮结果发现引脚对不上、地址扫不到、初始化后一片黑。它解决的不是“显示多漂亮”的问题而是“在极小尺寸、极低功耗约束下把像素稳定点亮并刷出可读内容”。适合做穿戴设备、微型传感器节点、便携仪表、调试状态屏的嵌入式开发者尤其是用 STM32、ESP32、nRF52 或 51 单片机做主控的人。这块屏的坑集中在供电、初始化时序和显存映射三处资料的价值就在于把这三处讲透。2. 0.5寸OLED的驱动原理与选型判断先搞清它和0.96寸差在哪2.1 0.5寸OLED常见的两种驱动芯片与接口形态0.5 寸单色 OLED 模组市面上主流驱动芯片是 SSD1306 的缩小版和 SH1106 的衍生型号也有部分模组用 SSD1315。它们的分辨率通常为 64×32 或 48×64显存按页组织每页 8 行像素64×32 就是 4 页48×64 就是 8 页。接口上分 I2C 和 SPI 两种I2C 只要两根线SPI 速度快但占引脚多。选型时先看你的主控还剩几个 IO再看刷新率要求。如果只是刷状态文字I2C 足够如果要画波形或做动画SPI 更稳。判断模组用哪种芯片最直接的办法是看排线丝印或模组背面标注。没有标注时用 I2C 扫描地址SSD1306 常见 0x3C 或 0x3DSH1106 也是 0x3C 但显存寻址方式不同。这里有个血泪经验SH1106 的显存是 132 列而 0.5 寸屏只有 64 列初始化后如果不做列偏移图像会整体右移 2 到 4 个像素看起来像“显示不全”。所以资料里如果只给 SSD1306 的初始化序列直接套到 SH1106 上大概率翻车。2.2 供电与复位0.5寸屏最容易忽略的硬件前提0.5 寸 OLED 的供电范围一般是 1.65V 到 3.3V逻辑电平也是 3.3V。很多开发者用 5V 单片机直接接结果 I2C 电平不匹配屏幕时亮时不亮。正确做法是加电平转换或者确认模组自带稳压和电平移位。复位引脚 RES 不能悬空上电后需要拉低至少 3 微秒再拉高然后延时 100 毫秒等内部电荷泵稳定。我一般会在代码里显式控制 RES而不是依赖模组自带的 RC 复位电路因为不同批次的 RC 参数差异会导致初始化失败率明显上升。电荷泵电容也要注意。0.5 寸模组为了做小电荷泵电容通常贴在排线上容量在 1 微法到 4.7 微法之间。如果自己画转接板这个电容不能省否则屏幕亮度不足或直接不亮。常见做法是参考模组厂给的典型应用电路把 VCC、VCOMH、VCC 三路去耦电容都放上容值按 1 微法、4.7 微法、10 微法搭配。2.3 显存映射与取模方式为什么你的字是倒的0.5 寸 OLED 的显存按页写入每页 8 行列地址从 0 到 63。写入一个字节对应一列 8 个像素低位在上还是高位在上取决于模组的扫描方向设置。初始化序列里的 COM 扫描方向寄存器和段重映射寄存器决定了图像是正还是倒。很多资料给的取模软件默认“列行式、逆向、高位在前”但实际模组可能需要“列行式、顺向、低位在前”。如果你发现字是上下颠倒或左右镜像先别改代码逻辑去改初始化里的 0xA0/0xA1 和 0xC0/0xC8 这两个命令。取模工具方面常见的是 PCtoLCD2002 和 Image2Lcd。0.5 寸屏因为分辨率小建议用 8×16 或 6×8 的点阵字库太大放不下。取模时输出格式选“C51 格式”或“十六进制数组”每个字节对应一列 8 像素。下面是一个 6×8 数字字模的示例取模方式为列行式、顺向、低位在前// 6x8 数字 0-9 字模列行式顺向低位在前 const unsigned char Font6x8[10][6] { {0x3E,0x51,0x49,0x45,0x3E,0x00}, // 0 {0x00,0x42,0x7F,0x40,0x00,0x00}, // 1 {0x42,0x61,0x51,0x49,0x46,0x00}, // 2 {0x21,0x41,0x45,0x4B,0x31,0x00}, // 3 {0x18,0x14,0x12,0x7F,0x10,0x00}, // 4 {0x27,0x45,0x45,0x45,0x39,0x00}, // 5 {0x3C,0x4A,0x49,0x49,0x30,0x00}, // 6 {0x01,0x71,0x09,0x05,0x03,0x00}, // 7 {0x36,0x49,0x49,0x49,0x36,0x00}, // 8 {0x06,0x49,0x49,0x29,0x1E,0x00} // 9 };这段数组每个数字占 6 列每列一个字节字节的 bit0 到 bit7 对应这一列的 8 行像素。写入时先设置页地址和列地址再连续写 6 个字节。参数说明数组第二维是列数第一维是字符索引。如果你的屏是 64×32一页 8 行那么一行文字占一页最多显示 4 行 6×8 字符。取模方向不对时把字节按位反转即可不用重新取模。3. 用STM32 HAL库点亮0.5寸OLED从I2C扫描到刷出第一行字3.1 硬件接线与I2C地址确认以 STM32F103 为例用 I2C1 的 PB6 和 PB7 接模组的 SCL 和 SDAVCC 接 3.3VGND 共地RES 接 PA0。上电后先跑 I2C 扫描确认地址。下面是一段扫描代码// I2C 扫描确认 0.5 寸 OLED 地址 #include i2c.h #include stdio.h void OLED_ScanI2C(void) { uint8_t addr; for (addr 1; addr 128; addr) { HAL_StatusTypeDef ret; // 用 HAL_I2C_IsDeviceReady 探测地址超时 10ms ret HAL_I2C_IsDeviceReady(hi2c1, addr 1, 1, 10); if (ret HAL_OK) { printf(Found device at 0x%02X\r\n, addr); } } }逻辑说明HAL_I2C_IsDeviceReady 的第二个参数是 8 位地址左移一位后的值因为 HAL 库要求传入 7 位地址左对齐。第三个参数是尝试次数第四个是超时毫秒。如果扫到 0x3C说明模组在线。扫不到时先查上拉电阻I2C 总线需要 4.7k 上拉到 3.3V很多模组自带但阻值偏大长线时通信不稳。3.2 初始化序列0.5寸OLED的寄存器配置顺序初始化序列不能乱顺序错了屏幕不亮。下面是一段针对 64×32 单色 OLED 的初始化代码兼容 SSD1306 和 SSD1315// 0.5 寸 64x32 OLED 初始化序列 void OLED_Init(void) { HAL_GPIO_WritePin(OLED_RES_GPIO_Port, OLED_RES_Pin, GPIO_PIN_RESET); HAL_Delay(10); HAL_GPIO_WritePin(OLED_RES_GPIO_Port, OLED_RES_Pin, GPIO_PIN_SET); HAL_Delay(100); OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); // 设置时钟分频 OLED_WriteCmd(0x80); // 默认值 OLED_WriteCmd(0xA8); // 设置多路复用比 OLED_WriteCmd(0x1F); // 64x32 对应 31132 行 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); // COM 扫描方向上下方向 OLED_WriteCmd(0xDA); // COM 硬件配置 OLED_WriteCmd(0x02); // 64x32 对应交替 COM OLED_WriteCmd(0x81); // 对比度 OLED_WriteCmd(0x8F); // 亮度值0x00-0xFF OLED_WriteCmd(0xD9); // 预充电周期 OLED_WriteCmd(0xF1); // 默认 OLED_WriteCmd(0xDB); // VCOMH 电压 OLED_WriteCmd(0x40); // 默认 OLED_WriteCmd(0xA4); // 全局显示开启 OLED_WriteCmd(0xA6); // 正常显示非反色 OLED_WriteCmd(0xAF); // 开启显示 }参数说明0xA8 后面的 0x1F 是 64×32 屏的关键如果是 48×64 屏要改成 0x3F。0xDA 后面的 0x02 是交替 COM 配置0x12 是顺序 COM接错会导致显示错行。0x8D 的 0x14 是开启内部电荷泵0x10 是关闭用外部 VCC 时改 0x10。对比度 0x8F 是中等偏亮电池供电时可以降到 0x5F 省电。3.3 写命令与写数据的底层函数I2C 写命令和写数据的区别在于控制字节0x00 表示后面跟的是命令0x40 表示后面跟的是数据。下面是对应函数// 写命令控制字节 0x00 void OLED_WriteCmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR 1, buf, 2, 100); } // 写数据控制字节 0x40 void OLED_WriteData(uint8_t data) { uint8_t buf[2] {0x40, data}; HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR 1, buf, 2, 100); }逻辑说明每次传输两个字节第一个是控制字节第二个是命令或数据。OLED_ADDR 是 7 位地址左移一位后传给 HAL。超时 100 毫秒足够。如果通信频繁失败把超时加大到 500 毫秒或者改用 DMA 传输。注意 I2C 速率不要超过 400kHz0.5 寸模组的排线较长时100kHz 更稳。3.4 刷出一行字的完整流程设置页地址和列地址然后连续写数据。下面是在第 0 页第 0 列显示“123”的代码// 在指定页和列显示一个 6x8 字符 void OLED_ShowChar(uint8_t page, uint8_t col, char ch) { uint8_t i; uint8_t idx ch - 0; // 只处理数字 OLED_WriteCmd(0xB0 page); // 设置页地址 OLED_WriteCmd(0x00 (col 0x0F)); // 列低 4 位 OLED_WriteCmd(0x10 (col 4)); // 列高 4 位 for (i 0; i 6; i) { OLED_WriteData(Font6x8[idx][i]); } } // 主循环中调用 OLED_ShowChar(0, 0, 1); OLED_ShowChar(0, 6, 2); OLED_ShowChar(0, 12, 3);参数说明页地址 0xB0 到 0xB3 对应 64×32 的 4 页。列地址分两次写低 4 位和高 4 位这是 SSD1306 的寻址方式。每个字符占 6 列所以下一个字符列坐标加 6。如果显示出来是乱码先检查取模方向再检查页地址是否超出范围。4. 0.5寸OLED资料使用中的避坑与排查五个真实翻车点4.1 屏幕不亮但I2C能扫到地址现象扫描到 0x3C写初始化命令后屏幕全黑。原因电荷泵没开启或者 RES 复位时序不对。解决确认 0x8D 后面跟的是 0x14RES 拉低至少 3 微秒再拉高拉高后延时 100 毫秒。如果模组 RES 直接接 VCC检查上电斜率太慢会导致内部复位失败可以在 RES 对地加 100nF 电容。4.2 显示内容整体偏移或只显示一半现象字只显示左半部分或者整体右移几个像素。原因SH1106 和 SSD1306 的显存列数不同SH1106 是 132 列初始化后需要设置显示偏移。解决在初始化里加 0xD3 命令后面跟偏移值0.5 寸 64 列屏通常设 0x02 或 0x04。如果是 SSD13060xD3 设 0x00。4.3 字上下颠倒或左右镜像现象显示正常但方向不对。原因段重映射和 COM 扫描方向配置反了。解决交换 0xA0 和 0xA1交换 0xC0 和 0xC8。这两个命令组合决定四个方向试两次就能找到正确的。不要改取模数据改初始化命令更快。4.4 亮度不足或闪烁现象屏幕能亮但很暗或者亮度跳动。原因对比度设置太低或者电荷泵电容容量不够。解决把 0x81 后面的值从 0x8F 提到 0xCF同时检查模组上的电荷泵电容是否焊接良好。电池供电时VCC 跌落也会导致闪烁在 VCC 和 GND 之间并一个 10 微法电容。4.5 长时间运行后花屏或死机现象跑几个小时后屏幕出现随机像素或者 I2C 通信卡死。原因I2C 总线被干扰或者显存写入越界。解决I2C 加 4.7k 上拉走线远离电机和无线模块。显存写入时严格检查页地址不超过 364×32或 748×64列地址不超过 63。如果还花屏在刷屏前加一个清屏操作把显存全部写 0。5. 把0.5寸OLED资料用出进阶效果局部刷新与低功耗技巧局部刷新是 0.5 寸屏最值得练的技巧。全屏刷新一次要写 64×4256 字节I2C 在 100kHz 下大约 25 毫秒看起来不多但如果每秒刷 30 次功耗就上去了。局部刷新的做法是只改变化的页和列比如只更新时间数字其他区域不动。下面是一个局部刷新数字的示例先记录旧值只在新旧值不同的列写入// 局部刷新一个 6x8 数字只写变化的列 void OLED_UpdateDigit(uint8_t page, uint8_t col, char old_ch, char new_ch) { uint8_t i; uint8_t old_idx old_ch - 0; uint8_t new_idx new_ch - 0; if (old_ch new_ch) return; // 没变就不写 OLED_WriteCmd(0xB0 page); OLED_WriteCmd(0x00 (col 0x0F)); OLED_WriteCmd(0x10 (col 4)); for (i 0; i 6; i) { if (Font6x8[old_idx][i] ! Font6x8[new_idx][i]) { OLED_WriteData(Font6x8[new_idx][i]); } else { // 相同列也要写因为 I2C 是连续地址不能跳过 OLED_WriteData(Font6x8[new_idx][i]); } } }这段代码里即使列数据相同也要写因为 I2C 写数据是连续地址递增跳过会导致后续列错位。真正的省电做法是只刷新变化的页而不是只刷新变化的列。比如时间显示秒变化时只刷秒所在的页分和时不动。这样每次只写 6 到 12 个字节功耗降到全屏刷新的十分之一。低功耗还有一招利用 OLED 的睡眠命令 0xAE 和唤醒命令 0xAF。在传感器节点里采集间隔 10 秒屏幕只在采集后亮 500 毫秒其余时间睡眠。睡眠时电流从 10 毫安降到 10 微安以下。注意睡眠前不需要清屏唤醒后显存内容还在直接显示即可。对比度也可以动态调。白天设 0xCF晚上设 0x3F配合光敏电阻做自动亮度。0.5 寸屏的对比度寄存器是 0x81后面跟一个字节值越大越亮但超过 0xCF 后寿命会下降。我一般把上限设在 0xBF留一点余量。最后说一个验证方法写一个显存测试函数依次点亮每一页的每一列观察是否有坏点或暗列。0.5 寸屏的坏点率比大屏高尤其是排线焊接处。测试代码很简单双重循环写 0xFF 和 0x00每 200 毫秒切换一次。如果发现某列始终不亮先补焊排线再考虑换模组。我自己用 0.5 寸 OLED 做便携仪表时最深的教训是不要相信模组厂给的初始化序列能直接跑一定要自己用逻辑分析仪抓一遍 I2C 波形确认每个命令都写进去了。有一次调了一整天最后发现是 RES 引脚在 PCB 上被误接到了 GND屏幕永远处于复位状态。从那以后我拿到任何新模组第一件事就是量 RES 和 VCC 的对地阻值确认没有短路。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/15 19:49:55 · 阅读 1.2k 0.5寸OLED驱动资料全解析：从I2C扫描到STM32 HAL库点亮实战
简介这份资料面向嵌入式硬件与驱动开发初学者及工程师围绕0.5寸微型OLED显示屏的选型、电路设计与程序驱动展开适用于穿戴设备、微型仪器等紧凑型产品的开发场景。压缩包共3.74MB内含显示屏与驱动芯片规格书及配套源码等文件规格书用于查阅尺寸、分辨率、亮度对比度、工作电压电流、接口定义与工作温度等关键参数控制器文档则说明灰度控制、时序、引脚与功耗特性源码文件可用于初始化显示、刷新内容与触控处理。已有152人学习下载可帮助读者快速完成硬件选型、接口对接与驱动调试缩短从规格理解到系统集成的开发周期。1. 0.5寸OLED资料到底包含什么小屏点亮的第一个门槛0.5寸OLED资料指的是围绕 0.5 英寸单色 OLED 模组常见 64×32 或 48×64 分辨率的驱动代码、初始化序列、字库取模工具、接线定义和主控适配例程这一整套东西。很多人第一次拿到这种屏以为和 0.96 寸 I2C OLED 一样接上就能亮结果发现引脚对不上、地址扫不到、初始化后一片黑。它解决的不是“显示多漂亮”的问题而是“在极小尺寸、极低功耗约束下把像素稳定点亮并刷出可读内容”。适合做穿戴设备、微型传感器节点、便携仪表、调试状态屏的嵌入式开发者尤其是用 STM32、ESP32、nRF52 或 51 单片机做主控的人。这块屏的坑集中在供电、初始化时序和显存映射三处资料的价值就在于把这三处讲透。2. 0.5寸OLED的驱动原理与选型判断先搞清它和0.96寸差在哪2.1 0.5寸OLED常见的两种驱动芯片与接口形态0.5 寸单色 OLED 模组市面上主流驱动芯片是 SSD1306 的缩小版和 SH1106 的衍生型号也有部分模组用 SSD1315。它们的分辨率通常为 64×32 或 48×64显存按页组织每页 8 行像素64×32 就是 4 页48×64 就是 8 页。接口上分 I2C 和 SPI 两种I2C 只要两根线SPI 速度快但占引脚多。选型时先看你的主控还剩几个 IO再看刷新率要求。如果只是刷状态文字I2C 足够如果要画波形或做动画SPI 更稳。判断模组用哪种芯片最直接的办法是看排线丝印或模组背面标注。没有标注时用 I2C 扫描地址SSD1306 常见 0x3C 或 0x3DSH1106 也是 0x3C 但显存寻址方式不同。这里有个血泪经验SH1106 的显存是 132 列而 0.5 寸屏只有 64 列初始化后如果不做列偏移图像会整体右移 2 到 4 个像素看起来像“显示不全”。所以资料里如果只给 SSD1306 的初始化序列直接套到 SH1106 上大概率翻车。2.2 供电与复位0.5寸屏最容易忽略的硬件前提0.5 寸 OLED 的供电范围一般是 1.65V 到 3.3V逻辑电平也是 3.3V。很多开发者用 5V 单片机直接接结果 I2C 电平不匹配屏幕时亮时不亮。正确做法是加电平转换或者确认模组自带稳压和电平移位。复位引脚 RES 不能悬空上电后需要拉低至少 3 微秒再拉高然后延时 100 毫秒等内部电荷泵稳定。我一般会在代码里显式控制 RES而不是依赖模组自带的 RC 复位电路因为不同批次的 RC 参数差异会导致初始化失败率明显上升。电荷泵电容也要注意。0.5 寸模组为了做小电荷泵电容通常贴在排线上容量在 1 微法到 4.7 微法之间。如果自己画转接板这个电容不能省否则屏幕亮度不足或直接不亮。常见做法是参考模组厂给的典型应用电路把 VCC、VCOMH、VCC 三路去耦电容都放上容值按 1 微法、4.7 微法、10 微法搭配。2.3 显存映射与取模方式为什么你的字是倒的0.5 寸 OLED 的显存按页写入每页 8 行列地址从 0 到 63。写入一个字节对应一列 8 个像素低位在上还是高位在上取决于模组的扫描方向设置。初始化序列里的 COM 扫描方向寄存器和段重映射寄存器决定了图像是正还是倒。很多资料给的取模软件默认“列行式、逆向、高位在前”但实际模组可能需要“列行式、顺向、低位在前”。如果你发现字是上下颠倒或左右镜像先别改代码逻辑去改初始化里的 0xA0/0xA1 和 0xC0/0xC8 这两个命令。取模工具方面常见的是 PCtoLCD2002 和 Image2Lcd。0.5 寸屏因为分辨率小建议用 8×16 或 6×8 的点阵字库太大放不下。取模时输出格式选“C51 格式”或“十六进制数组”每个字节对应一列 8 像素。下面是一个 6×8 数字字模的示例取模方式为列行式、顺向、低位在前// 6x8 数字 0-9 字模列行式顺向低位在前 const unsigned char Font6x8[10][6] { {0x3E,0x51,0x49,0x45,0x3E,0x00}, // 0 {0x00,0x42,0x7F,0x40,0x00,0x00}, // 1 {0x42,0x61,0x51,0x49,0x46,0x00}, // 2 {0x21,0x41,0x45,0x4B,0x31,0x00}, // 3 {0x18,0x14,0x12,0x7F,0x10,0x00}, // 4 {0x27,0x45,0x45,0x45,0x39,0x00}, // 5 {0x3C,0x4A,0x49,0x49,0x30,0x00}, // 6 {0x01,0x71,0x09,0x05,0x03,0x00}, // 7 {0x36,0x49,0x49,0x49,0x36,0x00}, // 8 {0x06,0x49,0x49,0x29,0x1E,0x00} // 9 };这段数组每个数字占 6 列每列一个字节字节的 bit0 到 bit7 对应这一列的 8 行像素。写入时先设置页地址和列地址再连续写 6 个字节。参数说明数组第二维是列数第一维是字符索引。如果你的屏是 64×32一页 8 行那么一行文字占一页最多显示 4 行 6×8 字符。取模方向不对时把字节按位反转即可不用重新取模。3. 用STM32 HAL库点亮0.5寸OLED从I2C扫描到刷出第一行字3.1 硬件接线与I2C地址确认以 STM32F103 为例用 I2C1 的 PB6 和 PB7 接模组的 SCL 和 SDAVCC 接 3.3VGND 共地RES 接 PA0。上电后先跑 I2C 扫描确认地址。下面是一段扫描代码// I2C 扫描确认 0.5 寸 OLED 地址 #include i2c.h #include stdio.h void OLED_ScanI2C(void) { uint8_t addr; for (addr 1; addr 128; addr) { HAL_StatusTypeDef ret; // 用 HAL_I2C_IsDeviceReady 探测地址超时 10ms ret HAL_I2C_IsDeviceReady(hi2c1, addr 1, 1, 10); if (ret HAL_OK) { printf(Found device at 0x%02X\r\n, addr); } } }逻辑说明HAL_I2C_IsDeviceReady 的第二个参数是 8 位地址左移一位后的值因为 HAL 库要求传入 7 位地址左对齐。第三个参数是尝试次数第四个是超时毫秒。如果扫到 0x3C说明模组在线。扫不到时先查上拉电阻I2C 总线需要 4.7k 上拉到 3.3V很多模组自带但阻值偏大长线时通信不稳。3.2 初始化序列0.5寸OLED的寄存器配置顺序初始化序列不能乱顺序错了屏幕不亮。下面是一段针对 64×32 单色 OLED 的初始化代码兼容 SSD1306 和 SSD1315// 0.5 寸 64x32 OLED 初始化序列 void OLED_Init(void) { HAL_GPIO_WritePin(OLED_RES_GPIO_Port, OLED_RES_Pin, GPIO_PIN_RESET); HAL_Delay(10); HAL_GPIO_WritePin(OLED_RES_GPIO_Port, OLED_RES_Pin, GPIO_PIN_SET); HAL_Delay(100); OLED_WriteCmd(0xAE); // 关闭显示 OLED_WriteCmd(0xD5); // 设置时钟分频 OLED_WriteCmd(0x80); // 默认值 OLED_WriteCmd(0xA8); // 设置多路复用比 OLED_WriteCmd(0x1F); // 64x32 对应 31132 行 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); // COM 扫描方向上下方向 OLED_WriteCmd(0xDA); // COM 硬件配置 OLED_WriteCmd(0x02); // 64x32 对应交替 COM OLED_WriteCmd(0x81); // 对比度 OLED_WriteCmd(0x8F); // 亮度值0x00-0xFF OLED_WriteCmd(0xD9); // 预充电周期 OLED_WriteCmd(0xF1); // 默认 OLED_WriteCmd(0xDB); // VCOMH 电压 OLED_WriteCmd(0x40); // 默认 OLED_WriteCmd(0xA4); // 全局显示开启 OLED_WriteCmd(0xA6); // 正常显示非反色 OLED_WriteCmd(0xAF); // 开启显示 }参数说明0xA8 后面的 0x1F 是 64×32 屏的关键如果是 48×64 屏要改成 0x3F。0xDA 后面的 0x02 是交替 COM 配置0x12 是顺序 COM接错会导致显示错行。0x8D 的 0x14 是开启内部电荷泵0x10 是关闭用外部 VCC 时改 0x10。对比度 0x8F 是中等偏亮电池供电时可以降到 0x5F 省电。3.3 写命令与写数据的底层函数I2C 写命令和写数据的区别在于控制字节0x00 表示后面跟的是命令0x40 表示后面跟的是数据。下面是对应函数// 写命令控制字节 0x00 void OLED_WriteCmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR 1, buf, 2, 100); } // 写数据控制字节 0x40 void OLED_WriteData(uint8_t data) { uint8_t buf[2] {0x40, data}; HAL_I2C_Master_Transmit(hi2c1, OLED_ADDR 1, buf, 2, 100); }逻辑说明每次传输两个字节第一个是控制字节第二个是命令或数据。OLED_ADDR 是 7 位地址左移一位后传给 HAL。超时 100 毫秒足够。如果通信频繁失败把超时加大到 500 毫秒或者改用 DMA 传输。注意 I2C 速率不要超过 400kHz0.5 寸模组的排线较长时100kHz 更稳。3.4 刷出一行字的完整流程设置页地址和列地址然后连续写数据。下面是在第 0 页第 0 列显示“123”的代码// 在指定页和列显示一个 6x8 字符 void OLED_ShowChar(uint8_t page, uint8_t col, char ch) { uint8_t i; uint8_t idx ch - 0; // 只处理数字 OLED_WriteCmd(0xB0 page); // 设置页地址 OLED_WriteCmd(0x00 (col 0x0F)); // 列低 4 位 OLED_WriteCmd(0x10 (col 4)); // 列高 4 位 for (i 0; i 6; i) { OLED_WriteData(Font6x8[idx][i]); } } // 主循环中调用 OLED_ShowChar(0, 0, 1); OLED_ShowChar(0, 6, 2); OLED_ShowChar(0, 12, 3);参数说明页地址 0xB0 到 0xB3 对应 64×32 的 4 页。列地址分两次写低 4 位和高 4 位这是 SSD1306 的寻址方式。每个字符占 6 列所以下一个字符列坐标加 6。如果显示出来是乱码先检查取模方向再检查页地址是否超出范围。4. 0.5寸OLED资料使用中的避坑与排查五个真实翻车点4.1 屏幕不亮但I2C能扫到地址现象扫描到 0x3C写初始化命令后屏幕全黑。原因电荷泵没开启或者 RES 复位时序不对。解决确认 0x8D 后面跟的是 0x14RES 拉低至少 3 微秒再拉高拉高后延时 100 毫秒。如果模组 RES 直接接 VCC检查上电斜率太慢会导致内部复位失败可以在 RES 对地加 100nF 电容。4.2 显示内容整体偏移或只显示一半现象字只显示左半部分或者整体右移几个像素。原因SH1106 和 SSD1306 的显存列数不同SH1106 是 132 列初始化后需要设置显示偏移。解决在初始化里加 0xD3 命令后面跟偏移值0.5 寸 64 列屏通常设 0x02 或 0x04。如果是 SSD13060xD3 设 0x00。4.3 字上下颠倒或左右镜像现象显示正常但方向不对。原因段重映射和 COM 扫描方向配置反了。解决交换 0xA0 和 0xA1交换 0xC0 和 0xC8。这两个命令组合决定四个方向试两次就能找到正确的。不要改取模数据改初始化命令更快。4.4 亮度不足或闪烁现象屏幕能亮但很暗或者亮度跳动。原因对比度设置太低或者电荷泵电容容量不够。解决把 0x81 后面的值从 0x8F 提到 0xCF同时检查模组上的电荷泵电容是否焊接良好。电池供电时VCC 跌落也会导致闪烁在 VCC 和 GND 之间并一个 10 微法电容。4.5 长时间运行后花屏或死机现象跑几个小时后屏幕出现随机像素或者 I2C 通信卡死。原因I2C 总线被干扰或者显存写入越界。解决I2C 加 4.7k 上拉走线远离电机和无线模块。显存写入时严格检查页地址不超过 364×32或 748×64列地址不超过 63。如果还花屏在刷屏前加一个清屏操作把显存全部写 0。5. 把0.5寸OLED资料用出进阶效果局部刷新与低功耗技巧局部刷新是 0.5 寸屏最值得练的技巧。全屏刷新一次要写 64×4256 字节I2C 在 100kHz 下大约 25 毫秒看起来不多但如果每秒刷 30 次功耗就上去了。局部刷新的做法是只改变化的页和列比如只更新时间数字其他区域不动。下面是一个局部刷新数字的示例先记录旧值只在新旧值不同的列写入// 局部刷新一个 6x8 数字只写变化的列 void OLED_UpdateDigit(uint8_t page, uint8_t col, char old_ch, char new_ch) { uint8_t i; uint8_t old_idx old_ch - 0; uint8_t new_idx new_ch - 0; if (old_ch new_ch) return; // 没变就不写 OLED_WriteCmd(0xB0 page); OLED_WriteCmd(0x00 (col 0x0F)); OLED_WriteCmd(0x10 (col 4)); for (i 0; i 6; i) { if (Font6x8[old_idx][i] ! Font6x8[new_idx][i]) { OLED_WriteData(Font6x8[new_idx][i]); } else { // 相同列也要写因为 I2C 是连续地址不能跳过 OLED_WriteData(Font6x8[new_idx][i]); } } }这段代码里即使列数据相同也要写因为 I2C 写数据是连续地址递增跳过会导致后续列错位。真正的省电做法是只刷新变化的页而不是只刷新变化的列。比如时间显示秒变化时只刷秒所在的页分和时不动。这样每次只写 6 到 12 个字节功耗降到全屏刷新的十分之一。低功耗还有一招利用 OLED 的睡眠命令 0xAE 和唤醒命令 0xAF。在传感器节点里采集间隔 10 秒屏幕只在采集后亮 500 毫秒其余时间睡眠。睡眠时电流从 10 毫安降到 10 微安以下。注意睡眠前不需要清屏唤醒后显存内容还在直接显示即可。对比度也可以动态调。白天设 0xCF晚上设 0x3F配合光敏电阻做自动亮度。0.5 寸屏的对比度寄存器是 0x81后面跟一个字节值越大越亮但超过 0xCF 后寿命会下降。我一般把上限设在 0xBF留一点余量。最后说一个验证方法写一个显存测试函数依次点亮每一页的每一列观察是否有坏点或暗列。0.5 寸屏的坏点率比大屏高尤其是排线焊接处。测试代码很简单双重循环写 0xFF 和 0x00每 200 毫秒切换一次。如果发现某列始终不亮先补焊排线再考虑换模组。我自己用 0.5 寸 OLED 做便携仪表时最深的教训是不要相信模组厂给的初始化序列能直接跑一定要自己用逻辑分析仪抓一遍 I2C 波形确认每个命令都写进去了。有一次调了一整天最后发现是 RES 引脚在 PCB 上被误接到了 GND屏幕永远处于复位状态。从那以后我拿到任何新模组第一件事就是量 RES 和 VCC 的对地阻值确认没有短路。希望帮到你。本文还有配套的精品资源点击获取