简介面向树莓派3B及同类Linux单板计算机的OLED显示驱动套件集中解决基于WiringPi库通过IIC/I2C协议控制0.96寸OLED屏的问题适配SSD1306与SH1106控制器适合嵌入式DIY学习者与物联网项目开发者参考。资源包共包含10个文件整体大小约为19KB文件构成上包括3份C语言源码负责屏幕初始化、像素绘制与字符显示、2份头文件、3份编译中间文件、1份makefile工程配置文件以及1份编译好的可执行程序结构紧凑便于直接编译或对照阅读。目前已有947人学习代码量小而完整配合描述中的编译流程可快速理解驱动从环境配置到生成可执行文件的完整链路。通过阅读驱动源码还能掌握OLED显存操作、坐标设置、文本与图形绘制的具体写法并学习makefile中头文件路径与链接选项的配置思路对后续移植其他传感器驱动同样具有参考价值。1. 树莓派3B使用WiringPi的IIC驱动0.96寸的OLED这张小屏的启动流程比你想的简单树莓派3B使用WiringPi的IIC驱动0.96寸的OLED听起来要啃一堆数据手册实际核心就三步初始化IIC总线、向SSD1306发命令、往显存里填像素。这个组合能把 128x64 的字符和简单图形送到一块大约一块钱硬币大小的屏幕上而且不依赖桌面系统非常适合无头服务器监控、自制仪表盘或者嵌入式入门练习。它不需要外接USB转接板也不需要额外的显示驱动芯片两根信号线就能完成所有通信。这篇笔记我按自己反复搭过的流程写先讲原理和接线再给最小C代码最后把最容易翻车的几类问题单独拎出来希望你能照着复现少走弯路。2. 先搞清原理为什么 IIC 驱动 0.96 寸 OLED 只需两根信号线2.1 SSD1306 是屏幕真正的大脑命令字节和数据字节的区别0.96 寸 OLED 模块背面通常有一颗 SSD1306 控制器。树莓派3B的CPU并不直接控制每个像素它只是通过 IIC 总线给 SSD1306 发字节。SSD1306 内部包含一块 128x64 的显存也就是 GDDRAM它把显存内容映射到玻璃面板上。你写显存屏幕就亮你不写它靠控制器持续刷新树莓派完全不用参与刷新过程。这时就会遇到一个新手最容易绕晕的点同一根 SDA 上发送的字节到底被 SSD1306 当成命令还是数据答案藏在控制字节里。在 SSD1306 的 IIC 协议中每个数据包的第一个字节是控制字节通常0x00表示后续字节是命令0x40表示后续字节是显示数据。控制字节里其实还有 Co 位如果 Co 为 1表示这个包只有一个字节并且该字节本身就是命令或数据。很多驱动库会在内部封装好这两个常量直接用writeCommand(0xAF)和writeData(buf)但用 WiringPi 或裸系统调用时你必须自己组装。所谓 IIC 驱动本质上就是按 SSD1306 数据手册里的初始化序列把一串命令依次写进去。比如0xAE关闭显示、0x8D配合0x14打开内部电荷泵、0xAF打开显示。这些命令对不同厂家、不同尺寸的 SSD1306 模组几乎通用。所以如果你以前在别的平台上驱动过同款屏命令序列可以直接搬过来只是底层发送函数要换掉。2.2 WiringPi 的 IIC 接口从wiringPiI2CSetup到寄存器读写WiringPi 提供了一组精简的 IIC 接口。最常用的是wiringPiI2CSetup(int devId)它打开/dev/i2c-1并返回一个文件描述符。在树莓派3B上设备号通常是 1对应物理引脚 3SDA和 5SCL。返回的 fd 可以传给后续的wiringPiI2CWrite、wiringPiI2CRead等函数。需要注意这个 fd 本质上就是 Linux 的普通文件描述符因此也可以直接用于write()系统调用。wiringPiI2CWrite(fd, data)的作用是向当前从机发送一个字节。对于 OLED这个字节既可以是命令也可以是数据完全取决于你之前发的控制字节。很多人会误用wiringPiI2CWriteReg8(fd, reg, value)以为像操作 EEPROM 一样先写寄存器地址再写值。但 SSD1306 并不是那种按寄存器寻址的芯片它只有命令流和数据流没有传统意义的寄存器地址。我建议只用wiringPiI2CSetup完成地址绑定后续用 Linux 的write()发送多字节数据这样更容易控制 IIC 传输的连续性和 STOP 条件。一个兼容性更好的初始化发送函数可以这样写#include stdio.h #include unistd.h #include fcntl.h #include linux/i2c-dev.h #include sys/ioctl.h #include string.h int i2c_fd; int oled_write_cmd(uint8_t cmd) { uint8_t buf[2] { 0x00, cmd }; // 控制字节: Co0, D/C#0 return write(i2c_fd, buf, 2); } int oled_write_data(const uint8_t *data, int len) { uint8_t buf[1 len]; buf[0] 0x40; // 控制字节: Co0, D/C#1 memcpy(buf 1, data, len); return write(i2c_fd, buf, 1 len); }逻辑说明0x00作为控制字节告诉 SSD1306 接下来的第一个字节是命令。write()把控制字节和命令字节放在同一个 IIC 传输里避免出现“先发控制字节但数据字节被拆成下一次传输”的情况。0x40作为控制字节时后续字节全部按显示数据处理。参数说明i2c_fd可以通过open(/dev/i2c-1, O_RDWR)获得也可以用wiringPiI2CSetup(0x3C)的返回值。但如果混用wiringPiI2CWrite和write同一个 fd 上的传输拆分规则可能不一致我一般只选一种。这里有个容易忽略的点wiringPiI2CSetup返回的 fd 在部分版本里已经设置过I2C_SLAVE所以直接write是可以的。如果你自己open必须用ioctl(fd, I2C_SLAVE, addr)设置从机地址否则write会返回错误。为了减少不确定性我习惯在自己的代码里直接open和ioctl不依赖 WiringPi 的封装但保留 WiringPi 作为初始化参考。2.3 为什么 3B 上这个组合仍然实用有人会问WiringPi 已经不再活跃维护树莓派3B上为什么还要用它一个现实原因是大量教学代码、课程实验和旧项目都建立在 WiringPi API 上而 0.96 寸 OLED 的驱动逻辑非常简单不需要新内核特性。另一个原因是 WiringPi 的gpio readall表格能直观显示引脚编号和 ALT 模式快速确认 IIC 有没有被复用成 GPIO。当然如果你追求长期维护完全可以用内核自带的i2c-dev用户态驱动或者 Python 的smbus2。这个标题聚焦 WiringPi并不是因为它不可替代而是因为它历史包袱轻、示例多、踩坑记录丰富。一旦你理解控制字节和显存位序切换到任何 IIC 库都只是换几个 API 名。在 3B 上还有一个特殊点3B 的硬件 I2C1 时钟频率默认是 100kHz但实际很多 OLED 模块支持 400kHz。WiringPi 本身不提供改总线速度的接口你需要用dtparami2c_armon配合内核参数提升。不过 128x64 的显存只有 1024 字节100kHz 下刷新一次约 80ms显示静态界面完全够用不需要为了这个去调速。3. 接线与初始化把 3B 的 I2C1 和 OLED 连成最小系统3.1 启用内核 I2C 接口raspi-config与/boot/config.txt树莓派3B 默认关闭 I2C 功能。常见做法是先运行sudo raspi-config进入 Interface Options 找到 I2C选择 Enable然后重启。也可以直接改/boot/config.txt追加一行dtparami2c_armon。这个参数会告诉内核加载i2c_bcm2835驱动并生成/dev/i2c-1设备节点。用命令行修改的方式sudo grep -q dtparami2c_armon /boot/config.txt || echo dtparami2c_armon | sudo tee -a /boot/config.txt sudo reboot逻辑说明先检查配置文件中是否已经有这一行避免重复追加。tee -a以追加方式写入grep -q静默判断存在性。重启后 I2C 设备节点才会出现。参数说明i2c_arm对应 CPU 上的 I2C1 控制器也就是物理引脚 3 和 5。千万不要写dtparami2c_vcon那是给摄像头和显示接口用的引脚不同。重启后确认设备节点ls -l /dev/i2c-1 lsmod | grep i2c如果能列出/dev/i2c-1说明内核已经创建设备。如果没有大概率是系统没识别到设备树参数。3B 上一般不会失败但如果你用的是第三方精简系统可能缺少 i2c 设备树模块。这时候可以查一下/boot/overlays/目录下有没有i2c1.dtbo有的话手动加dtoverlayi2c1再试。3.2 引脚对照表3B 的物理引脚 3 和 5 对应 I2C1树莓派 40Pin 排针上I2C1 的 SDA 在物理 pin 3对应 GPIO2SCL 在物理 pin 5对应 GPIO3。OLED 模块上的 SDA、SCL 分别接这两个VCC 接 3.3VGND 接 GND。很多 OLED 模块同时支持 IIC 和 SPI板上会有几个电阻或跳线用来切换模式购买时如果发现引脚很多先确认模块已经焊成了 IIC 模式。下面是引脚对照表OLED 模块引脚树莓派3B 物理引脚作用VCC1 (3.3V)电源不要超过 3.5VGND6 (GND)共地SCL5 (GPIO3)I2C1 时钟SDA3 (GPIO2)I2C1 数据注意有些 OLED 模块丝印上写的是 C 和 D其中 C 是 SCK/SCLD 是 SDA。不要看到 C 就以为是时钟看到 D 就以为是数据。模块上的 D 往往指的是 DATA也就是 SDA。接反的后果是i2cdetect扫不到地址屏幕偶尔亮一下但没有内容。I2C 总线需要上拉电阻。树莓派3B 的内部已经给 GPIO2/GPIO3 配上拉了所以即使模块上没有上拉电阻信号也能工作。如果模块上自带上拉相当于两个上拉并联信号更强但不要接外部可调电阻把电压拉太高。检查接线的一个技巧启用 I2C 后用gpio readall查看 pin 3 和 pin 5 的模式如果显示 ALT0说明引脚被硬件 I2C 占用。3.3 用i2cdetect扫地址0x3C 还是 0x3D接线完成后先不要急着写 C 代码。用系统自带工具确认设备地址sudo apt-get install -y i2c-tools sudo i2cdetect -y 1-y 1表示扫描 I2C 总线 1。如果 OLED 正常工作输出里会有一个3c。大部分 0.96 寸 OLED 模块默认地址是 0x3C少数模块通过板上的地址选择电阻改为 0x3D。i2cdetect 会扫描 0x03 到 0x77 的所有地址只要有 ACK 就会显示出来。扫描结果空白时先检查接线和是否重启。VCC 没接好或 GND 悬空的表现就是扫不到。这里有一个经验不要用太长的杜邦线15cm 左右最稳。IIC 是漏极开路长线会增加电容导致沿变缓模块无法正确识别。我遇到过几次换短线后立刻扫到地址。如果扫到3c但后面初始化返回 -1可能是代码里地址写错。注意wiringPiI2CSetup(0x3C)传的是 7 位地址i2cdetect 显示的也是 7 位地址两者一致。有些旧代码里会写0x3C 1那是内核老驱动要求的 8 位地址。WiringPi 内部已经处理了左移你再左移一次就变成 0x78肯定找不到设备。注意在/boot/config.txt里加dtparami2c_armon后如果总线被占用可以用dmesg | grep i2c查看内核日志。不要反复重启后才发现配置文件根本没生效。4. 用 WiringPi 写最小驱动命令序列、显存填充和字符显示4.1 打开 IIC 设备并配置 OLED初始化命令数组逐条解释我直接给一个可用的 C 文件骨架。常见做法是用wiringPiI2CSetup拿 fd但为了避免不同 WiringPi 版本对write的影响这里手动open并ioctl初始化命令用手写函数发送。#include stdio.h #include unistd.h #include fcntl.h #include linux/i2c-dev.h #include sys/ioctl.h #include string.h #define OLED_ADDR 0x3C static int fd; static int oled_write_cmd(uint8_t cmd) { uint8_t buf[2] { 0x00, cmd }; return write(fd, buf, 2); } static int oled_write_data(const uint8_t *data, int len) { uint8_t buf[1 len]; buf[0] 0x40; memcpy(buf 1, data, len); return write(fd, buf, 1 len); } void oled_init(void) { oled_write_cmd(0xAE); // 关闭显示 oled_write_cmd(0x20); // 设置内存寻址模式 oled_write_cmd(0x00); // 水平寻址 oled_write_cmd(0x81); // 设置对比度 oled_write_cmd(0x7F); // 对比度值 oled_write_cmd(0xA8); // 设置多路复用比 oled_write_cmd(0x3F); // 64 行 oled_write_cmd(0xD3); // 设置显示偏移 oled_write_cmd(0x00); // 无偏移 oled_write_cmd(0x40); // 起始行 0 oled_write_cmd(0x8D); // 电荷泵设置 oled_write_cmd(0x14); // 使能电荷泵 oled_write_cmd(0xA1); // 段重映射 oled_write_cmd(0xC8); // COM 扫描方向 oled_write_cmd(0xDA); // COM 引脚配置 oled_write_cmd(0x12); oled_write_cmd(0xAF); // 打开显示 }逻辑说明oled_write_cmd的buf[0]0x00表示后续是命令oled_write_data的buf[0]0x40表示后续是显示数据。初始化命令里的0x20和0x00是设置水平寻址模式这样连续写 128 字节数据后列地址自动回到 0页地址自动加 1适合刷新整块显存。0x81和0x7F是设置对比度数值越大越亮范围 0x00 到 0xFF。0x8D和0x14必须成对出现少了它你会发现屏幕一片漆黑。0xA1和0xC8这两条非常关键。0xA1表示段重映射开启0xC8表示 COM 扫描方向反向。如果你的屏幕显示内容是镜像的问题基本都出在这两条上。不同模块的排线方式不同可能需要改为0xA0和0xC0这不算 bug只是模块硬件差异。main函数中打开设备int main(void) { fd open(/dev/i2c-1, O_RDWR); if (fd 0) { perror(open); return 1; } if (ioctl(fd, I2C_SLAVE, OLED_ADDR) 0) { perror(ioctl); return 1; } oled_init(); return 0; }参数说明I2C_SLAVE告诉内核后续读写都发给地址0x3C。如果你用的是wiringPiI2CSetup(0x3C)它内部做的是同样的事返回的 fd 可以直接替换这里的fd。但注意别在wiringPiI2CSetup之后又手动ioctl改地址那会让状态混乱。4.2 把像素写进显存页面寻址与 buffer 数组SSD1306 的显存组织方式按页划分共 8 页每页 8 行像素。水平寻址模式下你从左上角开始连续写 128 个字节填满第一页然后第二页。因此最自然的做法是在 C 中维护一个长度为 1024 的framebuffer所有绘图操作都写在数组里最后一次性刷新。uint8_t framebuffer[1024]; // 128 * 64 / 8 void oled_clear(void) { memset(framebuffer, 0, sizeof(framebuffer)); oled_refresh(); } void oled_refresh(void) { uint8_t col_cmd[] { 0x00, 0x21, 0x00, 0x7F }; write(fd, col_cmd, sizeof(col_cmd)); uint8_t page_cmd[] { 0x00, 0x22, 0x00, 0x07 }; write(fd, page_cmd, sizeof(page_cmd)); oled_write_data(framebuffer, sizeof(framebuffer)); }逻辑说明0x21是设置列地址命令后面跟起始列0x00和结束列0x7F也就是 0 到 127。0x22是设置页地址命令后面跟起始页0x00和结束页0x07。这两条命令把读写窗口锁定到整个显存区域。oled_write_data会先发0x40控制字节再发 1024 字节数据SSD1306 自动递增地址。参数说明如果你只想刷新特定页比如只刷新第 0 页和第 2 页可以把页结束地址改成0x02然后只发 256 字节数据。这样可以减少 IIC 负载减少闪烁。但最小驱动里整块刷新更简单1024 字节在 100kHz 下大约需要 80ms人眼基本看不出延迟。像素位序要注意每个字节的 8 个 bit 对应同一页上的 8 行像素bit0 是第 0 行bit7 是第 7 行。因此画点函数必须把坐标换算成“页地址 列地址 位偏移”void oled_set_pixel(int x, int y, int on) { if (x 0 || x 128 || y 0 || y 64) return; int page y / 8; int bit y % 8; int index page * 128 x; if (on) framebuffer[index] | (1 bit); else framebuffer[index] ~(1 bit); }逻辑说明page y / 8得到该行所在页bit y % 8得到该行在页内的偏移。index page * 128 x是一个字节在 framebuffer 中的位置。1 bit把对应位置 1实现点亮。这个函数不直接和 IIC 交互只改数组必须配合oled_refresh()才会显示。4.3 显示字符串简易 ASCII 字库与滚动刷新如果要显示字母、数字和标点最简单的方法是内置一个 8x8 ASCII 字库。字库本质是一个const uint8_t font[95][8]数组每个字符占用 8 个字节每个字节表示一行 8 个像素。我不在这里贴完整字库你可以从任何开源字体取模工具生成也可以手工编几个字符先验证位序。下面这个函数用画点的方式把字符绘制到 framebuffervoid oled_draw_char(int x, int y, unsigned char c) { if (c 32 || c 126) c ?; const uint8_t *glyph font[c - 32]; for (int row 0; row 8; row) { uint8_t line glyph[row]; for (int col 0; col 8; col) { if (line (1 col)) { oled_set_pixel(x col, y row, 1); } } } } void oled_draw_string(int x, int y, const char *s) { int cx x; while (*s) { oled_draw_char(cx, y, (unsigned char)*s); cx 8; if (cx 120) break; s; } }逻辑说明font[c - 32]把字符映射到字库下标因为字库通常从空格开始排列。glyph[row]的 8 个 bit 从左到右对应一行的 8 个像素通过循环判断并调用oled_set_pixel。cx是当前字符的 x 坐标每画完一个字符向右平移 8 像素超出右边界就停止。参数说明如果字符间距太挤可以把cx 8改成cx 9。但字库本身是 8x8你需要在字库左侧或右侧留一列空白。否则会出现字符粘在一起的情况。显示字符串时别忘记随后调用oled_refresh()否则显存变了但屏幕不更新。这里我建议你先在屏幕上画一个白色矩形或一条直线验证坐标系统再画字符串。因为字符串的字库如果位序反了显示结果会是一堆乱麻很难排查。先画点、再画线、最后画字符每一步都调通你才知道是字库问题还是坐标问题。我见过有人一上来就用别人的 1024 字节字库结果字符上下颠倒最后发现是取模方向跟 SSD1306 的起始行不完全一致。用oled_set_pixel手动点个 L 形就能快速确认坐标。5. 避坑指南树莓派3B驱动0.96寸OLED的5个常见问题5.1 现象屏幕白屏或花屏初始化命令写进去没反应白屏通常表现为整块屏幕亮成一片白色或者出现随机的雪花点。原因一般是初始化命令不完整。最常见的是缺少0x8D, 0x14这对电荷泵命令。SSD1306 在内部升压未打开时OLED 驱动电压不足像素会处于一种不受控的亮度状态。解决方法是检查命令序列确保0x8D后面跟着0x14而且顺序不能反。另一种花屏原因是控制字节用错。如果你在发命令时把控制字节写成0x80SSD1306 会把它解释为“单字节命令”后面的数据字节会被当成另一个命令。于是你的显存写入根本没有发生屏幕上就残留了初始化时的随机状态。解决命令控制字节固定为0x00数据控制字节固定为0x40不要混用。还有一类白屏是刷新前没有设置列地址和页地址。如果之前 SSD1306 的地址指针停在显存末尾你发送的数据会写到不可见区域。解决在oled_refresh开头一定要发0x21, 0x00, 0x7F和0x22, 0x00, 0x07把窗口重置到左上角。5.2 现象i2cdetect扫不到 0x3C屏幕毫无反应最常见的现象是执行sudo i2cdetect -y 1后输出表格里全是--。原因分三类接线问题、电源问题、I2C 未启用。先确认/dev/i2c-1存在如果不存在查/boot/config.txt的dtparami2c_armon是否生效。然后量电压OLED 的 VCC 引脚对 GND 应该是 3.3V低于 3.0V 基本无法工作。SDA/SCL 接反是另一个高频原因。模块上丝印如果写着 D 和 CD 接 SDAC 接 SCL。有些模块正面丝印不规范反面才有标注遇到扫描不到时先翻过来看。解决不要依赖颜色和记忆用万用表蜂鸣档测一下模块引脚焊盘到排针的连通性确保没有虚焊。我遇到过一次很奇怪的问题i2cdetect 能扫到地址但每次扫到的结果不一样有时 0x3C 消失。后来发现是杜邦线太长线芯氧化导致接触电阻不稳定。换成短线并重新插拔后就稳定了。所以扫不到时先把线换短别一上来就怀疑芯片烧了。5.3 现象WiringPi 初始化返回 -1但i2cdetect正常wiringPiI2CSetup返回 -1 是一个很让人沮丧的情况因为系统工具明明能看到设备。第一个原因是权限。当前用户没有/dev/i2c-1的访问权open会失败。解决办法是用sudo ./your_program先验证如果 sudo 后正常就把用户加入i2c组sudo usermod -aG i2c $USER重新登录。第二个原因是地址写错。wiringPiI2CSetup(0x3C)中传的是 7 位地址。如果你抄了一段老代码里面写的是wiringPiI2CSetup(0x78)这相当于把 8 位地址直接传给内核内核会当成 7 位地址去匹配自然失败。解决统一按照 i2cdetect 显示的十六进制值不加任何左移或右移。第三原因是你之前已经调用过一次wiringPiI2CSetup但没有保存返回的 fd也没有关闭然后又调用第二次。WiringPi 内部每次 setup 都会 open 一次fd 泄露到一定数量后内核会拒绝打开新设备。解决在程序里只调用一次 setup用完close(fd)。如果你用的是wiringPiSetup()初始化也要先检查它是否返回非负。5.4 现象程序跑几分钟后卡死或 OLED 不再刷新程序一开始显示正常过一段时间write调用阻塞CPU 占用升高最后只能 CtrlC 退出。原因通常是 I2C 总线被某个从机拉死。SSD1306 如果收到错误命令可能会一直把 SCL 拉低产生总线死锁。解决在每次write后检查返回值如果小于 0立即perror并退出不要盲目重试。一旦发现死锁需要把 OLED 的 SDA/SCL 断开让上拉电阻恢复总线然后再重新插拔。另一个原因是你在刷新循环里没有加延时。频繁刷新 1024 字节会让 I2C 控制器持续工作树莓派3B 的 CPU 占用升高看起来像卡死。实际上程序还在跑只是 IIC 中断占用了大量时间。解决在两次刷新之间加usleep(100000)也就是每秒刷新 10 次足够显示动态数字也不会让系统变慢。还有一种少见情况你和其它设备共用了 I2C 总线某个设备在启动时未就绪导致总线 ACK 异常。树莓派3B 上我一般不推荐把 OLED 和传感器并联在同一 I2C1 总线上做长期运行因为一个设备坏掉会拖死整条总线。如果必须共用最好给传感器加独立的使能控制。5.5 现象屏幕发烫甚至闻到异味屏幕温度明显升高显示亮度也不正常这时要立刻断电。原因多半是 VCC 接到了 5V。0.96 寸 OLED 模块虽然有稳压芯片但长期 5V 输入会让稳压器发热严重SSD1306 的逻辑电平也接近上限。解决改用 3.3V 供电即树莓派物理 pin 1。还有一种发热情况是 GND 没接好。如果 OLED 的 GND 没有和树莓派共地电流会从 SDA 或 SCL 灌入导致芯片异常发热同时 i2cdetect 可能扫不到。解决用万用表量一下模块 GND 和树莓派 GND 之间的电阻应该接近 0。某些裸屏模块没有稳压芯片丝印上会注明只能接 3.3V。这种模块如果接 5V轻则发热重则直接烧毁。购买时如果没写支持 3.3V 到 5V一定当成只能接 3.3V。我个人的习惯是无论任何模块只要信号线是 3.3V 电平电源一律接 3.3V省去电平转换的烦恼。6. 让 OLED 真正实用做一个资源监视小工具当你能点亮屏幕并显示 ASCII 字符串后下一步不是继续死磕寄存器而是把屏幕用起来。我最常用的场景是把 0.96 寸 OLED 变成树莓派3B 的迷你监视屏第一行显示 CPU 负载第二行显示内存使用情况。这样即使没有 HDMI 屏幕也能随时掌握这台小主机的健康状态。实现思路很简单沿用第 4 章的oled_draw_string函数读取/proc/loadavg和/proc/meminfo格式化后分别绘制到屏幕的y0和y16。刷新频率控制在 1 秒不要无脑刷。下面是一个读取 CPU 负载的片段char line[32]; FILE *fp fopen(/proc/loadavg, r); float load; if (fp) { fscanf(fp, %f, load); fclose(fp); sprintf(line, CPU:%.2f, load); oled_clear(); oled_draw_string(0, 0, line); oled_refresh(); }逻辑说明/proc/loadavg的第一个浮点数是 1 分钟平均负载。sprintf拼接成固定长度的字符串字符串只调用一次刷新。注意我在每帧先oled_clear再重画避免数字残影。如果你觉得清屏闪烁可以改成只画一个背景色再覆盖但 1 秒刷新一次肉眼基本看不到闪烁。内存占用的读取方法类似读取MemTotal和MemFree计算使用率后画到第二行。这里有一个细节MemTotal的单位是 kB不要直接乘 1024否则数字会大得离谱。用浮点数计算后保留一位小数即可。这个工具的进阶是局部刷新。整块 framebuffer 有 1024 字节1 秒刷新一次虽然没问题但如果把刷新率提高到 10Hz整块刷新会占用较多带宽。更稳的做法是只刷新第 0 页和第 2 页也就是把oled_refresh里的页结束地址从0x07改成0x02然后只发送对应页的 256 字节。这样字符区域和数字区域可以独立更新互不干扰。最后说点个人的教训我最早做这个监视屏时为了追求流畅把刷新率调到了 20Hz结果屏幕亮度下降而且程序占用了不少 CPU。后来发现对于 0.96 寸 OLED静态界面 2Hz 足够动态数字 10Hz 已经是人眼极限。之后我把刷新降下来温度也低了系统负担小了很多。硬件驱动这行不是越快越好而是够用才好。希望这篇笔记能帮你把这块小屏真正用起来少走我踩过的弯路。本文还有配套的精品资源点击获取