前阵子整理硬盘翻出了前两年做的图书馆环境监测系统项目当时在调试DHT11时序和OLED显示的时候熬了好几个晚上踩了不少坑也积累了一些还算实用的经验。正好最近不少做嵌入式的小伙伴在问有没有适合练手的完整开源项目既要能学到东西又不能太复杂我索性把这个项目重新梳理了一遍把代码、原理图、仿真文件都整理齐全。这个项目非常适合正在学STM32的同学、准备做课程设计的在校生以及想从点灯进阶到小型系统开发的嵌入式爱好者。它麻雀虽小但五脏俱全——涉及GPIO操作、定时器中断、ADC采集、I2C通信、传感器驱动编写、低功耗设计思路等一系列STM32开发的核心知识点最关键的是它能够完整跑通“采集—处理—显示—报警”这条嵌入式系统开发的典型链路。做完这个项目你基本就掌握了独立开发一个小型嵌入式系统的核心能力。1. 项目整体设计与思路拆解1.1 为什么选择图书馆环境作为应用场景很多人可能会问市面上那么多环境监测项目为什么偏偏选图书馆首先图书馆对环境的要求其实非常苛刻。温度过高会加速纸质图书的老化变脆湿度过大容易导致书籍发霉长时间的光照直射会让书脊褪色而安全隐患更是重中之重——图书馆人员密集、纸质资料多一旦发生烟雾异常却没有及时发现后果不堪设想。从技术实现角度来说图书馆环境监测是一个“刚刚好”的复杂度。它需要监测的物理量很明确温度、湿度、光照强度、烟雾浓度这四种传感器串行接口、模拟接口都有刚好覆盖了STM32开发中最常用的几种外设交互方式。而且图书馆场景逻辑清晰控制策略简单直接超限就报警显示当前状态即可不需要复杂的控制算法非常适合作为入门到进阶的过渡项目。1.2 主控选型的考量主控我选的是STM32F103C8T6这颗芯片可以说是STM32家族里的“国民神芯”了。Cortex-M3内核主频72MHz64KB Flash20KB SRAM资源对这个项目来说绰绰有余而且市场上货源充足、价格便宜十几块钱就能买到万一焊坏了也不心疼。更重要的原因是生态成熟。STM32F103系列的参考资料、例程代码、社区讨论数量是其他芯片难以比拟的遇到问题只要搜索关键词基本都能找到解决方案。对于一个以学习为主要目的的开源项目来说这是非常大的隐形优势。如果你手头有STM32F103ZET6或者F407的板子代码移植也非常方便主要修改引脚定义就行整个程序框架完全不用动。1.3 系统架构一条清晰的“感知-决策-执行”链路整个系统采用了经典的“感知-决策-执行”三层架构感知层由四路传感器组成DHT11负责温湿度采集光敏电阻配合ADC通道实现光照强度检测MQ-2烟雾传感器通过另一个ADC通道监测空气质量。决策层是STM32主控它通过GPIO模拟时序读取DHT11的数据通过ADC通道获取光照和烟雾的电平信号然后对这些数据进行滤波、校准、阈值判断决定当前环境状态是否正常。执行层包含三个部分OLED显示屏实时刷新当前环境数据蜂鸣器在参数越限时发出报警声状态指示灯同步闪烁提示。用户还可以通过按键切换显示界面或者调整报警阈值。这样的架构设计把一个看似简单的“测量显示”项目变成了一个真正具有工业雏形的完整系统。这也是我在面试新人时比较看重的思维方式——即使是一个小项目也能体现出设计者对系统整体性的把握能力。2. 核心硬件电路解析2.1 传感器选型与接口设计传感器的选型直接决定了系统的成本和开发难度我在这部分说一下当初的选择理由温度湿度测量用的是DHT11数字温湿度传感器。这是一颗非常经典的传感器单总线协议只需要一根数据线就能同时输出温度和湿度数据。测量范围温度0-50摄氏度、湿度20%-90%RH精度分别是±2摄氏度和±5%RH。坦白说DHT11的精度在工业级应用里不算高但对于图书馆这种对环境要求不那么苛刻的场景完全足够了。而且它的单总线协议对初学者理解时序概念非常有帮助——通信双方通过拉高拉低电平的时间长短来传递数据这是嵌入式开发中很重要的基本功。光照检测用的是光敏电阻加电阻分压的经典方案。光敏电阻的阻值会随光照强度变化——光照越强阻值越小。把光敏电阻和一个固定电阻串联中间抽头接入STM32的ADC引脚就能把光照变化转化为电压变化。这个方案成本极低一个光敏电阻加一个10K电阻成本不超过五毛钱。需要说明的是这种方案只有相对光强概念没有绝对的照度数值但对这个项目来说已经足够——我们只需要判断“光照是否过强”或者“是否过于昏暗”不需要精确到多少勒克斯。烟雾浓度检测采用MQ-2烟雾传感器模块。这种传感器内部有一个二氧化锡半导体气敏元件在洁净空气中电导率较低当环境中存在可燃气体或烟雾时电导率会随浓度增大而升高。我使用的是常见的MQ-2模块版本模块上自带了LM393比较器电路既可以输出数字开关量配合电位器调节阈值也可以直接输出模拟电压信号。我在项目中用的是模拟输出读取的数值经过映射后可以大致反映烟雾浓度的相对变化。2.2 显示与报警电路设计显示部分使用的是0.96寸OLED屏SSD1306驱动芯片I2C接口四根线就能完成连接VCC、GND、SCL、SDA。选择OLED而不是LCD1602的原因有三点可视角度大、对比度高在强光下也能清晰显示功耗低工作电流只有20-30mA左右尺寸小巧方便集成到小体积的壳体中。最重要的是SSD1306的I2C驱动这部分代码几乎是嵌入式圈子的“公共财富”网上例程一抓一大把初学者不用从零啃数据手册也能快速点亮屏幕成就感来得很快。报警电路使用有源蜂鸣器用一个NPN三极管我用的S8050做驱动。有源蜂鸣器内部自带振荡电路只要通电就能发声控制起来非常简单——GPIO输出高电平就响输出低电平就停。这里我特别提一下STM32的GPIO驱动能力有限直接驱动蜂鸣器可能会出现电流不足导致声音偏小的问题加一级三极管放大电路就可以完美解决。在基极串联一个1K限流电阻防止基极电流过大损坏三极管。3. 软件架构与代码实现细节3.1 工程初始化与系统时钟配置这个项目的代码我是基于标准外设库写的虽然现在ST官方已经在推HAL库和LL库但标准库的代码逻辑更直白每一个寄存器操作都摆在你面前对于理解STM32的工作原理帮助很大。系统时钟配置为内部8MHz晶振经过PLL倍频到72MHz。这部分别偷懒直接用默认设置必须认真配置因为后面的串口波特率、ADC采样频率、延时函数的准确性全都依赖系统时钟。延时函数我用的SysTick系统定时器配置为1ms中断一次在主循环中通过一个全局变量来计时。void Delay_Init(void) { SysTick_Config(SystemCoreClock / 1000); }这个配置需要理解一下SysTick的频率设置为系统时钟72MHz除以1000也就是72MHz/1000 72000这样每计数72000次就是1ms。SysTick是一个24位的向下计数器72000远小于其最大值完全没问题。3.2 DHT11单总线时序的软件实现DHT11的驱动是整个项目中代码难度最高、也最容易出问题的部分。我在这里把实现细节拆开讲一下。单总线通信的基本流程是这样的主机STM32先拉低总线至少18ms然后释放总线DHT11检测到起始信号后回复一个80us的低电平和80us的高电平然后开始连续发送40位数据8位湿度整数8位湿度小数8位温度整数8位温度小数8位校验和。每一位数据的读取是最关键的地方。数据0和数据1的区别在于高电平持续的时间数据0高电平持续26-28us数据1高电平持续70us在代码里的实现方式是在DHT11回复起始信号后反复读取引脚电平测量电平翻转的时间差。uint8_t DHT11_ReadByte(void) { uint8_t i, byte 0; for(i 0; i 8; i) { while(DHT11_DQ_READ() 0); // 等待低电平结束 delay_us(40); // 延时40us if(DHT11_DQ_READ() 1) // 如果40us后仍然是高电平 { byte | (uint8_t)(1 (7 - i)); // 这一位是1 } while(DHT11_DQ_READ() 1); // 等待高电平结束 } return byte; }这个逻辑的原理是这样的我们等待50us后去采样电平如果DHT11发的是数据1高电平持续70us50us时高电平还没结束我们就能读到1如果发的是数据0高电平只持续26-28us50us时高电平已经结束、总线已经拉低了我们读到0。当时我在写这段代码的时候最大的困惑在于时间基准怎么把握。因为DHT11的时序要求虽然不算非常严格但延时太短会导致误判。后来我意识到直接用循环延时每次调用之间还有额外的指令开销会导致时间偏差累积。最终的解决方案是用示波器实测时序然后微调了一个延时偏移值让每个位都能被正确解析。3.3 ADC多通道采集实现光照传感器和烟雾传感器都是模拟信号需要使用STM32的ADC模块进行采集。我这里用的是ADC1的通道1和通道2配置为软件触发、连续转换模式。void ADC_Config(void) { ADC_InitTypeDef ADC_InitStructure; GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_1 | GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AIN; // 模拟输入 GPIO_Init(GPIOA, GPIO_InitStructure); ADC_InitStructure.ADC_Mode ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode DISABLE; ADC_InitStructure.ADC_ContinuousConvMode ENABLE; ADC_InitStructure.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_DataAlign ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel 1; ADC_Init(ADC1, ADC_InitStructure); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); }这里我踩过一个坑一开始我用的是规则通道组的扫描模式想一次启动把所有选择的通道都采集完。但扫描模式需要配合DMA使用否则数据很容易丢失。后来我干脆改回单通道采集需要读哪个通道就配置哪个通道的采样顺序为1然后触发一次转换读取结果。代码虽然多几行但逻辑清晰也不会出问题。对于这个项目的数据更新速率要求来说完全够用。3.4 数据处理逻辑阈值判断与报警策略传感器原始数据不能直接用来做控制判断需要经过处理。我在代码里做了两层处理移动平均滤波和阈值越限判断。移动平均滤波的原理很简单就是维护一个长度为10的数组每次新的采样值进来就丢弃最旧的值然后把所有10个值求平均。这种滤波方式对随机噪声的抑制效果不错而且实现简单不需要复杂的数学运算在MCU上运行非常轻量。uint16_t Filter_GetAverage(uint16_t value, uint16_t *buf, uint8_t size) { uint8_t i; uint32_t sum 0; for(i 0; i size - 1; i) { buf[i] buf[i 1]; sum buf[i]; } buf[size - 1] value; sum value; return (uint16_t)(sum / size); }报警策略方面我设计了不同的优先级烟雾浓度越限是最高优先级报警触发后蜂鸣器持续鸣响温度和湿度越限是次一级报警蜂鸣器间歇鸣响鸣响0.5秒停0.5秒光照越限最轻只通过OLED显示警告图标和指示灯变色不启动蜂鸣器。这个分级设计是符合实际场景的——烟雾异常可能是火灾的前兆必须立刻引起注意而光照强弱往往只是舒适性问题不需要用声音惊扰其他人。3.5 OLED显示界面的设计OLED的驱动基于SSD1306的I2C协议。我需要重点说的是显示内容的组织方式。整个界面我设计了三页第一页显示温湿度数值用大号字体显示方便远距离查看 第二页显示光照强度和烟雾浓度的数值同时用进度条的方式直观展示当前数值在量程中的位置 第三页显示系统状态四个监测参数的当前状态正常/异常、报警统计次数、系统运行时间。界面切换通过一个按键实现短按切换页码长按进入阈值设置模式。在写显示驱动的时候有个细节很值得注意SSD1306的显存是1KB分为8页每页128字节对应8个像素行。我们在写显示函数的时候需要先计算坐标在显存中的位置然后再按页写入。如果坐标计算搞不明白很容易出现显示错位的问题。我自己写的驱动封装了一个画点函数在此基础上实现了画线、画矩形、显示字符、显示字符串等基础接口组合起来就能完成各种UI绘制。4. 仿真验证与关键环节实现4.1 为什么先做仿真再上实物我在做这个项目的时候第一步不是拿烙铁焊接而是在Proteus里先搭建仿真电路、跑通整个系统逻辑。很多初学者觉得仿真多余直接搞实物多爽。但我强烈建议至少在做完硬件设计后、焊接前先在仿真环境里验证一遍控制逻辑。原因很简单调试效率差异巨大。仿真环境里你可以实时查看引脚电平、轻松修改参数、随时暂停程序运行观察变量出了问题立即定位不会出现实物调试中“程序烧进去没反应不知道是电路问题还是代码问题”这种让人抓狂的情况。当然仿真替代不了实物验证——传感器模型和真实传感器的时序行为有差异但逻辑层面的验证完全足够。4.2 Proteus仿真电路搭建要点在Proteus中搭建这个系统有几个需要注意的点。STM32F103C8T6模型放置在“STM32F103C8T6”元件中DHT11模型在Proteus 8.9及以上版本中可以直接搜到。OLED屏在Proteus里的模型兼容性比较差我用的方案是用“LCD12864”配合I2C转并口的中间模型来替代或者直接在Proteus里设计一个简化的OLED模型——用一块显示屏模型配合自定义的显存映射来模拟显示效果。比较省事的做法是Proteus仿真中先用虚拟终端把采集数据打印出来验证数据采集和阈值判断逻辑正确后再把显示部分单独测试。这样可以把“数据链路”和“显示链路”的调试解耦问题定位会容易得多。仿真时设置ADC输入的方式也需要说一下。光敏电阻在Proteus里是通过电阻分压模拟的你可以在仿真运行的时候直接用鼠标调节分压电位器的阻值观察ADC采样值的变化。烟雾传感器同样如此用可变电阻来模拟传感器内阻变化转化为电压变化输入ADC。这样虽然缺少了真实传感器的“物理感”但对验证代码逻辑来说完全够用。4.3 仿真过程中遇到的几个坑第一个坑是系统时钟配置问题。在Proteus仿真中STM32模型的系统时钟使用的是虚拟时钟和真实芯片的外部晶振并不完全一致。如果代码中使用了外部高速晶振HSE配置仿真时经常会出现启动失败的问题。我的解决方案是在仿真阶段使用内部高速时钟HSI作为系统时钟源实测运行一切正常。等烧录到真实芯片时再切换为HSE配置即可。第二个坑是ADC初始化时的校准环节。STM32的ADC校准过程需要一定的时间如果初始化代码中没有等待校准完成就启动转换读出来的数据永远是0。在仿真环境中这个过程比真实芯片更慢所以我在校准后加了一个等待循环确保校准寄存器完成设置后再进入主循环。第三个坑是DHT11的时序仿真。Proteus中的DHT11模型对时序的容忍度比真实芯片更苛刻一些有时候真实芯片能正常通信的时序在仿真里却读不到数据。如果你的仿真卡在DHT11读取超时可以先检查你的延时函数是否准确。我当时的延时函数在仿真中明显偏慢后来用示波器波形工具校准了延时基准才恢复正常。4.4 从仿真到实物焊接与上电测试仿真跑通之后就可以开始焊接实物了。PCB我直接用洞洞板手工焊接这个项目的元件密度不高布局合理的话洞洞板完全能胜任。这里分享几个焊接时的经验。电源部分是整个系统的“心脏”。我用的USB供电5V输入经过AMS1117-3.3稳压芯片给STM32供电。注意在稳压芯片的输出端并联一个10uF和一个100nF电容分别滤除低频纹波和高频噪声输入输出端都要加——这个细节很多新手会忽略结果是系统莫名其妙地复位或者ADC读数跳变。传感器模块的供电也要注意。DHT11和OLED可以直接用3.3V供电但MQ-2模块的加热电阻需要较大的电流如果也接3.3V会导致稳压芯片发热严重。我的做法是MQ-2模块的加热部分直接接5V信号输出引脚通过一个1K电阻分压后接到STM32的ADC引脚这样既保证了传感器正常工作又保护了主控的GPIO。上电测试有一套固定的流程先不烧录程序用万用表测量各关键节点的电压是否正确特别是3.3V和5V是否正常然后烧录一个最简单的LED闪烁程序确认芯片工作正常最后再烧录整个系统程序。每次只增加一个模块确认工作正常后再加下一个。这样如果有问题你永远知道是新加的模块导致的。5. 常见问题与排查技巧实录5.1 DHT11传感器读取数据异常这个是我在项目过程中被问得最多的问题也是我自己当初折腾最久的问题。症状五花八门有时读到温湿度全是0有时数据跳变剧烈有时每隔几次才能成功读取一次。先说原因DHT11的单总线协议对时序要求是很严格的。主机发出的起始信号至少要拉低18ms这个很多人知道但容易忽略的细节是起始信号结束后主机必须把引脚从输出模式切换为输入模式。如果切换不及时或者切换后没有进行适当的延时DHT11就来不及准备响应信号。另一个高频问题是上拉电阻。DHT11的数据线是开漏输出必须在外部接一个4.7K-10K欧姆的上拉电阻到VCC否则总线在空闲状态下电平不确定通信完全无法进行。如果是模块化的DHT11通常板上自带上拉电阻但如果是裸传感器自己搭建电路这个电阻很容易遗漏。还有个比较隐蔽的问题是延时函数的准确性。如果你用的是软件循环延时而编译器开启了优化选项如-O2循环体内的空语句有可能被编译器优化掉导致实际延时远小于预期。解决办法是在延时循环中用一个volatile修饰的变量或者干脆用定时器做精确延时。5.2 ADC读数跳变和噪声干扰ADC读数不稳定在美团外卖个传感器项目中几乎都会遇到。我当时遇到的情况是光敏电阻通道的读数在稳定光源下仍然有正负20-30的波动烟雾传感器通道更是噪声不断。排查路径是这样的先是确认是否是传感器本身输出就带噪声用示波器直接测量传感器输出引脚的电压波形——果然波形上有明显的高频毛刺。然后检查电源STM32的VDDA引脚模拟电源引脚直接连在了VDD上没有加滤波电感。查阅数据手册后发现STM32的VDDA建议通过一个10uH电感或10欧姆电阻与数字电源隔离同时在VDDA引脚对地加一个1uF和100nF的电容这样才能有效滤除数字电路产生的高频噪声对模拟电路的影响。电路调整之后ADC读数的稳定性有了很明显的提升波动范围缩小到了正负3-5。另外在软件层面我把ADC采样时间配置到了最大239.5个周期虽然采样速率变慢了但信号源的内阻较高更长的采样时间可以让采样电容充分充电这也是提升读数精度的有效措施。5.3 OLED显示闪烁与刷新问题OLED显示的典型问题是两种花屏和闪烁。花屏一般出现在上电初期。原因很可能是I2C通信时序不对或者复位时序不对。我用的OLED模块有一个RES复位引脚正常情况下可以悬空但如果上电时STM32复位导致OLED没有得到正确的初始化信号显示就会乱码。解决方法是把RES引脚接到一个GPIO上在初始化代码中执行一次完整的硬件复位操作拉低20ms再拉高。闪烁问题则和刷新策略有关。如果你在每帧数据到来时都做一整屏的更新显示就会明显闪烁。优化的策略是“局部刷新”——只有数值变化时才重绘数值区域这样既减少了闪烁也降低了I2C总线的通信负载。我在显示代码中实现了一个简单的脏标记机制每次数据更新时先和上次显示的数据比较如果差值超过1个单位才触发刷新如果数据没有变化则不执行任何刷新操作。这个小小的优化让显示流畅度有了质的提升。5.4 系统上电后偶发死机这是比较棘手的问题因为故障不是每次都出现。现象是系统上电后OLED亮起但无内容按键无响应程序似乎跑飞了。排查思路从复位开始。我用示波器量了NRST引脚的波形发现在上电瞬间有一个下降沿毛刺这是典型的电源跌落引起的复位异常——5V电源在接入瞬间有一个短暂的塌陷导致3.3V电压跌落超过复位阈值MCU反复复位后卡在某个不可预期的状态。解决方法是三个方面电源输入端加一个470uF的大电容缓冲上电瞬间的电流冲击复位引脚外部加上拉电阻和100nF电容构成标准的RC硬件复位电路软件层面在main函数开头增加一段系统时钟稳定等待程序——启动后先延时200ms等外部晶振稳定后再执行主逻辑。加了这三重保险之后死机问题再也没出现过。这类“偶发”故障最考验排查耐心但也是提升工程能力的好机会。5.5 快速排查手册我把项目中遇到过的典型问题和对应的排查方向整理成了表格方便后来者快速定位问题问题现象可能原因排查方法DHT11数据全零起始时序不满足、上拉电阻缺失用示波器抓取总线上电波形检查主机拉低时间是否大于18msDHT11偶发读取失败延时函数计时不精确校准延时改为定时器延时OLED上电白屏I2C地址错误或上电时序异常确认地址0x3C还是0x3D检查RES引脚复位OLED显示闪烁全屏刷新频率过高改为脏标记局部刷新ADC数据跳变电源噪声、采样时间过短VDD与VDDA之间加磁珠/电感隔离增加采样时间按键无响应GPIO内部上拉未使能、抖动未消除确认按键引脚上拉配置增加消抖延时系统上电死机电源跌落、复位异常增加大容量储能电容优化RC复位电路蜂鸣器声音小GPIO驱动能力不足加三极管驱动电路烟雾浓度读数接近0MQ-2预热不足MQ-2传感器需要预热几分钟才能稳定输出光照数值反向光敏电阻分压接反检查光敏电阻在分压电路中的位置光照增强时ADC电压应升高5.6 关于整机测试和长期稳定性的一些心得项目功能全部验证通过后我在图书馆环境里实际跑了72小时连续运行测试。测试结果和调试阶段的情况还是有些差别的。一个明显发现是DHT11在环境湿度较高时比如60%RH以上读取到的湿度值与实际值之间有肉眼可见的偏差这与DHT11传感器本身的出厂标称精度相符。如果你的项目对湿度精度要求更高可以考虑升级为DHT22或SHT30代码结构基本不变只需要替换驱动程序。还有一个发现是OLED在长时间显示静态界面后会有轻微的残影现象。这与OLED的发光原理有关——有机材料在长时间导通后发光效率会下降。解决思路是让屏幕在无人靠近时自动进入休眠或者定期刷新整个显示内容全屏刷新可以“擦除”残影。我在最终版本中增加了5分钟无操作自动关屏的功能按任意键唤醒实测对延长屏幕寿命有帮助。功耗方面整个系统在正常工作模式下电流大约在70mA左右其中MQ-2的加热电流占了大部分。后续如果要做电池供电的便携版本可以考虑使用低功耗版本的烟雾传感器或者让主控在数据采集间隙进入Sleep模式这又是另一个有趣的优化方向了。6. 项目文件结构、环境搭建与开源说明6.1 开源文件目录总览项目文件已经上传到网盘整个目录结构如下Library_Environment_Monitor/ ├── Docs/ │ ├── 原理图.pdf │ ├── PCB布局建议.md │ └── 元件清单BOM.xlsx ├── Firmware/ │ ├── Core/ │ │ ├── Inc/ │ │ ├── Src/ │ │ └── Startup/ │ ├── Drivers/ │ │ ├── BSP/ │ │ ├── Middlewares/ │ │ └── ... │ ├── Project/ │ │ ├── MDK-ARM/ │ │ └── EWARM/ │ └── User/ │ ├── main.c │ ├── dht11.c │ ├── oled.c │ ├── adc.c │ ├── buzzer.c │ └── key.c ├── Simulation/ │ └── library_env_sim.pdsprj └── README.md代码部分我做了很详细的注释每个功能模块对应的例程和驱动都有单独的说明文档方便你按模块学习。硬件设计部分提供了完整的原理图PDF和元件清单照着买料即可焊接。6.2 开发环境搭建这个项目的开发环境非常标准建议按以下步骤搭建。集成开发环境我用的Keil MDK5版本5.27以上。如果你电脑上还没有安装Keil可以直接去官网下载MDK-ARM版本安装过程比较简单唯一需要注意的是安装路径不要包含中文和空格否则编译器会有莫名其妙的问题。装好Keil之后需要先安装STM32F1系列的器件支持包Device Family Pack。Keil 5之后的版本不再自带器件库必须通过Pack Installer在线安装打开软件后点击“Pack Installer”图标在搜索框输入“STM32F1”安装对应的Keil.STM32F1xx_DFP包。如果没有联网条件也可以去官网下载离线包手动安装。代码烧录用的调试器是ST-Link V2。十几块钱的山寨版也能用唯一的问题是有时候需要安装旧版本的驱动。烧录前记得在Keil的Options for Target - Debug页面选择“ST-Link Debugger”然后在Settings里确认能识别到目标芯片。如果识别不到检查一下接线SWD只需要四根线SWDIO、SWCLK、GND、3.3V千万不要接反。如果你电脑上没有ST-Link也可以使用串口ISP下载把BOOT0引脚拉高BOOT1拉低然后通过串口工具烧录程序效果是一样的。当然这种方式每次烧录都要拔跳线帽调试效率会低一些。仿真环境使用Proteus 8.9及以上版本需要提前在Proteus元件库中确认是否有STM32F103C8T6模型。Proteus 8.9之后的版本都内置了这款芯片。打开仿真文件后先编译工程生成hex文件然后在STM32模型上双击在Program File一栏选择编译生成的hex文件路径点击运行即可。6.3 硬件材料清单元件清单是照着可以直接采购的版本整理的编号元件名称型号/规格数量备注U1主控芯片STM32F103C8T61LQFP48封装U2稳压芯片AMS1117-3.315V转3.3VU3温湿度传感器DHT111模块或裸传感器U4烟雾传感器MQ-21模块含比较器U5显示模块0.96寸OLED SSD13061I2C接口R1光敏电阻55281亮阻10-20KR2固定电阻10K 1%1分压用Q1三极管S80501蜂鸣器驱动BZ1有源蜂鸣器5V1低电平触发SW1-SW3轻触按键6x6mm3界面切换/设置C1-C4陶瓷电容100nF4滤波去耦C5电解电容470uF/16V1电源储能C6-C7钽电容10uF2稳压输入输出J1USB接口Type-C或MicroUSB1供电和下载整个项目的物料成本我算了一下大约在60-80元人民币之间绝大部分是MQ-2模块和OLED屏的价格。如果你手头有旧开发板可以拆元件成本还能再压一压。6.4 编译常见错误与解决办法给新手提前打个预防针编译阶段有几个非常经典的报错“Error: L6218E: Undefined symbol”这个报错表示有函数声明了但没定义。绝大多数情况是忘记把对应的.c文件添加到工程中。在Keil左侧的Project栏中右键点击Source Group选择Add Existing Files把缺少的.c文件加进去重新编译。“Error: C2099E: Inline assembler not permitted”这个报错出现在代码中使用了内联汇编而编译器配置不允许。在Options for Target - C/C选项卡中把Language standard设置为GNU99或AC5的默认模式即可解决。“Warning: #1-D: last line of file ends without a newline”这个警告本身不影响编译和运行但会导致git版本管理的diff显示异常。解决方法是确保每个源文件末尾都有一个空行。还有一类问题是在编译时反复提示找不到头文件**“Error: C #5: cannot open source input file”**。这种基本上是因为头文件路径没配置。打开Options for Target - C/C - Include Paths把所有头文件所在目录添加进去即可。6.5 项目如何进一步拓展这个项目做完之后如果还想继续深入学习有几个不错的拓展方向可以试试拓展一加入ESP8266模块实现物联网远程监测。通过WiFi模块把温湿度、光照、烟雾数据上传到云端或局域网服务器用户可以通过手机网页实时查看。这个拓展可以让你接触到AT指令集、TCP/IP通信、MQTT协议等物联网核心知识是当前嵌入式行业非常热门的方向。拓展二改为RTOS版本。把当前的前后台循环架构改为基于FreeRTOS的多任务架构——传感器采集任务、显示刷新任务、按键扫描任务、报警控制任务各自独立运行通过消息队列和信号量进行通信。这个改造能帮你理解实时操作系统的核心概念。值得说明的是当前这种裸机架构对于单传感器低速采集的小系统完全够用改用RTOS的收益在这个项目规模下主要是学习价值。拓展三增加数据存储功能。外接一片AT24C02或者用STM32内部的Flash定时存储环境数据用户可以通过按键查看历史记录。这个功能涉及I2C读写、Flash擦写均衡算法、简单文件系统设计等知识点对你后续做一个完整的数据采集产品有直接帮助。拓展四优化为低功耗版本。使用STM32的Stop模式定时唤醒采集数据采集完成后继续睡眠。这个方向会让你的系统从“实验室样机”向“可部署产品”迈进一大步对电源管理和低功耗设计的理解会深入很多。拓展五增加室内时钟功能。加一个DS1302或DS3231实时时钟芯片让系统在显示环境数据的同时显示当前时间这样图书馆管理员可以做整点数据记录。这个项目看起来改动不大但能让你接触到BCD码转换、闰年计算、时间校准等实用技巧。我个人最推荐的是第一个方向物联网化。因为当前行业对嵌入式物联网的复合需求非常大而且这个拓展方向可以让你把云平台、数据库、App开发这些知识串起来形成一个完整的技能体系。6.6 写在最后的一些体会这个项目从头到尾做完我印象最深的并不是某个技术难点突破的瞬间而是“调试思路”的重要性。我见过太多初学者遇到问题后的第一反应就是盲目改代码——这里加个延时试试那里换种写法试试改来改去问题没有解决代码反而变得更混乱。正确的做法是先确认问题现象再缩小排查范围最终定位到根因。DHT11读不到数据先不要急着改代码先用示波器看看总线上到底发生了什么ADC读数跳变先用万用表测供电电压稳不稳定OLED显示异常先检查I2C地址对不对而不是一上来就换驱动库。做嵌入式开发七分靠硬件分析、三分靠写代码。理解这句话能帮你省下大把的无用功。另外再说一点开源项目最重要的不只是代码本身还包括文档和使用说明。我在整理这个项目的时候专门花了大量时间写README和注释确保每个模块的设计思路、每个关键参数的选择依据都有记录。这样做一方面方便其他学习者理解另一方面也是对自己思考过程的一次梳理。你如果计划把自己的项目开源请一定重视文档工作这会让你的项目价值提升好几个档次。最后感谢你看到这里。希望这个项目能帮你在STM32的学习和开发道路上少走一些弯路。如果在调试过程中遇到任何问题欢迎在评论区留言我会尽力帮你解答。