做嵌入式开源项目这几年我越来越觉得真正有价值的不是把代码跑通而是把一个系统从需求到落地完整地拆开给人看。这次开源的粮仓环境安防监测系统就是这样一个项目——基于STM32F103C8T6集成了温湿度采集、烟雾检测、火焰预警、红外防盗和自动通风控制配合LCD实时显示和声光报警不管是拿来做毕业设计、课程设计还是想入门STM32实战开发都有很高的参考价值。项目资料包含完整的源码工程、可生产的原理图以及Proteus仿真文件全部开源免费你可以直接下载、复现、二次开发。我先把这套系统的整体定位说清楚它解决的不仅仅是“采集几个环境参数”的问题而是把传感器数据采集、状态判断、执行控制、人机交互和异常报警串成了一条完整的嵌入式产品链路。对于刚接触STM32的初学者这套代码能让你少走至少两个月的弯路对于已经有一定基础的朋友这套系统的模块化设计思想和可靠性处理手段也值得抄一抄作业。1. 系统设计思路为什么是这套方案1.1 核心需求解析粮仓到底需要监测什么粮仓环境安防不是一个模糊的“要监测环境”的需求拆开来看实际要解决的是四个具体问题第一个问题是温湿度失控。粮食储存对温湿度极其敏感温度过高容易引起粮食发热、霉变湿度过大则会导致结露、生虫。按照储粮技术规范粮堆温度一般应控制在15-20摄氏度以下相对湿度应控制在65%-75%之间超出这个范围就必须启动通风或除湿设备。第二个问题是火灾隐患。粮仓内粉尘浓度高电气线路老化或人为疏忽都可能引发火灾烟雾和火焰的早期发现非常关键。注意粮仓火灾最可怕的不是明火而是阴燃——初期往往只有烟、没有明显火焰所以烟雾检测和火焰检测必须双管齐下。第三个问题是非法入侵。粮仓通常位于郊区或农村夜间安防力量薄弱防盗是不可忽视的刚需有人非法闯入时需要第一时间报警。第四个问题是远程告警不及时。传统粮仓管理靠人工巡检发现问题时往往已经造成损失。这个系统虽然不追求复杂的物联网云端联动但至少要能在现场通过LCD屏幕实时展示数据并通过蜂鸣器和LED灯实现本地声光报警让巡检人员第一时间发现问题。1.2 主控选型与传感器搭配的底层逻辑主控我选了STM32F103C8T6也就是大家常说的“C8T6蓝板”。这颗芯片在嵌入式圈子里几乎是“国民级”的存在72MHz主频、64KB Flash、20KB SRAM在这个项目中性能绰绰有余。选择它的核心原因有三个资料极其丰富踩坑成本低引脚兼容性好后面想升级到F103RCT6或者移植到GD32、AT32都很方便价格便宜损坏了不心疼。传感器的选型遵循“稳定大于性能、接口简单、便于教学”的原则温湿度用DHT11。我知道很多人会吐槽DHT11精度一般但在这个项目里它有一个无可替代的优势单总线协议代码实现简单非常适合用来讲解时序驱动的原理。如果你觉得精度不够后期可以直接替换成DHT22或SHT30代码改动量并不大。烟雾检测用MQ-2烟雾传感器模块。它输出的是模拟电压信号正好可以配合STM32的ADC外设来采集一个模块同时解决了气体检测和ADC实战两个学习点。火焰检测用带数字输出的火焰传感器模块检测范围可调输出低电平表示检测到火焰逻辑简单可靠度高。人体入侵用HC-SR501人体红外传感器也就是常说的PIR传感器。它输出的是数字电平人靠近时输出高电平可以直接接GPIO读取。这套传感器组合覆盖了“环境参数采集”“安全隐患检测”“安防入侵检测”三条线每一路都有不同的接口类型单总线、模拟量、数字量对学习STM32的外设使用非常友好。1.3 系统架构与工作流程整个系统的工作流程可以概括为“一采二判三控四报”系统上电后STM32首先完成外设初始化和传感器自检LCD显示开机界面。随后进入主循环定时采集DHT11的温湿度数据通过ADC读取MQ-2的烟雾浓度值同时轮询火焰传感器和红外传感器的电平状态。采集到的数据会同步刷新到LCD1602屏幕上。在数据判断环节系统设定了多级阈值。温湿度超过设定上限时自动开启风扇进行通风降温除湿烟雾浓度超过阈值、检测到火焰或有人闯入时立即触发声光报警。报警状态具有自锁特性也就是报警一旦触发必须人工按键复位避免危险解除后系统仍然持续报警造成误判。2. 硬件原理图拆解每一根走线都有讲究2.1 最小系统板设计要点原理图的核心是STM32最小系统包括电源电路、晶振电路、复位电路、BOOT启动配置和SWD下载接口。电源方面系统整体使用5V供电经过AMS1117-3.3稳压芯片转换为3.3V给STM32供电。很多新手在这里容易犯一个错误直接拿5V给STM32供电或者把5V接到3.3V引脚上轻则芯片发烫重则直接烧毁。AMS1117的输入输出端各加一个10uF电解电容和100nF陶瓷电容做滤波这个组合是经验值能够有效抑制电源纹波。晶振电路使用8MHz无源晶振配合两个20pF负载电容。这里有一个细节值得注意STM32F103的RTC实时时钟需要独立的32.768kHz晶振但这个项目不需要掉电计时功能所以没有画RTC晶振电路。如果你后面想加时间戳记录报警事件需要补上这个部分。复位电路采用经典的10K上拉电阻加100nF电容的方案低电平复位。BOOT0和BOOT1都通过10K电阻下拉到地确保芯片从Flash启动这是最常规的启动模式。SWD下载接口只引出4根线SWDIO、SWCLK、GND、3.3V。相比JTAG的20针接口SWD只需要两根信号线就能完成下载和调试省引脚、占用面积小是小型嵌入式项目的首选。2.2 传感器接口电路数字、模拟、单总线全覆盖DHT11的数据引脚是开漏输出使用时必须接一个4.7K上拉电阻到3.3V这样才能保证通信时电平变化是正常的。很多人DHT11读取失败排查到最后发现就是忘了加上拉电阻或者上拉电阻接到了5V上。MQ-2模块的AO口模拟输出直接接到STM32的PA1引脚该引脚复用为ADC1的通道1。要注意的是MQ-2模块上电后有一个预热过程前几十秒输出的电压会偏高代码里需要做“上电延时数据稳定判断”处理否则开机瞬间可能误报烟雾浓度超标。火焰传感器模块和HC-SR501红外模块都是数字输出分别接到PA4和PA5。这两个模块的供电都是5V但输出电平是3.3V兼容的可以直接接STM32的GPIO不需要额外做电平转换。蜂鸣器电路使用的是有源蜂鸣器通过一个NPN三极管S8050驱动STM32的PB12引脚输出高电平时三极管导通蜂鸣器发声。很多人会问为什么不直接用STM32引脚驱动蜂鸣器因为STM32的GPIO输出电流最多只有20mA左右驱动不了蜂鸣器这种感性负载必须加三极管或驱动芯片做电流放大。2.3 继电器与执行机构驱动电路风扇控制通过一个5V继电器实现STM32的PB13引脚控制另一个S8050三极管三极管再驱动继电器线圈。继电器线圈两端必须并联一个续流二极管1N4007方向是反向并联这个是整个驱动电路里最关键的器件。没有续流二极管继电器断电瞬间会产生很高的反向感应电动势轻则干扰MCU运行重则击穿三极管。继电器触点一端接5V电源另一端接风扇的正极风扇负极直接接GND。选择5V继电器而不是220V继电器主要是从安全角度考虑这个项目定位是教学和原型验证5V直流风扇足以演示通风控制逻辑避免220V高压带来的触电风险。如果你要控制220V的工业设备需要换成对应的继电器模块并且在布线时做好强弱电隔离。指示灯电路也很简单三个LED分别指示电源状态、报警状态和继电器工作状态每个LED串联一个330欧限流电阻。注意LED和蜂鸣器不要共用同一个GPIO控制否则报警时无法区分是哪种类型的告警。3. 软件核心实现模块化写法拒绝“一坨代码”3.1 工程文件结构与模块划分整个代码工程基于标准库开发虽然是老技术了但胜在稳定、资料多、适合教学。工程结构分为以下几个模块main.c系统主循环负责初始化、任务调度和状态刷新dht11.c / dht11.hDHT11温湿度传感器驱动实现单总线时序adc.c / adc.hADC采集模块读取MQ-2烟雾传感器的模拟电压lcd1602.c / lcd1602.hLCD屏幕驱动实现字符显示和刷新gpio.c / gpio.h按键、LED、蜂鸣器、继电器等GPIO设备的初始化与控制system.c / system.h系统状态机、阈值判断和报警逻辑这种模块化的好处不需要我多说每个外设的驱动独立成文件改一个模块不会影响其他模块排查问题的时候也能快速定位。3.2 DHT11驱动时序最容易踩坑的地方DHT11的通信协议是单总线一根数据线既做输入又做输出时序要求非常严格。我在这里把完整流程拆开讲主机先发送起始信号拉低数据线至少18ms然后拉高20-40us之后释放总线。DHT11收到起始信号后会回发一个80us的低电平响应信号再拉高80us然后开始输出40bit的数据。数据格式是8bit湿度整数部分 8bit湿度小数部分 8bit温度整数部分 8bit温度小数部分 8bit校验和。每一位数据的读取是整个时序里最核心的技巧DHT11先拉低50us表示数据位开始然后拉高拉高的时长决定该位是0还是1。如果高电平持续26-28us表示“0”如果高电平持续70us左右表示“1”。代码实现时我用的是GPIO读取配合us级延时函数的方式。这里有个重要经验STM32标准库的延时函数要自己写不要用SysTick做高精度延时因为DHT11时序对延时的连续性要求很高中断可能会打断时序。我用的是一个简单的for循环空指令延时函数。还有一个很多教程没提到的细节DHT11的读取间隔不能太频繁。数据手册要求两次读取间隔至少1秒实际测试中如果间隔小于500msDHT11很可能会不响应或者返回错误数据。所以主循环里要加一个时间片判断比如每2秒才读一次DHT11。3.3 ADC采集与传感器数据校准MQ-2烟雾传感器的AO口输出的是模拟电压电压越高表示检测到的可燃气体浓度越高。STM32的ADC是12位的读取到的原始值是0-4095的数字量需要换算成实际电压值电压 ADC原始值 x 3.3V / 4095。代码里我做了一个滑动平均滤波连续采集5次去掉最大值和最小值取中间三个值的平均。这个处理非常实用MQ-2的输出在稳定情况下也有几十毫伏的波动直接使用单次采集值会导致报警阈值附近反复跳变。阈值标定方面我在纯净空气中实测MQ-2的ADC值大约在300-500之间所以在代码里把烟雾报警阈值设定为1200对应电压大约0.97V留出了足够的余量。这个阈值不是固定的你在实际部署时需要根据现场环境重新标定。标定方法是正常环境下记录稳定值然后人为制造烟雾记录报警值取两者的中间值作为阈值。3.4 系统主状态机与报警逻辑整个系统的软件核心是一个简单的状态机代码逻辑清晰我重点讲一下报警自锁的设计正常状态下系统处于NORMAL状态LCD显示当前温湿度和烟雾值继电器根据温湿度阈值决定是否开启风扇。当任一报警条件触发时烟雾超限、火焰检测到、红外检测到入侵系统切换到ALARM状态蜂鸣器鸣叫、红色LED闪烁、LCD显示报警类型。ALARM状态下即使报警条件已经消失系统也不会自动恢复NORMAL必须人工按下复位按键。这个设计的初衷是报警事件发生后必须有人到现场确认并处理不能因为传感器的短暂波动就自动解除报警否则可能漏掉真实的危险情况。主循环的任务调度我采用了一个非常朴素的时间片轮询方式没有用操作系统。系统时钟每10ms产生一次中断在主循环中通过计数变量实现不同任务的不同执行频率LCD刷新500ms一次DHT11读取2秒一次ADC采集1秒一次按键扫描50ms一次。这种方式简单可靠不依赖RTOS非常适合这个规模的项目。4. 仿真、调试与常见问题排查实录4.1 Proteus仿真环境搭建要点很多人仿真STM32项目时卡在第一步Proteus里找不到STM32的元器件模型。我用的是Proteus 8.x版本在元器件选择框里搜索STM32F103C8T6LPC等关键词可以找到对应的MCU模型。需要注意的是Proteus里的STM32模型不支持引脚级别的完全仿真部分外设模型是通过“虚拟外设”实现的比如虚拟终端可以代替串口调试虚拟示波器可以观察波形。仿真电路搭建时液晶显示器选择LM016L这是LCD1602的Proteus模型。DHT11在Proteus里有对应的库模型但是请注意仿真模型对时序的模拟和真实硬件有差异DHT11在Proteus里的行为往往比真实器件“宽容”很多所以仿真通过不代表硬件一定没问题反之亦然。另外一个仿真中的常见坑Proteus仿真时电源和地要显式连接VCC和GND引脚必须接上否则MCU不工作。很多人画仿真图时为了美观隐藏了电源引脚结果芯片毫无反应耽误大量时间。4.2 真实硬件调试的四个高频问题第一个问题是STM32无法识别USB设备/芯片无法下载程序。排查顺序是检查SWDIO和SWCLK是否接反、是否接触良好检查BOOT0是否接地检查3.3V供电是否正常最后检查芯片是否被锁死。如果芯片被锁死需要用ST-Link Utility的“Connect under reset”模式连接然后执行全擦除。第二个问题是DHT11读取温湿度一直是0或者固定值。九成原因是时序问题。我遇到最离谱的一次是网上拷的一段延时函数在72MHz主频下实际延时不准确导致时序完全混乱。解决办法是自己写一个延时函数用示波器或者逻辑分析仪实测校准。第三个问题是LCD1602显示乱码或者不显示。如果屏幕有背光但不显示字符先检查对比度调节电位器这个旋钮是新手最容易忽略的。如果显示乱码检查数据线和RS、RW、EN引脚的连接是否正确。还有一个坑是LCD1602上电后需要等待约50ms才能接收指令初始化时序必须严格按照 datasheet 来。第四个问题是MQ-2烟雾传感器上电就报警。前面提过MQ-2上电预热时阻值会剧烈变化输出电压忽高忽低需要等1-2分钟稳定后再启用报警判断。代码里我用了一个简单的方案系统上电后前60秒只显示数据、不进行报警判断并且在显示界面上提示“正在预热”。4.3 阈值标定与系统可靠性调优在整个项目的调试过程中我把大量精力花在了**“防误报”**上。粮仓环境不是实验室通风、粉尘、气流扰动都会让传感器数值产生波动。经过几轮实测我总结出三条可靠性调优经验第一所有报警判断都必须做去抖处理。烟雾报警需要连续3次采集值都超过阈值才触发红外报警需要持续高电平超过1秒才触发这样可以避免短暂的干扰信号造成误报。第二湿度检测与通风控制要联动不能只看温度。粮仓里夜间降温时相对湿度会升高如果单纯按温度控制风扇夜间可能会因为温度略高而启动风扇结果反而把外界潮湿空气抽进来加剧粮食受潮。所以代码里我加的判断逻辑是温度超过上限且湿度低于85%时才开启通风否则只报警不通风。第三设计看门狗防止程序跑飞。STM32内置独立看门狗IWDG在初始化时配置超时时间约1秒主循环里定期喂狗。万一程序因为干扰跑飞看门狗可以让系统自动复位保证系统长时间运行的可靠性。这个功能在粮仓这种需要长期无人值守的场景里非常重要。5. 开源资料的使用指南与二次开发方向5.1 资料包内容与快速上手路径开源资料包里的文件组织如下源码工程目录下包含完整的Keil5工程文件和源代码文件硬件目录下有原理图的PDF文件以及AD格式的原理图源文件仿真目录下有可直接打开的Proteus工程文件文档目录下有接线说明和芯片数据手册。上手路径我建议按“三步走”执行第一步在Proteus里打开仿真工程先跑通仿真看效果这一步只需要电脑操作零硬件成本第二步在Keil5里打开源码工程通读代码搞清楚每个模块的功能和数据流向可以尝试修改一些阈值参数观察系统行为的变化第三步按照原理图制作或购买硬件把代码烧录到真实的STM32芯片中运行。如果你拿到手的代码编译报错排查优先级首先是检查Keil5的芯片包是否安装了STM32F1系列支持包其次是确认编译器版本兼容性最后检查工程配置中的Flash和RAM大小设置是否与C8T6匹配64KB Flash、20KB RAM。5.2 可以继续扩展的方向这个项目的架构决定了它的扩展性很强我列几个我认为有价值的改进方向一个是增加ESP8266模块实现物联网远程监测。STM32通过串口把采集数据发送到ESP8266ESP8266再通过Wi-Fi上报到MQTT服务器这样手机App或者网页端就能实时查看粮仓环境数据。代码上需要在现有基础上增加一个串口数据处理模块和一个AT指令控制模块。另一个是增加SD卡存储模块做历史数据记录。用STM32的SPI接口驱动SD卡把每天的温湿度变化、报警事件记录到CSV文件里方便事后分析和追溯。这个方案在真实粮仓管理中很实用因为安全事故的责任追溯需要数据支撑。还有一个是升级传感器配置把DHT11换成DHT22或SHT30精度更高、量程更大代码改动量也不大。只要保持接口函数名不变内部实现替换即可这就是模块化设计的好处。值得一提的是这套系统的设计思路不只是粮仓能用。把它改一改传感器配置就能变成机房温湿度监测系统、档案室安防系统、蔬菜大棚环境监测系统整个代码架构和报警逻辑都可以直接复用。这也是我选择开源这套项目的一个原因——希望给正在做嵌入式入门或者课程设计的朋友提供一套能真正跑得起来的、结构清晰的参考方案而不是网上那些只能看不能用的半成品。我在实际使用中最大的体会是嵌入式开发的学习曲线最先卡住人的不是单片机本身而是到了一个阶段发现“资料太杂不知道信谁的”。这套项目从硬件到软件的设计都是经过实践检验的步骤和方案都有据可查按照上面的路径一步步来你就能完整地走通一遍嵌入式系统开发的标准流程。最后再分享一个小技巧做这类项目第一版不要追求功能复杂先把“传感器采集-LCD显示-报警执行”这条主链路跑通再逐步加功能这样出现问题时排查范围最小学习收获也最大。