1. 项目背景与硬件准备第一次接触STM32和空气质量检测时我和很多新手一样被各种专业术语绕晕。直到用MQ135传感器做出第一个能检测空气质量的设备才发现嵌入式开发其实没那么可怕。这个黄豆大小的传感器能检测氨气、苯、二氧化碳等多种气体成本不到20元特别适合用来练手。你需要准备的硬件很简单STM32F103C8T6最小系统板蓝色板子淘宝30元左右MQ135传感器模块注意选择带AO模拟输出的版本USB-TTL串口模块推荐CH340芯片版本杜邦线若干建议买现成的母对母线这里有个新手常踩的坑MQ135需要5V供电才能正常工作。虽然STM32的IO口是3.3V电平但传感器供电必须接开发板的5V引脚。我第一次测试时用了3.3V供电结果串口打印的数据永远显示0折腾了半天才发现是电压问题。2. 开发环境搭建2.1 软件安装清单建议按这个顺序安装Keil MDK记得注册破解不然代码限制32KBSTM32CubeMX图形化配置神器串口助手推荐XCOM或SSCOM安装CubeMX时会遇到Java环境问题。有个小技巧如果安装失败先去Oracle官网下载最新版Java手动安装再重新运行CubeMX安装程序。2.2 工程创建步骤打开CubeMX后选择New Project在芯片选择框输入STM32F103C8并选中对应型号配置时钟树时有个快捷方法直接点击Clock Configuration标签页右上角的HSE按钮系统会自动配置好72MHz主频注意第一次使用时建议开启Trust Zone选项避免后期出现奇怪的权限问题。3. 硬件连接与CubeMX配置3.1 接线示意图MQ135与STM32的连接只需要3根线VCC → 5VGND → GNDAO → PA1任意ADC通道实际接线时建议先用万用表测量电压。我遇到过杜邦线接触不良导致数据异常的情况后来养成了先用万用表确认通断的习惯。3.2 ADC配置详解在CubeMX中配置ADC的步骤如下左侧导航栏找到Analog→ADC1启用IN1通道对应PA1引脚参数设置建议Resolution12BitsScan Conversion ModeDisabledContinuous Conversion ModeEnabledDMA不需要开启有个容易忽略的地方在Configuration标签页里要把Sampling Time调到最大239.5 Cycles。我第一次测试时采样时间太短导致数据波动特别大。4. 两种编程模式实战4.1 裸机循环模式这是最直接的实现方式适合快速验证功能。核心代码就这几行while(1) { HAL_ADC_Start(hadc1); if(HAL_ADC_PollForConversion(hadc1, 50) HAL_OK) { uint32_t raw HAL_ADC_GetValue(hadc1); float voltage raw * 3.3f / 4095.0f; printf(Raw: %lu, Voltage: %.2fV\r\n, raw, voltage); } HAL_Delay(1000); }实测发现两个注意事项每次采集前都要调用HAL_ADC_Start否则第二次采集会失败延时不能太短建议至少500ms否则传感器响应不过来4.2 函数封装模式当项目复杂度上升时推荐使用这种更结构化的方式。先创建mq135.h头文件#ifndef __MQ135_H #define __MQ135_H #include main.h typedef struct { float voltage; uint16_t raw; } MQ135_Data; void MQ135_Init(ADC_HandleTypeDef *hadc); MQ135_Data MQ135_Read(ADC_HandleTypeDef *hadc); #endif对应的mq135.c实现文件#include mq135.h void MQ135_Init(ADC_HandleTypeDef *hadc) { HAL_ADCEx_Calibration_Start(hadc); // 这个校准步骤很多人会漏掉 } MQ135_Data MQ135_Read(ADC_HandleTypeDef *hadc) { MQ135_Data result {0}; HAL_ADC_Start(hadc); if(HAL_ADC_PollForConversion(hadc, 50) HAL_OK) { result.raw HAL_ADC_GetValue(hadc); result.voltage result.raw * 3.3f / 4095.0f; } return result; }这种封装方式有三大优势避免全局变量污染方便后期添加温度补偿等功能代码可读性更好5. 数据校准与优化5.1 基础校准方法MQ135的输出电压与气体浓度关系需要校准。简单做法是在空气清新的户外记录基准电压V0用公式ppm (V0 - V) / V0 * 1000我在卧室实测的数据通风良好时V01.82V关闭门窗2小时后V2.15V计算得ppm≈1815.2 进阶温度补偿传感器受温度影响较大可以添加DS18B20温度传感器进行补偿。修改读取函数MQ135_Data MQ135_Read_With_Temp(ADC_HandleTypeDef *hadc, float temp) { MQ135_Data data MQ135_Read(hadc); // 温度补偿公式系数需要根据实测调整 data.voltage * (1 0.02 * (temp - 25.0)); return data; }6. 常见问题排查6.1 数据一直为0检查清单确认供电是5V而非3.3V测量AO引脚电压是否变化CubeMX中ADC配置是否正确代码里是否漏了HAL_ADC_Start6.2 数据波动大解决方法在ADC输入端加0.1uF电容滤波软件端采用滑动平均滤波#define SAMPLE_SIZE 5 float avg_filter(float new_val) { static float buf[SAMPLE_SIZE] {0}; static uint8_t idx 0; buf[idx] new_val; if(idx SAMPLE_SIZE) idx 0; float sum 0; for(uint8_t i0; iSAMPLE_SIZE; i) { sum buf[i]; } return sum / SAMPLE_SIZE; }7. 项目扩展思路完成基础功能后可以尝试添加OLED实时显示浓度曲线通过ESP8266上传数据到物联网平台结合蜂鸣器实现超标报警用FreeRTOS创建独立的数据采集任务我最近做的智能空气检测盒就整合了这些功能代码量从最初的50行增加到2000多行。建议新手先从基础版本做起逐步添加新功能这样能避免一次调试太多模块导致的混乱。