企业官网建设流程全解析

1. 从一块0.96寸小屏说起：OLED显示模块到底怎么玩

如果你玩过单片机，大概率绕不开一块巴掌都算不上的小屏幕——0.96寸OLED显示模块。它几乎成了所有嵌入式项目的标配：温湿度计要它、智能小车要它、便携示波器要它、甚至一个简单的按键计数器也要它。为什么？因为这块小屏对比度极高、可视角度接近180度、不需要背光、功耗低到可以用电池撑几个月，而且驱动起来比LCD简单得多。你只需要两根线（I2C）或者四根线（SPI），就能让单片机把字符、数字、甚至简单图形显示出来。

但问题也恰恰出在这里。很多人第一次点亮OLED的时候，要么屏幕全黑，要么满屏雪花，要么显示一半就卡死。网上搜到的代码五花八门，有基于HAL库的、有基于标准库的、有CH32V307这种RISC-V内核的、还有各种STM32F103的。你复制过来一编译，发现引脚定义不对、I2C地址不对、初始化序列不对，折腾半天就是不出图像。更让人头疼的是，有些例程用的是软件I2C，有些用的是硬件I2C，有些甚至用的是SPI，你如果不清楚它们之间的区别，很容易在移植的时候踩坑。

这篇文章就是来解决这些问题的。我会从OLED显示模块的核心原理讲起，把I2C和SPI两种驱动方式的选型逻辑说清楚，然后重点拆解HAL库驱动OLED的完整代码实现，包括I2C地址扫描、初始化序列、显存管理、字符显示和图形绘制。同时我也会提到CH32V307这种RISC-V平台上的I2C OLED例程该怎么移植，因为现在用国产芯片的人越来越多了。不管你是刚入门的新手，还是已经用过几块屏但一直没搞明白底层原理的老手，这篇内容都能让你对OLED驱动有一个系统性的认识。我还会分享一些在实际项目中踩过的坑，比如I2C上拉电阻选多大、显存刷新频率怎么控制、为什么你的屏幕会闪烁等等。这些都是文档里不会写的经验，但恰恰是决定你项目能不能稳定跑起来的关键。

2. OLED显示模块的核心原理与选型逻辑

2.1 OLED为什么能自己发光：从像素结构说起

OLED的全称是有机发光二极管（Organic Light-Emitting Diode）。它的核心结构非常简单：在两层电极之间夹一层有机发光材料。当电流通过时，电子和空穴在发光层中复合，释放出能量并以光的形式发射出来。这跟LED的发光原理类似，但材料是有机物，所以可以做得非常薄，而且每个像素都可以独立控制发光与否。

这就带来了一个巨大的优势：OLED不需要背光。LCD屏幕必须有一个背光层一直亮着，然后通过液晶分子偏转来控制光线通过与否，所以LCD显示黑色的时候，背光其实还在工作，只是被挡住了。而OLED显示黑色的时候，那个像素直接不发光，功耗几乎为零。这就是为什么OLED的对比度可以做到无穷大，黑色是真的黑，不是灰的。

对于0.96寸这种小尺寸模块来说，常见的驱动芯片是SSD1306。它支持最大128x64的分辨率，内置了显存（GDDRAM），可以通过I2C或SPI接口与单片机通信。你写入的数据并不会立刻显示在屏幕上，而是先存到显存里，然后驱动芯片按照一定的刷新率把显存内容扫描到屏幕上。这个机制非常重要，因为它意味着你可以先在单片机内存里构建好一整帧图像，然后一次性写入显存，避免屏幕出现撕裂或闪烁。

2.2 I2C还是SPI：驱动方式的选择逻辑

0.96寸OLED模块通常提供两种接口：I2C和SPI。你买模块的时候要看清楚，有些模块只支持I2C，有些只支持SPI，有些两者都支持但需要焊接不同的电阻来切换。这两种接口各有优劣，选择哪一个取决于你的项目需求。

I2C的优势是引脚少。只需要两根线：SCL（时钟）和SDA（数据），再加上电源和地，总共四根线就能工作。对于引脚资源紧张的单片机来说，这非常友好。而且I2C支持多设备挂载，你可以在同一组总线上挂多个I2C设备，通过不同的地址来区分。SSD1306的I2C地址通常是0x78或0x7A（7位地址是0x3C或0x3D），具体取决于模块上的电阻配置。

