1. 项目概述一个实用的烟雾浓度监测报警系统最近在工作室整理电子物料翻出来几个MQ-2烟雾传感器模块想着不能浪费正好手头有STM32的开发板和OLED屏幕就顺手搭了一个烟雾浓度监测报警系统。这个项目虽然听起来简单但麻雀虽小五脏俱全它集成了传感器数据采集、本地显示、声光报警以及数据上传到电脑端分析的功能非常适合作为学习STM32外设驱动、ADC采样、I2C通信以及串口应用的综合练手项目。无论你是刚接触STM32的新手想通过一个完整项目串联知识点还是有一定经验的开发者想快速搭建一个环境监测原型这套方案都能给你提供清晰的思路和可直接复用的代码。整个系统的核心逻辑很直观STM32单片机作为大脑持续读取MQ-2传感器输出的模拟电压值这个电压值对应着环境中烟雾或可燃气体的浓度。单片机一方面将处理后的浓度值实时显示在小小的OLED屏幕上让你能直观看到当前环境状况另一方面通过串口将浓度数据打包发送到电脑的串口调试助手方便你记录数据或进行进一步分析。当浓度超过你设定的安全阈值时单片机还会驱动蜂鸣器发出警报实现本地预警。下面我就把这个项目的设计思路、硬件连接、代码实现以及调试过程中踩过的坑毫无保留地分享出来。2. 系统整体设计与核心思路拆解2.1 核心需求与功能定义这个项目的目标很明确就是构建一个实时、本地可视、可远程监控的烟雾浓度监测终端。拆解开来它需要完成以下四个核心功能数据采集准确、稳定地读取MQ-2传感器的模拟信号。本地显示将浓度信息以清晰易懂的方式呈现在OLED屏幕上。阈值报警在浓度超标时通过蜂鸣器发出明确的声学警告。数据通信将浓度数据通过串口发送至上位机电脑实现数据导出和远程监控的可能性。2.2 硬件选型与方案考量为什么选择这些器件这背后有成本和实用性的权衡。主控MCUSTM32F103C8T6核心板。这是STM32家族中经久不衰的“蓝色药丸”核心板性价比极高。它拥有足够多的GPIO、多路ADC、USART和I2C接口完全满足本项目需求。对于初学者来说其社区资源教程、库函数也最为丰富降低了学习门槛。传感器MQ-2烟雾/可燃气体传感器模块。MQ-2是一个广谱传感器对液化气、丙烷、氢气、烟雾等都很敏感。选择模块而非裸传感器是因为模块通常集成了比较器电路提供了数字量DO和模拟量AO两种输出。我们使用AO模拟输出可以获得连续的浓度信息而不仅仅是“有”或“无”的开关量数据更有价值。显示器件0.96寸OLED屏幕SSD1306驱动I2C接口。OLED屏幕自发光、对比度高、功耗低在少量信息显示的场景下比LCD更具优势。选择I2C接口版本通常只有4根线VCC, GND, SCL, SDA可以极大节省MCU的IO口接线也简洁。SPI接口的OLED虽然刷新更快但本项目对刷新率要求不高I2C足矣。报警器件有源蜂鸣器。有源蜂鸣器内部集成了振荡电路通电即响驱动简单一个GPIO口控制高低电平即可声音响亮非常适合做报警提示。无源蜂鸣器需要MCU产生PWM波驱动才能发声虽然音调可控但本项目只需要简单的“嘀嘀”报警声有源蜂鸣器是更经济高效的选择。通信接口USB转TTL串口模块。这是连接STM32与电脑的桥梁。STM32的USART引脚输出的是TTL电平需要通过这个模块转换为USB信号电脑才能识别。同时它也为STM32核心板提供供电和程序烧录通过串口方式的功能一举两得。2.3 软件架构与流程规划软件层面我们采用前后台超级循环架构这对于功能明确、实时性要求不极端的中小型项目来说结构清晰且易于理解。主程序在一个while(1)大循环中不断执行以下任务定时例如每500ms启动一次ADC转换读取MQ-2的电压值。将ADC原始值转换为电压再根据传感器特性需校准映射为相对的“浓度值”。刷新OLED屏幕显示当前浓度值和报警阈值。判断当前浓度是否超过阈值若超过则控制蜂鸣器鸣叫否则关闭蜂鸣器。将浓度数据格式化为字符串例如Smoke: 256 ppm\r\n通过串口发送出去。这里的关键在于定时采样。我们不能在循环里不停地采样ADC那会浪费CPU资源且可能使串口发送数据不流畅。通常采用延时函数或者定时器中断来产生固定的采样周期。为了代码结构更好我推荐使用一个简单的定时器产生一个比如1ms的时基然后在主循环中判断时间标志位来实现非阻塞的定时任务。3. 硬件连接与核心电路解析3.1 模块引脚定义与接线图工欲善其事必先利其器。先把各个模块的引脚搞清楚是成功的第一步。STM32F103C8T6核心板我们需要用到以下引脚3.3V和GND为所有模块供电。特别注意MQ-2模块的工作电压通常是5V但其AO模拟输出引脚的最大电压可能也是5V而STM32的ADC引脚耐受电压一般为3.3V。直接连接可能损坏单片机稳妥的做法是MQ-2模块用5V供电但其AO输出线串联一个1kΩ左右的电阻后再接入STM32的ADC引脚或者使用电平转换模块。另一种常见方案是选择AO输出范围在0-3.3V的MQ-2模块有些模块可跳线选择或者通过分压电路将5V信号衰减至3.3V以内。本文假设你使用的模块AO输出兼容3.3V电平。PA0配置为ADC输入通道ADC1_IN0连接MQ-2的AO引脚。PB6配置为I2C1的SCL时钟线连接OLED的SCL。PB7配置为I2C1的SDA数据线连接OLED的SDA。PB8配置为推挽输出的GPIO连接蜂鸣器的信号线正极。蜂鸣器负极接GND。PA9配置为USART1的TX发送引脚连接USB转TTL模块的RX。PA10配置为USART1的RX接收引脚连接USB转TTL模块的TX。BOOT0需要置低接GND或通过跳线帽设置为正常启动模式。NRST复位引脚通常悬空即可。MQ-2模块VCC接5V电源可从USB转TTL模块或核心板的5V引脚取。GND接电源地。AO模拟输出接STM32的PA0需注意电平兼容问题。DO数字输出本项目不用可悬空。OLED屏幕 (I2C)VCC接3.3V。GND接GND。SCL接STM32的PB6。SDA接STM32的PB7。有源蜂鸣器标有或VCC的引脚接STM32的PB8。标有-或GND的引脚接GND。USB转TTL模块3.3V或5V可以为STM32核心板供电接核心板的3.3V或5V引脚。建议统一用5V供电电流更足。GND接核心板和所有模块的GND共地至关重要TX接STM32的PA10(USART1_RX)。RX接STM32的PA9(USART1_TX)。注意接线时务必断电操作所有电源连接VCC, GND确认无误后再上电。特别是I2C总线SDA和SCL不要接反。3.2 电平兼容与ADC参考电压问题这是硬件连接中最容易出问题的地方值得单独拿出来讨论。MQ-2 AO输出电平市面上多数MQ-2模块在5V供电时AO引脚在洁净空气中的输出电压约为0.1V-0.3V在高浓度气体中可能接近5V。STM32的GPIO和ADC引脚通常只能承受3.6V电压。如果直接将5V的AO信号接入PA0长时间工作或气体浓度高时可能损坏单片机。解决方案A推荐为MQ-2模块提供5V电源但在AO输出和STM32的ADC引脚之间加入一个简单的电阻分压电路。例如用一个1kΩ电阻串联一个2kΩ电阻将AO电压分压至原来的1/35V-1.67V这样就在STM32的安全范围内且保留了足够的测量精度。解决方案B寻找标称AO输出为0-3.3V的MQ-2模块或者模块上有输出电平选择跳线帽。解决方案C使用专用的电平转换芯片如TXS0108E或模块。STM32的ADC参考电压STM32F103C8T6的ADC参考电压默认接在VDDA引脚上而VDDA通常与VCC3.3V相连。这意味着ADC测量的电压范围是0~3.3V。如果你的VCC不稳定ADC测量值也会漂移。对于精度要求稍高的场合建议确保给核心板供电的3.3V电源纹波小、较稳定。4. 软件实现与核心代码解析4.1 开发环境与工程配置我使用的是Keil MDKARMCC编译器和STM32标准外设库StdPeriph_Lib。使用HAL库或LL库同样可以原理相通。首先我们需要在工程中正确配置以下外设ADC1选择通道0对应PA0配置为独立模式、连续扫描禁用、使能连续转换。采样时间可以设置长一些例如239.5个周期以提高抗干扰能力。需要开启DMA吗对于单通道、低速采样的本项目不需要。我们采用查询方式或者中断方式读取一次转换结果即可。I2C1配置为标准模式100kHz时钟延展使能。注意GPIO模式要设置为开漏输出Open-Drain并启用内部上拉电阻或者外部接上拉电阻到3.3V这是I2C总线标准所要求的。USART1配置为异步模式波特率115200与串口调试助手匹配8位数据位无校验1位停止位。需要开启发送中断或使用查询方式发送。GPIOPB8配置为推挽输出用于控制蜂鸣器。SysTick定时器用于产生精确的毫秒级延时方便我们实现非阻塞的定时任务。4.2 ADC采样与数据处理ADC是感知世界的“眼睛”其稳定性和准确性直接决定系统性能。// 假设已初始化ADC1通道0 12位分辨率 uint16_t ADC_GetValue(void) { ADC_SoftwareStartConvCmd(ADC1, ENABLE); // 启动转换 while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); // 等待转换结束 return ADC_GetConversionValue(ADC1); // 读取转换值 } float ADC_ConvertToVoltage(uint16_t adc_value) { // Vref 3.3V, 12位ADC最大值是4095 return (adc_value * 3.3f) / 4095.0f; }读取到电压值后如何把它变成有意义的“浓度”呢MQ-2的灵敏度特性曲线Rs/Ro vs. 气体浓度通常在其数据手册里。但对我们这个定性或半定量应用来说可以进行简化校准确定Ro洁净空气中的传感器电阻将传感器在洁净空气中预热至少24小时这是关键MQ-2需要预热才能稳定。然后测量此时的输出电压Vc。根据模块原理图通常AO输出与Rs分压可以反推出此时的Rs这个Rs近似等于Ro。对于很多模块我们可以直接记录下此时的ADC原始值ADC_air作为“空气基准”。计算浓度比值定义ratio (float)ADC_value / (float)ADC_air。这个比值越大说明气体浓度越高。你可以通过实验在已知浓度的烟雾源需谨慎安全操作附近测试记录下不同浓度对应的ratio值建立一个简单的查找表或线性关系。本项目简化处理由于精确校准需要专业环境和气室对于报警应用我们可以采用更简单的办法直接使用ADC原始值或电压值作为“浓度指示值”。然后设置一个经验阈值当这个值超过阈值就报警。这个阈值需要通过实验来确定在安全环境下产生少量烟雾观察数值变化找到一个能可靠触发报警但又不会误报的值。4.3 OLED显示驱动与界面设计OLED显示我们使用现成的驱动库如ssd1306.h或OLED_Font.h。核心是初始化I2C和调用显示函数。// 初始化I2C后初始化OLED OLED_Init(); OLED_Clear(); // 在主循环中刷新显示 void OLED_RefreshDisplay(uint16_t smoke_value, uint16_t threshold) { char str_buf[20]; OLED_ShowString(0, 0, Smoke Monitor, 16); OLED_ShowString(0, 2, Value:, 16); sprintf(str_buf, %4d, smoke_value); OLED_ShowString(48, 2, str_buf, 16); OLED_ShowString(0, 4, Thresh:, 16); sprintf(str_buf, %4d, threshold); OLED_ShowString(56, 4, str_buf, 16); // 如果浓度超标显示警告标志 if(smoke_value threshold) { OLED_ShowString(90, 2, !!!, 16); } else { OLED_ShowString(90, 2, , 16); // 清除警告 } }显示界面力求简洁明了第一行显示标题第二行显示当前浓度值第四行显示报警阈值并在浓度超标时在数值旁显示“!!!”警示。注意OLED屏幕的坐标体系x, y和字体大小这里用了16x8的字体需要根据你的驱动库函数进行调整。4.4 串口数据发送与格式化串口是将数据发送到电脑的“嘴巴”格式清晰很重要。// 初始化USART1波特率115200 void USART1_SendString(char *str) { while(*str) { while(USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); // 等待发送缓冲区空 USART_SendData(USART1, *str); } } // 在主循环中定时如每秒发送一次数据 if(send_uart_flag) { // 这个标志位由定时器置位 send_uart_flag 0; char uart_buf[64]; // 格式化为 Smoke: 345, Voltage: 0.85V, Status: OK/ALARM\r\n if(smoke_value threshold) { sprintf(uart_buf, Smoke: %4d, Voltage: %.2fV, Status: ALARM\r\n, smoke_value, voltage); } else { sprintf(uart_buf, Smoke: %4d, Voltage: %.2fV, Status: OK\r\n, smoke_value, voltage); } USART1_SendString(uart_buf); }发送的数据格式包含了原始值、电压值和状态用逗号分隔便于电脑端软件如串口调试助手、Python脚本、Excel解析。末尾的\r\n是换行符确保每次发送的数据在接收端独立成行。4.5 主程序逻辑与状态管理将所有模块整合起来的主循环其结构体现了系统的实时性和响应性。int main(void) { // 系统时钟、外设初始化 SystemInit(); GPIO_Init(); ADC1_Init(); I2C1_Init(); OLED_Init(); USART1_Init(115200); SysTick_Init(); // 初始化系统滴答定时器用于产生1ms中断 TIM3_Init(); // 初始化一个定时器用于产生500ms的采样周期标志位 uint16_t adc_value 0; uint16_t smoke_value 0; uint16_t alarm_threshold 1500; // 示例阈值需根据实测调整 uint8_t alarm_on 0; OLED_Clear(); OLED_ShowString(0, 0, System Ready, 16); Delay_ms(1000); while(1) { // 任务1定时采样ADC if(adc_sample_flag) { // 由TIM3中断置位 adc_sample_flag 0; adc_value ADC_GetValue(); // 可选进行软件滤波如滑动平均滤波 smoke_value adc_value; // 这里直接用ADC值代表浓度 } // 任务2刷新OLED显示 OLED_RefreshDisplay(smoke_value, alarm_threshold); // 任务3报警判断与控制 if(smoke_value alarm_threshold) { if(!alarm_on) { BEEP_ON(); // 宏定义置PB8为高电平 alarm_on 1; } } else { if(alarm_on) { BEEP_OFF(); // 宏定义置PB8为低电平 alarm_on 0; } } // 任务4定时发送串口数据 if(uart_send_flag) { // 由另一个定时器或计数置位 uart_send_flag 0; Send_Smoke_Data_UART(smoke_value, alarm_threshold); } // 其他任务... 如按键扫描调整阈值如果接了按键 // Key_Scan(); } }这个主循环清晰展示了基于标志位的协作式调度。每个任务采样、显示、报警、通信都由对应的标志位触发而这些标志位在定时器中断服务函数中被设置。这样保证了每个任务都能以固定的周期执行避免了使用Delay函数导致的CPU空转和响应迟钝。5. 调试技巧与常见问题实录5.1 上电无反应或OLED不显示问题现象连接好电路上电后OLED屏幕没有任何显示或者STM32芯片发热。排查思路电源检查首先用万用表测量STM32核心板的3.3V和GND之间电压是否为3.3V左右。测量OLED的VCC引脚是否有3.3V。如果电压为0或很低检查USB线、USB转TTL模块的供电能力或者是否有短路。接线复查这是最高频的错误来源。逐根线核对特别是I2C的SDA和SCL是否接反OLED和STM32的I2C引脚是否对应PB6/PB7或PB8/PB9。蜂鸣器正负极是否接反。程序下载确认程序是否成功烧录到单片机。可以写一个最简单的LED闪烁程序测试一下核心板是否工作正常。OLED初始化确认OLED驱动代码中的I2C地址是否正确通常0x78或0x7A。尝试在初始化后调用清屏和显示测试字符的函数并检查这些函数是否被成功执行。5.2 ADC读数不稳定或始终为0问题现象串口打印的烟雾浓度值乱跳或者一直为0/4095。排查思路电平兼容再确认这是ADC问题的首要怀疑对象。用万用表测量MQ-2模块AO引脚对GND的电压。在洁净空气中电压应该是一个较低的值如0.1-0.5V。如果接近5V或0V检查传感器是否预热、是否损坏。确保这个电压不超过3.3VADC引脚配置确认STM32的PA0引脚配置为模拟输入模式GPIO_Mode_AIN而不是浮空输入或推挽输出。参考电压测量STM32的VDDA引脚通常与3.3V相连电压是否稳定。软件滤波ADC读数存在固有的噪声。可以在软件中实现滤波算法如滑动平均滤波维护一个数组存储最近N次采样值每次输出这N个值的平均值。这能有效平滑数据。#define FILTER_LEN 10 uint16_t adc_filter_buf[FILTER_LEN] {0}; uint8_t filter_index 0; uint16_t ADC_Filter(uint16_t new_value) { adc_filter_buf[filter_index] new_value; filter_index (filter_index 1) % FILTER_LEN; uint32_t sum 0; for(int i0; iFILTER_LEN; i) { sum adc_filter_buf[i]; } return (uint16_t)(sum / FILTER_LEN); }5.3 串口调试助手收不到数据或乱码问题现象电脑上的串口调试助手打开了对应COM口但看不到数据或者看到的是乱码。排查思路接线检查TX接RXRX接TX这是最容易接反的。确认USB转TTL模块的TX接STM32的PA10(RX)RX接PA9(TX)。共地检查确保USB转TTL模块的GND与STM32核心板的GND连接在一起。没有共地通信必然失败。波特率匹配检查STM32程序里USART的初始化波特率是否与串口调试助手设置的波特率完全一致如115200。串口助手设置数据位8停止位1无校验无流控。换一个串口助手软件如AccessPort、Putty试试有时是软件兼容性问题。代码检查确认USART_SendData函数发送的是单个字符而USART1_SendString函数正确遍历了字符串。检查发送的字符串末尾是否添加了\r\n。5.4 蜂鸣器不响或常响问题现象浓度超过阈值时蜂鸣器没反应或者一上电就响。排查思路驱动能力STM32的GPIO输出电流有限通常几mA到20mA。有源蜂鸣器工作电流可能较大可达30mA以上。直接驱动可能导致声音小或单片机复位。解决方案在GPIOPB8和蜂鸣器正极之间加一个NPN三极管如S8050或MOSFET如2N7002来驱动用单片机的IO口控制三极管的基极。电平逻辑确认你的代码逻辑。BEEP_ON()是置高电平还是低电平这取决于你的蜂鸣器模块是高电平触发还是低电平触发。用万用表测量蜂鸣器信号引脚在报警时的电压变化即可知。阈值设置检查你的alarm_threshold值是否合理。如果阈值设得太低可能一上电就报警设得太高则永远不报警。通过串口观察正常的smoke_value范围来调整。5.5 系统功耗与稳定性优化这是一个课后思考题。如果你希望这个设备能电池供电长期运行需要考虑功耗。降低采样频率烟雾浓度变化不会很快将采样和发送数据的频率从每秒2次降低到每5秒1次。使用停机模式在长时间无报警时让STM32进入低功耗的停机模式Stop Mode仅由外部中断如传感器数字输出DO变化或定时器唤醒。关闭不必要的外设在初始化时只开启需要用到的外设时钟ADC, I2C, USART, TIM。在进入低功耗前关闭OLED屏幕有专门的命令、蜂鸣器。硬件优化选择低功耗的LDO稳压器MQ-2传感器可以间歇性供电通过一个GPIO控制MOSFET来开关其电源因为它的预热时间很长不适合频繁开关。这个项目从硬件连接到软件调试涵盖了嵌入式开发中多个基础且重要的环节。当你成功看到OLED上跳动的数值听到超阈值时蜂鸣器的警报并在串口助手上看到规整的数据流时那种成就感是看多少遍教程都无法替代的。希望这份详细的拆解能帮你少走弯路顺利实现你的烟雾监测系统。代码虽然重要但调试过程中培养出来的硬件感觉和问题排查思路才是更宝贵的财富。
![[具身智能-649]：个人电脑搭建 RTSP 服务完整方案（Windows / Ubuntu 双平台，适配 RDK X5 rtsp2display 调试）](http://pic.xiahunao.cn/yaotu/[具身智能-649]：个人电脑搭建 RTSP 服务完整方案（Windows / Ubuntu 双平台，适配 RDK X5 rtsp2display 调试）)
