用STM32CubeMX和SGP30打造高精度空气质量监测仪：从硬件配置到数据优化

最近在工作室调试设备时，突然注意到长时间工作后容易感到头晕乏力。排查了一圈才发现，封闭空间里的TVOC和CO2浓度已经悄悄攀升到了影响健康的水平。这让我意识到，空气质量监测不应该只是商业设备的专利，每个关注健康生活的技术爱好者都应该拥有自己的监测工具。本文将带你从零开始，用STM32CubeMX和SGP30传感器构建一个带数据优化功能的专业级空气质量检测仪。

1. 项目规划与环境搭建

空气质量监测的核心在于准确性和稳定性。SGP30作为一款数字式多气体传感器，能够同时检测TVOC（总挥发性有机物）和CO2浓度，非常适合DIY项目。但在开始编码前，我们需要先理解几个关键概念：

• TVOC：衡量空气中所有挥发性有机化合物的总和，装修材料、清洁剂甚至打印机都会释放这些物质。长期暴露在高浓度环境下可能导致头痛、过敏等症状。
• eCO2：SGP30实际测量的是挥发性有机化合物，然后通过算法换算成等效CO2浓度。虽然不如专业CO2传感器精确，但对室内空气质量的评估已经足够。

硬件准备清单：

• STM32F103C8T6开发板（蓝色药丸板）
• SGP30传感器模块
• 4.7kΩ上拉电阻×2（部分模块已集成）
• 面包板和连接线

提示：选择STM32F103系列是因为其丰富的文档资源和社区支持，初学者遇到问题更容易找到解决方案。

2. STM32CubeMX工程配置

启动STM32CubeMX后，按照以下步骤配置基础环境：

1. 选择正确的MCU型号（STM32F103C8Tx）
2. 在Pinout视图中启用I2C1：
   • PB6 → I2C1_SCL
   • PB7 → I2C1_SDA
3. 时钟配置中确保I2C时钟不超过400kHz（SGP30的最高支持频率）
4. 生成代码时选择Toolchain/IDE为MDK-ARM（Keil）

关键配置参数表格：

c复制// 自动生成的I2C初始化代码片段
hi2c1.Instance = I2C1;
hi2c1.Init.ClockSpeed = 200000;
hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2;
hi2c1.Init.OwnAddress1 = 0;
hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE;
hi2c1.Init.OwnAddress2 = 0;
hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE;
hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE;

3. SGP30传感器驱动实现

SGP30的通信协议有几个特殊点需要注意：

1. 每次上电后需要12小时的"初始优化期"才能达到最佳精度
2. 所有命令都是16位大端格式
3. 读取数据时需要发送CRC校验

基础驱动函数实现：

c复制#define SGP30_ADDR (0x58 << 1) // 7位地址左移1位

// 发送命令函数
HAL_StatusTypeDef SGP30_SendCommand(uint16_t cmd) {
    uint8_t buf[2];
    buf[0] = cmd >> 8;   // 高位在前
    buf[1] = cmd & 0xFF; // 低位在后
    return HAL_I2C_Master_Transmit(&hi2c1, SGP30_ADDR, buf, 2, HAL_MAX_DELAY);
}

// 读取测量结果
HAL_StatusTypeDef SGP30_ReadMeasurement(uint16_t *tvoc, uint16_t *co2) {
    uint8_t buf[6];
    HAL_StatusTypeDef ret = HAL_I2C_Master_Receive(&hi2c1, SGP30_ADDR|1, buf, 6, HAL_MAX_DELAY);
    
    // 校验CRC
    if(ret == HAL_OK) {
        if(buf[2] != CRC8(buf, 2) || buf[5] != CRC8(buf+3, 2)) {
            return HAL_ERROR;
        }
        *co2 = (buf[0] << 8) | buf[1];
        *tvoc = (buf[3] << 8) | buf[4];
    }
    return ret;
}