但I2C的缺点也很明显：速度慢。标准模式100kHz，快速模式400kHz，高速模式才能到3.4MHz，但大多数单片机只支持到400kHz。对于128x64的屏幕，一帧图像有1024字节的显存数据，加上命令和地址开销，刷新一帧需要不少时间。如果你要做动画或者频繁刷新，I2C可能会成为瓶颈。

SPI的优势是速度快。SPI是全双工同步串行接口，时钟频率可以做到几MHz甚至几十MHz。对于SSD1306来说，SPI接口可以轻松跑到10MHz以上，刷新率比I2C高一个数量级。而且SPI不需要地址帧，协议开销更小。但SPI需要四根线：SCK、MOSI、CS、DC（数据/命令选择），有些还需要RESET。对于引脚紧张的项目来说，这可能会占用太多IO口。

我的建议是：如果你只是显示一些静态的文本或数字，刷新频率不高，用I2C就够了，接线简单，代码也简单。如果你要做波形显示、动画、或者高刷新率的界面，那就用SPI。另外，如果你用的是CH32V307这种引脚比较多的芯片，SPI也不是问题。但如果你用的是STM32F103C8T6这种引脚较少的芯片，I2C可能更合适。

2.3 显存管理与刷新策略：为什么你的屏幕会闪烁

前面提到SSD1306内置了显存，大小为128x64位，也就是1024字节。单片机通过I2C或SPI写入的数据会先存到这个显存里，然后驱动芯片自动扫描并显示。这个机制意味着你不需要持续不断地往屏幕发送数据，只需要在内容变化时更新显存即可。

但这里有一个常见的坑：如果你每次只更新变化的部分，比如只更新一个数字，那么你需要精确计算这个数字在显存中的位置，然后只写入对应的字节。这听起来很高效，但实现起来比较复杂，而且容易出错。更常见的做法是在单片机内存中开辟一个同样大小的缓冲区（通常叫OLED_GRAM或OLED_BUFFER），所有的绘制操作都在这个缓冲区里进行，然后定期把整个缓冲区一次性写入SSD1306的显存。

这种做法的好处是逻辑简单，你不需要关心屏幕上的实际像素位置，只需要在缓冲区里画就行了。但缺点是每次刷新都要传输1024字节，对于I2C来说，400kHz的时钟下，传输1024字节大约需要20多毫秒，也就是刷新率最高只有40多帧。如果你在主循环里频繁刷新，可能会影响其他任务的执行。

更糟糕的是，如果你在刷新过程中屏幕正在扫描，可能会出现撕裂现象。不过SSD1306的扫描频率通常很高，而且显存写入是异步的，所以实际使用中撕裂并不明显。但如果你发现屏幕有闪烁，那可能是刷新频率太低，或者你在刷新时没有关闭显示。有些驱动代码会在写入显存前先发送关闭显示的命令，写完后再打开，这样可以避免闪烁，但会增加额外的开销。

我的经验是：对于大多数应用，不需要每次都刷新整个屏幕。你可以设置一个标志位，只有当缓冲区内容发生变化时才刷新。另外，刷新频率控制在20-30Hz就足够了，人眼不会感觉到明显的闪烁。如果你需要更高的刷新率，那就换SPI接口。

3. HAL库驱动OLED的完整实现与代码拆解

3.1 硬件连接与I2C地址确认

在开始写代码之前，首先要确认硬件连接。以STM32F103C8T6和0.96寸I2C OLED为例，典型的连接方式是：

• OLED的VCC接3.3V（有些模块支持5V，但建议用3.3V以保护STM32的IO口）
• OLED的GND接GND
• OLED的SCL接STM32的PB6（I2C1_SCL）
• OLED的SDA接STM32的PB7（I2C1_SDA）

这里有一个非常重要的细节：I2C总线需要上拉电阻。很多OLED模块自带了4.7kΩ或10kΩ的上拉电阻，但有些模块没有。如果你用的模块没有上拉电阻，或者你直接连接了多个I2C设备，那么你需要在SCL和SDA线上各接一个4.7kΩ的上拉电阻到3.3V。没有上拉电阻的话，I2C通信会不稳定，甚至完全无法工作。

