基于STM32的MQ-135空气质量传感器驱动移植与数据读取实战最近在做一个室内环境监测的小项目需要检测空气中的有害气体于是就用上了MQ-135这个经典的空气质量传感器。很多刚开始接触STM32和传感器的朋友可能会觉得把传感器用起来挺复杂的既要接硬件又要写驱动。其实没那么难今天我就以STM32F10x系列为例手把手带你走一遍MQ-135的驱动移植和数据读取全过程。咱们的目标很明确把MQ-135模块接到STM32开发板上通过ADC读取它的模拟输出AO同时也能读取它的数字输出DO最后把空气质量数据换算成百分比通过串口打印出来。整个过程我会把原理讲清楚代码一行行解释保证你跟着做就能成功。1. 认识你的“侦察兵”MQ-135传感器在写代码之前咱们得先了解手里的“武器”。MQ-135传感器就像是一个嗅觉灵敏的“侦察兵”它的核心是一层二氧化锡(SnO2)气敏材料。它是怎么工作的呢简单来说在干净的空气里这层材料的导电性很差电阻大。但是一旦空气中出现了像氨气、硫化物、苯系物或者烟雾这类“不受欢迎”的气体材料的导电性就会变好电阻变小。传感器就是通过测量这个电阻的变化来感知空气质量的。你买到的模块通常长这样有4个引脚引脚名称类型作用说明VCC电源接3.3V或5V模块兼容GND地接系统地DO数字输出输出高低电平用于简单阈值判断AO模拟输出输出模拟电压用于精确测量这里有个关键点要理解AO引脚直接输出传感器感知到的电压信号。空气越“脏”电压越高。我们需要用STM32的ADC模数转换器来读取这个变化的电压。DO引脚这个信号是模块自己处理过的。模块上有个比较器芯片通常是LM393它会将AO的电压和一个可调的阈值电压进行比较。超过阈值就输出高电平否则是低电平。你可以通过模块上的电位器来调节这个报警阈值。所以如果你只需要一个“超标/正常”的报警功能用DO引脚最简单。但如果你想得到具体的污染程度数据就必须用AO引脚配合ADC来测量。注意模块资料可以在提供的链接中下载里面会有更详细的电气特性和灵敏度曲线图建议动手前先看看。2. 硬件连接把传感器“插”到开发板上硬件连接是第一步千万不能接错。我们以最常见的STM32F103C8T6核心板也就是“蓝色药丸”为例其他STM32F10x系列引脚可能不同但原理一样。根据原始代码里的头文件定义它使用了以下引脚AO引脚连接到了PA5这个引脚同时也是ADC1的通道5。DO引脚连接到了PA1配置为普通GPIO输入。你的接线应该是这样的MQ-135模块-STM32开发板VCC - 3.3V 或 5V开发板上的3.3V引脚更安全GND - GNDAO - PA5 (对应ADC1通道5)DO - PA1提示如果你用的开发板PA5或PA1被占用了完全可以换其他引脚。只需要记住两点AO必须接到具有ADC功能的引脚上查看芯片数据手册的“引脚定义”章节并且后续代码里的引脚定义要同步修改。3. 软件驱动编写让STM32“读懂”传感器硬件接好了接下来就是重头戏——写驱动。我们把驱动代码分成两个文件bsp_mq135.c功能实现和bsp_mq135.h引脚和函数声明。这样结构清晰以后用到其他项目也方便移植。3.1 头文件定义 (bsp_mq135.h)头文件就像是驱动模块的“说明书”告诉别人我们用了哪些资源提供了哪些函数。#ifndef _BSP_MQ135_H_ #define _BSP_MQ135_H_ #include stm32f10x.h // 1. 时钟和端口宏定义 #define RCC_MQ_GPIO RCC_APB2Periph_GPIOA // GPIOA的时钟 #define RCC_MQ_ADC RCC_APB2Periph_ADC1 // ADC1的时钟 #define PORT_ADC ADC1 // 使用的ADC外设 #define CHANNEL_ADC ADC_Channel_5 // 使用的ADC通道对应PA5 #define PORT_MQ_GPIO GPIOA // 使用的GPIO端口 #define GPIO_MQ_AO GPIO_Pin_5 // AO引脚PA5 #define GPIO_MQ_DO GPIO_Pin_1 // DO引脚PA1 // 2. 采样次数宏定义 #define SAMPLES 30 // ADC采样次数用于取平均值滤波 // 3. 函数声明 void ADC_MQ135_Init(void); // 初始化函数 unsigned int Get_Adc_MQ135_Value(void); // 获取ADC原始值 unsigned int Get_MQ135_Percentage_value(void); // 获取空气质量百分比 char Get_MQ135_DO_value(void); // 获取DO引脚状态 #endif代码解读我们用宏定义把硬件连接关系固定下来比如GPIO_MQ_AO就是GPIO_Pin_5。以后想换引脚只需要改这里就行非常方便。SAMPLES定义为30意思是我们要连续采样30次然后取平均值。这是为了对抗ADC读取时的随机噪声让数据更稳定是嵌入式里常用的软件滤波小技巧。3.2 初始化函数 (ADC_MQ135_Init)这是最核心的函数负责把STM32的ADC和GPIO配置好准备读取数据。void ADC_MQ135_Init(void) { // 第一部分打开时钟开关 RCC_APB2PeriphClockCmd (RCC_MQ_GPIO, ENABLE); // 打开GPIOA的时钟 RCC_APB2PeriphClockCmd (RCC_MQ_ADC, ENABLE); // 打开ADC1的时钟 // 第二部分配置AO引脚(PA5)为模拟输入模式 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_MQ_AO; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN; // 关键ADC引脚必须设为模拟输入 GPIO_Init(PORT_MQ_GPIO, GPIO_InitStructure); // 第三部分配置DO引脚(PA1)为上拉输入模式 GPIO_InitStructure.GPIO_Pin GPIO_MQ_DO; GPIO_InitStructure.GPIO_Mode GPIO_Mode_IPU; // 上拉输入引脚悬空时为高电平 GPIO_Init(PORT_MQ_GPIO, GPIO_InitStructure); // 第四部分复位并配置ADC1 ADC_DeInit(PORT_ADC); // 先将ADC恢复默认状态这是个好习惯 ADC_InitTypeDef ADC_InitStruct; // ADC工作模式独立模式只用它一个ADC ADC_InitStruct.ADC_Mode ADC_Mode_Independent; // 扫描模式失能我们只采一个通道不需要扫描 ADC_InitStruct.ADC_ScanConvMode DISABLE; // 连续转换模式使能让ADC不停地自动转换 ADC_InitStruct.ADC_ContinuousConvMode ENABLE; // 触发方式软件触发我们用程序控制开始转换 ADC_InitStruct.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; // 数据对齐方式右对齐读取数据时比较方便 ADC_InitStruct.ADC_DataAlign ADC_DataAlign_Right; // 转换通道数1个就是我们的通道5 ADC_InitStruct.ADC_NbrOfChannel 1; ADC_Init(PORT_ADC, ADC_InitStruct); // 将配置写入ADC寄存器 // 第五部分设置ADC时钟和通道参数 // ADC的时钟不能太快这里设为系统时钟的6分频。如果系统时钟是72MHz那ADC时钟就是12MHz。 RCC_ADCCLKConfig(RCC_PCLK2_Div6); // 配置具体是哪个通道以及采样时间 // 参数ADC1, 通道5, 转换顺序为1, 采样时间55.5个周期 // 采样时间越长精度越高但速度越慢。对于MQ135这种变化慢的信号55.5周期很合适。 ADC_RegularChannelConfig(PORT_ADC, CHANNEL_ADC, 1, ADC_SampleTime_55Cycles5); // 第六部分使能ADC并校准 ADC_Cmd(PORT_ADC, ENABLE); // 正式启动ADC // ADC内部有误差上电后必须校准一次这是标准流程 ADC_ResetCalibration(PORT_ADC); // 复位校准寄存器 while (ADC_GetResetCalibrationStatus(PORT_ADC)); // 等待复位完成 ADC_StartCalibration(PORT_ADC); // 开始校准 while (ADC_GetCalibrationStatus(PORT_ADC)); // 等待校准完成 // 第七部分启动连续转换 ADC_SoftwareStartConvCmd(PORT_ADC, ENABLE); // 软件触发开始连续转换 }关键点解析GPIO模式用于ADC的引脚PA5必须设置为GPIO_Mode_AIN模拟输入其他模式都会导致读数不准。连续转换模式我们设置了ENABLE这样ADC就会在后台不停地进行转换。当我们想读值时直接去取最新的结果就行效率高。校准ADC_StartCalibration这个步骤绝对不能省它能减少ADC的零点误差和增益误差是保证测量精度的关键。3.3 数据读取函数初始化完成后我们就可以轻松地读取数据了。驱动提供了三个函数分别用于不同目的。函数1获取ADC原始值这个函数负责从ADC数据寄存器里读取值并且进行了软件平均滤波。unsigned int Get_Adc_MQ135_Value(void) { uint32_t Data 0; // 循环采样SAMPLES次我们在头文件里定义为30次 for(int i 0; i SAMPLES; i) { Data ADC_GetConversionValue(PORT_ADC); // 累加每次的ADC值 delay_ms(5); // 每次采样间隔5ms让信号稳定一下 } Data Data / SAMPLES; // 计算平均值 return Data; // 返回12位的ADC原始值0-4095 }函数2获取空气质量百分比这是最常用的函数它把原始的ADC值0-4095转换成了我们更容易理解的百分比0%-100%。unsigned int Get_MQ135_Percentage_value(void) { int adc_max 4095; // STM32的12位ADC最大值 int adc_new 0; int Percentage_value 0; adc_new Get_Adc_MQ135_Value(); // 先获取滤波后的ADC值 // 核心计算公式 (当前ADC值 / 最大ADC值) * 100% Percentage_value ((float)adc_new / (float)adc_max) * 100.f; return Percentage_value; }注意这个百分比是“电压百分比”而不是“污染物浓度百分比”。电压越高百分比越大表示传感器电阻越小意味着空气中有害气体浓度可能越高。要得到精确的ppm百万分之一浓度需要根据传感器资料中的灵敏度曲线进行复杂的换算对于一般定性判断这个百分比已经非常直观。函数3获取数字输出状态如果你只关心是否超过阈值用这个函数最简单。char Get_MQ135_DO_value(void) { // 读取DO引脚(PA1)的电平 if( GPIO_ReadInputDataBit(PORT_MQ_GPIO, GPIO_MQ_DO) RESET ) // RESET代表低电平 { return 0; // 返回0表示空气质量“良好”未超过模块设定的阈值 } else { return 1; // 返回1表示空气质量“差”超过模块设定的阈值 } }模块上的电位器这个返回值的高低阈值就是通过模块上的蓝色可调电阻电位器来设定的。顺时针旋转灵敏度降低更难报警逆时针旋转灵敏度升高更容易报警。你可以对着酒精、打火机气体测试并调整它。4. 实战应用在主函数中读取并打印数据驱动写好了最后一步就是在主函数里调用它并把数据打印出来看效果。这里假设你已经初始化好了系统时钟和串口用于printf打印。#include stm32f10x.h #include board.h // 你的板级支持包包含系统初始化等 #include bsp_uart.h // 你的串口驱动头文件 #include stdio.h // 用于printf #include bsp_mq135.h // 我们刚写的驱动头文件 int main(void) { // 1. 开发板基础初始化系统时钟、外设等 board_init(); // 2. 初始化串口1波特率115200用于打印数据到电脑 uart1_init(115200U); // 3. 初始化MQ-135传感器配置ADC和GPIO ADC_MQ135_Init(); printf(MQ-135空气质量传感器Demo启动\r\n); // 4. 主循环每隔1秒读取并打印一次数据 while(1) { // 读取并打印空气质量百分比 printf(空气质量(电压百分比) %d%%\r\n, Get_MQ135_Percentage_value() ); // 读取并打印数字输出状态 char do_status Get_MQ135_DO_value(); if(do_status 1) { printf(数字输出状态超标警告\r\n); } else { printf(数字输出状态正常\r\n); } printf(\r\n); // 空行分隔每次输出 delay_ms(1000); // 延时1秒 } }把代码编译下载到开发板打开串口助手比如XCOM、Putty等设置好波特率115200你就能看到类似这样的输出MQ-135空气质量传感器Demo启动 空气质量(电压百分比) 15% 数字输出状态正常 空气质量(电压百分比) 18% 数字输出状态正常 空气质量(电压百分比) 62% 数字输出状态超标警告当你向传感器附近呼一口气或者喷一点酒精时百分比数值会显著上升DO状态也可能从0变为1。5. 调试心得与常见问题最后分享几个我在调试过程中踩过的坑希望能帮你节省时间ADC读数始终为0或4095检查接线首先确认AO引脚是否确实接到了PA5或你定义的ADC引脚VCC和GND是否接反。检查GPIO模式确保ADC引脚的GPIO模式配置成了GPIO_Mode_AIN模拟输入这是最容易出错的地方。检查ADC校准确认ADC_StartCalibration和等待校准完成的步骤没有被遗漏。数据跳动很厉害电源噪声MQ-135对供电比较敏感。尝试给开发板和传感器模块单独供电或者使用线性稳压电源开关电源的噪声可能被引入。优化软件滤波可以增加SAMPLES的数值比如从30加到100或者将delay_ms(5)的间隔加长让滤波效果更好。当然这会降低数据更新频率。检查地线确保传感器模块的GND和开发板的GND是连接在一起的且接触良好。DO输出状态不变化调节电位器模块上的蓝色电位器决定了报警阈值。用已知的“污染源”如酒精测试并缓慢旋转电位器直到LED指示灯和DO输出状态能正常变化。确认GPIO模式DO引脚配置成了上拉输入(GPIO_Mode_IPU)吗按照上面的步骤你应该已经成功驱动了MQ-135传感器。这套驱动代码结构清晰你可以轻松地修改引脚定义移植到其他STM32型号或者其他ADC通道上。环境监测是嵌入式应用里非常有意思的一个方向有了这个基础你还可以尝试连接温湿度传感器、OLED屏幕做一个完整的桌面环境监测仪。