1. 项目概述与核心价值最近在做一个基于STM32的便携式数据采集设备需要一块小尺寸的OLED屏幕来实时显示波形和关键参数。市面上最常见的0.96寸OLED屏驱动芯片无非就是SSD1306或SH1106接口则多是I2C。项目对实时性要求不低主控STM32F103除了要处理ADC采样、算法运算还得负责屏幕刷新。如果还用传统的HAL库阻塞式HAL_I2C_Master_Transmit来刷屏CPU时间被大量占用在等待I2C传输完成上整个系统的响应就变得拖泥带水。这正是DMA直接存储器访问大显身手的地方。它的核心思想是“让专业的人干专业的事”把CPU从繁琐的数据搬运工作中解放出来。具体到我们这个场景就是配置好I2C的DMA传输让DMA控制器自动把显存Frame Buffer里的数据通过I2C总线搬运到OLED屏幕上。在此期间CPU可以完全不管I2C传输的进度去执行其他更重要的任务比如处理传感器数据或响应外部事件。整个系统的吞吐量和响应速度能得到质的提升。这个项目示例就是展示如何利用STM32 HAL库构建一个基于DMA的、非阻塞的I2C OLED驱动。它不仅仅是一段能点亮的代码更是一种优化嵌入式系统资源利用的设计思路。无论你是正在做需要高频刷新UI的设备还是单纯想深入学习HAL库下DMA与I2C的协同工作模式这个示例都能提供一个清晰、可复现的参考模板。我们会从原理、配置、代码实现到调试心得完整地走一遍。2. 整体设计与思路拆解2.1 为什么选择“HAL DMA I2C”这个组合首先得说说为什么是这几个技术点的组合。STM32的开发标准库StdPeriph已逐渐被ST官方弃用HAL库和LL库是现在的主流。HAL库的优势在于抽象程度高跨STM32系列芯片的移植性好虽然效率可能略低于LL库但开发速度更快更适合快速原型开发和项目初期。对于I2C这种时序要求严格的外设使用HAL库能避免我们陷入繁琐的寄存器配置细节中。而DMA的选择源于对系统效率的追求。一个128x64分辨率的OLED其显存大小为1024字节。如果使用CPU通过循环调用HAL_I2C_Mem_Write来逐个字节或逐页发送每发送一个字节或一页通常128字节CPU都需要等待本次I2C传输完成阻塞这期间CPU什么都干不了。对于需要实时性的系统这是不可接受的。DMA则能实现“后台”自动传输传输完成后通过中断或标志位通知CPU实现了传输与处理的并行。I2C接口的OLED屏硬件连接简单只需两根线SCL SDA占用IO口少在PCB布局和飞线调试时都更方便。虽然速度上不及SPI接口但对于OLED这种小尺寸、刷新率要求不极端通常几十Hz足矣的屏幕I2C的400kHz快速模式Fast Mode完全够用是一种在性能和复杂度之间取得很好平衡的选择。2.2 驱动框架的核心思路整个驱动框架围绕“非阻塞”和“双缓冲”的思想展开。非阻塞传输这是DMA带来的最直接好处。我们提供一个OLED_Refresh_DMA()之类的函数它的作用仅仅是启动一次DMA传输将显存数据发送给OLED然后函数立即返回。CPU无需等待可以继续执行后续代码。传输完成与否通过查询DMA传输完成标志位或是在DMA传输完成中断回调函数里设置标志来得知。显存Frame Buffer管理我们在STM32的内部RAM中开辟一块区域大小与OLED屏幕的显存对应例如1024字节。所有绘图操作画点、画线、写字都只修改这块RAM中的显存。当需要更新屏幕时再启动DMA将这块完整的显存数据一次性或分批次发送出去。这避免了直接操作硬件总线带来的时序管理和等待问题。DMA传输策略一次性传输1024字节可能超过某些DMA通道的单次传输限制或者不利于总线占用。更常见的做法是分页传输。OLED的GDDRAM图形显示数据RAM是分页管理的通常8页每页128列。我们可以配置DMA每次传输一页的数据128字节。传输完一页后在DMA传输完成中断或半传输完成中断中更新OLED的页地址和列地址然后启动下一页的传输直到所有页发送完毕。这种“链式”传输能更精细地控制传输过程。SSD1306与SH1106的兼容性处理这两种芯片指令集高度兼容但有一个关键区别SH1106的显存是132x64而SSD1306是128x64。这意味着SH1106每行有132列但中间128列用于显示。因此在初始化时需要发送不同的命令来设置列地址偏移通常为2以确保图像显示在屏幕中央。我们的驱动需要能自动识别或通过宏定义来适配这两种芯片。3. 硬件连接与CubeMX基础配置3.1 硬件连接图与要点OLED模块以四针I2C接口为例与STM32的连接非常简单VCC- 3.3V 注意一定要确认模块电压是3.3V还是5VGND- GNDSCL- STM32的某个I2C时钟引脚如PB6/PB8 for I2C1SDA- STM32的某个I2C数据引脚如PB7/PB9 for I2C1注意I2C总线需要上拉电阻。通常OLED模块本身已经集成了4.7kΩ或10kΩ的上拉电阻。如果没有你需要在STM32这端的SCL和SDA线上各接一个4.7kΩ的上拉电阻到3.3V。3.2 STM32CubeMX工程配置详解使用CubeMX可以极大简化外设初始化代码的生成。以下是关键配置步骤选择型号与时钟选择你的STM32型号如STM32F103C8T6。在Clock Configuration标签页配置系统时钟SYSCLK到最高频率如72MHz因为I2C和DMA的时钟源于此。配置I2C在Pinout Configuration标签页找到I2C1或其他你想用的I2C。将I2C Mode设置为I2C。在Configuration-Parameter Settings中Speed Mode选择Fast Mode400kHz。这是I2C标准模式100kHz的升级能提供更高的刷屏速率。其他参数如Duty Cycle、Addressing mode等保持默认即可。OLED作为从设备主控不需要设置自身地址。配置DMA这是核心步骤。在DMA Settings标签页点击Add添加一个DMA请求。DMA Request选择I2C1_TX因为我们是向OLED发送数据。Direction选择Memory To Peripheral内存到外设。Priority根据系统需求选择如果屏幕刷新优先级高可以设为High。这里设为Medium即可。Mode必须选择Normal。Circular循环模式会持续不断地传输不适合我们这种单次刷新的场景。Increment AddressMemory端需要勾选Increment因为我们是从连续的显存地址发送数据。Peripheral端不要勾选因为I2C的数据寄存器地址是固定的。Data Width都选择Byte因为I2C数据是按字节传输的。配置NVIC嵌套向量中断控制器为了使CPU知道DMA传输何时完成我们需要开启DMA通道的中断。在NVIC Settings中找到你刚刚为I2C1_TX分配的DMA通道例如DMA1 Channel6勾选其Interrupt使能。同时也可以使能I2C的事件中断和错误中断便于调试和错误处理。生成代码配置好时钟树、项目名称、IDE等后点击GENERATE CODE生成工程。3.3 生成的代码结构初探CubeMX生成的代码在main.c中已经完成了I2C和DMA的硬件初始化MX_I2C1_Init()和MX_DMA_Init()。我们的工作主要集中在编写OLED的初始化序列发送一系列命令。实现显存uint8_t buffer[1024]及相关的绘图函数。编写基于DMA的刷屏函数并处理好DMA传输完成中断回调。4. 驱动层代码实现与解析4.1 显存定义与基础绘图函数首先我们定义显存和屏幕参数。为了兼容SSD1306和SH1106最好使用宏定义来切换。// oled.h #define OLED_WIDTH 128 #define OLED_HEIGHT 64 #define OLED_PAGE_NUM (OLED_HEIGHT/8) // 8行一页共8页 // 选择驱动芯片 #define OLED_DRIVER_SSD1306 // #define OLED_DRIVER_SH1106 // 显存 buffer[page][column] extern uint8_t oled_buffer[OLED_PAGE_NUM][OLED_WIDTH]; // 基础函数 void OLED_Init(void); void OLED_Clear(void); void OLED_Refresh(void); // 使用DMA刷新 void OLED_DrawPixel(uint8_t x, uint8_t y, uint8_t color); void OLED_DrawChar(uint8_t x, uint8_t y, char ch, uint8_t size); void OLED_DrawString(uint8_t x, uint8_t y, char *str, uint8_t size); // ... 其他绘图函数画线、矩形、圆等// oled.c uint8_t oled_buffer[OLED_PAGE_NUM][OLED_WIDTH] {0}; // 向OLED发送命令不通过DMA阻塞式仅用于初始化 static void OLED_Write_Cmd(uint8_t cmd) { HAL_I2C_Mem_Write(hi2c1, OLED_I2C_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, cmd, 1, HAL_MAX_DELAY); } // 向OLED发送数据不通过DMA阻塞式可用于调试 static void OLED_Write_Data(uint8_t data) { HAL_I2C_Mem_Write(hi2c1, OLED_I2C_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, data, 1, HAL_MAX_DELAY); } // 初始化序列 void OLED_Init(void) { HAL_Delay(100); // 等待OLED上电稳定 // 一系列初始化命令 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); // 无偏移 OLED_Write_Cmd(0x40); // 设置显示起始行 OLED_Write_Cmd(0x8D); // 电荷泵设置 OLED_Write_Cmd(0x14); // 使能电荷泵 OLED_Write_Cmd(0x20); // 设置内存地址模式 OLED_Write_Cmd(0x00); // 水平地址模式 OLED_Write_Cmd(0xA1); // 段重映射设置 (0xA1 左右反置0xA0 正常) OLED_Write_Cmd(0xC8); // 扫描方向设置 (0xC8 上下反置0xC0 正常) OLED_Write_Cmd(0xDA); // COM引脚硬件配置 OLED_Write_Cmd(0x12); OLED_Write_Cmd(0x81); // 对比度控制 OLED_Write_Cmd(0xCF); // 对比度值 OLED_Write_Cmd(0xD9); // 预充电周期 OLED_Write_Cmd(0xF1); OLED_Write_Cmd(0xDB); // VCOMH 电平选择 OLED_Write_Cmd(0x40); OLED_Write_Cmd(0xA4); // 输出跟随RAM内容 OLED_Write_Cmd(0xA6); // 设置正常显示 (0xA7 反色) OLED_Write_Cmd(0xAF); // 开启显示 OLED_Clear(); OLED_Refresh(); // 首次清屏刷新 } void OLED_Clear(void) { memset(oled_buffer, 0, sizeof(oled_buffer)); } // 基础画点函数操作显存 void OLED_DrawPixel(uint8_t x, uint8_t y, uint8_t color) { if (x OLED_WIDTH || y OLED_HEIGHT) return; uint8_t page y / 8; uint8_t bit y % 8; if (color) { oled_buffer[page][x] | (1 bit); } else { oled_buffer[page][x] ~(1 bit); } }4.2 DMA刷屏函数与状态机设计这是驱动最核心的部分。我们不能简单地把1024字节一次性扔给DMA因为需要每发送一页128字节后更新OLED的内部地址指针。这里采用一个简单的状态机配合DMA传输完成中断来实现。// oled.c (续) // DMA传输状态机 typedef enum { OLED_DMA_IDLE, // 空闲 OLED_DMA_SENDING, // 正在发送 OLED_DMA_PAGE_DONE, // 一页发送完成等待设置新地址 OLED_DMA_ALL_DONE // 全部发送完成 } OLED_DMA_State_t; static OLED_DMA_State_t oled_dma_state OLED_DMA_IDLE; static uint8_t current_page 0; // 当前正在发送的页 // 启动一页数据的DMA传输 static void OLED_DMA_SendPage(uint8_t page) { // 1. 设置OLED的页地址和列地址 OLED_Write_Cmd(0xB0 page); // 设置页地址 (Page0 ~ Page7) OLED_Write_Cmd(0x00); // 设置列地址低4位 OLED_Write_Cmd(0x10); // 设置列地址高4位 #ifdef OLED_DRIVER_SH1106 // SH1106需要额外的2列偏移 OLED_Write_Cmd(0x02); // 设置起始列地址偏移为2 #endif // 2. 启动DMA传输发送该页的128字节数据 // HAL_I2C_Mem_Write_DMA 参数I2C句柄设备地址内存地址地址长度数据指针数据大小 // 注意内存地址参数对于OLED数据写入固定是0x40 if (HAL_I2C_Mem_Write_DMA(hi2c1, OLED_I2C_ADDR, 0x40, I2C_MEMADD_SIZE_8BIT, (uint8_t*)oled_buffer[page][0], OLED_WIDTH) ! HAL_OK) { // 启动DMA失败处理 oled_dma_state OLED_DMA_IDLE; // 可以设置错误标志或尝试恢复 } else { oled_dma_state OLED_DMA_SENDING; } } // 供主程序调用的刷新函数非阻塞 void OLED_Refresh(void) { if (oled_dma_state OLED_DMA_IDLE) { current_page 0; OLED_DMA_SendPage(current_page); } // 如果正在发送则忽略本次调用或者可以设计一个刷新请求队列 } // DMA传输完成回调函数在stm32f1xx_it.c中声明在此定义 void HAL_I2C_MemTxCpltCallback(I2C_HandleTypeDef *hi2c) { if (hi2c-Instance I2C1) { // 一页数据发送完成 current_page; if (current_page OLED_PAGE_NUM) { // 准备发送下一页 oled_dma_state OLED_DMA_PAGE_DONE; // 注意不能在这里直接调用OLED_DMA_SendPage // 因为回调函数在中断上下文应尽快退出。 // 我们设置一个标志在主循环中处理。 } else { // 所有页发送完成 oled_dma_state OLED_DMA_ALL_DONE; current_page 0; } } }4.3 主循环中的状态机处理DMA传输完成回调函数只负责更新状态。实际的“发送下一页”这个动作需要放到主循环或一个专门的任务中执行以避免在中断服务程序中进行可能耗时的操作如发送I2C命令。// main.c 中的主循环 int main(void) { // ... 初始化代码 OLED_Init(); OLED_DrawString(0, 0, Hello DMA!, 16); OLED_Refresh(); // 启动第一次DMA刷新 while (1) { // 处理DMA刷屏状态机 if (oled_dma_state OLED_DMA_PAGE_DONE) { // 上一页DMA传输完成现在可以安全地设置新地址并启动下一页传输 OLED_DMA_SendPage(current_page); } // 如果状态是 OLED_DMA_ALL_DONE则表示一次完整的刷屏结束。 // 可以在这里置位一个标志通知其他任务可以开始准备下一帧数据了。 // ... 其他任务如读取传感器、运行算法、响应按键等 // 这些任务不会因为刷屏而阻塞 } }这种设计实现了“准并行”。当DMA在后台搬运数据时CPU在主循环里处理OLED_DMA_PAGE_DONE状态并快速发送下一条地址命令然后继续执行其他任务。整个刷屏过程对CPU的占用被降到了最低。5. 关键参数配置与优化技巧5.1 I2C时钟速度与上拉电阻I2C的通信速率受限于总线的RC常数由上拉电阻和总线电容决定。CubeMX中配置的400kHz是目标值实际速率可能略低。上拉电阻阻值越小上升沿越陡峭速度可以更快但功耗也更大。通常4.7kΩ在3.3V下是个平衡点。如果通信距离较长或线上设备较多导致电容较大可以尝试减小到2.2kΩ。STM32的I2C时钟配置在CubeMX的I2C Configuration-Timing Settings中你可以直接输入一个值也可以使用I2C Timing Configuration工具根据时钟频率自动计算。对于72MHz系统时钟400kHz Fast Mode的一个常见配置值是0x0010061A。如果通信不稳定可以适当降低此时钟配置值以增加时序裕量。5.2 DMA传输模式与中断优先级DMA模式务必选择Normal。Circular模式会循环覆盖缓冲区除非你实现的是双缓冲动画否则会导致显示乱码。DMA中断优先级在NVIC Configuration中设置。如果屏幕刷新不是最紧急的任务可以将其优先级设低一些如5把更高的优先级留给更关键的中断如电机控制PWM、紧急停止信号等。I2C中断除了DMA中断也建议使能I2C的Event Interrupt和Error Interrupt。当I2C通信出错如从设备无应答时错误中断能帮你快速定位问题而不是让程序卡死在某个地方。5.3 显存管理与双缓冲技术上面的示例使用的是单显存。在复杂UI或动画场景下可能会遇到“撕裂”现象即CPU在修改显存时DMA正在读取并发送它导致屏幕上显示的是半帧旧数据半帧新数据。解决方案是双缓冲定义两个显存缓冲区buffer_front和buffer_back。所有绘图函数只操作buffer_back后台缓冲区。当一帧图形绘制完成后调用一个OLED_SwapBuffer()函数。这个函数并不拷贝数据而是交换两个缓冲区的指针并启动DMA从新的buffer_front即刚才的buffer_back读取数据。DMA始终从buffer_front读取数据发送到屏幕。 这样绘图和送显完全分离彻底避免了撕裂但代价是RAM开销翻倍2KB。6. 常见问题排查与调试心得6.1 屏幕不亮或显示乱码电源和接线首先用万用表确认VCC是3.3VGND连通SCL和SDA线连接正确且接触良好。这是最常见的问题。I2C地址常见的OLED模块I2C地址是0x78写地址或0x7A如果SA0接高电平。在代码中HAL库的HAL_I2C_Mem_Write函数需要的是7位设备地址左移一位后的值即0x3C 1 0x78。所以我们的OLED_I2C_ADDR宏通常定义为0x78。务必用逻辑分析仪或示波器抓一下I2C波形看起始信号后的设备地址是否正确。初始化序列SSD1306和SH1106的初始化命令序列略有不同特别是电荷泵命令0x8D和显示开关命令0xAE/0xAF的顺序和参数。确保你的初始化代码是针对你手头屏幕的型号。网上代码鱼龙混杂最好找到官方数据手册对照。DMA未启动或配置错误在OLED_Refresh()函数后检查oled_dma_state是否变为OLED_DMA_SENDING。如果没有说明HAL_I2C_Mem_Write_DMA可能返回了错误。可以在调用后打印HAL的错误状态hi2c1.ErrorCode来排查。常见错误是DMA通道未使能或者I2C处于忙碌状态。6.2 DMA传输卡住只刷新一部分DMA传输完成中断未触发检查CubeMX中是否使能了对应DMA通道的全局中断NVIC Settings。检查stm32f1xx_it.c中DMA通道的中断服务函数如DMA1_Channel6_IRQHandler是否正确调用HAL_DMA_IRQHandler。状态机逻辑错误在HAL_I2C_MemTxCpltCallback回调中我们只是更新了状态。确保主循环中确实有代码在检查oled_dma_state OLED_DMA_PAGE_DONE并调用OLED_DMA_SendPage。如果主循环被其他高优先级任务长时间阻塞状态机就无法推进。I2C总线锁死I2C通信异常如从设备无应答可能导致总线处于“忙”状态后续所有操作都会失败。在错误中断回调HAL_I2C_ErrorCallback中可以尝试调用HAL_I2C_Init重新初始化I2C来复位总线状态。6.3 刷新速度慢达不到预期I2C时钟速率确认CubeMX中配置的确实是400kHz Fast Mode并且实际波形频率接近此值。分页传输的开销我们每传输128字节都需要用阻塞式的OLED_Write_Cmd发送3条设置地址的命令。这个过程中CPU是等待的。虽然时间很短每条命令约30us但累积8次也有近1ms的额外开销。可以考虑优化如果OLED芯片支持设置连续写入模式可以在传输开始前一次性发送“设置起始页和列”的命令然后让DMA连续发送所有1024字节。但这需要确认芯片是否支持跨页的连续写以及DMA单次传输长度是否支持1024字节。CPU主频确保STM32运行在最高性能状态。如果系统时钟配置过低CPU处理状态机和发送命令本身也会变慢。6.4 使用逻辑分析仪进行调试逻辑分析仪是调试I2C和DMA的利器。连接SCL、SDA和一根GPIO用于标记关键代码点。查看初始化波形触发上电后的第一次通信检查命令序列是否正确。查看DMA传输波形在启动OLED_Refresh()时翻转一个GPIO调试引脚。在逻辑分析仪中你可以看到这个GPIO变高后紧接着是一长串密集的I2C数据波形。观察数据是否连续是否有错误的NACK无应答信号。测量刷屏时间用两个GPIO翻转来标记一次完整刷新的开始和结束测量其时间间隔。理论上1024字节在400kHz I2C下纯数据传输时间约为(1024 * 9 bits/byte) / 400000 Hz ≈ 23ms9 bits 8数据位 1应答位。加上命令开销一次完整刷新在30ms左右是合理的对应约33FPS对于大多数UI足够了。通过这个项目你将不仅仅获得一个能用的OLED驱动更重要的是理解如何在资源受限的MCU上利用DMA这种外设来优化系统性能构建响应更迅捷的嵌入式应用。这种“CPU与DMA协同”的思想在ADC采样、串口通信、SPI Flash读写等场景中同样适用是提升STM32项目水平的关键技能之一。