上拉电阻的阻值选择也有讲究。阻值太小，功耗大，而且可能超出IO口的灌电流能力；阻值太大，上升沿变缓，高速通信时波形会失真。4.7kΩ是一个比较通用的选择，对于400kHz的快速模式，2.2kΩ到10kΩ之间都可以工作。如果你发现通信不稳定，可以用示波器看一下SCL和SDA的波形，如果上升沿太慢，就减小阻值。

接下来要确认OLED的I2C地址。SSD1306的7位地址是0x3C或0x3D，对应的8位写地址是0x78或0x7A。你可以通过扫描I2C总线来确认。在HAL库中，可以用HAL_I2C_IsDeviceReady函数来检测设备是否存在。下面是一个简单的扫描代码：

for (uint8_t addr = 0x00; addr < 0x80; addr++) { if (HAL_I2C_IsDeviceReady(&hi2c1, addr << 1, 1, 10) == HAL_OK) { printf("Device found at address: 0x%02X\n", addr); } }

这段代码会遍历所有可能的7位地址，左移一位变成8位地址，然后调用HAL_I2C_IsDeviceReady。如果返回HAL_OK，说明该地址上有设备响应。对于大多数0.96寸OLED，你会看到0x3C或0x3D被打印出来。

3.2 初始化序列：为什么不能随便改

SSD1306的初始化序列是一组命令，用来配置驱动芯片的工作模式、显示方向、对比度、扫描方式等。这些命令必须按照一定的顺序发送，否则屏幕可能不显示或者显示异常。网上有很多版本的初始化序列，有些能用，有些不能用，原因就在于SSD1306有不同的版本和厂商，某些命令的默认值可能不同。

下面是一个比较通用的初始化序列，适用于大多数0.96寸128x64的OLED模块：

static uint8_t OLED_InitCmd[] = { 0xAE, // 关闭显示 0xD5, 0x80, // 设置时钟分频因子 0xA8, 0x3F, // 设置多路复用率 0xD3, 0x00, // 设置显示偏移 0x40, // 设置显示起始行 0x8D, 0x14, // 电荷泵使能 0x20, 0x00, // 设置内存寻址模式 0xA1, // 设置段重映射 0xC8, // 设置COM扫描方向 0xDA, 0x12, // 设置COM硬件引脚配置 0x81, 0xCF, // 设置对比度 0xD9, 0xF1, // 设置预充电周期 0xDB, 0x40, // 设置VCOMH电压 0xA4, // 全局显示开启 0xA6, // 设置正常显示 0xAF // 开启显示 };

这个序列里，有几个命令特别关键。0x8D是电荷泵使能命令，后面跟的0x14表示开启电荷泵。电荷泵的作用是产生OLED所需的高电压，如果不开启，屏幕可能完全不亮或者非常暗。0xA1和0xC8分别控制段重映射和COM扫描方向，这两个命令决定了屏幕的显示方向。如果你发现屏幕显示的内容是镜像的或者倒置的，就是这两个命令配置不对。0xDA是COM硬件引脚配置，0x12表示交替COM引脚配置，这个对于128x64的屏幕是必须的。

还有一个容易忽略的命令是0x20，设置内存寻址模式。0x00表示水平寻址模式，0x01表示垂直寻址模式，0x02表示页寻址模式。大多数例程用的是页寻址模式，因为这样可以直接按页写入显存，不需要计算列地址。但如果你用的是水平寻址模式，写入数据后列地址会自动增加，跨页时行地址也会自动增加，写起来更方便。我个人的习惯是用水平寻址模式，这样刷新整个屏幕的时候只需要发送一次起始地址，然后连续写入1024字节即可。

3.3 显存缓冲区的设计与刷新函数

前面提到，最好在单片机内存中开辟一个显存缓冲区。对于128x64的屏幕，缓冲区大小是128*64/8 = 1024字节。你可以定义一个全局数组：

uint8_t OLED_GRAM[128][8];

这里用二维数组是为了方便按页操作。每一页有8行像素，128列，所以OLED_GRAM[x][y]表示第x列第y页的8个像素。这种布局跟SSD1306的显存组织方式是一致的，写入的时候可以直接按页发送。

刷新函数的作用是把整个缓冲区写入SSD1306的显存。如果用的是水平寻址模式，可以这样写：

void OLED_Refresh(void) { uint8_t cmd[] = {0x21, 0x00, 0x7F, 0x22, 0x00, 0x07}; HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDR, cmd, sizeof(cmd), 100); HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDR, (uint8_t *)OLED_GRAM, 1024, 100); }

