简介本资源是一套基于STM32F103C8T6的嵌入式物联网检测系统完整开发包面向嵌入式初学者、课程设计学生及智能家居项目实践者解决温湿度与烟雾多参数采集、WiFi远程监控及本地联动控制如LED加热模拟、蜂鸣器报警、电器开关等典型应用场景问题。压缩包共105个文件涵盖39个C源文件与38个头文件构成Keil工程主体、6个PDF器件手册、原理图.schdoc与PCB图.pcbdoc、可直接安装的Android APK应用、HEX固件、BOM清单.xlsx及实物图.jpg总大小26.33MB。已有3071人学习下载内容结构完整从硬件设计含LED/蜂鸣器/传感器接口逻辑、底层驱动ADC、USART、I2C、TIM等标准外设库调用、WiFi通信协议对接到APP双向交互均提供可运行代码与配套文档特别适合开展嵌入式软硬协同开发实训与毕业设计参考。1. 项目概述与核心价值最近在整理过去的项目资料翻到了一个基于STM32的温湿度和烟雾检测系统感觉挺有代表性的。这玩意儿说白了就是一个集成了多种传感器的环境监测终端核心是STM32单片机搭配DHT11或DHT22温湿度传感器和MQ-2烟雾传感器实时采集环境数据并通过OLED屏显示或者串口上传。听起来是不是挺简单的但就是这么个“简单”的项目从选型、电路设计、代码调试到最终稳定运行里面能踩的坑、能学到的门道可一点都不少。无论是刚接触STM32的新手想找个综合性的练手项目还是有一定经验的工程师需要快速搭建一个可靠的环境监测节点这个方案都值得深入琢磨一下。它的核心价值在于将一个具体的应用需求监测环境分解成了单片机开发中几个最经典的模块GPIO控制传感器驱动、ADC采样模拟信号处理、定时器精准延时或PWM、通信接口UART/I2C/SPI用于显示或上传。通过完成它你不仅能学会如何让STM32“干活”更能理解一个嵌入式产品从想法到实物的完整闭环。市面上很多开发板配套的例程往往是零散的而这个项目能帮你把知识点串起来。接下来我就结合自己实际做这个项目时的经历从设计思路、硬件选型、软件实现到调试心得完整地拆解一遍。2. 整体设计与硬件选型解析2.1 核心需求与方案定调做任何项目第一步永远是明确需求。我们这个“温湿度和烟雾检测”系统核心需求就三条第一能准确、稳定地测量环境的温度和湿度第二能有效检测空气中的可燃气体或烟雾浓度通常以模拟量形式反映第三能将结果直观地呈现出来。基于这三点方案的大框架就出来了主控传感器显示/输出。为什么选择STM32对于这个级别的应用STM32系列尤其是STM32F1系列如STM32F103C8T6也就是常说的“蓝桥杯”或“最小系统板”核心性价比和生态支持是无敌的。它拥有足够多的GPIO、ADC通道、定时器和通信接口社区资料和海量例程能让你在遇到问题时快速找到参考。相比8位单片机它的性能足以应对更复杂的算法比如简单的滤波或校准相比更高级的MPU它又避免了操作系统的复杂性让开发者能更专注于底层硬件和传感器逻辑。2.2 传感器选型背后的考量传感器是项目的“感官”选型直接决定数据的质量。温湿度传感器DHT11 vs DHT22 vs SHT30最常见的入门选择是DHT11单总线通信价格极低。但它精度一般温度±2°C湿度±5%RH响应慢且代码里需要处理严格的时序。我最初用的就是DHT11实测在室内环境还行但如果你对精度有要求比如用于仓储或实验室环境DHT22AM2302是更好的选择精度更高温度±0.5°C湿度±2%RH。如果项目预算更充足且考虑I2C数字接口的便利性和稳定性像SHT30这类传感器会是更专业的选择它内部有校准抗干扰能力更强但价格也贵不少。对于学习和大多数应用场景从DHT11入手完全没问题它能让你深刻理解单总线协议的精髓——那种对微秒级延时要求严格的“握手”过程。烟雾/气体传感器MQ-2及其家族MQ-2是检测可燃气体、烟雾的模拟量传感器。它价格便宜灵敏度可调通过板载电位器输出的是模拟电压信号浓度越高电压越高。这里有个关键点MQ-2对多种气体氢气、液化气、甲烷、烟雾等都有响应是非特异性传感器。所以它更适合做“有无”或“浓度变化趋势”的定性或半定量报警而不是精确测定某种特定气体浓度。它的预热时间较长通电后需要1-2分钟稳定且受环境温湿度影响这些特性必须在软件设计中考虑进去。如果项目需要检测特定气体比如一氧化碳那就需要选择像MQ-7这类针对性更强的传感器。2.3 外围电路与显示单元设计电源与ADC参考电压STM32的ADC参考电压VREF直接影响采样精度。如果使用开发板通常VREF会连接到3.3V。那么MQ-2的输出电压范围通常0-5V就需要通过电阻分压电路降到0-3.3V以内再送入STM32的ADC引脚。一个简单的两个电阻分压网络就能解决但要注意阻抗匹配和滤波可以在分压点对地加一个0.1uF的电容滤除高频噪声。显示方案OLED vs LCD vs 串口打印为了直观我选择了0.96寸的OLED屏SSD1306驱动I2C接口。它功耗低、显示对比度高且I2C接线简单仅需SCL、SDA两根线。比起并口LCD节省了大量GPIO。在代码中你需要移植一个OLED的驱动库用于显示文字和数字。如果只是为了调试完全可以用串口UART将数据打印到电脑的串口助手如Putty、XCOM上查看这样更简单但少了点“产品”的感觉。报警输出一个完整的检测系统通常需要报警功能。可以通过STM32的一个GPIO引脚控制一个蜂鸣器有源蜂鸣器直接给高电平就响无源的则需要PWM驱动和一个LED。当烟雾浓度超过设定的阈值时触发声光报警。阈值不是固定值需要根据实际应用环境通过实验来校准设定。3. 软件开发环境搭建与核心驱动实现3.1 开发环境抉择HAL库 vs 标准库STM32编程绕不开库的选择。标准库Standard Peripheral Library经典、直接寄存器操作感强很多老教程都用它。但ST官方已停止更新对新芯片支持不足。HAL库Hardware Abstraction Layer是ST现在主推的硬件抽象程度高代码可移植性好配合STM32CubeMX图形化工具能快速生成初始化代码极大提升开发效率。对于新手和需要快速迭代的项目我强烈推荐从HAL库入手。虽然它的代码效率可能稍低代码量看起来“臃肿”但对于我们这个项目来说这点开销完全可以接受。CubeMX能帮你配置好时钟树、GPIO模式、ADC、I2C、UART等避免手动配置寄存器时容易出现的低级错误。我的选择是STM32CubeMX Keil MDK或VSCode ARM GCC工具链。CubeMX生成初始化代码Keil用于编写业务逻辑和调试。用VSCode编辑体验更好但调试配置稍复杂。对于初学者Keil的一体化环境更友好。3.2 DHT11单总线驱动详解DHT11的通信协议是项目的第一个难点。它只有一根数据线双向通信严格依赖时序。通信时序拆解主机STM32启动信号拉低数据线至少18ms然后拉高20-40us随后释放总线设置为输入模式等待从机DHT11响应。从机响应DHT11检测到起始信号后会拉低总线80us再拉高80us表示准备发送数据。数据传输每一位数据都以一个50us的低电平起始位开始随后的高电平持续时间决定数据是026-28us还是170us。一共传输40位数据16位湿度整数16位湿度小数16位温度整数16位温度小数8位校验和通常小数部分为0。代码实现关键点精准延时时序要求微秒级。不能直接用HAL_Delay()那是毫秒级的。有两种方法一是使用STM32的定时器生成精确的微秒延时二是使用SysTick定时器或简单的for循环空指令需要根据主频校准。我常用一个基于SysTick的微秒延时函数在系统初始化后配置好。总线状态读取在等待从机响应和数据位时需要循环读取GPIO引脚电平并加入超时判断防止程序死等。数据解析连续读取40个位组合成5个字节。最后校验前4个字节的和是否等于第5个字节校验和。注意DHT11对时序极其敏感中断、其他高优先级任务可能会干扰时序。在读取DHT11期间最好暂时关闭全局中断或者确保没有其他操作占用同一个GPIO引脚。这是我调试时踩过的一个坑数据偶尔会乱码原因就是被定时器中断打断了。3.3 MQ-2的ADC采样与软件滤波MQ-2输出模拟电压我们需要用STM32的ADC将其转换为数字值。ADC配置要点通道与模式在CubeMX中使能ADC1选择连接MQ-2输出脚的通道如PA0。模式选择“独立模式”扫描和连续转换模式根据需求定。对于单通道可以不用扫描开启连续转换让ADC一直在后台工作需要时直接读取值即可。采样时间适当增加采样时间可以提高精度尤其是信号源阻抗较高时。对于分压后的MQ-2信号设置一个中等偏长的采样时间如239.5个周期。DMA可选如果系统需要同时采样多个传感器比如未来扩展多个气体传感器或者需要高频采样强烈建议使用DMA。它能将ADC转换结果自动搬运到内存数组中不占用CPU。对于当前单通道、低速采样的场景用查询或中断方式也够用。软件滤波算法ADC采样值会存在波动和噪声。直接使用单次采样值来判断浓度极易误触发。必须加入滤波。简单移动平均维护一个数组存储最近N次采样值取平均值作为最终结果。实现简单能有效平滑随机噪声。中值滤波取最近N次采样值的中位数。对脉冲性干扰偶发的尖峰有很好的抑制作用。一阶滞后滤波低通滤波本次结果 α * 本次采样值 (1-α) * 上次结果。α是滤波系数0α1α越小滤波越强响应越慢。这种方法占用内存小适合实时性要求高的场合。我通常采用“移动平均阈值比较”的组合。连续采样10次排序后去掉最大最小值防止极端值再对剩下的取平均得到一个相对稳定的AD值。然后根据这个AD值通过一个简单的线性或分段线性公式映射为浓度百分比或等级。3.4 OLED显示与数据融合OLED驱动通常使用现成的开源库如ssd1306或u8g2的简化版。你需要根据使用的I2C地址通常是0x78或0x7A修改库中的配置。在程序中创建一个显示任务或函数定期比如每秒刷新屏幕内容。显示内容可以设计为---------------- Temp: 25.6 C Hum: 45.8 % Smoke: 0123 [LOW] ----------------其中“Smoke”后面的数值是滤波后的ADC原始值或计算出的浓度百分比[LOW]、[MID]、[HIGH]或[ALARM]是根据阈值判断的等级。数据同步问题温湿度读取DHT11耗时较长几十毫秒而ADC采样很快。不要让OLED刷新函数等待DHT11读取完成这会导致显示卡顿。应该将传感器数据读取和显示刷新解耦。例如在主循环中以不同的周期执行不同任务每2秒读一次DHT11每100ms采样一次ADC并滤波每500ms刷新一次OLED。刷新时只是去显示最新的、已经存储在变量中的结果。4. 系统整合与主程序逻辑架构4.1 外设初始化与CubeMX配置使用STM32CubeMX进行可视化配置是事半功倍的第一步。选择芯片型号例如STM32F103C8T6。配置时钟树RCC选择外部高速时钟HSE并将系统时钟SYSCLK设置为最高72MHz对于F103这是性能的保障。配置GPIODHT11数据引脚设置为推挽输出启动时和上拉输入通信时。CubeMX中可以在代码里动态切换模式。MQ-2 ADC引脚例如PA0模拟输入模式。OLED的I2C引脚例如PB6(SCL), PB7(SDA)设置为复用开漏输出Alternate Function Open Drain并使能内部上拉。蜂鸣器/LED引脚推挽输出。串口引脚如果用于调试例如PA9(TX), PA10(RX)异步模式。配置ADC选择通道0对应PA0设置独立模式右对齐开启连续转换模式。采样时间可以设为239.5周期。配置I2C选择I2C1标准模式100kHz或快速模式400kHz。OLED一般100kHz足够。配置定时器可选可以配置一个基本定时器如TIM2用于产生精确的微秒延时或者用于系统心跳。生成代码选择MDK-ARMKeil工具链生成初始化代码。4.2 主程序状态机与任务调度一个清晰的主程序结构能让代码易于维护和扩展。对于没有RTOS的裸机程序我推荐使用一个简单的“超级循环状态机/时间片”架构。int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_ADC1_Init(); MX_I2C1_Init(); MX_USART1_UART_Init(); // 初始化OLED、传感器状态变量等 uint32_t tick_dht11 0, tick_adc 0, tick_display 0; const uint32_t interval_dht11 2000; // 2秒读一次温湿度 const uint32_t interval_adc 100; // 100ms采样一次ADC const uint32_t interval_display 500; // 500ms刷新一次显示 while (1) { uint32_t current_tick HAL_GetTick(); // 获取系统毫秒时钟 // 任务1定时读取DHT11 if (current_tick - tick_dht11 interval_dht11) { tick_dht11 current_tick; DHT11_ReadData(temperature, humidity); // 阻塞式读取内部有延时 } // 任务2定时ADC采样与滤波 if (current_tick - tick_adc interval_adc) { tick_adc current_tick; raw_adc HAL_ADC_GetValue(hadc1); // 获取ADC值 filter_adc_value(raw_adc); // 送入滤波函数 check_alarm(get_filtered_adc()); // 检查是否超阈值 } // 任务3定时刷新显示 if (current_tick - tick_display interval_display) { tick_display current_tick; OLED_Show(); // 显示函数内部调用OLED驱动显示最新变量值 } // 其他任务如处理串口命令等 // ... } }这种结构避免了在while(1)里使用HAL_Delay()导致整个程序阻塞的问题让多个任务得以“并行”执行。虽然简单但对于此类小型监测系统非常有效。4.3 报警逻辑与输出控制报警逻辑需要避免频繁误报。例如当烟雾浓度ADC值超过阈值ALARM_THRESHOLD时不要立即报警而是启动一个“确认计时”。只有当浓度在连续几次检测比如3次中都超过阈值才判定为真实报警触发蜂鸣器和LED。同样当浓度回落到阈值以下时也需要连续几次检测都低于阈值才解除报警。这种迟滞比较Hysteresis能有效防止临界点抖动造成的报警器“滴滴答答”乱响。报警输出控制可以直接操作GPIOvoid set_alarm(bool state) { if (state) { HAL_GPIO_WritePin(BUZZER_GPIO_Port, BUZZER_Pin, GPIO_PIN_SET); // 蜂鸣器响 HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET); // LED亮 } else { HAL_GPIO_WritePin(BUZZER_GPIO_Port, BUZZER_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); } }5. 调试技巧、常见问题与优化方向5.1 硬件调试排坑实录DHT11无响应或数据全零检查接线确保VCC、GND、DATA线连接正确且牢固。DHT11的VCC是3.3V还是5V数据手册说5V但很多3.3V系统也能驱动不过为了稳定建议接5V如果MCU是3.3VDATA脚需要电平匹配或确认DHT11兼容3.3V。检查上拉电阻DATA线必须接一个4.7kΩ - 10kΩ的上拉电阻到VCC这是协议要求的很多模块已经集成。检查时序用逻辑分析仪或示波器抓取DATA线上的波形对照DHT11时序图看启动信号、响应信号和数据位是否正常。这是最直接的调试方法。如果没有仪器可以尝试调整微秒延时函数的精度稍微拉长启动信号的低电平时间比如从18ms调到30ms。ADC采样值跳动大电源噪声确保给STM32和MQ-2的电源是干净的。可以在电源入口处加一个大电容如100uF和一个小电容0.1uF并联滤波。参考电压不稳检查VREF引脚是否连接了稳定的3.3V并且对地接了去耦电容。信号线干扰MQ-2的输出信号线应尽量短远离MCU的晶振、数字开关信号线等噪声源。软件滤波如前所述必须加入软件滤波。先通过硬件手段尽量降低噪声再用软件滤波平滑。OLED不显示I2C地址错误最常见的坑。SSD1306的I2C地址可能是0x78写地址或0x7A。在驱动代码里尝试修改一下。用逻辑分析仪抓I2C总线看起始信号后发送的地址字节是什么。初始化序列OLED上电后需要发送一系列初始化命令才能正常显示。确保你的驱动代码包含了完整的初始化流程。电源确认OLED模块供电正常3.3V或5V看模块要求。5.2 软件调试与优化心得利用串口打印调试信息这是嵌入式调试的“万能钥匙”。在关键节点如DHT11读取前后、ADC采样后、报警触发时通过printf重定向到串口打印变量值、状态标志。可以快速定位问题出在哪个环节。合理使用断点和单步调试在Keil中对于时序要求不严的代码段如数据处理、显示更新可以设置断点观察变量。但对于DHT11通信、I2C通信等严格时序的部分禁用断点否则会破坏时序导致失败。功耗考虑如果项目是电池供电需要考虑低功耗。可以在主循环中加入__WFI()指令让CPU进入睡眠模式通过定时器中断唤醒执行采样任务。同时不采样时关闭ADCOLED也可以设置为休眠模式。扩展性思考这个系统的框架很容易扩展。比如可以增加一个ESP8266 WiFi模块通过AT指令将数据上传到云平台如OneNET、阿里云可以增加一个SD卡模块实现数据本地存储可以改用精度更高的SHT35温湿度传感器可以增加多个MQ系列传感器检测不同气体。5.3 校准与阈值设定这是让项目从“能工作”到“好用”的关键一步。MQ-2的阈值不能拍脑袋决定。简易校准流程将系统置于洁净空气中室外或通风良好的室内运行一段时间等待MQ-2预热稳定记录下此时ADC的平均值作为“洁净空气基准值”V_clean。制造一个可控的测试环境注意安全在通风、无明火、有监护的条件下进行例如在传感器附近轻轻喷一下酒精模拟酒精蒸汽或点燃一支香然后吹灭模拟烟雾观察ADC值上升到的峰值取一个安全系数比如峰值的70%作为报警阈值V_alarm。在程序中将(V_alarm - V_clean)的一个比例例如50%设为预警阈值V_warning。最终你的报警逻辑可以是ADC值 V_warning: 状态正常显示[LOW]。V_warning ADC值 V_alarm: 状态预警显示[MID]LED慢闪。ADC值 V_alarm: 状态报警显示[HIGH]或[ALARM]触发声光报警。通过这样一个完整的项目实践你收获的不仅仅是一个能检测温湿度烟雾的小设备更是一套嵌入式系统开发的方法论从需求分析、方案选型、硬件设计、软件架构、驱动编写到系统调试与优化。每个环节的细节都值得反复推敲而解决其中遇到的各种问题正是能力提升最快的过程。本文还有配套的精品资源点击获取