STM32F103C8T6连接ZH03B传感器：一个串口采集PM2.5数据的完整流程（附代码）

STM32F103C8T6与ZH03B传感器实战从零搭建PM2.5监测系统最近在做一个室内空气质量监测的小项目发现ZH03B这款激光粉尘传感器性价比超高但网上资料比较零散。今天就把整个开发过程整理成保姆级教程特别适合刚接触STM32的新手。我用的是最常见的STM32F103C8T6最小系统板蓝色药丸板成本不到20元搭配ZH03B传感器教你如何通过串口获取精确的PM2.5数据。1. 硬件准备与连接先清点下需要的器材STM32F103C8T6开发板正点原子Mini板或类似蓝色药丸板均可ZH03B激光粉尘传感器注意要买3.3V版本的USB转TTL模块如CH340杜邦线若干万用表非必须但建议备一个重要提醒ZH03B有5V和3.3V两种版本STM32的IO口耐压一般是3.3V务必确认你的传感器是3.3V电平的我刚开始就买错了版本导致数据异常后来用逻辑电平转换器才解决。接线示意图STM32引脚ZH03B引脚功能说明PA2PIN5(TXD)传感器数据输出PA3PIN4(RXD)传感器控制输入3.3VPIN1(VCC)电源正极GNDPIN2(GND)电源地线注意很多教程只接了TXD但实际上RXD也需要连接因为ZH03B的主动输出模式需要MCU发送配置指令。2. 开发环境搭建推荐使用Keil MDKSTM32CubeMX组合对新手特别友好安装Keil MDK-ARM记得注册避免代码大小限制下载STM32CubeMX并安装F1系列HAL库新建工程选择STM32F103C8型号配置时钟树外部晶振8MHz主频设为72MHz时钟配置是新手最容易出错的地方这里给出一个稳定配置方案// SystemClock_Config() 关键参数 RCC_OscInitStruct.OscillatorType RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL RCC_PLL_MUL9;3. 串口配置与传感器初始化我们需要配置两个串口USART1用于调试输出连接电脑USART2与ZH03B通信在CubeMX中的配置步骤使能USART1和USART2USART1参数9600波特率8位数据无校验USART2参数9600波特率8位数据无校验开启USART2全局中断关键点USART1在APB2总线USART2在APB1总线时钟使能时要特别注意__HAL_RCC_USART1_CLK_ENABLE(); // APB2 __HAL_RCC_USART2_CLK_ENABLE(); // APB1ZH03B传感器需要先发送初始化指令才能进入主动输出模式// ZH03B初始化指令 uint8_t init_cmd[] {0xFF, 0x01, 0x78, 0x40, 0x00, 0x00, 0x00, 0x00, 0x47}; HAL_UART_Transmit(huart2, init_cmd, sizeof(init_cmd), 100);4. 数据解析与处理ZH03B的数据帧格式固定为32字节包含PM1.0、PM2.5、PM10等参数0 1 2 3 4~5 6~7 8~9 10~15 16~31 0x42 0x4D Len Data PM1.0 PM2.5 PM10 保留 校验和在USART2中断服务函数中添加解析逻辑void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { static uint8_t rx_buf[32], index 0; static bool frame_start false; if(huart-Instance USART2) { uint8_t byte rx_byte; // 接收到的字节 if(!frame_start byte 0x42) { frame_start true; rx_buf[0] byte; index 1; } else if(frame_start) { rx_buf[index] byte; // 完整帧接收完成 if(index 32 rx_buf[1] 0x4D) { uint16_t pm25 (rx_buf[6] 8) | rx_buf[7]; printf(PM2.5: %d ug/m3\r\n, pm25); frame_start false; } } } }5. 常见问题排查问题1接收不到任何数据检查接线是否正确TXD-RX交叉连接用万用表测量传感器VCC电压是否为3.3V尝试降低波特率如4800问题2数据乱码确认双方波特率一致检查STM32时钟配置是否正确尝试在传感器TXD线上加1K上拉电阻问题3数据偶尔丢失增加接收缓冲区大小优化中断优先级建议设置USART2中断优先级高于其他外设在传感器电源端并联100μF电容6. 进阶优化建议数据平滑处理传感器数据可能有波动可以添加滑动平均滤波#define FILTER_SIZE 5 uint16_t pm25_buffer[FILTER_SIZE] {0}; uint8_t filter_index 0; // 在数据解析后添加 pm25_buffer[filter_index] pm25; if(filter_index FILTER_SIZE) filter_index 0; uint32_t avg 0; for(int i0; iFILTER_SIZE; i) avg pm25_buffer[i]; avg / FILTER_SIZE;低功耗模式适合电池供电场景间隔唤醒采集如每5分钟唤醒一次采集完成后进入Stop模式多传感器融合可搭配温湿度传感器如DHT22获取更全面的环境数据7. 完整项目代码结构建议按模块化方式组织代码├── Core │ ├── Src │ │ ├── main.c │ │ ├── stm32f1xx_it.c │ │ └── usart.c │ └── Inc │ ├── main.h │ └── zh03b.h ├── Drivers └── zh03b_driver ├── zh03b.c └── zh03b.h关键数据结构封装// zh03b.h typedef struct { UART_HandleTypeDef *huart; uint16_t pm1_0; uint16_t pm2_5; uint16_t pm10; } ZH03B_HandleTypeDef; void ZH03B_Init(ZH03B_HandleTypeDef *hzh03b); HAL_StatusTypeDef ZH03B_ReadData(ZH03B_HandleTypeDef *hzh03b);在调试过程中发现ZH03B对电源稳定性要求较高建议在VCC和GND之间并联一个100μF的电解电容加一个0.1μF的陶瓷电容这样数据稳定性会明显提升。另外传感器的激光头容易积灰建议每隔几个月用棉签轻轻清洁否则测量精度会逐渐下降。