这里先发送设置列地址和页地址的命令，0x21设置列地址范围从0到127，0x22设置页地址范围从0到7。然后一次性发送1024字节的显存数据。注意，发送数据的时候，I2C的控制字节需要设置为0x40，表示后面跟的是数据而不是命令。但在HAL库中，如果你直接调用HAL_I2C_Master_Transmit，它会把第一个字节当作地址，后面的都是数据。所以你需要确保OLED_ADDR是8位地址，并且已经包含了读写位。

实际上，更常见的做法是封装一个写命令函数和一个写数据函数：

void OLED_WriteCmd(uint8_t cmd) { uint8_t buf[2] = {0x00, cmd}; HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDR, buf, 2, 100); } void OLED_WriteData(uint8_t data) { uint8_t buf[2] = {0x40, data}; HAL_I2C_Master_Transmit(&hi2c1, OLED_ADDR, buf, 2, 100); }

这里0x00表示后面跟的是命令，0x40表示后面跟的是数据。这是SSD1306的I2C协议规定的。如果你用SPI接口，就不需要这个控制字节，而是用DC引脚来区分命令和数据。

3.4 字符显示与图形绘制：从点阵到界面

有了显存缓冲区和刷新函数，接下来就可以在缓冲区里绘制内容了。最基本的操作是画点：

void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t mode) { if (x >= 128 || y >= 64) return; if (mode) { OLED_GRAM[x][y / 8] |= (1 << (y % 8)); } else { OLED_GRAM[x][y / 8] &= ~(1 << (y % 8)); } }

这个函数根据坐标计算出对应的字节和位，然后设置或清除。注意y/8得到页号，y%8得到位号。mode为1时置位，为0时清零。

字符显示通常使用点阵字库。对于ASCII字符，常用的字库是8x16或6x8。8x16的字库每个字符占用16个字节，分为上半部分和下半部分各8字节。显示的时候，先根据字符的ASCII码计算出字库中的偏移，然后逐字节写入缓冲区。

void OLED_ShowChar(uint8_t x, uint8_t y, char ch) { uint8_t i, j; uint8_t *pFont = (uint8_t *)&ASCII_8x16[(ch - ' ') * 16]; for (i = 0; i < 8; i++) { OLED_GRAM[x + i][y / 8] = pFont[i]; OLED_GRAM[x + i][y / 8 + 1] = pFont[i + 8]; } }

这里假设y是8的倍数，也就是从页边界开始显示。如果y不是8的倍数，就需要更复杂的位操作来合并像素。为了简化，通常建议字符显示从页边界开始。

对于中文显示，需要用到16x16的点阵字库。每个汉字占用32字节，显示原理类似，只是宽度和高度都变成了16。你可以用取模软件生成字库，然后按照同样的方式写入缓冲区。

图形绘制方面，常用的有画线、画矩形、画圆。画线可以用Bresenham算法，画矩形就是画四条线，画圆可以用中点画圆算法。这些算法的实现都比较成熟，网上有很多参考代码。我个人的建议是，如果你的项目不需要复杂的图形，就不用花时间实现这些，直接用字符显示就够了。如果需要显示波形，画线函数是必须的。

4. CH32V307上的I2C OLED例程移植要点

4.1 CH32V307的I2C外设特点

CH32V307是沁恒微电子推出的一款基于RISC-V内核的MCU，主频最高144MHz，资源丰富，价格便宜，最近两年在国产替代的浪潮中非常受欢迎。它的I2C外设跟STM32的I2C外设类似，但也有一些差异。如果你之前用的是STM32的HAL库，移植到CH32V307上需要做一些调整。