// CRC8校验算法
uint8_t CRC8(uint8_t *data, uint8_t len) {
    uint8_t crc = 0xFF;
    for(uint8_t i=0; i<len; i++) {
        crc ^= data[i];
        for(uint8_t b=0; b<8; b++) {
            if(crc & 0x80) crc = (crc << 1) ^ 0x31;
            else crc <<= 1;
        }
    }
    return crc;
}

4. 数据滤波与优化算法

原始传感器数据往往存在波动，直接显示会给用户造成困扰。以下是三种经过验证的滤波方案：

4.1 滑动平均滤波

最简单的实现方式，适合资源有限的MCU：

c复制#define FILTER_SIZE 10

typedef struct {
    uint16_t buffer[FILTER_SIZE];
    uint8_t index;
    uint32_t sum;
} MovingAverage;

uint16_t MovingAverage_Filter(MovingAverage *filter, uint16_t newValue) {
    filter->sum -= filter->buffer[filter->index];
    filter->sum += newValue;
    filter->buffer[filter->index] = newValue;
    filter->index = (filter->index + 1) % FILTER_SIZE;
    return (uint16_t)(filter->sum / FILTER_SIZE);
}

4.2 一阶滞后滤波

计算量小，能平滑数据同时保持一定响应速度：

c复制float alpha = 0.2; // 滤波系数(0-1)，越小越平滑

float FirstOrderFilter(float oldValue, float newValue) {
    return oldValue * (1 - alpha) + newValue * alpha;
}

4.3 动态阈值滤波

专门针对气体传感器的特性设计：

c复制#define MAX_CHANGE_RATE 50 // ppm/秒

uint16_t DynamicThresholdFilter(uint16_t prev, uint16_t current, uint32_t elapsedMs) {
    float maxChange = MAX_CHANGE_RATE * elapsedMs / 1000.0f;
    if(abs(current - prev) > maxChange) {
        return prev + (current > prev ? maxChange : -maxChange);
    }
    return current;
}

三种算法效果对比表格：

5. 系统集成与优化建议

将各个模块组合后，主程序逻辑应该包含以下状态机：

c复制typedef enum {
    SGP30_INIT,
    SGP30_READY,
    SGP30_MEASURING,
    SGP30_ERROR
} SGP30_State;

void main() {
    // 初始化代码...
    SGP30_State state = SGP30_INIT;
    MovingAverage co2_filter = {0}, tvoc_filter = {0};
    
    while(1) {
        switch(state) {
            case SGP30_INIT:
                if(HAL_GetTick() > 1000) { // 等待1秒初始化
                    SGP30_SendCommand(0x2003);
                    state = SGP30_READY;
                }
                break;
                
            case SGP30_READY:
                SGP30_SendCommand(0x2008); // 启动测量
                state = SGP30_MEASURING;
                break;
                
            case SGP30_MEASURING:
                if(HAL_GetTick() - lastMeasureTime > 1000) { // 每秒读取一次
                    uint16_t tvoc, co2;
                    if(SGP30_ReadMeasurement(&tvoc, &co2) == HAL_OK) {
                        uint16_t filtered_co2 = MovingAverage_Filter(&co2_filter, co2);
                        uint16_t filtered_tvoc = MovingAverage_Filter(&tvoc_filter, tvoc);
                        Display_Update(filtered_co2, filtered_tvoc);
                    }
                    lastMeasureTime = HAL_GetTick();
                }
                break;
        }
    }
}

实际部署时的几个实用技巧：

• 将传感器放置在离地面1-1.5米高度（与人呼吸高度相近）
• 避免直接暴露在空调出风口或阳光直射位置
• 定期（建议每月）进行8小时以上的通风校准
• 在OLED显示屏上增加趋势图表，比单纯数字更直观

有一次我在客户现场调试时发现CO2读数异常偏高，排查半天才发现是传感器被临时放在了正在工作的激光打印机旁边。这个经历让我深刻理解到，环境因素对气体传感器的影响远比我们想象的要大。