

EnvMonitor
🌡️ 智能环境监测站 | STM32F103C8T6 + FreeRTOS + ESP8266 | 温湿度/光照/测距/OLED菜单/ThingSpeak上云 | 从裸机到RTOS到KiCad PCB全流程
- Size
- 80 × 60 mm
- Copper layers
- 2
- Thickness
- 1.6 mm
- Parts
- 27
- Nets
- 83
- Pads
- 149
- Tracks, vias
- 197, 0
- Pours
- 2
- Routed
- Yes
- KiCad
- KiCad 10.0 (file 20260206)
- Created
- 20 Jul 2026
- Updated
- 25 Jul 2026
Overview
EnvMonitor is an open-source printed circuit board by kennySzhucheng, from the kennySzhucheng/EnvMonitor repository on GitHub. It is a 2-layer board of 80 × 60 mm with 27 parts on 83 nets, routed with 197 tracks and 0 vias.
It is built around the DHT22, 100UF 10V 4*7 and HC-SR04. Its parts include 9 resistors, 5 capacitors, 4 connectors, 3 diodes and 3 switches. It belongs with the lEDs and displays and home automation and IoT boards and the ESP8266 and STM32 boards of this library.
Main components
3DHT22
插件-40℃~+80℃ 3.3V 5%RH~99%RH 500uA ±3%RH 插件 Temperature and Humidity Sensor ROHSHAIGUTemperature And Humidity Sensor100UF 10V 4*7
插件,4x7mm1.5mm 1000hrs@105℃ 100uF 10V 4mm 7mm 插件,4x7mm Aluminum Electrolytic Capacitors - Leaded ROHSLCSCAluminum Electrolytic Capacitors - LeadedHC-SR04
-- Ultrasonic Receivers, Transmitters ROHSUniversal MicroelectronicsUltrasonic Receivers, Transmitters
README
README.mdEnvMonitor — 智能环境监测站
STM32F103C8T6 + FreeRTOS + ESP8266 桌面环境监测终端 | 练习项目
一个从零开始搭建的嵌入式 IoT 项目:裸机固件 → FreeRTOS 重构 → KiCad 画板 → 嘉立创打样,走完嵌入式产品全流程。
📸 实物展示
PCB 制板 & 焊接
| 空板 | 正面细节 | 焊接完成 |
|---|---|---|
![]() | ![]() | ![]() |
OLED 功能页面
| 启动画面 | 主页 | 详情页 |
|---|---|---|
![]() | ![]() | ![]() |
| 设置页 | WiFi 已连接 | 关于页 |
|---|---|---|
![]() | ![]() | ![]() |
✨ 功能
| 模块 | 作用 |
|---|---|
| 🌡️ DHT22 | 温湿度传感器,单总线(1-Wire)通信,精度 ±0.5°C / ±2%RH,挂在 PA0 上 |
| ☀️ BH1750 | 环境光强度传感器,I²C 接口,0~65535 lux 量程,和 OLED 共用 PB6/PB7 |
| 📏 HC-SR04 | 超声波测距模块,探测前方物体距离,用于"有人靠近"检测,PB0 发触发信号、PB1 输入捕获回波 |
| 🖥️ OLED SSD1306 | 0.96 寸 I²C 显示屏,5 页菜单循环切换(温湿度/光照/距离/WiFi/系统信息) |
| 📡 ESP8266-01S | WiFi 模块,通过 UART1(PA9/PA10) 走 AT 指令,HTTP GET 方式每 60s 上传一次 ThingSpeak |
| 🚨 三色 LED | 红色(高温>35°C)、黄色(湿度<30%)、绿色(有人靠近<30cm),分别接 PB12/13/14 |
| 🔔 蜂鸣器 | 5V 有源模块,出现报警条件时由 BuzzerTask 队列驱动蜂鸣 |
| 🎛️ 三按键 | KEY1 页面切换 / KEY2 确认 / KEY3 返回,PA4/5/6,消抖电容 + 10kΩ 外部上拉 |
| ⏱️ FreeRTOS | 6 个任务抢占式调度,3 个互斥量保护共享资源,2 条队列做任务间通信 |
| 🛡️ 自定义 PCB | KiCad 10 设计,80×60mm 双面板,全插件 27 元件,双面 GND 铺铜 |
🧱 硬件架构
┌──────────────────────────────────┐
│ STM32F103C8T6 (72MHz) │
│ Blue Pill 核心板 │
│ │
DHT22 ──────────┤ PA0 (1-Wire) │
KEY1~3 ─────────┤ PA4/PA5/PA6 (GPIO Input) │
ESP8266 ────────┤ PA9/PA10 (USART1, 115200bps) │
HC-SR04 ────────┤ PB0(Trig) / PB1(Echo, TIM3_CH4) │
OLED SSD1306 ────┤ PB6/PB7 (I2C1) │
LED_R/Y/G ──────┤ PB12/PB13/PB14 (GPIO Output) │
Buzzer ─────────┤ PB15 (GPIO Output, 直连模块IO) │
└──────────────────────────────────┘
电源: USB 5V → Blue Pill → AMS1117 → 3.3V(全板供电来自 USB)📐 引脚分配
| 引脚 | 外设 | 功能 |
|---|---|---|
| PA0 | DHT22 | 1-Wire 单总线 |
| PA4/PA5/PA6 | KEY1/KEY2/KEY3 | 按键输入(10kΩ 上拉) |
| PA9/PA10 | ESP8266 | USART1 TX/RX |
| PB0 | HC-SR04 Trig | 触发信号 |
| PB1 | HC-SR04 Echo | TIM3_CH4 输入捕获 |
| PB6/PB7 | OLED SSD1306 | I2C1 SCL/SDA |
| PB12/PB13/PB14 | LED_R/Y/G | 报警指示灯 |
| PB15 | Buzzer | 有源蜂鸣器模块 IO |
| PA13/PA14 | SWDIO/SWCLK | ST-Link 调试(保留) |
🖥️ 软件架构
┌───────────────┐
│ FreeRTOS │
│ V10.3.1 │
├───────┬───────┤
│ 互斥量 ×3 │ 队列 ×1
│ I2C / Data │ Button → Display
│ / UART │
└───────┴───────┘
│
┌──────────────────────┼──────────────────────┐
│ │ │
┌───▼──────┐ ┌──────▼─────┐ ┌────────▼───────┐
│SensorTask│ │DisplayTask │ │ CloudTask │
│ (5s) │ │ (0.3s) │ │ (信号量触发) │
│ Prio:3 │ │ Prio:2 │ │ Prio:1 │
│ │ │ │ │ │
│ DHT22 │ │ OLED 5页 │ │ ESP8266 AT指令 │
│ HC-SR04 │ │ 菜单渲染 │ │ HTTP GET │
│ │ │ 按键事件处理 │ │ ThingSpeak ☁️ │
└──────────┘ └─────────────┘ └─────────────────┘
┌──────────┐ ┌──────────────┐
│AlarmTask │ │ ButtonTask │
│ (500ms) │ │ (10ms) │任务优先级原则: 采集 > 报警 > 显示 = 按键 > 上云
⚠️ 蜂鸣器任务已移除。有源蜂鸣器模块与 I2C/UART 共用 5V 电源轨,激活时电流冲击导致系统冻结,硬件限制无法软件规避。
📦 物料清单 (BOM)
PCB 焊接件(27个)— 全部使用
| 类型 | 规格 | 数量 | 位号 |
|---|---|---|---|
| 排母 | 1×20P 2.54mm | 2 | H1, H2(Blue Pill 直焊) |
| 排针 | 1×4P 2.54mm | 3 | J2, J3, J4 |
| 排针 | 2×4P 2.54mm | 1 | J5 |
| 排针 | 1×3P 2.54mm | 1 | LS1 |
| 电阻 | 330Ω 1/4W | 3 | R10, R11, R12 |
| 电阻 | 4.7kΩ 1/4W | 3 | R4, R5, R6 |
| 电阻 | 10kΩ 1/4W | 3 | R7, R8, R9 |
| 瓷片电容 | 100nF (104) | 3 | C18, C19, C20 |
| 电解电容 | 100µF/10V | 2 | C21, C22 |
| LED 3mm | 红/黄/绿 | 3 | D2, D3, D4 |
| 轻触开关 | 6×6mm | 3 | SW2, SW3, SW4 |
外接模块(实际使用 5 个,闲置 2 个)
| 模块 | 数量 | 状态 |
|---|---|---|
| STM32F103C8T6 Blue Pill | 1 | ✅ 使用中 |
| DHT22 温湿度传感器 | 1 | ✅ 使用中 |
| OLED 0.96" SSD1306 | 1 | ✅ 使用中 |
| HC-SR04 超声波 | 1 | ✅ 使用中 |
| ESP8266-01S WiFi | 1 | ✅ 使用中 |
| 1 | ❌ 未购买,固件已禁用 | |
| 1 | ❌ 电源冲突,已禁用 |
💰 全部物料实际花费约 90 元。BH1750 在设计阶段列入 BOM 但实际未采购。蜂鸣器模块已购买但因与 I2C 共用 5V 电源轨导致系统冻结,无法使用(需下一版 PCB 加独立去耦电路)。完整清单见
hardware/pcb/EnvMonitor/BOM_EnvMonitor.md
🔧 开发环境
| 工具 | 用途 |
|---|---|
| Keil MDK5 | 固件编译/烧录 |
| STM32CubeMX | 引脚配置 + HAL 代码生成 |
| STM32CubeF1 V1.8.7 | HAL 库 + FreeRTOS 源码 |
| ST-Link V2 | 调试/烧录器 |
| KiCad 10.0 | 原理图 + PCB 设计 |
| ThingSpeak | IoT 数据可视化云平台 |
编译
- 用 CubeMX 打开
EnvMonitor.ioc重新生成代码(如需要) EnvMonitor\MDK-ARM\EnvMonitor.uvprojx→ Keil 打开- 确认 Include Paths 包含:
Drivers/*、App/、FreeRTOS/include、FreeRTOS/portable/RVDS/ARM_CM3 - Build (F7) → 0 Error → Download (F8)
ThingSpeak 配置
- 注册 https://thingspeak.com → Create Channel → 4 Fields
- 将 Write API Key 填入
esp8266.h中的THINGSPEAK_API_KEY - 修改 WiFi 账号密码:
esp8266.h→WIFI_SSID/WIFI_PASS
📂 项目结构
EnvMonitor/
├── EnvMonitor/ ← Keil + CubeMX 工程(当前唯一固件)
│ ├── Core/ HAL 配置 + main.c + 中断服务
│ ├── Drivers/ 8 个外设驱动 + FreeRTOS + ST HAL
│ │ ├── DHT22/ 温湿度(开漏模式,无锁)
│ │ ├── HC_SR04/ 超声波(TIM3 IC,零阻塞)
│ │ ├── OLED/ SSD1306 I2C 显示 + 字库
│ │ ├── ESP8266/ WiFi AT指令 + ThingSpeak
│ │ ├── BH1750/ 光照(已禁用,模块未购买)
│ │ ├── LED/ 三色指示灯
│ │ ├── Button/ 按键(状态机消抖)
│ │ └── Buzzer/ 蜂鸣器(已禁用,硬件不兼容)
│ ├── App/ 6 个 FreeRTOS 任务 + task_shared
│ ├── MDK-ARM/ Keil 工程文件
│ └── EnvMonitor.ioc CubeMX 项目
│
├── firmware/ ← 固件副本(开发阶段保留)
│
├── hardware/pcb/EnvMonitor/ ← KiCad PCB 设计
│ ├── EnvMonitor.kicad_* 工程文件
│ ├── BOM_EnvMonitor.md 完整物料清单
│ ├── EnvMonitor_Gerber_Full.zip 嘉立创打样包
│ ├── gerber/ Gerber 源文件
│ └── analysis/ 出厂分析报告📝 开发历程
| 阶段 | 内容 | 状态 |
|---|---|---|
| P0 | 项目规划 + 器件采购 | ✅ |
| P1-P6 | 裸机固件:8 驱动 + 5 页菜单 + 报警 + 上云 | ✅ |
| P7 | FreeRTOS 6 任务重构 | ✅ |
| P8 | KiCad 原理图 → 布局 → 布线 → DRC → Gerber | ✅ |
| P9 | 嘉立创打样 → 焊接 → 联调 → 发布 | ✅ |
🔥 关键问题与解决
完整记录见
docs/开发日志.md
| # | 问题 | 根因 | 解决 |
|---|---|---|---|
| 1 | Keil 编译 cannot open oled.h | 循环包含:main.h ↔ 驱动 .h 互相 include | 驱动 .h 改用 stm32f1xx_hal.h,.c 先 include main.h |
| 2 | FreeRTOS 链接 4 个 Undefined | 调试钩子未实现,V10.x 默认开启 | 关闭 MallocFailedHook / StackOverflowHook / StaticAllocation |
| 3 | KiCad 标签放空白处 | 标签必须附着在导线上,否则 = 独立网络 | 标签放在导线段上,高亮确认后放下 |
| 4 | 按键消抖电路出错 | R/C/SW/MCU 未在同一节点,MCU 脚孤悬 | 四者交汇一点,SW 另一脚 → GND |
| 5 | 14 个元件 PCB 导入失败 | 封装名缺脚距后缀(如 _P2.54mm_Vertical) | 编辑 .kicad_sch 批量替换封装名 |
| 6 | 蜂鸣器方案紧急变更 | 实物 3 脚模块 vs 原理图 2 脚+NPN 驱动 | 换 3 脚排针,删 Q1/R13/R14/D5,MCU 直连 |
| 7 | GND 铺铜 DRC 仍报未连接 | 铺铜只创建轮廓,没填充 | 按 B 键填充所有区域 |
| 8 | Keil 缺 configUSE_16_BIT_TICKS | FreeRTOS V10.x 新增必选宏 | FreeRTOSConfig.h 补定义 |
| 9 | 面包板测试失败,跳过直接上 PCB | STM32 内部上拉 ~40kΩ 太弱,面包板寄生干扰导致引脚浮空、按键读值随机跳变 | 外部 10kΩ 上拉 + PCB 实体焊点可彻底解决,不在面包板上浪费时间 |
| 10 | FreeRTOS 启动后无反应 | 堆只有 6KB,6 任务栈+TCB+队列 ≈ 7.5KB | 堆→10KB,Sensor/Display 栈加大 |
| 11 | 运行 ~90s 后系统卡死 | DHT22 反复调 HAL_GPIO_Init 切换 GPIOA PA0,与按键 PA4/5/6 累积冲突 | 全程开漏 OUTPUT_OD,零 HAL_GPIO_Init 调用 |
| 12 | SR04 超声波无数据→卡死→中断风暴 | TIM3 NVIC 未使能、捕获极性残留、忙等阻塞 | 非阻塞架构:发 Trig 即返回,ISR 后台捕获 |
| 13 | 蜂鸣器任何时长都导致系统冻结 | 有源蜂鸣器模块与 I2C 共用 5V 电源轨,电流冲击→3.3V 抖动→I2C 锁死 | 永久禁用蜂鸣器,下一版 PCB 加独立去耦 |
| 14 | PCB 引脚与实物模块不匹配 | OLED/DHT22/ESP8266 的 KiCad 封装未按实物核对 | 杜邦线按信号名对接,下版先拍照再画 |
| 15 | WiFi 连接反复失败 | AT 指令返回 no change 被误判 ERROR、CWJAP 超时 | 忽略 CWMODE 返回值、15s 超时、30s 自动重试 |
💡 设计决策
| 决策 | 选择 | 理由 |
|---|---|---|
| RTOS | FreeRTOS 原生 API | 不依赖 CMSIS-RTOS 封装,社区资源多 |
| WiFi | ESP8266 AT 指令 + HTTP GET | ThingSpeak 原生支持,无需 MQTT broker |
| PCB | 全插件 THT + 模块化 | 新手可焊,Blue Pill 已有电路不重复画 |
| EDA | KiCad 10.0 | 开源免费,S-expression 格式透明 |
| I2C | OLED + BH1750 同总线 | 地址不同(0x3C/0x46),不冲突,省 GPIO |
📚 学习历程
这个项目最大的收获不是做出来一个东西,而是 5 天里从零啃下了 4 块硬骨头:
| 技能 | 项目前 | 项目后 |
|---|---|---|
| STM32 开发方式 | 只会标准库,没碰过 HAL | CubeMX 配置 + HAL 库驱动开发,理解句柄/初始化回调 |
| FreeRTOS | 完全不了解 | 6 任务抢占式调度,互斥量/队列/软件定时器,SysTick 三分天下 |
| PCB 设计 | 零基础,没画过板 | KiCad 10.0 原理图→封装→布局→布线→铺铜→DRC→Gerber 全流程 |
| 项目工程化 | 单文件裸机循环 | 三层架构(Drivers/App/Core),Git 版本控制,README 文档规范 |
| 整机联调 | 从没摸过烙铁 | 27 元件从矮到高焊接、万用表排错、杜邦线飞线适配 |
| 实时系统调试 | 只会裸机 while(1) | FreeRTOS 死锁/优先级反转/栈溢出/中断风暴全套排查 |
💡 KiCad 入门借助了 Claude Code 的 KiCad Skill 辅助分析,但具体画板——元件摆放、走线、铺铜——还是得自己动手一刀一刀画,其实我以为可以让ai帮我解决排线问题,实则搞半天还是得自己来而且第一次画确实特别乱,没有经验,更改了很多遍
💡 联调阶段的两天比前面五天的学习密度都大。裸机代码跑通了不叫完成——上真实 PCB 后才发现堆不够、GPIO 冲突、中断没注册、电源轨打架……每一个问题都要从硬件和软件两边同时排查。蜂鸣器的教训最深刻:写代码之前要先理解外设的电气特性,不是所有 "IO 控制" 的器件都一样。
💡 这次最大的进步是学会了一件事:不猜。 前期遇到卡死就改锁、改栈、改延时——都是猜。后期学会用 LED 闪码、逐模块隔离来定位根因。方法对了,再顽固的 BUG 也能找到。
💬 开发心得
这是我的第一个嵌入式 IoT 项目。从零开始,一路踩坑,做个总结。
HAL 库和标准库差别很大,一开始连 CubeMX 生成代码的工程结构都搞不清楚。KiCad 也是现学的,元件封装名少个后缀就导不进 PCB,画板子毫无经验,走线乱成一团,元器件摆放也没有章法。第一次打样回来发现 PCB 连接器引脚排列和实物模块对不上,只能全部用杜邦线飞线——画封装的时候完全是凭想象,没拿到实物对照。
调试阶段更是一言难尽。FreeRTOS 堆设小了系统起不来,DHT22 关中断导致调度器崩溃,超声波模块折腾了五六种方案最后才用非阻塞 TIM3 捕获解决,WiFi 连接反复超时。最遗憾的还是蜂鸣器——因为不了解有源蜂鸣器模块的电气特性,5V 共用电源轨导致 I2C 受干扰死锁,最后不得不阉割掉。最初规划的功能砍了不少,BH1750 没买,距离报警不敢加蜂鸣,按键反馈也没了声音。
最后做出来的东西离最初的设想差距不小,差不多是个超级阉割版。但至少完整跑起来了——能测温湿度、能测距、能显示、能上云,善始善终。
希望下一个项目会更严谨:画板前先拿实物拍照确认封装、电源去耦提前规划、外设驱动先在最小系统上验证再整合。不断进步吧。
📄 许可
MIT License
Parts
27| Qty | Value | Footprint | References |
|---|---|---|---|
| 3 | 100nF | Capacitor_THT:C_Disc_D3.0mm_W2.0mm_P2.50mm | C18, C19, C20 |
| 3 | 10k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P2.54mm_Vertical | R7, R8, R9 |
| 3 | 330 | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P2.54mm_Vertical | R10, R11, R12 |
| 3 | 4.7k | Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P2.54mm_Vertical | R4, R5, R6 |
| 2 | 100uF/10V | Capacitor_THT:CP_Radial_D5.0mm_P2.50mm | C21, C22 |
| 1 | Buzzer | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | LS1 |
| 1 | CoreBoard_L | Connector_PinHeader_2.54mm:PinHeader_2x20_P2.54mm_Vertical | H1 |
| 1 | CoreBoard_R | Connector_PinHeader_2.54mm:PinHeader_2x20_P2.54mm_Vertical | H2 |
| 1 | DHT22 | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J2 |
| 1 | ESP8266-01S | Connector_PinHeader_2.54mm:PinHeader_2x04_P2.54mm_Vertical | J5 |
| 1 | HC-SR04 | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J4 |
| 1 | KEY1 | Button_Switch_THT:SW_PUSH_6mm | SW2 |
| 1 | KEY2 | Button_Switch_THT:SW_PUSH_6mm | SW3 |
| 1 | KEY3 | Button_Switch_THT:SW_PUSH_6mm | SW4 |
| 1 | LED_红 | LED_THT:LED_D3.0mm | D2 |
| 1 | LED_绿 | LED_THT:LED_D3.0mm | D4 |
| 1 | LED_黄 | LED_THT:LED_D3.0mm | D3 |
| 1 | OLED+BH1750 | Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_Vertical | J3 |
Similar boards
- 2 layers

- 4 layers95 × 76.2 mm

- 2 layers138.8 × 55 mm

MuxPi
SamsungSLAV/muxpi
MuxPi is an open hardware and open software board which was designed to aid in automating tasks on physical devices.
354 parts22Apache-2.0 - 4 layers58.5 × 85.5 mm

- 2 layers125.7 × 97.8 mm

Qdisk v4
alvaroalea/QL_CST_FLoppyController
A clone of the CST's Floppy Disk Interface for Sinclair QL (PCB version 3 & 4)
31 parts8 - 4 layers130 × 90 mm

- 2 layers99.9 × 100 mm

- 2 layers127 × 71 mm

Questions
How big is the EnvMonitor PCB?
It measures 80 × 60 mm and has 2 copper layers, 1.6 mm thick.
What parts does the EnvMonitor use?
27 parts, built around the DHT22, 100UF 10V 4*7 and HC-SR04. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.
Where can I download the EnvMonitor KiCad files?
From the kennySzhucheng/EnvMonitor repository on GitHub, at the commit this page was made from: the board is hardware/pcb/EnvMonitor/EnvMonitor.kicad_pcb and its schematic hardware/pcb/EnvMonitor/EnvMonitor.kicad_sch. PCBKit opens the board in the browser, with nothing to install.
Can I use the EnvMonitor design in my own project?
Its repository states no licence, so its author keeps all rights: ask kennySzhucheng before reusing the design.








