STM32环境质量监测系统这是我折腾了挺长时间的一套开源项目代码、原理图、仿真文件全部打包放出来了。整套东西不是那种只点个LED的demo而是把“传感器采集-数据处理-LCD显示-超限报警”这条完整链路都跑通的项目主控用STM32F103C8T6配DHT11温湿度、MQ-135空气质量传感器和0.96寸OLED屏还有完整的Proteus仿真工程你不需要先买一堆硬件直接在电脑上就能把逻辑跑起来看效果。整理这套资源的初衷很简单很多新手学STM32对着教程点灯、串口打印都还行一旦要做个带传感器的实际项目就不知道怎么串联了。环境质量监测正好是个经典切入点传感器种类多但都不难驱动软件上涉及GPIO、ADC、I2C、定时器、中断几乎把STM32的基础外设都用了个遍。无论你是准备毕业设计、电赛练手还是想给家里做个空气质量检测小设备这套东西都能直接上。下面把这套系统的设计思路、原理图细节、代码实现和调试踩坑完整梳理一遍。1. 项目全貌与设计思路1.1 环境质量监测系统到底在监测什么先搞清楚这套系统定位是什么。环境质量监测不是个标准化的功能集不同场景要监测的参数完全不一样。我这套做的是室内空气质量方向核心监测四项指标温度DHT11精度±2°C湿度DHT11精度±5%RH空气质量指数MQ-135模拟输出反映甲醛、烟雾、氨气等有害气体的整体污染水平预留PM2.5粉尘传感器接口GP2Y1010AU0F后期按需扩展选这几项是因为它们在室内场景下最能说明问题成本又压得住。整套传感器材料费不到30块钱对学生党很友好。MQ-135这个传感器特别适合做报警阈值判断它没法精确区分具体哪种气体超标但模拟电压值能反映空气污染的整体趋势家庭环境里监测二手烟、厨房油烟、装修异味够用了。系统的工作流程我画在代码主函数里了主循环每秒调度一次读取DHT11温湿度、采集MQ-135模拟电压转换出空气质量指数然后刷到OLED上。同时实时和三个阈值比较任意一项超标就打开蜂鸣器、点亮对应指示灯。三个物理按键负责切换OLED显示页面和调整阈值长按是页面切换短按是阈值加减。另外预留了USART1接口想接ESP8266模块上传数据的话直接接三根线就行。1.2 方案选型为什么是STM32 这些传感器这套方案不是随便拼的主控和传感器的搭配都对比过几轮。主控这边市面上常见的候选是Arduino Nano、ESP32和STM32F103C8T6。Arduino Nano最省事库函数封装得极好但问题也在这底层逻辑全部被库遮住了换个引脚、改个中断都要翻源码学习价值打折而且引脚资源少同时接OLED、DHT11、MQ模块加蜂鸣器按键IO就紧张了。ESP32性能强还带WiFi看起来香但芯片价格波动大调试工具链对新手也没那么友好。STM32F103C8T6正好卡在中间资料多到爆炸你遇到的问题网上几乎都能搜到答案教程里的坑大家都替新人踩过一遍了芯片和最小系统板都便宜自己画板也不难。传感器方面DHT11和DHT22我选了前者。DHT22精度确实高一个档次价格也贵一倍多但家用监测场景里DHT11的±2°C和±5%RH精度足够了衣服都看不清的误差在空气监测里根本不叫事。而且DHT11的时序容限比DHT22宽单总线协议里对延时精确度要求没那么苛刻软件模拟时序更容易调通这对新手特别重要。MQ-135是空气污染物传感器的性价比之王一个模拟电压输出搞定不需要复杂的数字协议搭配STM32内置12位ADC正好。OLED选SSD1306驱动的0.96寸屏I2C接口两线搞定软件端我写了一套精简驱动后面换成1.3寸屏或者SPI接口屏改动的代码量都很小。还有一个很关键的选型理由这些器件在Proteus里都有现成模型整个系统在仿真阶段就能完整跑起来不需要先焊板子再写代码。先仿真验证逻辑再动手做实物调试周期能缩短一半以上。这部分后面专门讲。2. 原理图设计与硬件细节2.1 最小系统板与电源电路设计要点如果你直接买市售的STM32F103C8T6最小系统板用原理图里只需要画外围传感器的连接。但既然开源带了完整原理图我建议还是花点时间看懂最小系统这部分因为只有吃透了电源、时钟、复位三要素后面排查问题才不至于抓瞎。电源这部分系统输入我用的USB 5V板上通过AMS1117-3.3稳压到3.3V给MCU和传感器共用电轨。AMS1117最大输出电流是1A这套系统算下来工作电流大约在230mA左右余量很充足。供电电流怎么估算的STM32F103C8T6全速运行加GPIO驱动大约50mAOLED模块工作时约20mADHT11平均不到1mAMQRQ-135加热器比较费电大概150mA它直接吃5V蜂鸣器30mA加总就是230mA这个量级。输入输出端我都加了10uF钽电容和0.1uF陶瓷电容做组合滤波电源入口再串一个500mA自恢复保险丝接错线不会直接烧板子。时钟部分STM32F103C8T6的HSE外部晶振我选了8MHz配两个22pF负载电容。晶振起振失败是STM32项目里比较隐蔽的问题一旦HSE起振不了系统卡死在启动代码里串口、LED全都没反应。所以原理图阶段就要注意晶振引脚间距短、走线尽量靠近芯片两个负载电容更要紧贴晶振引脚别把负载电容放到板子边缘。复位电路就是一个10K上拉电阻加0.1uF电容到地BOOT0通过10K电阻下拉到GND保证正常从Flash启动。我在不少帮人排查的板子上见过BOOT0悬空的情况轻则偶尔启动失败重则直接进不了用户程序这些看似基础的细节反而最容易出问题。2.2 传感器接口电路DHT11、MQ-135、OLED接线整套系统的引脚分配我列成了表格方便你对照原理图看功能模块MCU引脚接口类型关键连接说明DHT11温湿度PA1单总线数据线接一个4.7K上拉到3.3VMQ-135模拟输出PA0ADC通道0经电阻分压后进ADC避免5V直灌OLED屏幕PB6/PB7I2C1 SCL/SDA4.7K上拉电阻接3.3V蜂鸣器PB12GPIO推挽输出经SS8550三极管驱动LED指示灯PB13/PB14/PB15GPIO推挽输出分别是温度、湿度、空气超限指示按键PA8/PB0/PB1GPIO输入上拉页面切换、阈值减、阈值加ESP8266预留PA9/PA10USART1 TX/RX预留接口方便联网扩展DHT11是单总线器件数据线必须有上拉电阻。但这里有个坑如果你用的是现成的DHT11模块而不是裸芯片模块板上已经自带上拉电阻了原理图里再加一个4.7K就会变成并联等效电阻约2.35K边沿会被拉缓数据容易读错。所以我的做法是用模块就不再额外加上拉用裸芯片才加。这个细节我特意在仓库README里标红了。MQ-135的模拟输出脚接到PA0。模块的模拟输出最大能到5V而STM32的ADC采样范围是0到3.3V直接接轻则读数一直满量程重则损伤MCU引脚。原理图里我用两个电阻做了分压把0-5V映射到0-3.3V电压换算关系是V_mcu V_sensor * 3.3 / 5。如果你买的传感器模块本身输出范围不同按这个思路调整分压比就行。OLED屏是I2C协议SDA接PB7SCL接PB6这是I2C1的默认引脚。两根线各加4.7K上拉到3.3V。I2C是开漏协议上拉电阻是必须的它决定了总线的上升沿时间。模块板子上一般已经集成上拉自己画裸屏的话一定要补上。蜂鸣器驱动电路用了SS8550三极管PB12接1K基极限流电阻集电极接蜂鸣器负极、发射极接地。不能直接用GPIO驱动蜂鸣器STM32单个GPIO最大输出电流约20mA蜂鸣器正常工作要30mA以上推不动的。另外蜂鸣器是感性负载断电瞬间会产生反向电动势我反并联了一个1N4148二极管做续流泄放不然后级三极管容易被击穿。2.3 原理图设计中的几个容易踩坑的地方第一个坑是电源去耦。很多新手画原理图只关心连没连对把去耦电容当摆设。我在MCU每个VDD引脚旁边都放了0.1uF陶瓷电容而且要尽量靠近引脚放置。STM32F103在GPIO翻转频率高的时候瞬态电流变化很大没有去耦电容电源线上会出现明显毛刺轻则ADC读数抖动重则随机复位。电源入口处的10uF储能电容同样不能省它的作用是应对蜂鸣器这类大电流负载开关瞬间的电压跌落。第二个坑是模拟地和数字地的关系。MQ-135是模拟器件它出来的信号幅度很小如果GND走线上混着蜂鸣器、LED的高频开关电流ADC采样值会叠加上噪声。我建议在原理图阶段就把模拟部分的地网络标成AGND数字地标成GND后期Layout时单点汇接能显著减少读数波动。原理图阶段体现不了PCB布线但网络标号分清楚后面省很大功夫。第三个坑是ADC参考电压。STM32F103C8T6的VDDA和VREF引脚虽然都在芯片内部连到了3.3V但如果自己画板这路供电质量直接决定ADC精度。理想做法是VDDA通过一个磁珠或者小电阻从3.3V主电源单独引出来再并一个1uF电容。如果偷懒直接和数字电源连在一起ADC测量值的跳动会很明显。这个问题仿真里看不出来只有做实物才能体会。3. 软件架构与核心代码实现3.1 开发环境搭建Keil5、固件库、烧录工具软件部分我基于标准外设库开发的工程创建用的是Keil MDK5。为什么用标准库而不是HAL库标准库的函数基本就是寄存器操作的封装你可以清楚地看到GPIO_Init的每个参数对应哪些寄存器动作比直接操作寄存器好写又比HAL库透明得多适合学习。HAL库配合CubeMX图形化配置确实快但封装层多函数跳来跳去新手出问题时很难定位是配置问题还是时序问题。环境搭建三件事每一步都有坑我写细一点装Keil MDK5在Pack Installer里勾选STM32F1系列Device Support Package。装完在Pack列表里能看到STM32F103C8如果没有检查是不是Keil版本太老或者Pack包下载失败。安装路径不能有中文我帮人排查过一次诡异编译错误最后发现是Keil装到了中文目录编译器路径解析直接乱掉。建工程时芯片型号选STM32F103C8。这个型号的Flash是64KB如果选成C632KB Flash或者选成高密度型号编译能过但烧录后程序跑飞因为启动文件和链接脚本的存储布局不对。ST-Link驱动和烧录设置。接线只需要SWDIO、SWCLK、GND三根线下载速度设4MHz比较稳定。如果Keil提示找不到目标设备检查SWDIO/SWCLK有没有接反目标板有没有供电。我工程里的目录结构按模块拆分Core放main函数和中断处理Hardware放各传感器驱动System放延时函数和串口调试User放配置头文件。每个驱动文件都有详细注释头文件里写明初始化顺序和注意事项。这套命名和目录习惯是我从几个大公司开源项目里学来的代码量大了之后清晰的目录结构能省80%的找文件时间。3.2 DHT11时序驱动单总线协议怎么调通DHT11驱动是这套系统里调试成本最高的模块单总线时序需要精确控制单独拿出来讲。DHT11通信只有一根数据线协议流程是主机先把总线拉低至少18ms作为起始信号然后释放总线拉高DHT11响应后先拉低80us再拉高80us表示开始传输数据之后连续发送40bit数据顺序是湿度整数、湿度小数、温度整数、温度小数、校验和。每一位的编码是50us低电平然后高电平持续时间区分0和126到28us左右的高电平代表070us左右的高电平代表1。真正写代码时最麻烦的是测量每一位的高电平持续时间。我的实现思路是先等数据线为低然后等它变高记录这个时刻再从高变低时记录第二个时刻两个时刻之差就是高电平持续时间。为了避免本地延时不准我用SysTick提供的微秒级延时函数来稳住节奏uint8_t DHT11_ReadByte(void) { uint8_t i, value 0; for(i 0; i 8; i) { // 等待数据位低电平结束 while(GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) RESET); // 延时约40us后采样 Delay_us(40); if(GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) SET) { value | (0x80 i); } // 等待该位高电平结束为下一位做准备 while(GPIO_ReadInputDataBit(DHT11_GPIO_PORT, DHT11_GPIO_PIN) SET); } return value; }这段代码的原理读到引脚为高后延时40us再读一次。如果还是高说明高电平持续时间超过40us那这一位必然是1因为1的高电平在70us左右而0只有26-28us。如果40us后已经变低说明这是0。两次while等待的目的是把每一位的起始时间对齐避免位与位之间边界错位。我调试DHT11时踩过最大的坑是GPIO模式。数据线必须配置成开漏输出并带上拉不能是推挽输出。开漏模式下主机拉低时总线是低的释放时靠上拉电阻恢复高这样读引脚时波形干净。推挽输出时主机拉高写1会把外部传感器的低电平输出给钳住数据全乱。另一个坑是DHT11两次读取之间必须隔1秒以上它内部传感器采样频率就1秒一次读太频繁容易拿到旧数据或者直接通信失败。我在主循环里做了个1秒调度器每秒钟读一次显示刷新节奏也正好合适。3.3 MQ传感器与ADC采集从电压到浓度值的换算MQ-135输出的是模拟电压对应内部敏感材料电阻的变化气体浓度越高输出电压越偏向某个方向具体偏哪个方向取决于模块电路和灵敏度电位器的调节。我们要做的就是把电压映射成0到100的空气质量指数。ADC配置用的是ADC1通道012位分辨率。采样时间配置时我特意调长了把采样周期设置到239.5个周期虽然单次采样速度慢了但采样电容充电更充分读数更稳。每次读取做50次采样取平均这个数字是实测后定的少于30次噪声压不住多于100次又耗CPU影响其它任务。uint16_t ADC_GetAverage(uint8_t channel, uint8_t times) { uint32_t sum 0; uint8_t i; for(i 0; i times; i) { ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC) RESET); sum ADC_GetConversionValue(ADC1); Delay_us(10); } return (uint16_t)(sum / times); }拿到12位ADC值后换算电压的公式是电压 ADC值 × 3.3 / 4096。然后我用分段线性映射把电压转换成空气质量指数电压小于1.0V指数0到20对应空气质量优电压在1.0V到1.8V指数20到60对应良电压在1.8V到2.5V指数60到80对应轻度污染电压大于2.5V指数80到100对应重度污染这个分段不是拍脑袋定的参考了MQ-135手册里对不同气体的响应曲线。传感器个体差异大模块板的灵敏度电位器能调节输出范围所以实际部署时要先放在干净空气里标定一个基准电压再反向校准分段边界。我在代码里留了一个MQ135_Calibrate函数上电后长按按键3秒就能进入标定模式把当前电压作为空气质量指数20的基准这个功能在实物调试时特别好用。3.4 显示、报警与主流程整合OLED用的是SSD1306驱动I2C通信软件核心函数就四个初始化、清屏、显示字符串、显示数字。整个驱动我压缩到了一个oled.c里代码换屏适配时只需要改引脚和I2C逻辑。显示界面分了两页。第一页显示温度、湿度、空气质量指数字体用的大号数字字体方便远距离读第二页显示三类报警阈值支持按键调整。页面切换逻辑用了一个变量page按键中断里翻转它主循环里根据page值选择刷新哪个页面。报警逻辑用结构体管理状态比零散变量清晰得多typedef struct { float temperature; float humidity; uint16_t air_quality; uint16_t temp_threshold; uint16_t hum_threshold; uint16_t air_threshold; } Monitor_State;主循环是个典型的状态机检测按键、读取传感器、更新OLED、判断阈值、输出报警。每次数据刷新后温度、湿度、空气质量三个值分别和阈值比较任意一个超标蜂鸣器响一声同时点亮对应颜色的LED。蜂鸣器的触发我做成了“超限只响3秒”的模式防止一直响着烦人实测下来比持续报警合理得多。延时系统用的SysTick在main函数里初始化。SysTick是Cortex-M3内核自带的定时器它提供的延时精度比传统的软件空循环高一个量级而且不占通用定时器资源。DHT11时序和OLED时序控制里都依赖它。使用SysTick时注意一个细节如果你在debug模式下单步执行延时会因为断点导致的时钟停止而失真DHT11读到乱码不要慌全速运行再看结果。4. 仿真验证与实物调试实录4.1 Proteus仿真搭建模型选择与运行要点Proteus 8以上版本自带STM32F103C8T6模型仿真环境搭建不难。从元件库拉出STM32F103C8T6、DHT11、SSD1306 OLED、电位器、按键、LED、蜂鸣器按照原理图连线加载编译好的hex文件就能跑。先说几个Proteus里容易忽略的设置。STM32模型默认时钟要手动设置我在模型属性里把HSE晶振频率设成8MHz和实物一致。代码里如果用了SystemInit启动文件时钟从外部晶振起振仿真里也必须保持一致否则OLED刷新率和DHT11时序都会异常。加载程序的方式是双击STM32芯片在Program File里选编译生成的hex文件。DHT11在Proteus里的模型是简化版它不模拟真实的信号翻转细节但通信协议是兼容的我用同一个DHT11驱动代码在仿真里能正常读出温湿度说明驱动逻辑本身没问题。OLED显示这块Proteus的SSD1306模型对I2C时序比较敏感如果I2C时钟频率设高了仿真里屏幕会出现花屏或白屏。我把I2C时钟配置在100KHz标准模式后仿真和实物都能稳定工作后期就没再动过这个配置。MQ-135在Proteus没有现成模型我用电位器模拟这是这类仿真比较常规的替代方案。电位器中间抽头输出电压到PA0仿真运行时双击电位器改变阻值ADC输入电压就会变化空气质量指数跟着变。这种方法虽然代替不了真实传感器的响应曲线但能完整验证ADC采集、阈值判断、报警输出整条逻辑链路。4.2 代码与仿真联调时的动态验证思路仿真不只是“看看能不能跑”我的习惯是在仿真里做三类逻辑测试大多数软件bug能在这个阶段暴露掉第一类阈值报警测试。把电位器阻值从低到高慢慢调观察OLED上空气质量指数的变化到了阈值附近看蜂鸣器有没有触发、LED有没有亮。这套测试能验证ADC采样、阈值比较、报警输出三个模块的协同逻辑。为了方便观测内部状态我在串口调试代码里加了一行输出把ADC原始值、电压值、指数值一起打出来仿真里的虚拟终端直接看数据流。第二类时序边界测试。故意把主循环里的延时时间改大改小比如DHT11读取间隔从1秒改到500ms观察仿真里通信是否依然稳定从而判断驱动代码的时序裕量。这类测试在实物上做很费劲在仿真里只是改一行代码的事。第三类按键交互测试。Proteus的按键元件可以点击操作验证页面切换、阈值增减逻辑是否正常。这比实物接按键跳线调试快多了。做完这三类测试代码里80%的逻辑错误基本都过了一遍剩下20%才是硬件层面特有的问题。4.3 实物调试中遇到的典型问题与解决实际焊接调试过程中踩了几个坑记录在这里不蒸馒头争口气希望各位不要重走。第一个坑是OLED白屏。现象程序下载正常OLED没反应。排查过程先用示波器量I2C总线的SDA和SCL发现SCL有波形SDA一直是高电平明显是I2C地址不对。查模块资料我的OLED模块地址是0x3C代码里配置的却是0x3D。SSD1306的I2C地址有两种0x3C和0x3D由模块背面一个电阻决定很多人买模块不看丝印就默认0x3C结果白屏。改成0x3C后正常。第二个坑是ADC值上下剧烈漂移。现象空气质量指数在20到60之间来回跳肉眼看着都晕。最先怀疑是传感器输出本身波动但用万用表量模块输出脚电压很稳定问题出在电源上。我用了一根劣质USB线供电压降和纹波都大MCU的ADC参考电压跟着抖采出来的值自然不稳。解决办法是在电源入口多并一个100uF电解电容又把传感器模拟输出线改成屏蔽线漂移问题基本消失。仿真里永远重现不了这种问题这算是实物的独有体验。第三个坑是DHT11偶发读取失败。现象大部分时间正常但偶尔读出来值是255或0加了校验和判断之后依然偶发。排查到最后发现是中断干扰。因为DHT11单总线时序对时间精度敏感在读取过程中如果有定时器中断打断延时就被拉长了时序就乱了。解决办法是在读取DHT11的关键时序段屏蔽中断读完再打开__disable_irq(); // 执行DHT11完整读取时序 __enable_irq();这个操作对实时性要求不高系统本身没有严格的中断响应硬指标所以屏蔽中断没有任何负作用。这类并发问题在仿真里完全看不出来因为仿真不模拟中断的精确时序行为只有实物上才会遇到。这也是为什么我一直强调“仿真验证逻辑、实物验证时序”的调试理念。问题排查这块我整理了一张速查表放仓库里方便对照异常现象可能原因排查手段OLED白屏I2C地址错误量总线波形确认模块地址0x3C/0x3DOLED显示乱码I2C速率过高降到100KHz标准模式DHT11全0上拉电阻缺失或失效检查数据线到VCC的上拉DHT11全1GPIO模式配置错改成开漏输出带上拉DHT11偶发失败中断干扰时序读取期间关中断ADC读数剧烈跳动电源纹波大电源入口加电容模拟走线改屏蔽ADC读数一直4095输入电压超过3.3V检查分压电路是否接好蜂鸣器不响GPIO驱动电流不足换三极管驱动电路程序下载后无反应BOOT0悬空检查BOOT0下拉电阻5. 开源仓库内容说明与扩展方向5.1 仓库目录与文件清单开源包解压后的目录结构是这样的/SoftwareKeil5完整工程MDK5.35及以上版本可直接编译下载/Hardware原理图PDF和Altium Designer源工程/SimulationProteus 8仿真工程文件双击即可打开运行/Doc调试笔记、BOM物料清单、接口连接表/Doc/调试笔记.md记录几次重大调试过程和最终解决方案就是我上面写的这些坑的原始版本拿到压缩包后建议按这个顺序操作先看原理图理解电路连接关系然后在Proteus里加载仿真工程跑一遍感受系统行为最后再焊实物、烧程序。这个顺序能帮你提前建立对代码行为的预期实物出问题时知道该往哪个方向排查。仓库里的代码不是我临时整理的那种每个文件都写了文件头注释主要函数有参数和返回值说明关键代码段有逻辑解释。BOM清单里标注了器件型号、封装、采购参考价照着买就能凑齐一套。5.2 可以怎么扩展这套系统这套系统本质上是完整的数据采集和报警闭环硬件接口和代码架构都预留了扩展位往前走的空间很大。第一个扩展方向是联网。USART1接口已经引出接一个ESP8266模块AT指令就能把温湿度、空气质量推送到云平台或者手机。我给这套代码写过一版简单的AT指令封装通过串口printf一行JSON数据出去配合ESP8266的透传模式就能实现代码量不大很适合继续深挖。第二个方向是组网监测。用LoRa或者蓝牙把多套设备连起来能实现教室、办公室这类空间的空气质量分布图。每个节点在上位机里用不同颜色标记哪里超标一目了然。这算是从“单点监测”到“区域监测”的升级需要的硬件不多主要工作在PC端软件和数据融合算法上。第三个方向是主控升级。如果后续想省掉外部联WiFi的麻烦可以直接换到ESP32代码移植工作量不大传感器驱动基本原封不动只改I2C、ADC、串口的初始化层。不过我的建议是在把STM32这套基本功吃透之前先别急着换平台。传感器、单总线时序、ADC采样、中断达成这些能力是通用的换个平台只是换个外壳核心原理完全一致。我也考虑过要不要把设备做成产品级的完整形态加上WiFi模块和数据后台。但最终还是决定保持现在这个“教学与DIY友好”的定位因为第一版发布的目的就是让任何人能照着复现而不是被功能复杂度劝退。先把底子打好扩展都是水到渠成的事。我自己把整套设备放在办公桌上连续跑了一个月除了中间有一次USB供电接触不良导致单片机复位之外其余时间都很稳定。最满意的部分是MQ-135的阈值标定功能焊好板子后长按按键3秒它自动把当前环境的污染水平标记为基准再也不用靠肉眼猜电位器该拧到哪个位置了。这套项目后续我计划补充一版ESP8266联网的扩展教程如果你在做实物的时候遇到什么问题欢迎拿着原理图和代码交流很多问题拖到具体环境里看往往都很简单。