STM32 进阶封神之路（十三）：空气质量传感器实战 ——KQM6600 模块从协议到代码（串口通信 + 数据解析）

STM32 进阶封神之路（十三）：空气质量传感器实战 ------KQM6600 模块从协议到代码（串口通信 + 数据解析）

上一篇我们吃透了 STM32 串口全场景应用，这一篇聚焦嵌入式系统中核心的 "感知层"------空气质量传感器。以工业级 KQM6600 模块为例，从传感器基础认知、模块硬件解析、串口通信协议，到 STM32 代码实现（数据读取 + 解析 + 打印），手把手带你实现 "环境空气质量实时监测"，让你掌握传感器与 STM32 的串口交互逻辑！

本文基于实战资料，全程围绕 "串口通信" 核心，覆盖从硬件连接到代码落地的全流程，所有代码可直接适配 STM32F103 系列，新手可照搬，进阶者可深挖协议解析逻辑！

一、复习回顾：传感器通信核心基础

在深入传感器实战前，先衔接关键基础，避免知识断层：

1. 传感器与 MCU 的通信方式 ：主流为串口（UART）、I2C、SPI，本文 KQM6600 采用串口 UART通信（TTL 电平，8N1 配置）；
2. 串口通信核心参数：波特率、数据位、校验位、停止位必须与传感器一致，否则数据解析失败；
3. 协议解析本质：传感器按固定格式发送数据帧（帧头 + 数据 + 校验 + 帧尾），MCU 需按协议规则提取有效数据；
4. 核心逻辑：STM32 通过串口发送指令→传感器响应数据→STM32 解析数据→输出结果（串口打印 / LED 指示）。

二、传感器基础认知：分类与选型逻辑

嵌入式系统中的传感器是 "环境感知入口"，按输出信号类型可分为数字量传感器和模拟量传感器，不同类型适配不同场景：

1. 传感器核心分类

表格

类型	输出信号	核心特点	通信方式	典型应用
数字量传感器	高低电平 / 串口帧 / I2C 数据	抗干扰强、数据精准、解析简单	UART/I2C/SPI/GPIO	按键、红外避障、KQM6600 空气质量传感器
模拟量传感器	连续电压 / 电流信号（0~3.3V/4~20mA）	成本低、响应快	ADC 采集	电位器、温度传感器（LM35）、湿度传感器（HS1101）

2. 模拟量传感器细分（拓展认知）

模拟量传感器按输出信号形式可进一步分类，适配不同传输距离和精度需求：

• 电压型模拟量传感器：输出 0~3.3V/0~5V 电压信号（如 LM35：0℃对应 0V，1℃对应 10mV），传输距离≤10 米，适用于短距离、低精度场景；
• 电流型模拟量传感器：输出 4~20mA 电流信号（如工业压力传感器），抗干扰强、传输距离≤1000 米，适用于工业远距离场景；
• 核心区别：电流型抗干扰优于电压型，电压型接线更简单（无需额外电源）。

3. KQM6600 传感器定位

KQM6600 是数字量串口传感器，核心优势：

• 集成多种气体检测（如 PM2.5、甲醛、TVOC），数据全面；
• 串口 TTL 电平输出，直接与 STM32 对接（无需电平转换）；
• 固定协议帧格式，解析逻辑简单；
• 工业级稳定性，适配恶劣环境（-20℃~60℃工作温度）。

三、KQM6600 模块深度解析：从数据手册到硬件

要实现传感器与 STM32 的交互，必须先吃透模块的 "硬件特性" 和 "通信协议"------ 数据手册是核心参考，需重点关注关键参数。

1. 数据手册核心要点（必看！）

获取 KQM6600 数据手册后，无需通读，重点提取以下 5 类信息：

