STM32F103C8T6驱动JW01-CO2-V2.2与OLED的CO2监测实战

1. 项目缘起与整体设计思路JW01-CO2-V2.2 这颗模块在圈子里其实不算新面孔但真正把它和 STM32 配合起来做出一套稳定可用的空气质量监测节点中间要踩的坑比想象中多。我最近刚完成一个基于 STM32F103C8T6 最小系统板的二氧化碳监测项目用 USART2 跟 JW01-CO2-V2.2 通信再通过 I2C 接口把数据刷到 0.96 寸 OLED 上整个链路跑通之后回头整理了一下发现很多细节在公开资料里要么一笔带过要么干脆没提。这篇文章就把我从选型、接线、配置到调试的完整过程拆开来讲适合正在做 STM32 环境监测类项目、毕业设计或者想快速验证传感器方案的朋友参考。先说清楚这个项目到底在做什么。JW01-CO2-V2.2 是一颗基于 NDIR 非色散红外原理的二氧化碳浓度传感器模块出厂已经做了标定直接输出串口数据帧量程覆盖 400 到 5000 ppm精度在 ±50 ppm 加 5% 读数以内。它跟 STM32 之间走的是 UART 协议默认波特率 9600周期性地往外吐数据包。STM32 这边负责接收、解析、校验然后把浓度值、温度值部分固件版本带温度补偿输出显示到 OLED 屏幕上。整个系统不需要额外的 ADC 采样也不需要复杂的模拟前端核心工作量集中在串口接收状态机、数据帧解析和显示刷新逻辑上。为什么选 USART2 而不是 USART1这个问题我在一开始也纠结过。STM32F103C8T6 的 USART1 挂在 APB2 总线上时钟频率 72 MHzUSART2 挂在 APB1 上时钟 36 MHz。从波特率精度角度看两者在 9600 波特率下都能做到误差远小于 2%实际使用没有区别。但 USART1 的 TX/RX 默认引脚是 PA9/PA10这两个脚同时也是 SWD 调试接口的复用位置附近虽然不直接冲突但在最小系统板上 PA9/PA10 经常被引到其他地方或者被板载 LED 占用。USART2 的 PA2/PA3 相对干净接线方便而且我习惯把 USART1 留给调试打印用这样传感器数据和调试信息可以分两个串口走互不干扰。这个习惯在后期排查问题时特别有用你可以一边看传感器原始数据一边用另一个串口打日志。OLED 选 I2C 接口而不是 SPI理由更直接I2C 只占两个引脚PB6/PB7 或者 PB10/PB11 都行接线简单0.96 寸屏刷个几十帧完全够用。SPI 虽然快但对于这种刷新率要求不高的场景多出来的引脚和代码复杂度不划算。我用的是 SSD1306 驱动的 128×64 单色屏市面上最常见的那个版本库用的是自己精简过的 I2C 驱动加字库没有上完整的图形库因为项目里只需要显示几行文字和一个简单的数值刷新没必要引入额外依赖。整体硬件清单如下组件型号/规格数量备注主控STM32F103C8T6 最小系统板1蓝色药丸板即可二氧化碳模块JW01-CO2-V2.21注意版本号V2.2 固件有差异显示屏0.96 寸 I2C OLED SSD13061128×64 分辨率调试器ST-Link V21用于下载和调试电源5V USB 供电1模块需要 5VSTM32 板载稳压出 3.3V这里有个关键点JW01-CO2-V2.2 模块的供电是 5V而 STM32 的 IO 是 3.3V 电平。模块的 UART 输出电平在 5V 供电下通常是 3.3V 兼容的我实测过 TX 引脚空闲高电平在 3.3V 左右直接接 STM32 的 RX 没有问题。但如果你手头的模块批次不同建议先用万用表量一下 TX 空闲电平超过 3.6V 就要考虑加电平转换。RX 方向STM32 的 TX 输出 3.3V 高电平模块能不能识别要看它的输入阈值实测 JW01 的 RX 阈值在 2.0V 左右3.3V 完全能驱动所以直接对接是安全的。2. 核心细节解析与实操要点2.1 JW01-CO2-V2.2 数据帧格式深度拆解这颗模块的串口协议看起来简单但如果不把帧格式吃透解析代码写出来就是各种乱码和跳变。V2.2 版本的固件输出的是 9 字节定长帧格式如下字节序号内容说明00xFF帧头高字节10x01帧头低字节2浓度高字节CO2 浓度值高 8 位3浓度低字节CO2 浓度值低 8 位4温度值部分固件版本有效偏移 405保留通常为 0x006校验和前 7 字节累加和取低 8 位70x0D帧尾 CR80x0A帧尾 LF浓度值的计算方式是浓度 (高字节 8) | 低字节单位是 ppm。比如收到 0x01 0xF4那就是 500 ppm。温度值的处理稍微绕一点如果第 4 字节是 0x28实际温度就是 0x28 - 40 0 摄氏度。这个偏移 40 的设计在 V2.2 固件里是固定的但有些早期批次可能不输出温度或者偏移量不同建议以实际收到的数据为准。校验和的计算是前 7 个字节从帧头到保留字节的累加和取低 8 位。我见过有人把帧尾的 0x0D 0x0A 也算进去结果校验永远对不上。正确的做法是只累加索引 0 到 6 这七个字节。这个细节在模块手册里写得比较隐晦我是用逻辑分析仪抓了几帧数据之后才确认的。注意V2.2 版本和 V2.1 的帧格式有差异V2.1 是 7 字节帧没有温度字节。如果你买到的模块固件版本不确定先抓一帧原始数据看看长度和帧头再决定解析逻辑。2.2 STM32 串口接收方案选型中断 vs DMA vs 轮询串口接收这块我试过三种方案最后选了中断加空闲检测的方式。先说轮询最简单在主循环里不断查 RXNE 标志位但问题是它会阻塞 CPUOLED 刷新和按键处理都会被拖慢而且一旦主循环有其他耗时操作很容易丢帧。DMA 方案看起来很美配置好之后 CPU 完全不用管但 JW01 的数据帧是定长 9 字节DMA 的接收长度不好设设 9 字节吧万一中间丢了一个字节后面所有帧都会错位设大一点吧又要在 DMA 传输完成中断里自己找帧头逻辑反而复杂了。中断加空闲检测的方案是这样的每收到一个字节进一次接收中断把数据塞进环形缓冲区同时重置一个定时器。当总线空闲超过一个字节的传输时间9600 波特率下大约 1 ms触发空闲中断这时候把缓冲区里的数据取出来做帧解析。STM32F103 的 USART 自带 IDLE 空闲中断配合接收中断使用非常顺手。这个方案的好处是既能及时响应又不会因为帧内字节间隔而误判帧结束而且 CPU 占用率很低。具体配置上USART2 的初始化参数如下// 使能时钟 RCC_APB1PeriphClockCmd(RCC_APB1Periph_USART2, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // GPIO 配置 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_2; // TX GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin GPIO_Pin_3; // RX GPIO_InitStructure.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, GPIO_InitStructure); // USART 配置 USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate 9600; USART_InitStructure.USART_WordLength USART_WordLength_8b; USART_InitStructure.USART_StopBits USART_StopBits_1; USART_InitStructure.USART_Parity USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART2, USART_InitStructure); // 使能接收中断和空闲中断 USART_ITConfig(USART2, USART_IT_RXNE, ENABLE); USART_ITConfig(USART2, USART_IT_IDLE, ENABLE); // NVIC 配置 NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel USART2_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority 1; NVIC_InitStructure.NVIC_IRQChannelSubPriority 1; NVIC_InitStructure.NVIC_IRQChannelCmd ENABLE; NVIC_Init(NVIC_InitStructure); USART_Cmd(USART2, ENABLE);中断服务函数里要区分是接收中断还是空闲中断void USART2_IRQHandler(void) { if(USART_GetITStatus(USART2, USART_IT_RXNE) ! RESET) { uint8_t data USART_ReceiveData(USART2); // 存入环形缓冲区 ring_buffer_write(data); USART_ClearITPendingBit(USART2, USART_IT_RXNE); } if(USART_GetITStatus(USART2, USART_IT_IDLE) ! RESET) { // 清除空闲中断标志先读 SR 再读 DR volatile uint32_t tmp; tmp USART2-SR; tmp USART2-DR; (void)tmp; // 标记一帧接收完成 frame_ready 1; } }这里有个 STM32 的经典坑IDLE 标志位的清除方式比较特殊必须先读 SR 寄存器再读 DR 寄存器顺序不能反。我一开始只读了 SR 没读 DR结果空闲中断一直重复触发程序卡在中断里出不来。这个细节在参考手册里有写但很容易被忽略。2.3 I2C OLED 驱动要点与刷新策略OLED 这边用的是软件 I2C没有用硬件 I2C 外设。原因很简单STM32F103 的硬件 I2C 出了名的难用各种死锁和时序问题而软件 I2C 在 100 kHz 速率下刷 128×64 的屏幕完全够用代码可控性也强。PB6 做 SCLPB7 做 SDA开漏输出加上拉电阻上拉用 4.7k 到 10k 都行我手头只有 10k 的实测也能稳定跑。SSD1306 的初始化序列比较长网上有很多现成的版本但要注意区分 128×64 和 128×32 的配置差异。128×64 的复用率设置是 0x3F显示时钟分频要设成 0x80这些参数错了屏幕要么不亮要么显示区域只有一半。我建议直接找一个验证过的初始化数组不要自己从头写。刷新策略上我没有用全屏缓冲加定时刷新的方式而是只刷新数值变化的区域。具体做法是把屏幕分成几个固定区域比如第一行显示 CO2:, 第二行显示浓度值第三行显示温度。每次数据更新时只重绘浓度值那一行的数字部分其他区域不动。这样刷新的数据量小I2C 占用时间短也不会出现整屏闪烁的问题。实测下来从收到串口数据到屏幕更新完成整个过程在 20 ms 以内人眼完全感觉不到延迟。实操心得OLED 的 I2C 地址通常是 0x78写地址或 0x3C7 位地址如果你用的是 0.91 寸或者其他型号地址可能是 0x7A。不确定的话写个扫描程序把 0x00 到 0xFF 都试一遍能应答的就是正确地址。3. 完整实操流程与核心环节实现3.1 硬件接线与上电检查接线这一步看起来简单但接错了后面调试能让你怀疑人生。先把所有连线列清楚STM32 引脚连接目标说明PA2 (USART2_TX)JW01 RX交叉连接PA3 (USART2_RX)JW01 TX交叉连接PB6OLED SCL软件 I2C 时钟PB7OLED SDA软件 I2C 数据5VJW01 VCC模块供电 5V3.3VOLED VCC屏幕供电 3.3VGNDJW01 GND, OLED GND共地上电之前先用万用表蜂鸣档检查一遍 VCC 和 GND 有没有短路特别是模块的 5V 和 3.3V 不要接反。JW01 模块内部有稳压但反接大概率会烧。OLED 屏反接一般不会立刻坏但背光可能不亮。上电之后先别急着下载程序用串口助手接在 JW01 的 TX 和 GND 上波特率 9600看看有没有数据出来。正常的话你应该能看到周期性的十六进制数据流帧头是 FF 01帧尾是 0D 0A。如果什么都没有检查模块供电是否正常有些批次的 JW01 需要预热几十秒才开始输出。如果数据是乱码检查波特率是不是 9600或者模块是不是被配置成了其他波特率。3.2 数据帧解析状态机实现帧解析我写了一个简单的状态机不依赖空闲中断的标志而是在主循环里定期检查环形缓冲区。这样做的好处是解析逻辑和中断解耦调试的时候可以在解析函数里打断点不会影响串口接收。typedef enum { STATE_HEADER_H 0, STATE_HEADER_L, STATE_DATA_H, STATE_DATA_L, STATE_TEMP, STATE_RESERVED, STATE_CHECKSUM, STATE_TAIL_CR, STATE_TAIL_LF } parse_state_t; typedef struct { uint16_t co2; int8_t temp; uint8_t valid; } jw01_data_t; jw01_data_t parse_jw01_frame(uint8_t *buf, uint16_t len) { jw01_data_t result {0}; static parse_state_t state STATE_HEADER_H; static uint8_t checksum 0; static uint8_t data_idx 0; static uint8_t frame_buf[9]; for(uint16_t i 0; i len; i) { uint8_t byte buf[i]; switch(state) { case STATE_HEADER_H: if(byte 0xFF) { frame_buf[0] byte; checksum byte; state STATE_HEADER_L; } break; case STATE_HEADER_L: if(byte 0x01) { frame_buf[1] byte; checksum byte; state STATE_DATA_H; } else { state STATE_HEADER_H; } break; case STATE_DATA_H: frame_buf[2] byte; checksum byte; state STATE_DATA_L; break; case STATE_DATA_L: frame_buf[3] byte; checksum byte; result.co2 (frame_buf[2] 8) | frame_buf[3]; state STATE_TEMP; break; case STATE_TEMP: frame_buf[4] byte; checksum byte; result.temp (int8_t)(byte - 40); state STATE_RESERVED; break; case STATE_RESERVED: frame_buf[5] byte; checksum byte; state STATE_CHECKSUM; break; case STATE_CHECKSUM: frame_buf[6] byte; if(byte checksum) { state STATE_TAIL_CR; } else { state STATE_HEADER_H; } break; case STATE_TAIL_CR: if(byte 0x0D) { state STATE_TAIL_LF; } else { state STATE_HEADER_H; } break; case STATE_TAIL_LF: if(byte 0x0A) { result.valid 1; } state STATE_HEADER_H; break; } } return result; }这个状态机的核心思路是只有完整走完所有状态并且校验和正确的帧才会被标记为有效。任何一步出错就回到帧头检测状态重新开始。这样即使中间有噪声或者丢字节也能在下一帧自动恢复不会一直错位。注意checksum 变量在每次进入 STATE_HEADER_H 时重置确保每帧的校验和独立计算。我见过有人在帧尾才重置结果第二帧的校验和把第一帧的数据也算进去了导致校验永远失败。3.3 OLED 显示布局与数值刷新显示部分我设计了一个简单的布局第一行固定显示 CO2 Monitor第二行显示 CO2: XXXX ppm第三行显示 Temp: XX C第四行显示 Status: OK 或者 Status: ERR。浓度值每收到一帧有效数据就更新一次温度值变化不大可以每 10 帧更新一次减少 I2C 流量。数值转字符串我用了自己写的u16_to_str函数没有用sprintf因为标准库的sprintf会引入比较大的代码体积而且浮点格式化在 Keil 里还要额外配置。对于整数显示自己写转换函数更轻量void u16_to_str(uint16_t num, char *str) { char temp[6]; int8_t i 0; if(num 0) { str[0] 0; str[1] \0; return; } while(num 0) { temp[i] 0 (num % 10); num / 10; } int8_t j 0; while(i 0) { str[j] temp[--i]; } str[j] \0; }刷新的时候只更新数字部分前面的 CO2: 和后面的 ppm 不动。OLED 的OLED_ShowString函数指定起始坐标和字符串我只需要计算数字的起始 X 坐标就行。比如 CO2: 占 5 个字符宽度每个字符 6 像素8x6 字体那数字就从 X30 开始画。3.4 主循环调度与时间管理主循环的结构很直接检查帧标志解析数据更新显示然后处理一些状态指示。没有用 RTOS因为任务太简单了裸机跑完全没问题。但要注意主循环里不能有长时间的阻塞操作比如delay_ms(1000)这种否则串口数据会丢。我用 SysTick 做了一个 1 ms 的软定时器主循环里检查时间戳来决定是否执行某些周期性任务volatile uint32_t tick_ms 0; void SysTick_Handler(void) { tick_ms; } uint32_t get_tick(void) { return tick_ms; } int main(void) { // 初始化... SysTick_Config(SystemCoreClock / 1000); uint32_t last_display 0; uint32_t last_led 0; while(1) { // 处理串口数据 if(frame_ready) { frame_ready 0; uint8_t buf[64]; uint16_t len ring_buffer_read(buf, sizeof(buf)); jw01_data_t data parse_jw01_frame(buf, len); if(data.valid) { current_co2 data.co2; current_temp data.temp; data_valid 1; } } // 每 200ms 刷新一次显示 if(get_tick() - last_display 200) { last_display get_tick(); update_display(); } // 每 500ms 翻转一次 LED 指示 if(get_tick() - last_led 500) { last_led get_tick(); GPIO_WriteBit(GPIOC, GPIO_Pin_13, (BitAction)(1 - GPIO_ReadOutputDataBit(GPIOC, GPIO_Pin_13))); } } }显示刷新间隔设 200 ms 是权衡的结果太快了 I2C 占用高太慢了数值变化看起来不流畅。200 ms 对应 5 Hz 的刷新率对于 CO2 浓度这种变化缓慢的量来说完全够用。4. 常见问题与排查技巧实录4.1 串口收不到数据或数据乱码这是最常见的问题我把它拆成几个排查步骤。首先确认模块有没有在工作用 USB 转串口模块直接接 JW01 的 TX 和 GND电脑上开串口助手9600 波特率看有没有数据。如果没有检查模块供电是不是 5V有些模块 3.3V 也能亮灯但不输出数据。如果有数据但 STM32 收不到检查 PA3 有没有配置成浮空输入TX 和 RX 有没有交叉连接。数据乱码通常是波特率不匹配。JW01 默认 9600但如果你之前用配置命令改过可能变成了 115200 或者其他值。恢复默认的方法一般是断电重启有些版本需要发送特定命令。另外检查 STM32 的系统时钟配置如果外部晶振没起振系统时钟默认走内部 8 MHzUSART 的分频计算就会错波特率偏差大了自然乱码。用示波器或者逻辑分析仪量一下 PA2 的波形周期应该是 104 us 左右9600 波特率下一位的时间。4.2 校验和经常对不上校验和错误一般有三个原因帧格式理解错了、缓冲区里有残留数据、中断处理有问题。先确认你用的模块版本V2.2 是 9 字节帧校验和是前 7 字节累加。如果你按 7 字节帧去解析 9 字节的数据校验和肯定对不上。缓冲区残留是另一个常见问题。如果环形缓冲区的读写指针没有正确同步上一帧的尾部数据可能会混到下一帧的头部。我的做法是在空闲中断触发后把缓冲区里的数据全部读出来交给解析函数解析函数内部的状态机自己会处理帧头对齐。不要在中断里做解析中断里只负责搬运数据。还有一种情况是串口接收中断被其他高优先级中断打断了导致某个字节丢失。检查 NVIC 的优先级分组设置确保 USART2 的中断优先级足够高不会被 SysTick 或者其他中断长时间阻塞。4.3 OLED 不亮或显示异常OLED 不亮先查供电和 I2C 地址。用万用表量 VCC 和 GND 之间是不是 3.3V然后写个 I2C 扫描程序确认地址。如果地址对了但不亮检查初始化序列里的对比度设置有些模块默认对比度是 0需要手动设成 0xCF 或者 0x9F。显示异常比如花屏、部分区域不显示通常是初始化参数不对。128×64 的屏幕复用率是 0x3F128×32 的是 0x1F设错了显示区域就会错位。还有显示偏移的问题SSD1306 有一个显示偏移寄存器默认是 0但有些模块出厂设了偏移需要在初始化时写 0x00 纠正。I2C 通信不稳定导致的花屏可以在 SCL 和 SDA 上各并一个 100 pF 的电容到地滤掉高频噪声。软件 I2C 的延时也要注意太快了 SSD1306 跟不上我一般设 2 us 左右的延时对应大约 100 kHz 的速率。4.4 常见问题速查表现象可能原因排查方法解决方案串口无数据模块未供电或损坏万用表量 VCC检查 5V 供电数据乱码波特率不匹配逻辑分析仪量位宽确认 9600 波特率校验和错误帧格式理解错误抓原始数据对比确认 V2.2 帧格式OLED 不亮I2C 地址错误写扫描程序确认 0x78 或 0x3C显示花屏初始化参数错误对比标准序列检查复用率和偏移数值跳变帧解析错位打印原始帧加状态机对齐帧头程序卡死中断标志未清除调试器看 PC正确清除 IDLE 标志避坑技巧调试串口问题时先把接收到的原始十六进制数据打印到另一个串口或者 OLED 上肉眼确认帧结构。不要一上来就怀疑代码逻辑很多时候是硬件接线或者模块配置的问题。我习惯在项目初期加一个 raw data 显示模式把收到的每个字节都显示出来确认无误后再切换到解析模式。4.5 长时间运行的稳定性处理这个项目我连续跑了 72 小时做老化测试中间遇到过两次数据卡死的情况。排查下来是环形缓冲区的读写指针在极端情况下出现了竞争。虽然主循环和中断的读写操作在 32 位 MCU 上通常是原子的但如果缓冲区大小不是 2 的幂取模运算可能被中断打断导致指针计算错误。解决办法很简单把缓冲区大小设成 2 的幂比如 128 或 256然后用位与运算代替取模。另外在读写指针的更新上先更新数据再更新指针确保中断看到的数据是一致的。如果还是不放心可以在关键操作前后关中断但关中断的时间要尽可能短不要超过几个微秒。还有一个稳定性问题是 OLED 的 I2C 通信偶尔会超时。软件 I2C 没有超时检测如果 SDA 被拉低不放程序就会死在 while 循环里。我加了一个简单的超时计数每次等待 SCL 或 SDA 变化时最多循环 1000 次超时就复位 I2C 总线重新开始。这个保护机制在实际运行中触发过几次都是因为屏幕排线接触不良导致的加上之后再也没有卡死过。5. 项目扩展与个人体会这套东西跑通之后扩展方向其实很多。最直接的是加一个 SD 卡或者 Flash 芯片做数据记录把 CO2 浓度按时间戳存下来后期可以导出成 CSV 做趋势分析。我试过用 W25Q64 做循环存储每 10 秒写一条记录8 MB 的容量能存差不多一个月的数据。另一个方向是加无线模块把数据传到上位机或者手机端这个就看具体需求了有线串口和无线方案各有各的适用场景。显示方面如果觉得 0.96 寸太小可以换 1.3 寸的 SH1106 屏驱动方式和 SSD1306 基本兼容只需要改一下初始化里的列地址范围。或者上 TFT 彩屏用 SPI 接口刷新率更高能画曲线图但代码量会大不少。我在这个项目里最大的体会是传感器模块的 datasheet 永远只是参考实际拿到的模块行为可能和手册有出入。JW01 的 V2.2 固件我就遇到过两个批次一个输出温度值一个温度字节固定为 0x00。所以调试阶段一定要先抓原始数据确认帧格式和字段含义再动手写解析代码。另外串口通信的稳定性很大程度上取决于中断处理和缓冲区设计不要为了省事用轮询后期一定会出问题。OLED 这边软件 I2C 加超时保护是最稳妥的组合硬件 I2C 在 F103 上能不碰就不碰。最后分享一个小技巧如果你手头没有逻辑分析仪可以用 STM32 的另一个串口把原始数据转发到电脑上用串口助手的十六进制显示功能看帧结构。虽然不如逻辑分析仪直观但排查基本的波特率和帧格式问题足够了。