企业官网建设流程全解析

简介：针对野火STM32F1开发板，提供0.96寸OLED（IIC接口）波形显示的完整工程源码，适合单片机入门及进阶学习者快速上手屏幕驱动与波形绘制。资源基于SSD1306驱动IC，涵盖I2C通信配置、坐标寻址、绘图函数及显示缓冲等关键模块，可帮助理解BS0~BS2引脚电平对通信模式的影响。压缩包共209个文件，以C源码、头文件、工程编译中间文件为主，附带Keil工程配置（uvprojx/uvoptx）及烧录HEX文件，整体仅7.36MB，下载后可直接编译验证。目前已有2077人学习，尤其适合需要在实际项目中集成OLED显示、实现采样波形输出的STM32开发者。

1. 一块 0.96 寸 OLED 的隐藏打开方式：STM32 单片机用它画波形

把 STM32 单片机的实时采样数据用 IIC 接口丢到一块 0.96 寸 OLED 上，直接画出滚动波形，这套代码包真正解决的是调试看板的问题——没有串口助手、没有上位机时，ADC 输入、传感器输出、心率信号这些模拟量到底长什么样，眼睛看不见就只能靠猜。资源里包含完整的 OLED 驱动、画点与波形刷新函数，核心思路是用 128x64 分辨率的页寻址缓冲，把「采样值」映射成「屏幕 Y 坐标」，再用局部刷新策略绕开 IIC 速度瓶颈。适合正在做数据采集、信号监测类项目的人，也适合想把 IIC OLED 驱动彻底吃透的入门者。看完这篇，你能直接复现一个每秒稳定刷新二十帧以上的实时波形屏。

2. IIC 驱动 SSD1306：从时序参数到初始化序列

2.1 IIC 与 SSD1306 的通信协议：地址、起始条件、控制字节

市面上绝大多数的 0.96 寸 OLED 模块走的都是 SSD1306 驱动芯片，IIC 接口只是它的一种物理连接方式。IIC 总线上只有 SCL 和 SDA 两根线，所有通信都靠主设备发起起始条件、发送从机地址、再传数据完成。SSD1306 的 7 位 IIC 地址出厂默认是 0x3C，左移一位变成 8 位写地址就是 0x78。如果模块背面的 SA0 电阻跳到了高电平，地址会变成 0x3D，写地址对应 0x7A。这个细节是很多人白屏的第一道坎，后面避坑章节会专门展开。

驱动 SSD1306 之前，先把底层的 IIC 读写函数写好。我习惯用软件模拟 IIC，因为换单片机型号时不用重新翻参考手册配硬件外设，直接把两个 GPIO 设成开漏输出就能跑。核心读写代码如下：

// 软件模拟 IIC，SCL=PB6，SDA=PB7，GPIO 开漏模式 #define IIC_SCL_H() GPIOB->BSRR = (1 << 6) #define IIC_SCL_L() GPIOB->BRR = (1 << 6) #define IIC_SDA_H() GPIOB->BSRR = (1 << 7) #define IIC_SDA_L() GPIOB->BRR = (1 << 7) #define IIC_SDA_READ() ((GPIOB->IDR >> 7) & 1) static void iic_delay(void) { // 3us 延时，72MHz 主频下约 200 个 NOP for (volatile uint8_t i = 0; i < 20; i++); } static void iic_start(void) { IIC_SDA_H(); IIC_SCL_H(); iic_delay(); IIC_SDA_L(); // 时钟高电平期间拉低数据线，产生起始条件 iic_delay(); IIC_SCL_L(); } static void iic_stop(void) { IIC_SDA_L(); IIC_SCL_H(); iic_delay(); IIC_SDA_H(); // 时钟高电平期间拉高数据线，产生停止条件 iic_delay(); } static void iic_write_byte(uint8_t dat) { for (uint8_t i = 0; i < 8; i++) { if (dat & 0x80) IIC_SDA_H(); else IIC_SDA_L(); dat <<= 1; IIC_SCL_H(); iic_delay(); IIC_SCL_L(); iic_delay(); } // 第 9 个时钟周期释放 SDA，等待从机应答 IIC_SDA_H(); IIC_SCL_H(); iic_delay(); IIC_SCL_L(); }

逻辑说明：起始条件必须在 SCL 高电平时让 SDA 产生下降沿，停止条件则是 SCL 高电平时 SDA 产生上升沿，这是 IIC 协议的基本时序约束。iic_write_byte 中每一位数据在 SCL 低电平时准备好，高电平时被从机采样，第 9 个时钟释放 SDA 读 ACK，从机拉低表示应答正常。