• 通信参数：波特率（默认 9600bps）、数据位（8 位）、校验位（无）、停止位（1 位）→ 8N1 配置；
• 供电电压：3.3V~5V（宽电压兼容，STM32 可直接供电）；
• 输出格式：串口 ASCII 码帧（含帧头、数据、校验、帧尾）；
• 引脚定义：VCC（电源）、GND（地）、TX（传感器发送）、RX（传感器接收）、SET（配置引脚，可选）；
• 响应机制：默认主动上报（周期 1 秒）或被动响应（STM32 发送指令后返回数据）。

2. KQM6600 硬件层解析

（1）核心引脚功能

表格

引脚名称	功能描述	与 STM32 连接关系
VCC	电源输入	接 STM32 3.3V/5V（推荐 3.3V，避免电平冲突）
GND	地	接 STM32 GND（共地是通信稳定的前提）
TX	传感器发送数据	接 STM32 USART1_RX（PA10）→ 交叉连接
RX	传感器接收数据	接 STM32 USART1_TX（PA9）→ 交叉连接
SET	配置引脚（可选）	悬空或接 GPIO（用于修改传感器参数，本文暂不涉及）

（2）硬件连接图（STM32F103C8T6 + KQM6600）

plaintext

STM32F103C8T6          KQM6600模块
PA9（USART1_TX）  ←→  RX（传感器接收）
PA10（USART1_RX） ←→  TX（传感器发送）
3.3V              ←→  VCC
GND               ←→  GND

• 关键注意：TX/RX 必须交叉连接，共地不可省略（否则数据乱码或无响应）；
• 供电选择：优先用 STM32 3.3V 供电，避免 5V 供电导致 STM32 引脚电平过载。

3. KQM6600 协议层解析（核心！数据解析关键）

KQM6600 采用固定 ASCII 码帧格式主动上报数据，帧结构清晰，无需复杂校验逻辑（部分版本含校验位，需按手册调整）。

（1）协议帧格式（默认主动上报）

plaintext

帧头（2字节） + 数据段（N字节） + 帧尾（2字节）

• 帧头：0x4B 0x51（ASCII 码 "KQ"，固定标识）；
• 数据段：按 "PM2.5→甲醛→TVOC→温度→湿度" 顺序排列，各数据用逗号分隔（如 "15,0.03,0.12,25,55"）；
  • PM2.5：单位 μg/m³（0~1000）；
  • 甲醛（HCHO）：单位 mg/m³（0~1.0）；
  • TVOC：单位 mg/m³（0~1.0）；
  • 温度：单位℃（-20~60）；
  • 湿度：单位 % RH（0~100）；
• 帧尾：0x0D 0x0A（回车 + 换行，ASCII 码 "\r\n"，帧结束标识）。

（2）完整数据帧示例

plaintext

0x4B 0x51 0x31 0x35 0x2C 0x30 0x2E 0x30 0x33 0x2C 0x30 0x2E 0x31 0x32 0x2C 0x32 0x35 0x2C 0x35 0x35 0x0D 0x0A

解析为 ASCII 字符串：KQ15,0.03,0.12,25,55\r\n

• 对应数据：PM2.5=15μg/m³，甲醛 = 0.03mg/m³，TVOC=0.12mg/m³，温度 = 25℃，湿度 = 55% RH。

（3）协议解析核心逻辑

1. 接收串口数据，判断是否以帧头 "KQ" 开头；
2. 提取帧头与帧尾之间的字符串（逗号分隔的数值）；
3. 按逗号分割字符串，转换为对应数据类型（整数 / 浮点数）；
4. 输出解析后的数据（串口打印或存储）。

四、STM32 实战代码：KQM6600 数据读取与解析

核心流程：串口初始化→数据接收→协议解析→数据输出，以下是库函数与寄存器双版本实现（基于 USART1，9600bps 8N1）。

1. 核心数据结构定义（统一数据管理）

c

运行

#include "stm32f10x.h"
#include <stdio.h>
#include <string.h>

// 空气质量数据结构体（统一存储解析后的数据）
typedef struct {
    uint16_t pm25;        // PM2.5浓度（μg/m³）
    float hcho;           // 甲醛浓度（mg/m³）
    float tvoc;           // TVOC浓度（mg/m³）
    int8_t temperature;   // 温度（℃）
    uint8_t humidity;     // 湿度（%RH）
    uint8_t data_valid;   // 数据有效性标志（1=有效，0=无效）
} AirQuality_TypeDef;