CH32V307的I2C支持标准模式100kHz、快速模式400kHz，还支持7位和10位地址。它的寄存器布局跟STM32F1系列比较接近，但中断向量和时钟使能方式不同。沁恒提供了自己的固件库，函数命名风格跟STM32的标准库类似，但跟HAL库差别较大。如果你用的是HAL库的代码，需要把HAL_I2C_Master_Transmit替换成CH32V307的I2C写函数。

4.2 从HAL库到CH32V307的代码适配

移植的核心工作是替换I2C的底层读写函数。在HAL库中，我们用的是HAL_I2C_Master_Transmit和HAL_I2C_Master_Receive。在CH32V307的固件库中，对应的函数是I2C_WriteData和I2C_ReadData，但需要自己封装起始、地址发送、数据传输和停止的流程。

下面是一个CH32V307的I2C写函数示例：

void I2C_WriteBytes(uint8_t addr, uint8_t *buf, uint16_t len) { I2C_GenerateSTART(I2C1, ENABLE); while (!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT)); I2C_Send7bitAddress(I2C1, addr, I2C_Direction_Transmitter); while (!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)); for (uint16_t i = 0; i < len; i++) { I2C_SendData(I2C1, buf[i]); while (!I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED)); } I2C_GenerateSTOP(I2C1, ENABLE); }

这个函数跟STM32标准库的写法几乎一样，因为CH32V307的固件库就是模仿STM32标准库设计的。如果你之前用的是标准库而不是HAL库，那移植起来会更容易。但如果你用的是HAL库，就需要把HAL_I2C_Master_Transmit的调用替换成这个函数。

另外，CH32V307的时钟配置也需要调整。STM32F103的I2C时钟通常来自APB1，最高36MHz。CH32V307的I2C时钟来自APB1，但频率可能不同，需要根据系统时钟重新计算I2C的时钟控制寄存器值。如果你发现I2C通信失败，首先要检查时钟配置是否正确。

4.3 移植过程中的常见问题与解决

移植过程中最常见的问题是I2C总线锁死。CH32V307的I2C外设在某些情况下会出现总线锁死，表现为SCL被拉低，无法产生时钟。这通常是因为在通信过程中出现了错误，比如从机没有响应ACK，或者主机在发送过程中被中断打断。解决方法是在I2C初始化时增加总线恢复逻辑：如果检测到SCL或SDA被拉低，就手动切换GPIO模式，发送9个时钟脉冲，让从机释放总线。

另一个问题是时序不匹配。CH32V307的主频比STM32F103高很多，如果你直接套用STM32的延时函数，可能会导致I2C时序过快，从机来不及响应。解决方法是根据实际主频调整延时，或者使用硬件I2C的时钟控制寄存器来设置正确的分频值。

还有一个坑是CH32V307的I2C引脚复用。有些引脚默认不是I2C功能，需要先配置GPIO的复用功能，并且开启AFIO时钟。如果你忘了这一步，I2C根本不会工作。具体的引脚配置可以参考CH32V307的数据手册，或者用沁恒提供的MounRiver Studio中的配置工具来生成初始化代码。

5. 常见问题与排查技巧实录

5.1 屏幕完全不亮：从电源到初始化序列的排查

屏幕完全不亮是最常见的问题，可能的原因有很多。我一般按照以下顺序排查：

首先检查电源。用万用表量一下OLED模块的VCC和GND之间是不是有3.3V。有些模块需要5V才能点亮，虽然逻辑电平是3.3V，但电荷泵可能需要5V才能正常工作。如果你用的是3.3V，屏幕很暗或者不亮，可以试试接5V。但要注意，如果模块上没有电平转换电路，5V可能会损坏STM32的IO口。所以最好先确认模块的规格。

然后检查I2C地址。用前面提到的扫描代码确认地址是否正确。如果扫描不到任何设备，说明I2C通信有问题。检查SCL和SDA有没有接反，上拉电阻有没有接，STM32的I2C外设有没有使能。

如果地址扫描到了，但屏幕还是不亮，那可能是初始化序列有问题。重点检查0x8D命令后面的参数是不是0x14，这是电荷泵使能。有些例程用的是0x10，那是关闭电荷泵，屏幕不会亮。另外检查0xAF命令有没有发送，这是开启显示的命令。如果这两个命令都正确，屏幕应该会亮起来，至少能看到一些噪点或者全黑。

