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模式下，模块的从机地址是0x2C（7位地址），读浓度只需要读两个寄存器：0x04和0x05，高字节在前。I2C的好处是不占用UART资源，适合STM32串口已经分配给调试打印或其他外设的场景。但I2C的坑在于模块内部上拉电阻的配置，如果你的STM32板子上已经有4.7kΩ上拉，模块自带的10kΩ上拉并联后会导致上升沿变缓，高速模式下容易丢数据。实测在100kHz标准模式下没问题，400kHz快速模式建议拆掉模块上的上拉电阻。

选UART还是I2C，我的建议是：如果你只需要读CO2浓度，I2C更省事，两根线搞定，不占用串口中断资源；如果你还需要同时读温度、湿度，或者模块固件版本较老只支持UART输出完整数据帧，那就用UART。下面这张表是我实测两种方式的对比：

对比项	UART模式	I2C模式
占用引脚	TX、RX（可只接RX）	SCL、SDA
默认速率	9600bps	100kHz
数据完整性	含温度、湿度、浓度	仅浓度（部分固件含温度）
中断开销	需串口中断或轮询	可用硬件I2C或软件模拟
多设备挂载	点对点	可挂载多个I2C设备
常见问题	波特率偏差、帧头误判	上拉电阻冲突、地址错误

2. STM32端USART2的配置细节与中断接收的坑

2.1 为什么选USART2而不是USART1

STM32最小系统板上，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字节的某种校验关系（不同固件校验算法略有差异，常见的是~（byte1+byte2+...+byte8）+1）。

我实际调试时遇到过一种情况：模块上电后第一帧数据总是错的，后面就正常了。后来用逻辑分析仪抓波形发现，模块上电初始化需要约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‑OLED（SSD1306驱动）是这类项目最常见的显示方案，默认从机地址0x78（8位写地址）或0x3C（7位地址）。JW01‑CO2‑V2.2的I2C地址是0x2C，两者不冲突，可以挂在同一条I2C总线上。但要注意，STM32的硬件I2C在F1系列上有个著名的“死锁”问题：当主机在读取过程中被中断打断，从机拉低SDA等待时钟时，如果主机没有及时恢复，总线就会卡死。我的做法是：要么用软件模拟I2C（GPIO翻转），要么在硬件I2C出错时调用I2C_GenerateSTOP加I2C_SoftwareResetCmd复位。

软件模拟I2C的延时函数很关键。很多教程用delay_us(2)，但在72MHz的STM32上，delay_us如果基于SysTick，最小延时可能不准。我一般直接用__NOP()循环，根据逻辑分析仪实测调整循环次数。100kHz的I2C，半周期约5us，72MHz下约360个时钟周期，用for(i=0;i<30;i++) __NOP();差不多。

3.2 显示刷新的节流策略

CO2浓度变化是缓慢的，没必要每收到一帧数据就刷一次OLED。SSD1306全屏刷新一次约需20ms（I2C 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‑01S（ESP8266），用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 Flash，Bootloader占8KB，应用程序如果带OLED驱动、串口协议、MQTT，很容易超过56KB。我的建议是：如果非要OTA，换F103CBT6（128KB）或者F401系列。OTA的流程是：Bootloader检查备份区标志，如果有新固件就搬运到运行区，然后跳转。注意STM32的Flash写操作要按半字（16位）对齐，搬运前先擦除目标扇区。

5.3 低功耗场景下的采样策略

如果项目是电池供电的便携空气质量检测仪，CO2模块的功耗是大头（约30mA）。STM32可以进Stop模式，但模块不能断电，因为NDIR传感器每次上电都要重新预热。折中方案是：STM32用RTC定时唤醒（比如每10秒醒一次），醒后读一帧CO2数据，刷OLED，然后继续睡。模块一直供电，整机平均电流约35mA，2000mAh电池能撑两天左右。如果加一个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传感器，它测的是二氧化碳浓度，反映的是通风状况，不是空气洁净度。别把这两个概念搞混了，否则做出来的项目逻辑就是错的。