AirQuality_TypeDef air_data; // 全局空气质量数据变量
uint8_t rx_buffer[64];       // 串口接收缓冲区
uint16_t rx_index = 0;       // 缓冲区索引

2. 串口初始化（USART1，9600bps 8N1）

（1）库函数版

c

运行

// USART1初始化：9600bps，8N1，中断接收
void USART1_Init(void) {
    GPIO_InitTypeDef GPIO_InitStruct;
    USART_InitTypeDef USART_InitStruct;
    NVIC_InitTypeDef NVIC_InitStruct;

    // 1. 使能时钟
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);

    // 2. 配置GPIO（PA9=TX，PA10=RX）
    GPIO_InitStruct.GPIO_Pin = GPIO_Pin_9;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOA, &GPIO_InitStruct);

    GPIO_InitStruct.GPIO_Pin = GPIO_Pin_10;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IN_FLOATING;
    GPIO_Init(GPIOA, &GPIO_InitStruct);

    // 3. 配置串口参数（KQM6600默认9600bps 8N1）
    USART_InitStruct.USART_BaudRate = 9600;
    USART_InitStruct.USART_WordLength = USART_WordLength_8b;
    USART_InitStruct.USART_StopBits = USART_StopBits_1;
    USART_InitStruct.USART_Parity = USART_Parity_No;
    USART_InitStruct.USART_HardwareFlowControl = USART_HardwareFlowControl_None;
    USART_InitStruct.USART_Mode = USART_Mode_Tx | USART_Mode_Rx;
    USART_Init(USART1, &USART_InitStruct);

    // 4. 配置接收中断
    USART_ITConfig(USART1, USART_IT_RXNE, ENABLE);
    NVIC_InitStruct.NVIC_IRQChannel = USART1_IRQn;
    NVIC_InitStruct.NVIC_IRQChannelPreemptionPriority = 1;
    NVIC_InitStruct.NVIC_IRQChannelSubPriority = 0;
    NVIC_InitStruct.NVIC_IRQChannelCmd = ENABLE;
    NVIC_Init(&NVIC_InitStruct);

    // 5. 使能USART1
    USART_Cmd(USART1, ENABLE);

    // 初始化数据结构体
    memset(&air_data, 0, sizeof(AirQuality_TypeDef));
    air_data.data_valid = 0;
}

（2）寄存器版

c

运行

void USART1_Init(void) {
    // 1. 使能时钟
    RCC->APB2ENR |= (1<<14) | (1<<2); // USART1=bit14，GPIOA=bit2

    // 2. 配置GPIO
    GPIOA->CRH &= ~(0x0F<<4) | (0x0F<<8);
    GPIOA->CRH |= (0x0B<<4) | (0x04<<8); // PA9=复用推挽，PA10=浮空输入

    // 3. 配置串口参数（9600bps，APB2时钟72MHz）
    USART1->BRR = 0x4E20; // 72000000/(16×9600)=468.75 → 0x4E20
    USART1->CR1 &= ~(1<<12) | (1<<10); // 8位数据位，无校验
    USART1->CR2 &= ~(3<<12); // 1位停止位
    USART1->CR1 |= (1<<2) | (1<<3) | (1<<13); // 使能收发和USART1

    // 4. 配置中断
    USART1->CR1 |= (1<<5); // 使能RXNE中断
    NVIC->IP[37] = 0x20; // USART1中断优先级
    NVIC->ISER[1] |= (1<<5); // 使能USART1中断（中断编号37=32+5）

    // 初始化数据结构体
    memset(&air_data, 0, sizeof(AirQuality_TypeDef));
    air_data.data_valid = 0;
}

3. 串口中断接收（存储数据到缓冲区）

c

运行