5.2 显示内容错乱：显存布局与寻址模式不匹配

如果屏幕亮了，但显示的内容是乱码或者位置不对，那通常是显存布局或寻址模式的问题。SSD1306的显存是按页组织的，每页8行，共8页。如果你在缓冲区里按列优先的方式存储，但发送的时候按页优先的方式发送，显示就会错乱。

解决方法是确认你的缓冲区布局跟SSD1306的显存布局一致。我建议直接用二维数组OLED_GRAM[128][8]，这样x是列，y是页，跟SSD1306的显存组织方式完全一致。发送的时候按页发送，每页128字节，共8页。

另外检查寻址模式。如果你用的是页寻址模式，每次写入一页后需要重新设置页地址。如果你用的是水平寻址模式，写入完一页后列地址会自动回到0，页地址自动加1。两种模式各有优劣，关键是你的刷新函数要跟寻址模式匹配。

5.3 屏幕闪烁或刷新慢：优化I2C传输效率

屏幕闪烁通常是因为刷新频率太低，或者刷新过程中屏幕正在扫描。如果你用的是I2C接口，400kHz的时钟下刷新一帧需要20多毫秒，也就是最高40多帧。如果你在主循环里每次都刷新，而且主循环还有其他耗时操作，实际刷新率可能只有几帧，人眼就会感觉到闪烁。

优化方法有几个：一是减少刷新频率，只在内容变化时刷新；二是用SPI接口替代I2C；三是优化I2C传输，比如用DMA传输显存数据，减少CPU占用。对于STM32F103来说，I2C的DMA支持不是很好，但SPI的DMA非常成熟，如果你对刷新率要求高，建议直接换SPI。

还有一个技巧是局部刷新。如果你只需要更新屏幕上的一个数字，可以只刷新那个数字所在的页，而不是整个屏幕。这样可以大大减少传输的数据量。但实现起来需要计算数字在显存中的位置，稍微复杂一些。

5.4 常见问题速查表

这个表格是我在实际项目中总结出来的，基本上覆盖了90%以上的OLED驱动问题。如果你遇到其他问题，可以在评论区留言，我会尽量回复。

6. 一些实战中的经验与建议

6.1 关于字库的选择与生成

字符显示离不开字库。对于ASCII字符，我推荐使用8x16的字库，因为它在0.96寸屏幕上显示效果比较好，一行可以显示16个字符，一屏可以显示4行。6x8的字库虽然能显示更多字符，但太小了，看起来费劲。

对于中文显示，16x16的字库是标配。你可以用PCtoLCD2002或者类似的取模软件生成字库。取模的时候要注意几个设置：阴码还是阳码、逐行还是逐列、顺向还是逆向。这些设置决定了字库数据的排列方式，如果跟你的显示函数不匹配，显示出来的就是乱码。我建议用阴码、逐列、顺向的方式，这是最常用的格式。

生成字库后，把数据放到一个数组里，然后在显示函数中根据字符编码计算偏移。对于中文，通常用GB2312编码或者UTF-8编码，计算偏移的方式不同。如果你只需要显示少量固定的汉字，可以直接把字库数组写死，不需要完整的字库文件。

6.2 关于I2C上拉电阻的实测经验

I2C上拉电阻的阻值选择，我实测下来4.7kΩ是最稳妥的。但如果你用的是长排线连接OLED，比如排线长度超过20厘米，4.7kΩ可能就不够了，上升沿会变缓，通信会出错。这时候可以减小到2.2kΩ，或者降低I2C时钟频率到100kHz。

另外，有些OLED模块自带了上拉电阻，你再外接上拉电阻的话，并联后的阻值会变小，可能导致功耗增加。所以如果你用的模块自带10kΩ上拉，你就不需要再外接了。但如果你发现通信不稳定，可以尝试在模块的外部再并联一个10kΩ，把总阻值降到5kΩ左右。

还有一个细节：STM32的I2C引脚是开漏输出，必须依赖外部上拉才能输出高电平。如果你忘了接上拉电阻，SCL和SDA永远是低电平，通信根本不可能成功。这是新手最容易犯的错误之一。

6.3 关于刷新频率与功耗的平衡

