MQ-5液化气传感器STM32驱动移植与浓度检测实战最近在做一个智能家居安全监控的小项目需要检测厨房的天然气浓度于是就用上了MQ-5这款传感器。很多刚开始接触STM32和传感器的朋友可能会觉得把一个小模块接到开发板上再读出数据来这个过程有点无从下手。其实没那么复杂今天我就以立创开发板STM32F103为例手把手带你走一遍MQ-5传感器的驱动移植和浓度读取全过程。咱们的目标很明确把MQ-5模块的AO模拟量和DO数字量两个输出口分别接到STM32的ADC引脚和普通GPIO引脚上然后写程序把气体浓度值读出来还能判断是否超过阈值报警。整个过程我会掰开揉碎了讲就算你是嵌入式新手跟着做也能搞定。1. 认识MQ-5气体传感器模块在动手接线写代码之前咱们先花几分钟了解一下手里这个传感器模块是干什么的、怎么工作的。知其然更要知其所以然后面调试出了问题才好排查。1.1 传感器工作原理MQ-5传感器的核心是一层二氧化锡(SnO2)材料。这东西在干净的空气里导电能力比较差电阻大。但是当它周围存在可燃气体比如咱们要测的液化气、天然气还有丁烷、丙烷、甲烷时气体的分子会和二氧化锡表面发生反应导致它的电导率上升电阻下降。简单理解就是气体浓度越高传感器的电阻越小。模块内部已经设计好了电路能把这个电阻的变化转换成咱们单片机容易读取的电压信号输出。注意MQ-5对多种可燃气体都敏感尤其对天然气主要成分甲烷和液化气主要成分丙烷的检测效果比较好。所以它非常适合用来做家庭燃气泄漏报警器成本也低。1.2 模块接口与参数拿到模块你会看到一排4个引脚2.54mm间距正好插在洞洞板或杜邦线上。模块通常需要5V供电但很多也兼容3.3V。关键就是两个输出引脚引脚名称类型功能说明VCC电源接3.3V ~ 5V电源正极GND电源接电源地DO数字输出数字量输出输出高低电平AO模拟输出模拟量输出输出连续电压信号DO数字输出这个信号最简单。模块上通常有个蓝色的电位器可调电阻你可以用它设定一个浓度阈值。当传感器检测到的气体浓度超过这个阈值时DO引脚就会输出低电平0浓度低于阈值时输出高电平1。它内部用了LM393这类电压比较器芯片来实现这个功能。DO口可以直接接到STM32的任何GPIO引脚上配置成输入模式读取电平就行。AO模拟输出这个引脚输出的电压是连续变化的直接反映了传感器电阻的变化也就是气体浓度的变化。浓度越高输出电压一般也越高具体关系要看模块电路设计。我们需要用STM32的ADC模数转换器功能把这个电压值读进来转换成数字量再通过计算得到浓度百分比。模块关键参数根据厂家资料工作电压3.3V ~ 5V 咱们的立创开发板有3.3V和5V输出接哪个都行工作电流约150mA 功耗不算小供电要保证输出方式DO数字量AO模拟量读取方式DO用GPIO输入AO用ADC读取2. 硬件连接与引脚规划现在开始动手。我用的主控是立创开发板核心是STM32F103系列。你需要准备一个MQ-5模块、几根杜邦线母对母。2.1 接线方案接线很简单确保别接错电源正负极就行。下面是我的连接方案你可以参考MQ-5 VCC- 开发板5V或3.3V引脚建议先接5V灵敏度更高MQ-5 GND- 开发板GNDMQ-5 AO- 开发板PA5引脚我计划用ADC1的通道5MQ-5 DO- 开发板PA1引脚任意一个GPIO都可以我选了PA1提示为什么AO接PA5因为STM32F103的ADC1通道5对应的引脚就是PA5。这个对应关系是芯片设计时定好的不能随意改。你可以在芯片数据手册或开发板原理图里查到ADC通道和引脚的映射表。2.2 模块上的电位器模块上那个蓝色的可调电阻电位器是调节数字输出(DO)的灵敏度阈值的。顺时针旋转通常电阻增大阈值提高需要更高的气体浓度才能触发DO跳变。逆时针旋转则降低阈值。你可以根据实际需要比如多少浓度算报警来调整它。模拟输出(AO)不受这个电位器影响。硬件接好后先上电看看。模块正常的话上面的电源指示灯会亮传感器需要预热一段时间几十秒到几分钟才能稳定工作这是正常的。3. 软件驱动编写与移植硬件搞定接下来就是重头戏——写代码。咱们的目标是创建两个文件bsp_mq5.c驱动源文件和bsp_mq5.h驱动头文件。把它们放到你的工程里然后调用。3.1 创建头文件 (bsp_mq5.h)头文件主要做两件事宏定义和函数声明。宏定义是为了让代码更易读、易修改。#ifndef _BSP_MQ5_H_ #define _BSP_MQ5_H_ #include stm32f10x.h /* 时钟和端口宏定义 */ #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通道通道5 #define PORT_MQ_GPIO GPIOA // 使用的GPIO端口GPIOA #define GPIO_MQ_AO GPIO_Pin_5 // AO引脚对应PA5 #define GPIO_MQ_DO GPIO_Pin_1 // DO引脚对应PA1 /* 采样次数用于软件滤波取平均值 */ #define SAMPLES 30 /* 函数声明 */ void ADC_MQ5_Init(void); // 初始化ADC和GPIO unsigned int Get_Adc_MQ5_Value(void); // 获取ADC原始值 unsigned int Get_MQ5_Percentage_value(void); // 获取浓度百分比 char Get_MQ5_DO_value(void); // 获取DO引脚状态 #endif代码解释我们把AOPA5和DOPA1都规划在GPIOA端口上方便管理。SAMPLES定义为30意思是ADC采样30次然后取平均值。这是一种简单的软件滤波可以减小单次采样的随机误差让读数更稳定。四个函数的功能看名字就能猜个大概具体实现咱们下面看.c文件。3.2 编写驱动源文件 (bsp_mq5.c)这是驱动的核心包含了所有功能的实现。3.2.1 初始化函数 ADC_MQ5_Init这个函数负责初始化STM32的ADC外设和相关的GPIO引脚。STM32的ADC功能配置步骤比较固定我加了详细注释你跟着做就行。#include bsp_mq5.h #include board.h // 立创开发板的板级支持包里面可能有delay函数等 void ADC_MQ5_Init(void) { /* 1. 开启时钟 —— 任何外设使用前必须先开时钟 */ RCC_APB2PeriphClockCmd (RCC_MQ_GPIO, ENABLE); // 开启GPIOA的时钟 RCC_APB2PeriphClockCmd (RCC_MQ_ADC, ENABLE); // 开启ADC1的时钟 /* 2. 配置GPIO引脚模式 */ GPIO_InitTypeDef GPIO_InitStructure; // 配置AO引脚(PA5)为模拟输入模式这是ADC专用模式 GPIO_InitStructure.GPIO_Pin GPIO_MQ_AO; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN; // 模拟输入 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); /* 3. 复位并初始化ADC */ ADC_DeInit(PORT_ADC); // 将ADC1恢复为默认状态 ADC_InitTypeDef ADC_InitStruct; // ADC 模式配置 ADC_InitStruct.ADC_Mode ADC_Mode_Independent; // 独立模式只用这一个ADC ADC_InitStruct.ADC_ScanConvMode DISABLE; // 禁用扫描模式单通道 ADC_InitStruct.ADC_ContinuousConvMode ENABLE; // 启用连续转换模式 ADC_InitStruct.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; // 软件触发不用外部事件 ADC_InitStruct.ADC_DataAlign ADC_DataAlign_Right; // 数据右对齐方便读取 ADC_InitStruct.ADC_NbrOfChannel 1; // 转换的通道数为1个 ADC_Init(PORT_ADC, ADC_InitStruct); // 应用配置 /* 4. 配置ADC时钟和采样通道 */ RCC_ADCCLKConfig(RCC_PCLK2_Div6); // 设置ADC时钟为PCLK2的6分频。STM32F103的PCLK2通常是72MHz6分频后是12MHz这是ADC工作的典型时钟。 // 配置规则组通道通道5采样顺序为1采样时间为55.5个ADC时钟周期 // 采样时间越长精度越高但转换速度越慢。55.5个周期是中等速度兼顾精度和速度。 ADC_RegularChannelConfig(PORT_ADC, CHANNEL_ADC, 1, ADC_SampleTime_55Cycles5); /* 5. 使能ADC并校准 */ ADC_Cmd(PORT_ADC, ENABLE); // 使能ADC1 // ADC校准是必须的可以减小内部误差 ADC_ResetCalibration(PORT_ADC); // 复位校准寄存器 while (ADC_GetResetCalibrationStatus(PORT_ADC)); // 等待复位完成 ADC_StartCalibration(PORT_ADC); // 开始校准 while (ADC_GetCalibrationStatus(PORT_ADC)); // 等待校准完成 /* 6. 启动连续转换 */ ADC_SoftwareStartConvCmd(PORT_ADC, ENABLE); // 软件触发开始连续转换 }注意board.h和里面的delay_ms函数是立创开发板资料包提供的。如果你用其他开发板或标准库需要换成你自己的延时函数比如HAL库的HAL_Delay。3.2.2 读取ADC原始值函数 Get_Adc_MQ5_Value初始化完成后ADC就在后台不停地进行转换了。这个函数的作用是去读取转换结果并且进行软件滤波取平均值。unsigned int Get_Adc_MQ5_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; // 返回滤波后的ADC原始值 }STM32F103的ADC是12位的所以这个返回值范围是0 ~ 4095对应输入电压0V ~ 3.3V如果ADC参考电压是3.3V。AO引脚输出的电压越高这个值就越大。3.2.3 计算浓度百分比函数 Get_MQ5_Percentage_value拿到ADC原始值后咱们把它转换成更容易理解的百分比形式。这里假设ADC值0~4095线性对应气体浓度0%~100%。注意这只是为了演示实际的气体浓度和电压值并非严格的线性关系需要根据传感器数据手册进行标定和曲线拟合。但对于要求不高的报警应用线性化处理简单有效。unsigned int Get_MQ5_Percentage_value(void) { int adc_max 4095; // 12位ADC最大值 int adc_new 0; int Percentage_value 0; adc_new Get_Adc_MQ5_Value(); // 获取滤波后的ADC值 // 将ADC值转换为百分比(当前值 / 最大值) * 100 Percentage_value ((float)adc_new / (float)adc_max) * 100.f; return Percentage_value; // 返回0-100之间的整数百分比 }3.2.4 读取数字输出函数 Get_MQ5_DO_value这个函数就简单多了直接读取DO引脚连接的那个GPIO的电平状态。char Get_MQ5_DO_value(void) { // 读取PA1引脚的电平 if( GPIO_ReadInputDataBit(PORT_MQ_GPIO, GPIO_MQ_DO) RESET ) { return 0; // 低电平表示气体浓度超过模块设定的阈值报警状态 } else { return 1; // 高电平表示气体浓度在安全范围内 } }模块上的电位器调的就是这个阈值。当浓度超过阈值比较器输出翻转DO引脚变成低电平。4. 主程序验证与调试驱动写好了最后就是在主函数里调用它们看看效果。4.1 主函数编写在你的工程主文件通常是main.c里包含头文件初始化外设然后在循环里读取并打印数据。#include stm32f10x.h #include board.h #include bsp_uart.h // 串口初始化用于打印 #include stdio.h // 为了使用printf #include bsp_mq5.h // 我们刚写的驱动头文件 int main(void) { /* 板级初始化包括系统时钟等 */ board_init(); /* 初始化串口1波特率115200用于连接电脑串口助手看数据 */ uart1_init(115200); /* 初始化MQ-5传感器主要是ADC和GPIO */ ADC_MQ5_Init(); printf(MQ-5 Sensor Demo Start\r\n); while(1) { // 读取并打印气体浓度百分比 printf(LPG Concentration %d%%\r\n, Get_MQ5_Percentage_value() ); // 读取并打印数字报警状态 if(Get_MQ5_DO_value() 0) { printf(Status: **ALARM!** Gas level exceeds threshold!\r\n); } else { printf(Status: Normal.\r\n); } printf(\r\n); // 空行分隔 delay_ms(1000); // 每秒读取一次 } }4.2 上电测试与现象将代码编译下载到立创开发板。打开电脑上的串口调试助手如XCOM Putty等设置好对应的串口号和波特率115200。给开发板和MQ-5模块上电。观察串口助手你会看到每秒输出一行信息显示当前的浓度百分比和数字报警状态。测试模拟输出(AO)向传感器附近呼一口气含二氧化碳或者用打火机释放少量气体注意安全远离明火观察百分比数值是否会上升。测试数字输出(DO)调整模块上的蓝色电位器直到Status在“Normal”和“ALARM!”之间切换。这表示你设置的阈值正在被触发。4.3 可能遇到的问题与排查读数一直为0或4095检查AO引脚是否接触不良或者接错了引脚。用万用表测量一下AO引脚对GND的电压看看是否在0-3.3V之间变化。数值跳动厉害这是正常的传感器本身有一定噪声。我们已经用了SAMPLES30次取平均来滤波。如果还觉得跳可以尝试增大SAMPLES值或者增加delay_ms(5)中的延时时间但会降低读取频率。DO状态不变化检查DO引脚连接并尝试大幅度旋转模块上的电位器。确保测试时气体浓度变化足够大例如用少量酒精靠近。百分比换算不准确再次强调我们这里的(ADC值/4095)*100只是一个线性的、粗略的浓度指示。MQ-5传感器的电阻-浓度关系是非线性的。如果需要精确的ppm百万分之一浓度值你必须参考传感器的数据手册里面有在不同气体、不同浓度下的典型电阻曲线Rs/R0曲线需要根据那个曲线进行复杂的计算或查表。好了到这里一个完整的MQ-5气体传感器STM32驱动移植和浓度检测项目就完成了。整个过程从原理、接线、代码编写到调试我都尽量把细节讲清楚了。你可以把这个驱动代码作为模板稍加修改就能用到其他模拟输出的传感器上。实际项目中你可能还需要加上更复杂的滤波算法、浓度标定、以及通过网络或蓝牙上报数据等功能。希望这篇教程能帮你踏出传感器应用的第一步。