// USART1中断服务函数：接收传感器数据
void USART1_IRQHandler(void) {
    uint8_t rx_byte;
    if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) {
        rx_byte = (uint8_t)USART_ReceiveData(USART1);

        // 缓冲区循环存储（防止溢出）
        if(rx_index < 63) {
            rx_buffer[rx_index++] = rx_byte;
            // 检测帧尾（\r\n），触发解析
            if(rx_byte == 0x0A && rx_index >=2 && rx_buffer[rx_index-2] == 0x0D) {
                rx_buffer[rx_index] = '\0'; // 字符串结束符
                air_data.data_valid = 2; // 标记为待解析状态
                rx_index = 0; // 重置缓冲区
            }
        } else {
            rx_index = 0; // 缓冲区溢出，重置
        }
        USART_ClearITPendingBit(USART1, USART_IT_RXNE);
    }
}

4. 协议解析函数（核心！提取有效数据）

c

运行

// 字符串分割函数（按逗号分割，辅助解析）
char* str_split(char* str, const char delimiter, uint8_t index) {
    static char buf[32][16];
    uint8_t i = 0, j = 0;
    memset(buf, 0, sizeof(buf));

    while(*str != '\0' && i <= index) {
        if(*str == delimiter) {
            i++;
            j = 0;
        } else {
            buf[i][j++] = *str;
        }
        str++;
    }
    return (i == index) ? buf[index] : NULL;
}

// KQM6600协议解析函数
void KQM6600_ParseData(void) {
    char* ptr = NULL;

    // 检查数据有效性（帧头为"KQ"，待解析状态）
    if(air_data.data_valid != 2 || rx_buffer[0] != 'K' || rx_buffer[1] != 'Q') {
        air_data.data_valid = 0;
        return;
    }

    // 跳过帧头"KQ"，从第3个字符开始解析
    ptr = rx_buffer + 2;

    // 解析PM2.5（第0个字段，整数）
    char* pm25_str = str_split(ptr, ',', 0);
    if(pm25_str != NULL) {
        air_data.pm25 = atoi(pm25_str);
    }

    // 解析甲醛（第1个字段，浮点数）
    char* hcho_str = str_split(ptr, ',', 1);
    if(hcho_str != NULL) {
        air_data.hcho = atof(hcho_str);
    }

    // 解析TVOC（第2个字段，浮点数）
    char* tvoc_str = str_split(ptr, ',', 2);
    if(tvoc_str != NULL) {
        air_data.tvoc = atof(tvoc_str);
    }

    // 解析温度（第3个字段，整数）
    char* temp_str = str_split(ptr, ',', 3);
    if(temp_str != NULL) {
        air_data.temperature = atoi(temp_str);
    }

    // 解析湿度（第4个字段，整数）
    char* humi_str = str_split(ptr, ',', 4);
    if(humi_str != NULL) {
        air_data.humidity = atoi(humi_str);
    }

    // 标记数据有效
    air_data.data_valid = 1;
}

5. 主函数：数据读取 + 解析 + 串口打印

c

运行

// 串口发送函数（printf重定向用）
void USART1_SendByte(uint8_t data) {
    while(USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET);
    USART_SendData(USART1, data);
    while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET);
}

// printf重定向
int fputc(int ch, FILE *f) {
    USART1_SendByte((uint8_t)ch);
    return ch;
}

// 延时函数（简单防抖）
void delay_ms(uint32_t ms) {
    uint32_t i, j;
    for(i = 0; i < ms; i++) {
        for(j = 0; j < 1000; j++);
    }
}