OLED的功耗跟显示内容有关。显示全白的时候功耗最高，显示全黑的时候功耗最低。如果你做的是电池供电的项目，可以通过降低刷新频率和减少亮像素来省电。

SSD1306支持对比度调节，通过0x81命令设置。对比度越低，功耗越小，但显示效果也会变差。你可以根据实际使用场景调整对比度，比如在室内使用时可以降低对比度，在室外强光下需要提高对比度。

另外，SSD1306支持睡眠模式，通过0xAE命令关闭显示，进入睡眠。在不需要显示的时候，可以发送0xAE命令让屏幕休眠，需要显示时再发送0xAF唤醒。这样可以进一步降低功耗。

6.4 关于CH32V307的I2C时钟配置

CH32V307的I2C时钟配置跟STM32略有不同。STM32F103的I2C时钟来自APB1，最高36MHz，I2C的时钟控制寄存器需要根据APB1频率计算分频值。CH32V307的APB1频率可能不同，需要根据系统时钟树重新计算。

具体来说，I2C的时钟控制寄存器CCR的值计算公式是：CCR = APB1时钟频率 / (2 * I2C时钟频率)。比如APB1是36MHz，I2C时钟是400kHz，那么CCR = 36000000 / (2 * 400000) = 45。如果你把APB1配置成72MHz，CCR就要改成90。如果CCR值不对，I2C的时钟频率就会偏离，导致通信失败。

我建议在初始化I2C之前，先用串口打印一下APB1的实际频率，然后根据这个频率计算CCR值。这样可以避免因为时钟配置错误导致的通信问题。

6.5 关于DMA传输显存的尝试

如果你用的是SPI接口，可以尝试用DMA传输显存数据。SPI的DMA配置比较简单，只需要设置好源地址、目标地址和数据长度，然后启动DMA传输即可。传输完成后，DMA会产生中断，你可以在中断里处理下一帧数据。

用DMA的好处是CPU不需要参与数据传输，可以腾出时间处理其他任务。对于需要高刷新率的应用，比如波形显示，DMA是必不可少的。但I2C的DMA支持比较复杂，STM32F103的I2C DMA有一些硬件bug，不建议使用。如果你一定要用I2C，可以考虑用软件I2C加DMA，但实现起来更麻烦。

我个人的建议是：如果项目对刷新率要求不高，用I2C轮询方式就够了，代码简单，调试方便。如果对刷新率要求高，直接换SPI加DMA，不要在I2C上浪费时间。

6.6 关于屏幕保护与寿命

OLED屏幕有一个众所周知的问题：烧屏。如果长时间显示静态内容，某些像素会老化得比其他像素快，导致屏幕上留下残影。对于0.96寸的小屏幕，烧屏问题不算严重，但如果你做的是长期运行的项目，还是要注意。

预防烧屏的方法有几个：一是定期改变显示内容，比如每隔几分钟移动一下显示位置；二是降低对比度，减少像素的发光强度；三是在不需要显示的时候关闭屏幕。这些方法都可以延长屏幕的寿命。

另外，OLED屏幕的寿命跟亮度有关。亮度越高，寿命越短。所以在满足可读性的前提下，尽量降低亮度。SSD1306的对比度设置范围是0x00到0xFF，我一般设置在0xCF左右，既能看清，又不会太亮。

6.7 关于代码的可移植性

最后说一点关于代码可移植性的建议。如果你写的OLED驱动代码将来可能移植到其他平台，最好把硬件相关的部分抽象出来。比如把I2C读写函数封装成OLED_WriteCmd和OLED_WriteData，这样移植的时候只需要修改这两个函数的实现，上层的显存管理和字符显示代码不需要动。

另外，把OLED的地址、分辨率、引脚定义等配置项放到一个头文件里，用宏定义来管理。这样换屏幕或者换平台的时候，只需要修改头文件即可。这个习惯在长期项目中非常重要，可以节省大量的移植时间。

我在实际项目中用过STM32F103、STM32F407、CH32V307等多种平台驱动OLED，每次移植都只需要修改底层I2C函数和引脚定义，上层代码几乎不用动。这就是抽象带来的好处。如果你刚开始学，可能觉得这样做麻烦，但等你做过几个项目之后，就会发现这是值得的。