简介基于MQ2烟雾传感器的STM32F103程序是一套完整的嵌入式实验工程面向物联网、嵌入式初学及开发人员解决可燃气体浓度采集与串口实时显示的需求。工程基于ARM Cortex-M3内核的STM32F103包含MQ2驱动、ADC采样、电压转换及UART串口发送等核心逻辑并附带Keil工程配置文件。压缩包共179个文件以C源文件、头文件、目标文件为主同时包含hex烧写文件、axf调试文件及uvprojx工程文件整体仅4.3MB便于快速移植与二次开发。这份工程已有16000余人学习下载适合通过实际代码理解传感器工作原理、串口通信机制及STM32外设配置。借助这套程序开发者可掌握MQ2传感器的数据读取与浓度换算方法并可参照工程结构将烟雾检测功能快速集成到自己的嵌入式项目中。1. 用STM32F103驱动MQ2烟雾传感器一块开发板和一颗气敏电阻能做的事很多人第一次把MQ2烟雾传感器接到STM32F103上第一反应是“读个ADC值”。但真跑起来才发现上电头几分钟数值一路漂串口每秒吐一个数每个数都不一样放在阳台通风处是800多拿到室内抽口烟忽然飙到3600再放回去两小时也降不回原来的值。如果你也被这颗气敏电阻折腾过那这正是一篇针对MQ2烟雾传感器配合STM32F103程序的落地笔记从硬件连接、ADC采样、滤波到标定与阈值设置再到我踩过的几个典型坑全部按可复现的方式写出来。适合手里有开发板、想做一个烟雾报警或空气质量监测装置又不想只停留在“能亮灯”阶段的从业者。MQ2的本质是一颗二氧化锡半导体气敏电阻它对丙烷、甲烷、烟雾、酒精都有响应价格便宜、响应快但精度和稳定性都不如电化学传感器。STM32F103自带12位ADC资源完全够用麻烦的是传感器本身的非线性和漂移。所以程序的核心并不是“读ADC”这一行代码而是围绕采样时机、滤波、基准标定、报警阈值展开的一整套策略。下面从硬件原理开始一步一步把它说透。2. MQ2的工作原理与硬件连接分压电路决定ADC读数的精度上限2.1 从气敏电阻到电压信号Rs、RL与分压公式MQ2内部的敏感材料是二氧化锡SnO2它被加热丝加热到大约200°C左右。在洁净空气中材料表面吸附氧分子形成电子耗尽层电阻Rs处于一个较高的稳定值当还原性气体比如烟雾中的可燃成分、甲烷、丙烷、酒精蒸气接触到表面时会与吸附氧发生反应释放电子Rs显著下降。MQ2的输出就是“Rs随气体浓度变化”这件事。但单片机只能读电压所以需要一个分压网络把电阻变化变成电压变化。常见的做法是把敏感电阻Rs与一个负载电阻RL串联在RL两端取电压Vout VCC × RL / (Rs RL)当烟雾浓度升高Rs下降RL分到的电压上升ADC读数变大。这个方向关系务必记清楚后面排查反向问题时会用到。RL的取值对输出电压范围和灵敏度影响很大。市面上常见的MQ2模块板载RL大多是1kΩ或4.7kΩ也有5kΩ如果你是自己搭电路我一般建议RL取值在4.7kΩ到10kΩ之间太小洁净空气下的分压太低浓度变化时电压变化不明显太大浓度高时输出很容易触顶饱和。这里还有个新手常忽视的点ADC读到的电压并不是Rs本身而是RL上的分压。要算Rs需要做一次反推Rs (VCC × RL / Vout) - RL这个公式在后面标定章节非常关键。因为你标定的不是“电压值”而是传感器的基准电阻Ro。2.2 引脚识别与最小硬件连接别把加热丝和测量极搞混MQ2是6个引脚内部实际上分为两组一组是加热丝引脚H/H-H一组是测量电极引脚A/B。焊接和接线时必须分清。很多初学翻车都是把测量电极接到了5V和GND上导致ADC读数一直不变或者干脆烧掉敏感层。按照我常用的接法把6个引脚分成三对要点 | 接法 加热丝H-H | 接5V正极另一脚接GND给内部加热丝供电 测量电极A | 接VCC5V作为分压上端 测量电极B | 串联RL后接GNDB与GND之间取分压输出即OUT信号用模块时通常省心板上已经做好了分压和比较器输出有的模块同时提供模拟输出和数字输出模拟输出接STM32的ADC引脚。但用模块也要确认一件事模拟输出引脚的最大电压。有些模块的模拟输出在5V供电时最高能到4V多直接进STM32F103的3.3V ADC引脚是有风险的。保守做法是加两个电阻做1:1分压比如10k和10k把最高电压压到2V左右或者确认模块设计上已经把输出限制在3.3V以内。我自己的习惯是数采模块用3.3V给传感器供电也行但加热丝可能加热功率不足灵敏度明显下降所以更推荐5V供电加分压的方案。供电去耦也值得单独提一句。加热丝是一个典型的电流型负载工作时电流变化会造成电源轨波动而这个波动会直接串到ADC参考电压上表现为读数周期性抖动。我一般会在传感器的VCC和GND之间放一颗100uF电解电容再并联一颗0.1uF陶瓷电容位置尽量靠近传感器引脚。这算是最便宜的“后悔药”了。连接关系整理成最小清单STM32F103的PA1引脚配置为模拟输入接模块模拟输出OUT或分压后的信号。模块VCC接5VGND共地。如果传感器是裸元件而非模块按上文配RL并引出分压中点。ADC参考电压默认接VDD3.3V如果你的板子有外部基准芯片标准电压源更佳但要保证外部基准电压不超过3.3V且与MCU共地。我把这部分作为一个固定的先导检查项每次上电前先量一下加热丝两端有没有5V、OUT对地电压是否在合理范围再去烧录程序。直接上电开读十有八九会读到一堆莫名其妙的数。3. 核心程序实现ADC采样、滑动滤波与浓度换算3.1 初始化ADC12位分辨率、采样时间与DMA配置STM32F103的ADC是12位精度转换结果范围04095对应0V3.3V。如果使用DMA循环模式可以让ADC连续采样并把结果持续搬运到内存数组里CPU不需要等待每次转换。这里给出一个完整的初始化函数代码基于标准外设库这是目前F103项目里最常见的写法。void ADC_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; ADC_InitTypeDef ADC_InitStructure; DMA_InitTypeDef DMA_InitStructure; // 1. 使能时钟ADC1挂载在APB2总线GPIOA也在APB2DMA1在AHB RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_GPIOA, ENABLE); RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE); // 2. PA1配置为模拟输入注意不是复用推挽是模拟输入 GPIO_InitStructure.GPIO_Pin GPIO_Pin_1; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN; GPIO_Init(GPIOA, GPIO_InitStructure); // 3. DMA配置循环模式每次搬运一个半字16位到ADC_Value数组 DMA_InitStructure.DMA_PeripheralBaseAddr (uint32_t)ADC1-DR; DMA_InitStructure.DMA_MemoryBaseAddr (uint32_t)ADC_Value; DMA_InitStructure.DMA_DIR DMA_DIR_PeripheralSRC; DMA_InitStructure.DMA_BufferSize ADC_SAMPLE_COUNT; DMA_InitStructure.DMA_PeripheralInc DMA_PeripheralInc_Disable; DMA_InitStructure.DMA_MemoryInc DMA_MemoryInc_Enable; DMA_InitStructure.DMA_PeripheralDataSize DMA_PeripheralDataSize_HalfWord; DMA_InitStructure.DMA_MemoryDataSize DMA_MemoryDataSize_HalfWord; DMA_InitStructure.DMA_Mode DMA_Mode_Circular; DMA_InitStructure.DMA_Priority DMA_Priority_High; DMA_InitStructure.DMA_M2M DMA_M2M_Disable; DMA_Init(DMA1_Channel1, DMA_InitStructure); // 4. ADC1配置独立模式连续转换12位分辨率软件触发 ADC_InitStructure.ADC_Mode ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode DISABLE; // 只转换一个通道 ADC_InitStructure.ADC_ContinuousConvMode ENABLE; // 连续转换配合DMA循环 ADC_InitStructure.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_DataAlign ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel 1; ADC_Init(ADC1, ADC_InitStructure); // 5. 配置ADC1通道1PA1对应ADC_Channel_1采样时间取最长239.5周期 ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); // 6. 使能ADC与DMA并校准F103每次上电建议执行一次校准 ADC_DMACmd(ADC1, ENABLE); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while (ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while (ADC_GetCalibrationStatus(ADC1)); // 7. 启动一次软件触发之后ADC连续转换、DMA持续搬运 ADC_SoftwareStartConvCmd(ADC1, ENABLE); DMA_Cmd(DMA1_Channel1, ENABLE); }逻辑说明整个初始化分四块。第一块是时钟ADC1挂在APB2上DMA1挂在AHB上遗漏任何一路都会导致外设不工作。第二块是GPIOPA1必须配置为模拟输入模式如果用复用推挽会破坏模拟信号通路。第三块是DMA循环模式它让ADC转换结果不断写入ADC_Value数组缓冲区满后从头覆盖这就是循环的意义你不需要在中断里手动读取结果。第四块是ADC本身的配置这里最关键的是采样时间MQ2的等效源阻抗不低采样时间不足会导致读数偏低且不稳定239.5周期是F103可配置的最长采样时间实测信噪比最好。参数说明ADC_SAMPLE_COUNT由你自己定义我一般取16。这个值影响DMA缓冲区大小和后续滤波窗口长度太小滤波效果差太大占用内存且响应变慢。16对我来说是一个兼顾两者的平衡点。采样时间如果用的默认1.5周期你会观察到ADC数值后面几位一直在跳那不是传感器的问题是采样电路没采稳。3.2 滑动平均滤波为什么不能直接拿单次ADC值做判断MQ2的瞬态输出噪声相当明显尤其在燃气、油烟这类气流扰动的场景里单次ADC读数跳变几十个单位是很常见的事。如果你拿着单次值去做阈值判断高点可能报警低点又不报警表现为报警指示灯闪个不停。所以程序里必须加滤波。滑动平均是最实用、最不挑场景的方案。#define ADC_SAMPLE_COUNT 16 uint16_t ADC_Value[ADC_SAMPLE_COUNT]; // 简单的滑动平均取最近ADC_SAMPLE_COUNT次转换结果的均值 uint16_t ADC_GetAverageValue(void) { uint32_t sum 0; uint16_t i; for (i 0; i ADC_SAMPLE_COUNT; i) { sum ADC_Value[i]; } return (uint16_t)(sum / ADC_SAMPLE_COUNT); }逻辑说明ADC_Value数组由DMA持续刷新主循环里直接调用ADC_GetAverageValue()就能拿到最近16次采样的平均值。之所以用多个样本平均而不是在中端里读一个值是因为DMA在硬件层面持续采样软件读到的是稳定的缓冲区快照不需要考虑采样时刻是否错过。参数说明窗口大小从8到32都有人用。窗口越大滤波越平滑但对浓度突变的响应越慢。烟雾报警场景我选16实测从烟雾出现到数值反映出来大约延迟300500ms可接受。如果你做的是需要快速响应的场景比如酒精检测窗口减到8更合适。这里有个血泪教训不要用每次转换都更新一次平均值再乘除运算的方式做递推均值效果一样但代码可读性和可维护性差很多DMA整块平均是最朴实也最好维护的方案。3.3 从电压到浓度的两种做法查表插值与对数拟合拿到稳定的ADC电压值之后下一个问题是“这个值到底是多少PPM”。MQ2的数据手册会给出一组灵敏度特性曲线横轴是气体浓度PPM纵轴是Rs/Ro坐标都是对数刻度。不同气体的曲线斜率不同说明同一颗传感器对甲烷的响应和对烟雾的响应是不一样的。如果你想在程序里输出一个近似浓度值常见做法有两种。第一种是查表插值把曲线上的关键点存成数组根据当前的Rs/Ro值在相邻两个点之间做线性插值。第二种是对数拟合手册曲线在双对数坐标下近似直线于是有log10(PPM) A B × log10(Rs/Ro)其中A和B是某个气体的拟合系数。这里的问题是不同气体的A、B差异明显而你手上没有标准气源去精确标定所以算出来的PPM只能作为参考。我个人的做法是程序里不输出PPM而是输出“归一化比率”Rs/Ro再用相对变化去判断报警。原因是Ro是传感器在洁净空气下的电阻值和个体、环境都有关系只报绝对PPM换一颗传感器就完全不准了这在项目落地时是灾难。如果确实要展示浓度我提供一个简化到可用的近似转换代码它假设你在洁净空气下标定过Rofloat MQ2_GetRs(float adc_voltage, float rl_resistance) { float rs; // 防止除零adc_voltage最小时相当于RL上没有压降此时视作最大量程 if (adc_voltage 0.001f) { adc_voltage 0.001f; } // 分压公式反推Rs (VCC * RL / Vout) - RL rs (MQ2_VCC * rl_resistance / adc_voltage) - rl_resistance; return rs; } // 通过Rs/Ro在双对数坐标下的线性关系估算PPM以烟雾/丙烷为例系数可调 float MQ2_GetPPM(float rs, float ro) { float ratio rs / ro; float ppm_log; // 参数来自典型灵敏度曲线的近似A、B对应丙烷/烟雾 ppm_log (log10f(ratio) - MQ2_INTERCEPT_A) / MQ2_SLOPE_B; return powf(10.0f, ppm_log); }逻辑说明MQ2_GetRs做的是分压公式的反推。你是从ADC电压推Rs所以第一步必须先确认VCC、RL和ADC参考电压三者之间的关系。MQ2_GetPPM则是把Rs/Ro通过线性公式从对数坐标换回PPM其中MQ2_INTERCEPT_A和MQ2_SLOPE_B是两个可调浮点参数你可以根据自己手上的传感器实测数据去修改没有任何魔法。参数说明这个转换最大的不稳定因素不是代码而是Ro。Ro必须每颗传感器单独标定程序里千万别写死同一个出厂值。模块上那个蓝色电位器调的也不是Ro它调的是比较器触发电平或模拟前端的增益和程序里的Ro是两回事。4. 标定与阈值设定MQ2最大的坑不在代码在传感器本身4.1 预热与老化为什么上电第一小时读数一路漂MQ2的敏感材料需要加热到工作温度之后表面吸脱附过程才会达到平衡。这个加热过程不是三秒钟就能完成的实测数据是上电第一分钟读数会快速下降从几百到几十接下来半小时内还会缓慢漂移一小时之后才基本稳定。这个漂移不是故障是敏感层温度分布和表面氧吸附尚未稳定的物理过程。所以在代码里做任何基准设定之前必须先解决“什么时候开始采样”的问题。我看过有人把基准值设定在开机后第2秒的读数结果可想而知后面整个阈值体系全部失效。正确的做法是程序里加一个初始化阶段开机后至少等待5分钟再开始更新环境基准。如果你需要更快进入工作状态可以在代码里跳过基准学习直接使用上一次保存在Flash里的Ro值但要保证传感器已经预热足够时间。另外还有一个“老化”概念全新的MQ2敏感层表面有一层工艺残留物首次通电后Rs会持续变化通常要老化24到48小时才能进入稳定工作区间。所以新买的传感器不要急着标定先连续通电一天再说。这是MQ2程序之外、但直接影响程序效果的一个步骤。4.2 标定方法用干净空气实测Ro而不是看手册标定Ro的标准做法是在洁净空气中测量Rs的稳定值。具体操作是传感器上电预热至少30分钟选择室外通风良好的地方或者室内确认没有燃气、香烟、酒精等干扰源然后用程序连续采集Rs值等读数在一个稳定范围内波动时取平均值作为Ro。这里记录一个实操代码片段。我一般会用一个串口命令触发标定这样不用重新烧录固件void MQ2_Calibrate(uint16_t sample_count) { uint32_t sum_rs 0; uint32_t voltage_sum 0; uint16_t i; float avg_vout, rs, ro; // 连续采集N次计算出平均输出电压 for (i 0; i sample_count; i) { voltage_sum ADC_GetAverageValue(); // 每次取滑动平均值 delay_ms(50); // 采样间隔避免ADC多路切换干扰 } avg_vout (float)voltage_sum / sample_count / 4095.0f * 3.3f; // 反推Rs并暂时作为Ro保存 rs (MQ2_VCC * MQ2_RL / avg_vout) - MQ2_RL; ro rs; // 写入内部Flash模拟的存储区保证掉电不丢失 MQ2_SaveRo(ro); }逻辑说明标定函数做了三件事。第一多次采样取平均消除瞬时波动的影响这里的sample_count我会取20到50之间太大耗时多太小不稳定第二把ADC原始值换算成实际电压然后反推Rs第三把结果保存到非易失存储区。注意avg_vout计算中用到的3.3f是ADC参考电压如果你的板子参考电压不是标准3.3V需要实测修正。参数说明delay_ms(50)是为了让两次采样之间有一点间隔虽然DMA模式下连续读取很简单但加入间隔能让电路在每次触发后有充分的稳定时间。特别是当你在多路ADC通道之间切换时这个间隔更加重要。4.3 阈值怎么设固定电压阈值与相对阈值各自的适用场景阈值设定有两种思路各有各的使用场景强烈不建议混用。第一种是固定阈值法标定后记录洁净空气下的基准ADC值然后设定一个固定偏移量比如“基准值300”作为报警线。这种方法的优点是简单直观、逻辑稳定缺点是受环境温湿度影响明显夏天的基准值和冬天可能相差几十甚至上百个ADC单位。第二种是相对阈值法程序动态维护一个慢速更新的环境基准当实时值相对于基准的偏离比例比如升高30%达到一定值时触发报警。这种方法的优点是对环境和个体差异的适应性强缺点是必须保证基准更新足够慢否则浓度真正升高时基准也被带偏程序永远不报警。我的建议是按场景选择固定安装的烟雾报警器用固定阈值更符合直觉因为报警动作需要有可重复性的客观标准而便携设备、车载环境这种空气本底变化大的场景用相对阈值更合适。还有一个折中方案开机后完成一次标定并把基准存进Flash程序定期比如每小时检查当前读数与基准的差值超过一个大的范围才更新基准这样兼顾两者。阈值设定的一个关键参数是回滞hysteresis。报警动作在基准值300附近触发但解除报警不要在基准值290就解除否则读数在阈值附近抖动时报警状态会反复翻转。我会设置报警触发为基准值300解除为基准值220这80个ADC单位的回滞区间能有效屏蔽抖动。5. 避坑与排查MQ2程序的常见问题清单5.1 上电后ADC读数直接接近满量程现象程序烧录后串口输出4090附近的值无论放在什么环境下都降不下来。传感器明明是新的模块焊线也没问题。原因最常见的是OUT引脚在传感器供电为5V时输出超过了STM32 ADC的3.3V量程ADC读满后不会再变。另一个可能是在裸传感器方案里你没有把负载电阻RL接上OUT直接浮空电压被拉到了电源附近。解决先用万用表量OUT对地电压确认是否超过3.3V。如果超过加一个分压电阻网络或改用3.3V给测量极供电注意加热丝仍用5V。如果确认电压在ADC量程内检查RL是否焊接、虚焊引脚是否接触不良。5.2 读数在洁净空气中持续走高几小时不回落现象传感器放在没有烟雾的房间里开了一晚上串口读数从早上800慢慢涨到1400再到1800像爬坡一样。原因这基本是加热丝供电时断时续、或者供电电压偏低导致敏感层温度不足的典型表现。温度不够时表面氧吸附变慢Rs漂移加大。还有一种常见情况是焊接时使用的松香或助焊剂残留被加热后挥发吸附到了敏感层表面导致读数失真。解决把MQ2单独放在通风处先确认加热丝两端电压稳定在4.8V以上然后连续通电24小时观察是否回落。如果还在爬坡用无水酒精轻轻擦拭传感器外壳不要接触敏感层再通电老化。程序端不要反复重启重启会打断加热平衡让漂移时间重新开始。5.3 读数周期性波动波形和电源纹波同步现象串口打印的数值不是单调跳变而是呈正弦波状上下起伏周期大约几十毫秒到几百毫秒。原因加热丝是电流负载工作电流变化会引起VCC波动。如果MQ2和STM32共用同一个LDOVCC的波动会传导到ADC参考电压使转换结果跟着电源一起抖。这类问题在电池供电或劣质USB供电时尤其严重。解决给传感器供电单独加一颗100uF电解电容和0.1uF陶瓷电容布线时电容尽量靠近传感器VCC引脚。更进一步的做法是给MCU的VDDA引脚单独接一颗磁珠或小电阻把数字电源噪声和模拟参考电压隔离开。如果手头没有磁珠先并大电容也能明显改善。5.4 换了传感器后原有报警阈值全部失灵现象同一套程序板子之前报警阈值设在1200换了一颗新的MQ2模块后放在同样的环境里读数变成2400直接开始报警。原因MQ2个体差异极大。即使是同一批次Rs在相同浓度下也可能相差一倍以上。把阈值写死在固件里等于把个体差异全都暴露出来。解决每一次更换传感器都要重新标定。我建议程序里内置一个简单的串口标定指令输入一个特定字符后进入标定模式完成后更新Flash里的Ro一切阈值都基于Ro重新计算。同时把报警阈值也改成存储变量不要用常量。这个习惯能省下大量现场调试的时间。5.5 低温环境下读数偏低加热丝温度起不来现象在北方冬天户外或阳台场景下MQ2读数一直偏低。把传感器拿到室内几分钟读数就恢复正常。原因加热丝电阻随温度变化寒冷环境导致加热丝起始电阻变小同样的供电电压下发热功率降低敏感层工作温度不足灵敏度明显下降。MQ2本质上是一个温度依赖型器件它并没有补偿机制。解决程序端做软件补偿很难因为影响的是敏感层温度而不是信号链上的某个固定增益。更实际的做法是在结构上避免让传感器直接暴露在强气流和低温环境中比如增加一个百叶窗式的防护罩减缓热量的流失。如果必须户外使用建议在固件里加一个温度传感器低于5°C时直接提示环境不适而不是给出不可信的浓度值。6. 进阶多级报警、低功耗策略与标定数据持久化MQ2本身加热功耗在800mW级别加热丝一直通电所以“待机低功耗”和“周期性唤醒采样”这类思路在MQ2上基本不成立——你可以在唤醒后花几秒钟采样并立刻让MCU进入睡眠但加热丝仍然在耗电。因此真正值得做的进阶方向有三个多级报警逻辑、标定数据的妥善存储、以及把相对值基准做得更聪明。多级报警的核心是改变蜂鸣器和LED的状态机。我的实现是分三档浓度高于基准30%为“关注”LED慢闪不响蜂鸣器高于70%为“警告”LED快闪蜂鸣器每两秒短鸣一次高于150%为“报警”LED常亮蜂鸣器持续鸣叫。状态机之间的切换要加入回滞否则在临界点附近会来回跳动。标定数据持久化方面STM32F103没有真正的EEPROM但可以使用内部Flash的最后一个页来保存Ro和报警阈值。写入前需要先擦除整个页然后写入固定格式的结构体读取出错时回退到默认值。这里有个坑Flash写操作会阻塞CPU数十毫秒标定写入时务必确保电源稳定避免写一半掉电导致数据损坏。最后谈一下“动态基准”的做法。我会让代码维护两个基准一个是长期基准通过每小时采样一次并保存到Flash另一个是短期基准每30秒更新一次。比较实时值时先看短期基准偏离但报警解除时参考长期基准。这样既避免了环境本底缓慢变化导致的误报又不会因为短期基准更新太快而漏报。这个方向的坑我已经踩得七七八八了最深的体会是MQ2程序的成败不在ADC读取那一行而在有没有耐心做预热、标定和阈值回滞。哪怕你只是做个课设或毕设也建议把这套流程完整写进代码里它会让你的设备从“能读数”变成“可真用”。希望帮到你。本文还有配套的精品资源点击获取
简介基于MQ2烟雾传感器的STM32F103程序是一套完整的嵌入式实验工程面向物联网、嵌入式初学及开发人员解决可燃气体浓度采集与串口实时显示的需求。工程基于ARM Cortex-M3内核的STM32F103包含MQ2驱动、ADC采样、电压转换及UART串口发送等核心逻辑并附带Keil工程配置文件。压缩包共179个文件以C源文件、头文件、目标文件为主同时包含hex烧写文件、axf调试文件及uvprojx工程文件整体仅4.3MB便于快速移植与二次开发。这份工程已有16000余人学习下载适合通过实际代码理解传感器工作原理、串口通信机制及STM32外设配置。借助这套程序开发者可掌握MQ2传感器的数据读取与浓度换算方法并可参照工程结构将烟雾检测功能快速集成到自己的嵌入式项目中。1. 用STM32F103驱动MQ2烟雾传感器一块开发板和一颗气敏电阻能做的事很多人第一次把MQ2烟雾传感器接到STM32F103上第一反应是“读个ADC值”。但真跑起来才发现上电头几分钟数值一路漂串口每秒吐一个数每个数都不一样放在阳台通风处是800多拿到室内抽口烟忽然飙到3600再放回去两小时也降不回原来的值。如果你也被这颗气敏电阻折腾过那这正是一篇针对MQ2烟雾传感器配合STM32F103程序的落地笔记从硬件连接、ADC采样、滤波到标定与阈值设置再到我踩过的几个典型坑全部按可复现的方式写出来。适合手里有开发板、想做一个烟雾报警或空气质量监测装置又不想只停留在“能亮灯”阶段的从业者。MQ2的本质是一颗二氧化锡半导体气敏电阻它对丙烷、甲烷、烟雾、酒精都有响应价格便宜、响应快但精度和稳定性都不如电化学传感器。STM32F103自带12位ADC资源完全够用麻烦的是传感器本身的非线性和漂移。所以程序的核心并不是“读ADC”这一行代码而是围绕采样时机、滤波、基准标定、报警阈值展开的一整套策略。下面从硬件原理开始一步一步把它说透。2. MQ2的工作原理与硬件连接分压电路决定ADC读数的精度上限2.1 从气敏电阻到电压信号Rs、RL与分压公式MQ2内部的敏感材料是二氧化锡SnO2它被加热丝加热到大约200°C左右。在洁净空气中材料表面吸附氧分子形成电子耗尽层电阻Rs处于一个较高的稳定值当还原性气体比如烟雾中的可燃成分、甲烷、丙烷、酒精蒸气接触到表面时会与吸附氧发生反应释放电子Rs显著下降。MQ2的输出就是“Rs随气体浓度变化”这件事。但单片机只能读电压所以需要一个分压网络把电阻变化变成电压变化。常见的做法是把敏感电阻Rs与一个负载电阻RL串联在RL两端取电压Vout VCC × RL / (Rs RL)当烟雾浓度升高Rs下降RL分到的电压上升ADC读数变大。这个方向关系务必记清楚后面排查反向问题时会用到。RL的取值对输出电压范围和灵敏度影响很大。市面上常见的MQ2模块板载RL大多是1kΩ或4.7kΩ也有5kΩ如果你是自己搭电路我一般建议RL取值在4.7kΩ到10kΩ之间太小洁净空气下的分压太低浓度变化时电压变化不明显太大浓度高时输出很容易触顶饱和。这里还有个新手常忽视的点ADC读到的电压并不是Rs本身而是RL上的分压。要算Rs需要做一次反推Rs (VCC × RL / Vout) - RL这个公式在后面标定章节非常关键。因为你标定的不是“电压值”而是传感器的基准电阻Ro。2.2 引脚识别与最小硬件连接别把加热丝和测量极搞混MQ2是6个引脚内部实际上分为两组一组是加热丝引脚H/H-H一组是测量电极引脚A/B。焊接和接线时必须分清。很多初学翻车都是把测量电极接到了5V和GND上导致ADC读数一直不变或者干脆烧掉敏感层。按照我常用的接法把6个引脚分成三对要点 | 接法 加热丝H-H | 接5V正极另一脚接GND给内部加热丝供电 测量电极A | 接VCC5V作为分压上端 测量电极B | 串联RL后接GNDB与GND之间取分压输出即OUT信号用模块时通常省心板上已经做好了分压和比较器输出有的模块同时提供模拟输出和数字输出模拟输出接STM32的ADC引脚。但用模块也要确认一件事模拟输出引脚的最大电压。有些模块的模拟输出在5V供电时最高能到4V多直接进STM32F103的3.3V ADC引脚是有风险的。保守做法是加两个电阻做1:1分压比如10k和10k把最高电压压到2V左右或者确认模块设计上已经把输出限制在3.3V以内。我自己的习惯是数采模块用3.3V给传感器供电也行但加热丝可能加热功率不足灵敏度明显下降所以更推荐5V供电加分压的方案。供电去耦也值得单独提一句。加热丝是一个典型的电流型负载工作时电流变化会造成电源轨波动而这个波动会直接串到ADC参考电压上表现为读数周期性抖动。我一般会在传感器的VCC和GND之间放一颗100uF电解电容再并联一颗0.1uF陶瓷电容位置尽量靠近传感器引脚。这算是最便宜的“后悔药”了。连接关系整理成最小清单STM32F103的PA1引脚配置为模拟输入接模块模拟输出OUT或分压后的信号。模块VCC接5VGND共地。如果传感器是裸元件而非模块按上文配RL并引出分压中点。ADC参考电压默认接VDD3.3V如果你的板子有外部基准芯片标准电压源更佳但要保证外部基准电压不超过3.3V且与MCU共地。我把这部分作为一个固定的先导检查项每次上电前先量一下加热丝两端有没有5V、OUT对地电压是否在合理范围再去烧录程序。直接上电开读十有八九会读到一堆莫名其妙的数。3. 核心程序实现ADC采样、滑动滤波与浓度换算3.1 初始化ADC12位分辨率、采样时间与DMA配置STM32F103的ADC是12位精度转换结果范围04095对应0V3.3V。如果使用DMA循环模式可以让ADC连续采样并把结果持续搬运到内存数组里CPU不需要等待每次转换。这里给出一个完整的初始化函数代码基于标准外设库这是目前F103项目里最常见的写法。void ADC_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; ADC_InitTypeDef ADC_InitStructure; DMA_InitTypeDef DMA_InitStructure; // 1. 使能时钟ADC1挂载在APB2总线GPIOA也在APB2DMA1在AHB RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_GPIOA, ENABLE); RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE); // 2. PA1配置为模拟输入注意不是复用推挽是模拟输入 GPIO_InitStructure.GPIO_Pin GPIO_Pin_1; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN; GPIO_Init(GPIOA, GPIO_InitStructure); // 3. DMA配置循环模式每次搬运一个半字16位到ADC_Value数组 DMA_InitStructure.DMA_PeripheralBaseAddr (uint32_t)ADC1-DR; DMA_InitStructure.DMA_MemoryBaseAddr (uint32_t)ADC_Value; DMA_InitStructure.DMA_DIR DMA_DIR_PeripheralSRC; DMA_InitStructure.DMA_BufferSize ADC_SAMPLE_COUNT; DMA_InitStructure.DMA_PeripheralInc DMA_PeripheralInc_Disable; DMA_InitStructure.DMA_MemoryInc DMA_MemoryInc_Enable; DMA_InitStructure.DMA_PeripheralDataSize DMA_PeripheralDataSize_HalfWord; DMA_InitStructure.DMA_MemoryDataSize DMA_MemoryDataSize_HalfWord; DMA_InitStructure.DMA_Mode DMA_Mode_Circular; DMA_InitStructure.DMA_Priority DMA_Priority_High; DMA_InitStructure.DMA_M2M DMA_M2M_Disable; DMA_Init(DMA1_Channel1, DMA_InitStructure); // 4. ADC1配置独立模式连续转换12位分辨率软件触发 ADC_InitStructure.ADC_Mode ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode DISABLE; // 只转换一个通道 ADC_InitStructure.ADC_ContinuousConvMode ENABLE; // 连续转换配合DMA循环 ADC_InitStructure.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_DataAlign ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel 1; ADC_Init(ADC1, ADC_InitStructure); // 5. 配置ADC1通道1PA1对应ADC_Channel_1采样时间取最长239.5周期 ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); // 6. 使能ADC与DMA并校准F103每次上电建议执行一次校准 ADC_DMACmd(ADC1, ENABLE); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while (ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while (ADC_GetCalibrationStatus(ADC1)); // 7. 启动一次软件触发之后ADC连续转换、DMA持续搬运 ADC_SoftwareStartConvCmd(ADC1, ENABLE); DMA_Cmd(DMA1_Channel1, ENABLE); }逻辑说明整个初始化分四块。第一块是时钟ADC1挂在APB2上DMA1挂在AHB上遗漏任何一路都会导致外设不工作。第二块是GPIOPA1必须配置为模拟输入模式如果用复用推挽会破坏模拟信号通路。第三块是DMA循环模式它让ADC转换结果不断写入ADC_Value数组缓冲区满后从头覆盖这就是循环的意义你不需要在中断里手动读取结果。第四块是ADC本身的配置这里最关键的是采样时间MQ2的等效源阻抗不低采样时间不足会导致读数偏低且不稳定239.5周期是F103可配置的最长采样时间实测信噪比最好。参数说明ADC_SAMPLE_COUNT由你自己定义我一般取16。这个值影响DMA缓冲区大小和后续滤波窗口长度太小滤波效果差太大占用内存且响应变慢。16对我来说是一个兼顾两者的平衡点。采样时间如果用的默认1.5周期你会观察到ADC数值后面几位一直在跳那不是传感器的问题是采样电路没采稳。3.2 滑动平均滤波为什么不能直接拿单次ADC值做判断MQ2的瞬态输出噪声相当明显尤其在燃气、油烟这类气流扰动的场景里单次ADC读数跳变几十个单位是很常见的事。如果你拿着单次值去做阈值判断高点可能报警低点又不报警表现为报警指示灯闪个不停。所以程序里必须加滤波。滑动平均是最实用、最不挑场景的方案。#define ADC_SAMPLE_COUNT 16 uint16_t ADC_Value[ADC_SAMPLE_COUNT]; // 简单的滑动平均取最近ADC_SAMPLE_COUNT次转换结果的均值 uint16_t ADC_GetAverageValue(void) { uint32_t sum 0; uint16_t i; for (i 0; i ADC_SAMPLE_COUNT; i) { sum ADC_Value[i]; } return (uint16_t)(sum / ADC_SAMPLE_COUNT); }逻辑说明ADC_Value数组由DMA持续刷新主循环里直接调用ADC_GetAverageValue()就能拿到最近16次采样的平均值。之所以用多个样本平均而不是在中端里读一个值是因为DMA在硬件层面持续采样软件读到的是稳定的缓冲区快照不需要考虑采样时刻是否错过。参数说明窗口大小从8到32都有人用。窗口越大滤波越平滑但对浓度突变的响应越慢。烟雾报警场景我选16实测从烟雾出现到数值反映出来大约延迟300500ms可接受。如果你做的是需要快速响应的场景比如酒精检测窗口减到8更合适。这里有个血泪教训不要用每次转换都更新一次平均值再乘除运算的方式做递推均值效果一样但代码可读性和可维护性差很多DMA整块平均是最朴实也最好维护的方案。3.3 从电压到浓度的两种做法查表插值与对数拟合拿到稳定的ADC电压值之后下一个问题是“这个值到底是多少PPM”。MQ2的数据手册会给出一组灵敏度特性曲线横轴是气体浓度PPM纵轴是Rs/Ro坐标都是对数刻度。不同气体的曲线斜率不同说明同一颗传感器对甲烷的响应和对烟雾的响应是不一样的。如果你想在程序里输出一个近似浓度值常见做法有两种。第一种是查表插值把曲线上的关键点存成数组根据当前的Rs/Ro值在相邻两个点之间做线性插值。第二种是对数拟合手册曲线在双对数坐标下近似直线于是有log10(PPM) A B × log10(Rs/Ro)其中A和B是某个气体的拟合系数。这里的问题是不同气体的A、B差异明显而你手上没有标准气源去精确标定所以算出来的PPM只能作为参考。我个人的做法是程序里不输出PPM而是输出“归一化比率”Rs/Ro再用相对变化去判断报警。原因是Ro是传感器在洁净空气下的电阻值和个体、环境都有关系只报绝对PPM换一颗传感器就完全不准了这在项目落地时是灾难。如果确实要展示浓度我提供一个简化到可用的近似转换代码它假设你在洁净空气下标定过Rofloat MQ2_GetRs(float adc_voltage, float rl_resistance) { float rs; // 防止除零adc_voltage最小时相当于RL上没有压降此时视作最大量程 if (adc_voltage 0.001f) { adc_voltage 0.001f; } // 分压公式反推Rs (VCC * RL / Vout) - RL rs (MQ2_VCC * rl_resistance / adc_voltage) - rl_resistance; return rs; } // 通过Rs/Ro在双对数坐标下的线性关系估算PPM以烟雾/丙烷为例系数可调 float MQ2_GetPPM(float rs, float ro) { float ratio rs / ro; float ppm_log; // 参数来自典型灵敏度曲线的近似A、B对应丙烷/烟雾 ppm_log (log10f(ratio) - MQ2_INTERCEPT_A) / MQ2_SLOPE_B; return powf(10.0f, ppm_log); }逻辑说明MQ2_GetRs做的是分压公式的反推。你是从ADC电压推Rs所以第一步必须先确认VCC、RL和ADC参考电压三者之间的关系。MQ2_GetPPM则是把Rs/Ro通过线性公式从对数坐标换回PPM其中MQ2_INTERCEPT_A和MQ2_SLOPE_B是两个可调浮点参数你可以根据自己手上的传感器实测数据去修改没有任何魔法。参数说明这个转换最大的不稳定因素不是代码而是Ro。Ro必须每颗传感器单独标定程序里千万别写死同一个出厂值。模块上那个蓝色电位器调的也不是Ro它调的是比较器触发电平或模拟前端的增益和程序里的Ro是两回事。4. 标定与阈值设定MQ2最大的坑不在代码在传感器本身4.1 预热与老化为什么上电第一小时读数一路漂MQ2的敏感材料需要加热到工作温度之后表面吸脱附过程才会达到平衡。这个加热过程不是三秒钟就能完成的实测数据是上电第一分钟读数会快速下降从几百到几十接下来半小时内还会缓慢漂移一小时之后才基本稳定。这个漂移不是故障是敏感层温度分布和表面氧吸附尚未稳定的物理过程。所以在代码里做任何基准设定之前必须先解决“什么时候开始采样”的问题。我看过有人把基准值设定在开机后第2秒的读数结果可想而知后面整个阈值体系全部失效。正确的做法是程序里加一个初始化阶段开机后至少等待5分钟再开始更新环境基准。如果你需要更快进入工作状态可以在代码里跳过基准学习直接使用上一次保存在Flash里的Ro值但要保证传感器已经预热足够时间。另外还有一个“老化”概念全新的MQ2敏感层表面有一层工艺残留物首次通电后Rs会持续变化通常要老化24到48小时才能进入稳定工作区间。所以新买的传感器不要急着标定先连续通电一天再说。这是MQ2程序之外、但直接影响程序效果的一个步骤。4.2 标定方法用干净空气实测Ro而不是看手册标定Ro的标准做法是在洁净空气中测量Rs的稳定值。具体操作是传感器上电预热至少30分钟选择室外通风良好的地方或者室内确认没有燃气、香烟、酒精等干扰源然后用程序连续采集Rs值等读数在一个稳定范围内波动时取平均值作为Ro。这里记录一个实操代码片段。我一般会用一个串口命令触发标定这样不用重新烧录固件void MQ2_Calibrate(uint16_t sample_count) { uint32_t sum_rs 0; uint32_t voltage_sum 0; uint16_t i; float avg_vout, rs, ro; // 连续采集N次计算出平均输出电压 for (i 0; i sample_count; i) { voltage_sum ADC_GetAverageValue(); // 每次取滑动平均值 delay_ms(50); // 采样间隔避免ADC多路切换干扰 } avg_vout (float)voltage_sum / sample_count / 4095.0f * 3.3f; // 反推Rs并暂时作为Ro保存 rs (MQ2_VCC * MQ2_RL / avg_vout) - MQ2_RL; ro rs; // 写入内部Flash模拟的存储区保证掉电不丢失 MQ2_SaveRo(ro); }逻辑说明标定函数做了三件事。第一多次采样取平均消除瞬时波动的影响这里的sample_count我会取20到50之间太大耗时多太小不稳定第二把ADC原始值换算成实际电压然后反推Rs第三把结果保存到非易失存储区。注意avg_vout计算中用到的3.3f是ADC参考电压如果你的板子参考电压不是标准3.3V需要实测修正。参数说明delay_ms(50)是为了让两次采样之间有一点间隔虽然DMA模式下连续读取很简单但加入间隔能让电路在每次触发后有充分的稳定时间。特别是当你在多路ADC通道之间切换时这个间隔更加重要。4.3 阈值怎么设固定电压阈值与相对阈值各自的适用场景阈值设定有两种思路各有各的使用场景强烈不建议混用。第一种是固定阈值法标定后记录洁净空气下的基准ADC值然后设定一个固定偏移量比如“基准值300”作为报警线。这种方法的优点是简单直观、逻辑稳定缺点是受环境温湿度影响明显夏天的基准值和冬天可能相差几十甚至上百个ADC单位。第二种是相对阈值法程序动态维护一个慢速更新的环境基准当实时值相对于基准的偏离比例比如升高30%达到一定值时触发报警。这种方法的优点是对环境和个体差异的适应性强缺点是必须保证基准更新足够慢否则浓度真正升高时基准也被带偏程序永远不报警。我的建议是按场景选择固定安装的烟雾报警器用固定阈值更符合直觉因为报警动作需要有可重复性的客观标准而便携设备、车载环境这种空气本底变化大的场景用相对阈值更合适。还有一个折中方案开机后完成一次标定并把基准存进Flash程序定期比如每小时检查当前读数与基准的差值超过一个大的范围才更新基准这样兼顾两者。阈值设定的一个关键参数是回滞hysteresis。报警动作在基准值300附近触发但解除报警不要在基准值290就解除否则读数在阈值附近抖动时报警状态会反复翻转。我会设置报警触发为基准值300解除为基准值220这80个ADC单位的回滞区间能有效屏蔽抖动。5. 避坑与排查MQ2程序的常见问题清单5.1 上电后ADC读数直接接近满量程现象程序烧录后串口输出4090附近的值无论放在什么环境下都降不下来。传感器明明是新的模块焊线也没问题。原因最常见的是OUT引脚在传感器供电为5V时输出超过了STM32 ADC的3.3V量程ADC读满后不会再变。另一个可能是在裸传感器方案里你没有把负载电阻RL接上OUT直接浮空电压被拉到了电源附近。解决先用万用表量OUT对地电压确认是否超过3.3V。如果超过加一个分压电阻网络或改用3.3V给测量极供电注意加热丝仍用5V。如果确认电压在ADC量程内检查RL是否焊接、虚焊引脚是否接触不良。5.2 读数在洁净空气中持续走高几小时不回落现象传感器放在没有烟雾的房间里开了一晚上串口读数从早上800慢慢涨到1400再到1800像爬坡一样。原因这基本是加热丝供电时断时续、或者供电电压偏低导致敏感层温度不足的典型表现。温度不够时表面氧吸附变慢Rs漂移加大。还有一种常见情况是焊接时使用的松香或助焊剂残留被加热后挥发吸附到了敏感层表面导致读数失真。解决把MQ2单独放在通风处先确认加热丝两端电压稳定在4.8V以上然后连续通电24小时观察是否回落。如果还在爬坡用无水酒精轻轻擦拭传感器外壳不要接触敏感层再通电老化。程序端不要反复重启重启会打断加热平衡让漂移时间重新开始。5.3 读数周期性波动波形和电源纹波同步现象串口打印的数值不是单调跳变而是呈正弦波状上下起伏周期大约几十毫秒到几百毫秒。原因加热丝是电流负载工作电流变化会引起VCC波动。如果MQ2和STM32共用同一个LDOVCC的波动会传导到ADC参考电压使转换结果跟着电源一起抖。这类问题在电池供电或劣质USB供电时尤其严重。解决给传感器供电单独加一颗100uF电解电容和0.1uF陶瓷电容布线时电容尽量靠近传感器VCC引脚。更进一步的做法是给MCU的VDDA引脚单独接一颗磁珠或小电阻把数字电源噪声和模拟参考电压隔离开。如果手头没有磁珠先并大电容也能明显改善。5.4 换了传感器后原有报警阈值全部失灵现象同一套程序板子之前报警阈值设在1200换了一颗新的MQ2模块后放在同样的环境里读数变成2400直接开始报警。原因MQ2个体差异极大。即使是同一批次Rs在相同浓度下也可能相差一倍以上。把阈值写死在固件里等于把个体差异全都暴露出来。解决每一次更换传感器都要重新标定。我建议程序里内置一个简单的串口标定指令输入一个特定字符后进入标定模式完成后更新Flash里的Ro一切阈值都基于Ro重新计算。同时把报警阈值也改成存储变量不要用常量。这个习惯能省下大量现场调试的时间。5.5 低温环境下读数偏低加热丝温度起不来现象在北方冬天户外或阳台场景下MQ2读数一直偏低。把传感器拿到室内几分钟读数就恢复正常。原因加热丝电阻随温度变化寒冷环境导致加热丝起始电阻变小同样的供电电压下发热功率降低敏感层工作温度不足灵敏度明显下降。MQ2本质上是一个温度依赖型器件它并没有补偿机制。解决程序端做软件补偿很难因为影响的是敏感层温度而不是信号链上的某个固定增益。更实际的做法是在结构上避免让传感器直接暴露在强气流和低温环境中比如增加一个百叶窗式的防护罩减缓热量的流失。如果必须户外使用建议在固件里加一个温度传感器低于5°C时直接提示环境不适而不是给出不可信的浓度值。6. 进阶多级报警、低功耗策略与标定数据持久化MQ2本身加热功耗在800mW级别加热丝一直通电所以“待机低功耗”和“周期性唤醒采样”这类思路在MQ2上基本不成立——你可以在唤醒后花几秒钟采样并立刻让MCU进入睡眠但加热丝仍然在耗电。因此真正值得做的进阶方向有三个多级报警逻辑、标定数据的妥善存储、以及把相对值基准做得更聪明。多级报警的核心是改变蜂鸣器和LED的状态机。我的实现是分三档浓度高于基准30%为“关注”LED慢闪不响蜂鸣器高于70%为“警告”LED快闪蜂鸣器每两秒短鸣一次高于150%为“报警”LED常亮蜂鸣器持续鸣叫。状态机之间的切换要加入回滞否则在临界点附近会来回跳动。标定数据持久化方面STM32F103没有真正的EEPROM但可以使用内部Flash的最后一个页来保存Ro和报警阈值。写入前需要先擦除整个页然后写入固定格式的结构体读取出错时回退到默认值。这里有个坑Flash写操作会阻塞CPU数十毫秒标定写入时务必确保电源稳定避免写一半掉电导致数据损坏。最后谈一下“动态基准”的做法。我会让代码维护两个基准一个是长期基准通过每小时采样一次并保存到Flash另一个是短期基准每30秒更新一次。比较实时值时先看短期基准偏离但报警解除时参考长期基准。这样既避免了环境本底缓慢变化导致的误报又不会因为短期基准更新太快而漏报。这个方向的坑我已经踩得七七八八了最深的体会是MQ2程序的成败不在ADC读取那一行而在有没有耐心做预热、标定和阈值回滞。哪怕你只是做个课设或毕设也建议把这套流程完整写进代码里它会让你的设备从“能读数”变成“可真用”。希望帮到你。本文还有配套的精品资源点击获取