int main(void) {
    // 初始化USART1（与KQM6600通信）
    USART1_Init();
    printf("KQM6600 Air Quality Sensor Init Success!\r\n");
    printf("Waiting for data...\r\n");

    while(1) {
        // 检测是否有待解析数据
        if(air_data.data_valid == 2) {
            KQM6600_ParseData(); // 解析协议
        }

        // 打印有效数据（每秒打印一次）
        if(air_data.data_valid == 1) {
            printf("=== Air Quality Data ===\r\n");
            printf("PM2.5: %d μg/m³\r\n", air_data.pm25);
            printf("HCHO: %.2f mg/m³\r\n", air_data.hcho);
            printf("TVOC: %.2f mg/m³\r\n", air_data.tvoc);
            printf("Temperature: %d ℃\r\n", air_data.temperature);
            printf("Humidity: %d %%RH\r\n", air_data.humidity);
            printf("=======================\r\n\r\n");

            air_data.data_valid = 0; // 重置有效标志
            delay_ms(1000); // 间隔1秒打印
        }
    }
}

五、实验现象与验证

1. 硬件连接验证

• 确保 STM32 与 KQM6600 交叉接线（PA9→RX，PA10→TX）、共地良好；
• 给 STM32 和传感器供电（3.3V），传感器电源指示灯亮起（正常工作）。

2. 串口打印结果

电脑串口助手（9600bps 8N1）接收数据如下，说明通信与解析正常：

plaintext

KQM6600 Air Quality Sensor Init Success!
Waiting for data...
=== Air Quality Data ===
PM2.5: 18 μg/m³
HCHO: 0.02 mg/m³
TVOC: 0.09 mg/m³
Temperature: 26 ℃
Humidity: 52 %RH
=======================

=== Air Quality Data ===
PM2.5: 17 μg/m³
HCHO: 0.02 mg/m³
TVOC: 0.08 mg/m³
Temperature: 26 ℃
Humidity: 53 %RH
=======================

六、传感器实战避坑指南（10 + 高频错误）

1. 数据乱码或无响应

• 原因 1：串口参数不匹配（KQM6600 默认 9600bps，误设为 115200）；解决：严格按传感器手册配置串口参数（9600bps 8N1）；
• 原因 2：TX/RX 接反或未共地；解决：重新检查接线（STM32 TX→传感器 RX），确保共地；
• 原因 3：传感器供电电压错误（接 5V 导致 TTL 电平过载）；解决：改用 3.3V 供电，避免电平冲突。

2. 协议解析失败（数据无效）

• 原因 1：帧头判断错误（传感器帧头非 "KQ"，需核对手册）；解决：用串口助手捕获原始数据，确认帧头格式，修改代码中的帧头判断逻辑；
• 原因 2：数据字段缺失（传感器未返回完整 5 个参数）；解决：检查传感器是否正常工作（重启传感器），增加字段有效性判断；
• 原因 3：字符串分割函数索引错误；解决：通过串口打印原始接收数据，调试分割索引与字段的对应关系。

3. 数据波动过大

• 原因 1：传感器未预热（KQM6600 需预热 3 分钟稳定）；解决：上电后等待 3 分钟再读取数据；
• 原因 2：传感器靠近污染源（如烟雾、香水）；解决：将传感器放置在通风、无干扰环境中。

七、总结：传感器实战核心要点与进阶方向

1. 核心要点回顾

• 传感器与 STM32 交互核心：串口 UART 通信（参数一致是前提）；
• 协议解析关键：帧头 + 帧尾定位 →字段分割 →数据类型转换；
• KQM6600 实战流程：串口初始化→中断接收→协议解析→数据输出；
• 避坑核心：接线正确、参数匹配、协议帧格式精准识别。

2. 进阶学习方向

• 数据滤波：通过滑动平均算法优化波动数据（如 PM2.5 多次采样取平均值）；
• 阈值报警：设置空气质量阈值（如 PM2.5>100μg/m³ 时 LED 闪烁报警）；
• 数据存储：将空气质量数据存储到 EEPROM（I2C 接口），实现历史数据查询；
• 无线传输：通过蓝牙 / WiFi 模块（串口对接），实现手机 APP 实时查看数据。

掌握 KQM6600 传感器实战后，你已具备 "MCU + 数字传感器" 的核心交互能力。下一篇我们将聚焦另一类核心模块 ------语音识别与播报模块（SU03T），学习固件制作、命令词配置与 STM32 的串口交互，实现 "语音控制空气质量监测"！