STM32F103C8T6连接ZH03B传感器：手把手教你用串口调试助手实时显示PM2.5数据

STM32PM2.5传感器数据采集

|难度：普通|阅读约 11 分钟

STM32F103C8T6与ZH03B传感器实战：从零搭建PM2.5监测系统

最近在工作室捣鼓环境监测设备时，发现很多朋友对如何用STM32读取PM2.5传感器存在困惑。作为一款性价比极高的激光粉尘传感器，炜盛ZH03B在创客圈颇受欢迎，但官方文档的晦涩表述常让初学者望而却步。本文将用最直白的语言，带你完整实现STM32F103C8T6与ZH03B的联调，重点解决实际开发中那些手册没写的细节问题。

1. 硬件准备与连接方案

1.1 器件选型要点

手头这块蓝色小板子STM32F103C8T6（俗称"蓝 pill"）堪称性价比之王，相比动辄上百元的开发板，它保留了完整的外设功能却只要一杯奶茶钱。搭配的ZH03B传感器要注意区分版本：

ZH03B-100：普通版（本文使用）
ZH03B-100F：带风扇版本
ZH03B-100U：UART输出型

提示：购买时务必确认是UART接口型号，I2C版本需要额外转接模块

1.2 引脚连接避坑指南

连接方案看似简单，但实际接线时这些细节最容易翻车：

设备端	开发板端	注意事项
ZH03B TX(PIN5)	PA3 (USART2_RX)	必须接3.3V电平
ZH03B RX(PIN4)	PA2 (USART2_TX)	非必要，仅需主动模式时使用
ZH03B GND	GND	共地消除干扰
ZH03B VCC	5V	严禁超过5.5V

c复制// 实测可用电源方案（电流需≥100mA）
1. USB转TTL模块的5V输出
2. 开发板的5V引脚
3. 18650电池+稳压模块

特别提醒：很多教程没提到的是，ZH03B上电需要约30秒预热才能输出稳定数据，期间串口可能收到乱码，这属于正常现象。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 工程配置关键步骤

2.1 时钟树配置玄机

STM32的时钟配置就像城市交通网，走错总线会导致数据"堵车"。对于Cortex-M3内核的F103系列：

APB2总线（高速路）：
- GPIOA-GPIOG
- USART1
- ADC1/2
- 所有IO口时钟
APB1总线（普通道路）：
- USART2/3
- I2C1/2
- SPI2/3
- TIM2-TIM7

bash复制# 检查时钟配置的命令（在STM32CubeMX中）
RCC → HSE → Crystal/Ceramic Resonator
→ APB1 Prescaler → /1 (保持72MHz)
→ APB2 Prescaler → /1 (保持72MHz)

2.2 串口参数精调

ZH03B的通信协议有这几个关键参数：

波特率：9600（出厂默认）
数据位：8位
停止位：1位
无校验位

在CubeMX中配置USART2时，建议开启DMA接收功能以减轻CPU负担。具体参数对应代码如下：

c复制// 串口初始化代码片段
huart2.Instance = USART2;
huart2.Init.BaudRate = 9600;
huart2.Init.WordLength = USART_WORDLENGTH_8B;
huart2.Init.StopBits = USART_STOPBITS_1;
huart2.Init.Parity = USART_PARITY_NONE;
huart2.Init.Mode = USART_MODE_TX_RX;
huart2.Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart2.Init.OverSampling = UART_OVERSAMPLING_16;

3. 数据解析实战技巧

3.1 协议帧结构解密

ZH03B的数据帧像精心包装的快递盒，我们需要拆开正确的层才能拿到PM2.5数值：

code复制字节位置  内容       说明
0        0x42      帧头1（ASCII 'B'）
1        0x4D      帧头2（ASCII 'M'）
2-3      帧长度     固定为0x001C（28字节）
4-5      PM1.0     通常忽略
6-7      PM2.5     目标数据（重点）
8-9      PM10      可选监测
10-11    保留位     
12-13    PM2.5重复 校验用
...      校验和     字节0-21的累加和

3.2 状态机解析法

比起简单粗暴的数组匹配，状态机更适合处理不连续的串口数据。下面这个方案经过实测稳定性极佳：

c复制typedef enum {
    WAIT_HEADER1,
    WAIT_HEADER2,
    RECEIVING_DATA,
    DATA_READY
} ParserState;

ParserState state = WAIT_HEADER1;
uint8_t buffer[32];
uint16_t index = 0;

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
    static uint8_t rx_data;
    if(huart->Instance == USART2) {
        HAL_UART_Receive_IT(&huart2, &rx_data, 1);
        
        switch(state) {
            case WAIT_HEADER1:
                if(rx_data == 0x42) {
                    buffer[index++] = rx_data;
                    state = WAIT_HEADER2;
                }
                break;
                
            case WAIT_HEADER2:
                if(rx_data == 0x4D) {
                    buffer[index++] = rx_data;
                    state = RECEIVING_DATA;
                } else {
                    state = WAIT_HEADER1;
                    index = 0;
                }
                break;
                
            case RECEIVING_DATA:
                buffer[index++] = rx_data;
                if(index >= 32) {
                    state = DATA_READY;
                    process_pm_data();
                }
                break;
        }
    }
}

4. 调试进阶与性能优化

4.1 串口助手高级玩法

普通的数据显示太单调？试试这些串口工具技巧：

CoolTerm：支持数据持久化记录
Termite：轻量级且支持正则过滤
自定义协议解析（以XCOM V2.2为例）：

code复制发送格式：<GET>${传感器地址}${命令}<CR>
示例：<GET>01RD<CR>

4.2 低功耗设计要点

当需要电池供电时，这些技巧可延长10倍续航：

启用STM32的Stop模式（电流降至20μA）
配置ZH03B进入休眠模式（通过TX引脚发送）
定时唤醒采样（RTC闹钟中断）
采样间隔建议≥30秒（传感器需要稳定时间）

c复制// 传感器休眠控制代码
void zh03b_sleep(bool enable) {
    uint8_t cmd[] = {0xFF, 0x01, enable ? 0xA0 : 0xA1, 0x00, 0x00};
    HAL_UART_Transmit(&huart2, cmd, sizeof(cmd), 100);
}

5. 常见问题排错指南

5.1 数据异常排查表

现象	可能原因	解决方案
持续输出FF FF	电压不稳或接触不良	检查5V电源质量
数据波动剧烈	传感器进气口堵塞	清洁激光通道
偶尔出现零值	电磁干扰	缩短线缆或加磁环
无任何数据输出	波特率不匹配	确认是否为9600bps
校验和错误	数据帧不完整	增加接收超时判断

5.2 校准注意事项

ZH03B支持手动校准，但需注意：

必须在清洁空气中进行（建议运行30分钟后）
校准命令需要连续发送两次
校准过程约3分钟，期间数据无效

python复制# 校准命令示例（十六进制）
# 第一次发送
0xFF 0x01 0x87 0x00 0x00 0x00 0x00 0x00 0x88
# 等待3秒后第二次发送相同命令

最后分享一个实战经验：在潮湿环境下，传感器内部可能结露导致数据异常。我在南方梅雨季时给ZH03B加了硅胶防潮盒，PM2.5读数稳定性提升了70%。