STM32驱动JW01-CO2-V2.2：UART/I2C通信与OLED显示实战

1. 拿到JW01‑CO2‑V2.2模块后先搞清楚它到底怎么用JW01‑CO2‑V2.2这个模块在空气质量检测类项目里出现频率很高尤其是基于STM32的毕业设计和开源环境监测方案。它的核心是一颗NDIR非色散红外二氧化碳传感器量程通常覆盖400到5000ppm输出方式支持UART和I2C两种。很多人拿到手第一反应是直接怼到STM32的串口上读数据结果发现读出来的全是乱码或者固定值问题基本都出在通信参数和协议帧格式没对上。这个模块的UART默认波特率是9600数据位8停止位1无校验。注意它不像很多GPS模块那样上电就主动吐数据JW01‑CO2‑V2.2需要你先发一条读取命令它才会回一帧数据。命令帧格式是固定的0xFF 0x01 0x86 0x00 0x00 0x00 0x00 0x00 0x79共9个字节。返回帧也是9个字节第2字节是浓度高8位第3字节是浓度低8位第4字节是温度第5字节是湿度部分固件版本最后是校验和。I2C模式下模块的从机地址是0x2C7位地址读浓度只需要读两个寄存器0x04和0x05高字节在前。I2C的好处是不占用UART资源适合STM32串口已经分配给调试打印或其他外设的场景。但I2C的坑在于模块内部上拉电阻的配置如果你的STM32板子上已经有4.7kΩ上拉模块自带的10kΩ上拉并联后会导致上升沿变缓高速模式下容易丢数据。实测在100kHz标准模式下没问题400kHz快速模式建议拆掉模块上的上拉电阻。选UART还是I2C我的建议是如果你只需要读CO2浓度I2C更省事两根线搞定不占用串口中断资源如果你还需要同时读温度、湿度或者模块固件版本较老只支持UART输出完整数据帧那就用UART。下面这张表是我实测两种方式的对比对比项UART模式I2C模式占用引脚TX、RX可只接RXSCL、SDA默认速率9600bps100kHz数据完整性含温度、湿度、浓度仅浓度部分固件含温度中断开销需串口中断或轮询可用硬件I2C或软件模拟多设备挂载点对点可挂载多个I2C设备常见问题波特率偏差、帧头误判上拉电阻冲突、地址错误2. STM32端USART2的配置细节与中断接收的坑2.1 为什么选USART2而不是USART1STM32最小系统板上USART1的PA9、PA10通常被用来做下载调试或者接USB转串口模块如果你用USART1接CO2模块调试信息就没地方打印了。USART2的PA2、PA3在很多板子上是空闲的正好拿来接模块。以STM32F103C8T6为例USART2挂在APB1总线上时钟频率36MHz配置波特率9600时BRR寄存器的值计算如下USARTDIV 36,000,000 / (16 × 9600) 234.375 整数部分 234 0xEA 小数部分 0.375 × 16 6 0x6 BRR 0xEA6用标准库配置时USART_InitStructure.USART_BaudRate 9600库函数会自动算好。但如果你用的是HAL库注意HAL_UART_Init里有个OverSampling参数默认是UART_OVERSAMPLING_16对应上面的计算。如果改成8倍过采样BRR值会不同但9600这种低速下没必要改。2.2 中断接收的帧头对齐问题JW01‑CO2‑V2.2返回的9字节帧以0xFF开头但数据区里也可能出现0xFF。如果你在串口中断里简单判断if (rxByte 0xFF) frameIndex 0;遇到数据区有0xFF就会误判帧头导致整帧错位。正确的做法是用状态机接收先等第一个0xFF然后连续收满9个字节最后校验第9字节是否等于前8字节的某种校验关系不同固件校验算法略有差异常见的是~byte1byte2...byte81。我实际调试时遇到过一种情况模块上电后第一帧数据总是错的后面就正常了。后来用逻辑分析仪抓波形发现模块上电初始化需要约200ms这期间TX引脚会输出一个低电平毛刺STM32的RX引脚如果配置成浮空输入这个毛刺会被当成起始位触发中断收到一个0x00。解决办法很简单模块上电后延时300ms再初始化USART2或者在中断里加一个超时重置机制超过10ms没收到完整帧就清空缓冲区。2.3 串口中断服务函数的写法下面是我在标准库下常用的中断接收代码框架用环形缓冲区加状态机稳定跑过连续72小时的老化测试#define FRAME_LEN 9 uint8_t rxBuf[FRAME_LEN]; uint8_t rxIdx 0; uint8_t frameReady 0; void USART2_IRQHandler(void) { if (USART_GetITStatus(USART2, USART_IT_RXNE) ! RESET) { uint8_t ch USART_ReceiveData(USART2); if (rxIdx 0 ch ! 0xFF) return; // 等帧头 rxBuf[rxIdx] ch; if (rxIdx FRAME_LEN) { rxIdx 0; // 校验第9字节 0xFF - (前7字节之和的低8位) 1 uint8_t sum 0; for (int i 1; i 8; i) sum rxBuf[i]; if (rxBuf[8] (uint8_t)(0xFF - sum 1)) { frameReady 1; } } USART_ClearITPendingBit(USART2, USART_IT_RXNE); } }注意校验算法这里写的是0xFF - sum 1等价于~sum 1也就是取反加一。不同批次的模块校验方式可能不同有的用简单累加和有的用异或。拿到模块后先用USB转串口工具在电脑上抓几帧原始数据确认校验方式再写代码能省很多调试时间。3. I2C‑OLED与CO2数据的同屏显示方案3.1 OLED选型与I2C地址冲突排查0.96寸I2C‑OLEDSSD1306驱动是这类项目最常见的显示方案默认从机地址0x788位写地址或0x3C7位地址。JW01‑CO2‑V2.2的I2C地址是0x2C两者不冲突可以挂在同一条I2C总线上。但要注意STM32的硬件I2C在F1系列上有个著名的“死锁”问题当主机在读取过程中被中断打断从机拉低SDA等待时钟时如果主机没有及时恢复总线就会卡死。我的做法是要么用软件模拟I2CGPIO翻转要么在硬件I2C出错时调用I2C_GenerateSTOP加I2C_SoftwareResetCmd复位。软件模拟I2C的延时函数很关键。很多教程用delay_us(2)但在72MHz的STM32上delay_us如果基于SysTick最小延时可能不准。我一般直接用__NOP()循环根据逻辑分析仪实测调整循环次数。100kHz的I2C半周期约5us72MHz下约360个时钟周期用for(i0;i30;i) __NOP();差不多。3.2 显示刷新的节流策略CO2浓度变化是缓慢的没必要每收到一帧数据就刷一次OLED。SSD1306全屏刷新一次约需20msI2C 100kHz下如果每秒刷10次CPU有20%的时间耗在显示上。我的做法是每500ms更新一次显示中间的数据只更新全局变量。另外OLED显示CO2浓度时建议同时显示一个趋势箭头上升、下降、平稳用最近3次采样的差值判断这样比单纯显示数字更直观。显示布局可以这样安排第一行显示“CO2: 1234 ppm”第二行显示“Temp: 25.3 C”第三行显示“Hum: 45%”第四行显示“Status: OK”或“Status: CAL”。如果模块正在预热或校准状态栏要明确提示否则用户会以为读数不准是代码问题。3.3 字库裁剪与RAM占用SSD1306的显存是128×64位即1KB。STM32F103C8T6只有20KB RAM如果再用全字库ASCII 96个字符每个字符16字节共1.5KB加上串口缓冲、栈空间RAM会很紧张。我的做法是只取需要的字符数字0‑9、大写字母、冒号、小数点、空格大约30个字符字库占用不到500字节。用PCtoLCD2002取模时选“阴码逐列式顺向”C51格式生成的数组直接放到const区不占RAM。4. 校准、预热与数据可信度的实战判断4.1 上电预热到底要多久JW01‑CO2‑V2.2的说明书一般写“预热3分钟”但实测下来上电后前30秒读数会从400ppm快速爬升到800‑1000ppm然后缓慢回落。真正稳定到环境真实值需要5‑10分钟取决于环境温湿度和模块之前断电的时长。如果你做的是便携设备不可能等10分钟那就在代码里加一个“预热标志”上电后前3分钟显示“Warming up”数据用灰色或加括号3分钟后正常显示。这样用户知道读数还在漂不会误判。4.2 零点校准的触发条件NDIR传感器的零点会随时间和温度漂移。模块支持手动校准在干净空气室外或通风良好的室内CO2约400ppm中给模块发校准命令UART下是0xFF 0x01 0x87 0x00 0x00 0x00 0x00 0x00 0x78模块会把当前读数设为400ppm。注意校准命令不要频繁发一个月一次足够。而且校准期间模块要稳定供电电压波动会导致校准失败。我遇到过用AMS1117供电输入输出电容用钽电容换成陶瓷电容后校准总是失败换回钽电容或加大陶瓷电容到22uF就正常了。原因是NDIR传感器的红外灯珠在校准时会加大驱动电流电源纹波大了会影响测量。4.3 数据跳变的常见原因排查如果你发现CO2读数偶尔跳到5000ppm或0ppm按这个顺序排查电源问题用示波器看模块VCC引脚纹波超过50mV就会导致读数异常。加一个100uF电解电容并联0.1uF陶瓷电容。串口干扰TX、RX线太长超过20cm且没有屏蔽附近有电机或继电器动作时会耦合噪声。缩短线长或加磁环。帧校验漏判如果校验算法写错错误帧被当成有效数据。用逻辑分析仪抓原始字节手动算一遍校验。I2C时钟拉伸JW01模块在转换数据时会拉低SCL如果STM32的I2C没有处理时钟拉伸硬件I2C一般支持软件模拟要加超时读到的就是旧数据或0。5. 从裸机到OTA这个项目还能怎么扩展5.1 加一个ESP8266做数据上云裸机跑通CO2采集和OLED显示后下一步自然是把数据传到手机或云端。最省事的方案是加一个ESP‑01SESP8266用AT指令连WiFi通过MQTT把数据推到公共平台。STM32和ESP8266之间用USART3通信注意ESP8266的AT固件默认波特率是115200和CO2模块的9600不同要分开配置。数据格式用JSON{co2:856,temp:24.5,hum:48}每30秒发一次流量消耗很小。5.2 OTA升级的可行性分析有人问能不能给这个项目加OTA。技术上可行但要看STM32的Flash够不够。F103C8T6只有64KB FlashBootloader占8KB应用程序如果带OLED驱动、串口协议、MQTT很容易超过56KB。我的建议是如果非要OTA换F103CBT6128KB或者F401系列。OTA的流程是Bootloader检查备份区标志如果有新固件就搬运到运行区然后跳转。注意STM32的Flash写操作要按半字16位对齐搬运前先擦除目标扇区。5.3 低功耗场景下的采样策略如果项目是电池供电的便携空气质量检测仪CO2模块的功耗是大头约30mA。STM32可以进Stop模式但模块不能断电因为NDIR传感器每次上电都要重新预热。折中方案是STM32用RTC定时唤醒比如每10秒醒一次醒后读一帧CO2数据刷OLED然后继续睡。模块一直供电整机平均电流约35mA2000mAh电池能撑两天左右。如果加一个MOS管控制模块电源每次采样前提前3分钟上电预热平均电流能降到5mA以下但数据刷新率就变成3分钟一次了。6. 调试工具与常见故障速查6.1 必备的调试工具清单USB转TTL模块CH340或CP2102都行用来在电脑上抓模块原始数据。逻辑分析仪8通道24MHz的够用抓UART和I2C时序排查帧错误和时钟拉伸。万用表测模块VCC电压和电流判断供电是否充足。ST‑Link V2下载和单步调试配合Keil5或STM32CubeIDE。6.2 故障速查表现象可能原因快速验证方法串口无数据TX/RX接反、波特率不对交换TX/RX确认9600数据固定不变模块未发命令、I2C地址错发读取命令扫描I2C地址读数跳变电源纹波、线缆干扰示波器看VCC缩短线缆OLED不亮I2C地址错、上拉缺失扫描地址测SCL/SDA电压校准失败电源不稳、环境CO2高换钽电容到室外校准上电第一帧错模块初始化毛刺延时300ms再初始化串口6.3 一个容易被忽略的细节STM32的JTAG禁用如果你用PA15、PB3、PB4做普通GPIO比如接OLED的复位或I2C引脚会发现配置了推挽输出但电平不对。这是因为这些引脚默认是JTAG功能。要在标准库的GPIO_PinRemapConfig里调用GPIO_Remap_SWJ_JTAGDisable只保留SWD下载。HAL库则在HAL_Init之后调用__HAL_AFIO_REMAP_SWJ_NOJTAG()。这个坑我在三个项目里都踩过每次都是查了半天才发现是JTAG没关。7. 写在最后关于这个模块的一些个人体会JW01‑CO2‑V2.2的性价比在百元级CO2模块里算不错的但它的固件版本比较杂不同批次买回来可能校验方式、预热时间、I2C寄存器定义都有细微差别。我的习惯是每批模块到手先用USB转串口抓20帧数据存成CSV用Python算一下校验规律确认无误再写进STM32代码。另外模块的PCB上有一个校准按键长按3秒会触发零点校准但如果你把它装在密闭外壳里按键够不着还是用软件命令校准更靠谱。OLED显示CO2浓度时建议加一个“笑脸/哭脸”图标800ppm以下笑脸800‑1500ppm平脸1500ppm以上哭脸。别小看这个图标用户扫一眼就知道空气质量好坏比盯着数字看直观得多。这个功能用取模软件生成三个16×16的图标数组切换显示就行占不了多少Flash。最后说一句CO2传感器不是PM2.5传感器它测的是二氧化碳浓度反映的是通风状况不是空气洁净度。别把这两个概念搞混了否则做出来的项目逻辑就是错的。