参数说明：iic_delay 里的循环次数直接决定 IIC 时钟频率。循环 20 次大约对应 100kHz 标准模式，如果想让刷新更快，可以缩减到 5 次左右提到 400kHz 快速模式。但注意，这个延时和主频强相关，换芯片后最好用示波器量一下 SCL 实际频率，别凭感觉改。

2.2 初始化序列：128x64、电荷泵、对比度参数怎么配

SSD1306 上电后默认是关显示状态，必须按固定顺序写入配置命令才能点亮。初始化序列看起来不长，但每个参数的取值都对应具体硬件行为。电荷泵必须打开，否则屏幕没有负压驱动，整屏根本不会亮；对比度寄存器决定像素点亮时的驱动电流；时钟分频和预充电周期则影响刷新稳定性和残影程度。

static void oled_write_cmd(uint8_t cmd) { iic_start(); iic_write_byte(0x78); // 从机写地址 iic_write_byte(0x00); // 控制字节：Co=0, D/C#=0，表示后续是命令 iic_write_byte(cmd); iic_stop(); } void oled_init(void) { oled_write_cmd(0xAE); // 关闭显示，进入配置模式 oled_write_cmd(0xD5); oled_write_cmd(0x80); // 显示时钟分频因子 oled_write_cmd(0xA8); oled_write_cmd(0x3F); // 多路复用比：64 行 oled_write_cmd(0xD3); oled_write_cmd(0x00); // 显示偏移：0 oled_write_cmd(0x40); // 起始行：0 oled_write_cmd(0x8D); oled_write_cmd(0x14); // 电荷泵使能 oled_write_cmd(0x20); oled_write_cmd(0x02); // 页寻址模式 oled_write_cmd(0xA1); // 段重映射：左右镜像修正 oled_write_cmd(0xC8); // COM 扫描方向：上下镜像修正 oled_write_cmd(0xDA); oled_write_cmd(0x12); // COM 引脚配置 oled_write_cmd(0x81); oled_write_cmd(0xCF); // 对比度：207 oled_write_cmd(0xD9); oled_write_cmd(0xF1); // 预充电周期 oled_write_cmd(0xDB); oled_write_cmd(0x40); // VCOMH 电平 oled_write_cmd(0xA4); // 关闭全局显示 oled_write_cmd(0xA6); // 正常显示，不反色 oled_write_cmd(0xAF); // 打开显示 }

逻辑说明：每个命令都是先用控制字节 0x00 告知 SSD1306 接下来是命令而非显示数据，然后再发具体寄存器值。0xA8 后面的 0x3F 表示 64 行复用，对应 0.96 寸屏的物理分辨率 128x64。0xA1 和 0xC8 这两条命令跟屏幕镜像相关，不同厂家的模块 PCB 走线不同，如果显示的内容左右颠倒，就改成 0xA0 和 0xC0。

参数说明：对比度 0xCF 是常用值，偏亮偏暗可以在 0x40 到 0xFF 之间调。预充电周期 0xF1 影响像素点亮速度，调太大会出现拖影，调太小亮度不够。VCOMH 0x40 是多数模块的稳定工作点，电池供电可以尝试 0x10 省电，但可能出现水平条纹。

2.3 数据传输的控制字节：0x00 与 0x40 的区别必须刻进脑子

SSD1306 的数据流里，紧跟从机地址之后的那一个字节叫控制字节，它决定本次传输是写命令还是写数据。控制字节的位定义是 Co（continuation）+ D/C#（data/command）。Co=0 表示后续字节都是同类型；D/C#=0 表示命令，D/C#=1 表示数据。于是 0x00 代表纯命令流，0x40 代表纯数据流。

很多初学者直接把命令和数据混在一个 IIC 传输里发，结果屏幕完全没反应。SSD1306 的规定是：一个控制字节后面可以跟多个同类型字节，但命令和数据切换必须重新产生起始条件并发送新的控制字节。常见的 OLED 型号驱动代码里，写命令函数和写数据函数是分开的，原因就在这里。数据写入函数如下：

static void oled_write_data(uint8_t dat) { iic_start(); iic_write_byte(0x78); // 从机写地址 iic_write_byte(0x40); // 控制字节：D/C#=1，表示后续是数据 iic_write_byte(dat); iic_stop(); }

逻辑说明：写数据函数唯一变化的就是控制字节从 0x00 变成 0x40，告诉 SSD1306 把后续字节填充到当前页地址对应的显示 RAM 中。理解这个区别后，再去看初始化序列和画点函数，整个驱动的读写逻辑就串起来了。

参数说明：0x40 控制字节后面可以连续发送多个数据字节，IIC 协议允许一次传输多个字节，SSD1306 会自动递增列地址。这意味着批量刷新时可以大幅减少起始条件和地址开销，对提升刷新率很关键。后面波形显示用到批量数据写入时，会一次性把一整列或一整行数据发出去，而不是一个字节一次起始条件。

3. 波形显示的核心：从画点到滚动刷新

3.1 用二维缓冲绕过页寻址的画点函数

SSD1306 内部的显示 RAM 被分成 8 页（page），每页对应屏幕的 8 行像素，垂直方向一页覆盖 8 个像素位。所以显示 RAM 的排布是 8 行 x 128 列，一共 1024 字节。初始化时如果选了页寻址模式，写数据时列地址会自动递增，写到第 128 列后不会自动跳到下一页，必须手动设置新的页地址。

这种硬件结构决定了不能像 LCD 那样直接给 X、Y 坐标画点。如果每画一个点都去读回当前页的显示内容再修改，IIC 的读操作麻烦且慢。更常见的做法是在单片机内存里维护一个完整的缓冲数组，所有画点、清屏操作都是改内存，需要显示时才把缓冲批量推到屏幕。

uint8_t oled_buf[8][128]; // 8 页 x 128 列的显示缓冲，等价于 128x64 像素 void oled_set_pixel(uint8_t x, uint8_t y, uint8_t color) { if (x >= 128 || y >= 64) return; // 越界保护 uint8_t page = y >> 3; // y / 8，得到页号 0~7 uint8_t bit = y & 0x07; // y % 8，得到页内偏移 if (color) { oled_buf[page][x] |= (1 << bit); // 点亮该像素 } else { oled_buf[page][x] &= ~(1 << bit); // 熄灭该像素 } }

逻辑说明：y 坐标右移三位相当于除以 8，得到像素落在哪一页；y 与 0x07 取余得到这一页内的具体位偏移。数组的第一个下标是页号，第二个下标是列号，和 SSD1306 的 RAM 结构完全对应。画一整个 8 像素高的字符或者波形轨迹时，只需要改某一个字节的某一位即可，效率非常高。

参数说明：oled_buf 的大小固定为 8*128=1024 字节，对于 STM32F103 这种 20KB 内存的芯片完全无压力。color 参数传入 1 表示点亮，传入 0 表示熄灭。这里越界保护很重要，如果采样值异常导致 y 计算出 64 以上，不保护就会写坏相邻页的数据，显示花屏。

3.2 把 ADC 采样值映射到屏幕坐标

波形显示的实质是把一个模拟量数值换算成屏幕上的 Y 坐标。假设用 12 位 ADC 采样，数值范围 0~4095，屏幕高度是 64 像素，那么 Y 坐标的计算就是一次线性缩放。x 坐标对应采样的时间顺序，从屏幕左边缘到右边缘一共 128 个点，刚好构成一帧波形。

#define SAMPLE_MAX 4095 #define SCREEN_H 64 #define SCREEN_W 128 uint16_t adc_samples[SCREEN_W]; // 存放一次采样的 128 个点 void wave_full_update(void) { memset(oled_buf, 0, sizeof(oled_buf)); // 先清空整帧缓冲 for (uint8_t x = 0; x < SCREEN_W; x++) { uint16_t y = (uint32_t)(SCREEN_H - 1) * adc_samples[x] / SAMPLE_MAX; y = SCREEN_H - 1 - y; // 数值越大显示越靠上 oled_set_pixel(x, y, 1); oled_set_pixel(x, y + 1, 1); // 加粗一点，便于观察 } }

逻辑说明：y 的计算使用先乘法再除法，避免浮点运算。如果先用 SAMPLE_MAX 除以 SCREEN_H 得到步长再去乘，会因为整除误差导致某些数值被压缩到同一行，波形呈阶梯状失真。公式中先减后取反是让数值大的采样点显示在屏幕上方，符合示波器习惯。

参数说明：y + 1 不加越界判断是因为 y 最大为 63 时，y + 1 是 64，会被 oled_set_pixel 的越界保护拦掉，所以这是安全的。SAMPLE_MAX 可以根据实际 ADC 位数调整，如果是 10 位 ADC 改成 1023，如果是有符号数需要先做偏移处理，比如中心零信号要加上 2048 再缩放。

3.3 滚动波形的实现与刷新策略取舍

静态波形一次画 128 个点，适合看一帧完整数据。但实际调试中更常用的是滚动模式，新的采样值不断从屏幕右侧挤进来，旧数据向左移动，看起来像心电图。滚动波形如果每帧都重新画全部 128 列，在 IIC 下刷新率会非常难看，所以核心思路是只更新变化的那一列。

void wave_scroll(uint16_t new_sample) { // 整个缓冲向左移动一列 for (uint8_t page = 0; page < 8; page++) { for (uint8_t i = 0; i < 127; i++) { oled_buf[page][i] = oled_buf[page][i + 1]; } oled_buf[page][127] = 0; // 清空最右列 } // 新采样值画在最右列 uint16_t y = (uint32_t)(SCREEN_H - 1) * new_sample / SAMPLE_MAX; y = SCREEN_H - 1 - y; oled_set_pixel(127, y, 1); oled_set_pixel(127, y + 1, 1); // 只刷新最右一列到屏幕 oled_flush_column(127); }

逻辑说明：滚动操作本质上是一次内存拷贝，把第 i+1 列的数据覆盖到第 i 列，最右列清零等待新数据。因为是在 RAM 缓冲里做的，不涉及 IIC 通信，速度非常快。等新采样值画好后，只需要把最右一列推送到 SSD1306 即可。屏幕显示效果自然向左滚动，因为缓冲区里数据已经左移了。

参数说明：oled_flush_column 是局部刷新函数，只向屏幕发送第 127 列对应的 8 个字节。相比全屏刷新 1024 字节，传输量降低了 128 倍。这是 IIC OLED 波形能做到实时更新的最关键策略，后面第 5 章还会详细计算刷新率的提升幅度。

4. 排查手册：IIC 地址错、缓冲残留、时钟翻车的五类典型现场

4.1 地址错了整屏白：0x78 与 0x7A 到底怎么选

现象：初始化代码写完，屏幕要么全黑要么全白，用示波器量 IIC 波形能看到从机 ACK 时有时无，画面偶尔会闪一下就灭了。

原因：SSD1306 的 7 位 IIC 地址是由 SA0 引脚电平决定的。模块上 SA0 接地，地址是 0x3C 左移一位得到 0x78；SA0 接 VCC，地址是 0x3D 左移一位得到 0x7A。很多卖家不会在详情页标注 SA0 的默认状态，同一个型号不同批次可能都不一样。

解决：写一个扫描函数，依次用 0x78 和 0x7A 发送地址字节，检测 ACK 信号。有 ACK 的那个地址就是正确地址。更快的办法是直接看模块背面，SA0 焊盘上如果有一个 0 欧电阻，顺着它看接到 GND 还是 VCC 即可判断。

4.2 波形滚动后带着鬼影：缓冲没清理干净

现象：滚动波形在原来轨迹的位置残留一条淡影，尤其信号幅度突然变小后特别明显，像显示器烧屏了一样。

原因：加法操作画点没问题，但滚动时如果只从旧列搬到新列，不把最外一列清零，旧的像素数据会一直循环转圈。还有一种情况是画新波形前没有清空缓冲，导致新旧轨迹叠加。

解决：滚动函数里搬完数据后强制写 0 清掉最右列，静态波形更新前用 memset 清空整个 oled_buf。注意 memset 清空缓冲后还需要把整屏刷一遍，否则 RAM 缓冲和屏幕状态不一致，显示还是旧的。

4.3 IIC 时钟太快导致偶发花屏

现象：波形大部分时间正常，但每隔几秒钟会出现几条乱线，屏幕局部错乱，复位后又恢复。用示波器看 SCL 上升沿明显变缓，SDA 数据线上有毛刺。

原因：硬件 IIC 配置到 400kHz 甚至更高时，如果模块飞线比较长、上拉电阻选得太大，信号边沿失真严重，SSD1306 误判数据位。软件模拟 IIC 的延时函数如果写得太短，低速模式下本来能容忍的线间电容就变成了致命问题。

解决：把 IIC 时钟降到 100kHz 到 300kHz 之间，飞线长度控制在 10 厘米以内，上拉电阻用 4.7k 而不是 10k。如果必须用高速，把所有 OLED 相关引脚加上 20pF 到 50pF 的对地电容，可以明显改善边沿质量。

4.4 电平不匹配：3.3V 逻辑驱动 5V 模块的隐患

现象：OLED 能显示但亮度不稳定，初始化偶尔失败，长时间运行后出现随机乱码。测量模块 VCC 引脚电压发现被拉到 4V 左右。

原因：部分模块上自带的稳压芯片是低压差线性稳压器，如果供电接到了 5V，而 STM32 的 SCL 和 SDA 是 3.3V 逻辑，两者在逻辑高电平时电压差太大，可能触发模块内部保护或者导致 ESD 二极管导通。

解决：模块 VCC 统一接 3.3V，确保 SCL、SDA 与 STM32 同电压域。如果模块必须工作在 5V，在 SCL 和 SDA 上各串一个 1k 电阻做分压限流，或者使用电平转换模块。这点对 STM32 这类 3.3V 单片机特别容易踩，很多人直接拿 5V 单片机的接线习惯来套。

4.5 全屏刷新太慢：IIC 协议本身的带宽天花板

现象：波形全屏刷新算法没问题，但屏幕上波形肉眼可见地一帧一帧跳，刷新率不超过 10 帧。优化了所有 memset 和循环，还是卡。

原因：全屏刷新需要发送 1024 字节显示数据，加上每次传输的起始条件、从机地址和控制字节，IIC 标准模式 100kHz 下理论耗时接近 100 毫秒。这是协议层的物理瓶颈，跟代码优化关系不大。初始化里如果把页地址模式设成水平寻址模式，能减少部分命令开销，但数据量没变。

解决：改成局部刷新策略，只发送变化的列和页。滚动波形每次只刷一列，大约 8 字节，即使在 100kHz 标准模式下也能轻松跑到 20 帧以上。如果还要更快，就用硬件 IIC 加 DMA，把传输从 CPU 中解放出来，第 5 章会给出具体做法。

5. 进阶：用局部更新与 DMA 把 IIC 波形跑出示波器感

5.1 局部更新策略：从整屏 1024 字节降到每帧几十字节

当波形只是滚动显示时，真正变化的像素只有最右列的那一两个点。如果还把全屏 1024 字节都推送到 SSD1306，就等于把大量 IIC 带宽浪费在重复数据上。局部更新思路是：算出变化的区域，只把这些区域的字节发过去。滚动波形场景下，每帧最多只需要更新最右列对应的 8 个页字节，其中真正发生点亮的通常只有 1 到 2 个字节。

void oled_flush_column(uint8_t x) { uint8_t page_start = 0, page_end = 7; // 先找到有变化的页范围，减少无意义传输 while (page_start < 8 && oled_buf[page_start][x] == 0 && /* 前一帧也是0 */ 1) { page_start++; } // 简化处理：直接用 0~7 全刷，传输量也只有 8 字节 for (uint8_t page = 0; page < 8; page++) { oled_write_cmd(0xB0 + page); // 设置页地址 oled_write_cmd(0x00 + (x & 0x0F)); // 列地址低 4 位 oled_write_cmd(0x10 + (x >> 4)); // 列地址高 4 位 // 批量发送该页这列的一个字节 iic_start(); iic_write_byte(0x78); iic_write_byte(0x40); iic_write_byte(oled_buf[page][x]); iic_stop(); } }

逻辑说明：这段代码先把页地址设到当前循环的页号，再设置列地址的低 4 位和高 4 位，最后在数据控制字节后发一个字节的像素数据。注意列地址的设置必须先低后高，且每个页都要重新设置一次，因为页寻址模式下列地址不会跨页自动递增。虽然这里简单粗暴地把 8 页全刷了，但总传输量仍然只有 8 个数据字节加少量命令，比全屏刷新快了两个数量级。

参数说明：x 是列号 0~127，0xB0 到 0xB7 是 8 个页地址寄存器。列低 4 位和高 4 位的设置是 SSD1306 页寻址模式的固定流程，低 4 位取 x 与 0x0F，高 4 位取 x 右移 4 位，注意高位要加 0x10 作为基地址。如果想进一步压缩每帧传输量，可以在波形更新函数里记录实际发生变化的页范围，只刷那几页，但对 8 字节来说收益不大。

5.2 IIC 加 DMA：CPU 占用率降到接近零

软件模拟 IIC 在发送数据时，每一个位都需要 CPU 参与。刷新一列 8 字节，大约要执行 72 次位操作加 9 次 ACK 检查，累计循环几百次。如果主循环里还要做 ADC 采样、滤波算法，这些 IIC 时序操作会挤占大量 CPU 时间。把硬件 IIC 打开并配置 DMA 传输后，CPU 只需要设置缓冲区指针和长度，剩下的事全部交给硬件。

// 使用 STM32 硬件 IIC1，DMA1 通道 7 传输数据到 SDA void oled_flush_column_dma(uint8_t x, uint8_t *buf, uint8_t len) { oled_write_cmd(0xB0); // 页地址 oled_write_cmd(0x00 + (x & 0x0F)); // 列低 4 位 oled_write_cmd(0x10 + (x >> 4)); // 列高 4 位 // 等待上一次 DMA 传输完成 while (DMA1->ISR & DMA_ISR_TCIF7) { } DMA1->IFCR = DMA_IFCR_CTCIF7; // 清除完成标志 I2C1->CR2 |= I2C_CR2_DMAEN; // 使能 IIC DMA 请求 DMA1_Channel7->CMAR = (uint32_t)buf; // 源地址：内存缓冲 DMA1_Channel7->CPAR = (uint32_t)&I2C1->DR; // 目标地址：IIC 数据寄存器 DMA1_Channel7->CNDTR = len; // 传输长度 DMA1_Channel7->CCR |= DMA_CCR1_EN; // 启动 DMA }

逻辑说明：DMA 传输启动后，CPU 可以立刻返回继续做采样，IIC 外设会按配置好的速率自动把缓冲数据逐字节发出。注意启动前必须先设置页地址和列地址，否则数据会写到错误位置。等下一次调用时检查上一次完成标志，确保缓冲区不会被覆盖。

参数说明：len 是本次要发送的数据字节数，通常就是 8。DMA 通道号取决于具体芯片型号，F1 系列 IIC1 的 TX 对应 DMA1 通道 7，换芯片必须查数据手册。另外硬件 IIC 在 F1 系列上有一些固有的总线错误问题，如果调试中发现 DMA 传输偶发卡死，可以在传输完成后加一句读取 I2C1->SR1 清空错误标志位。

5.3 用抖动法模拟多级灰度：让波形轨迹更细腻

单色 OLED 只能显示亮和不亮两种状态，但通过空间抖动可以模拟出中间亮度。2x2 像素的抖动模板有 4 种组合，分别对应 0%、33%、67%、100% 的视觉亮度。把波形轨迹附近的像素按模板点亮，信号强的地方亮线更实，信号弱的地方显示虚线，看起来就有层次感。

const uint8_t dither[4][2] = { {0, 0}, // 0% 亮度：不点亮 {0, 1}, // 33% 亮度：右下角点亮 {1, 0}, // 67% 亮度：左上角点亮 {1, 1} // 100% 亮度：全点亮 }; void wave_draw_dither(uint8_t x, uint8_t y, uint8_t level) { uint8_t g = level >> 6; // 0~3 四档灰度 for (uint8_t dy = 0; dy < 2; dy++) { for (uint8_t dx = 0; dx < 2; dx++) { oled_set_pixel(x + dx, y + dy, dither[g][dy * 2 + dx]); } } }

逻辑说明：把计算出的 Y 坐标按灰度分级，每一级对应一个 2x2 模板。点亮的像素越少，该区域的平均亮度越低，人眼在正常观看距离下会把它感知为平滑过渡。这种技术在单色 OLED 上模拟多级亮度，比直接改对比度寄存器灵活得多。

参数说明：x + dx 可能超出 128 列边界时，oled_set_pixel 的越界保护会直接返回，所以这段代码在边缘场景下是安全的。灰度分级可以扩展到 8 档，把模板改成 3x3 或 4x4，但要注意显示细节会变粗，波形边缘出现明显锯齿。实际调试中 4 档是性价比最高的选择，视觉上已经能明显区分强信号和弱信号轨迹。

从我在项目里第一次把全屏刷新改成局部列更新开始，OLED 波形卡顿的问题才算真正破局。那次我花了整整一个晚上排查，最后发现不是代码逻辑问题，而是 IIC 天然慢——从那以后我每次搭 OLED 波形显示，都强制先算一遍每帧传输字节数再动手写刷新函数。硬件 IIC 加 DMA 更是治好了 CPU 占用焦虑，采样循环再也不被显示刷新打断了。这套代码包里除了基础驱动，还有完整的波形滚动例程和灰度演示，下载到本地改一下引脚定义就能跑起来。希望帮到你。

本文还有配套的精品资源，点击获取