Skip to the content
2 layers80 × 60 mmEnvMonitor, the printed circuit board in 3D

🌡️ 智能环境监测站 | 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

3

README

README.md

EnvMonitor — 智能环境监测站

STM32F103C8T6 + FreeRTOS + ESP8266 桌面环境监测终端 | 练习项目

一个从零开始搭建的嵌入式 IoT 项目:裸机固件 → FreeRTOS 重构 → KiCad 画板 → 嘉立创打样,走完嵌入式产品全流程。


📸 实物展示

PCB 制板 & 焊接

空板正面细节焊接完成
PCB空板PCB细节焊接完成

OLED 功能页面

启动画面主页详情页
启动主页详情
设置页WiFi 已连接关于页
设置WiFi关于

✨ 功能

模块作用
🌡️ DHT22温湿度传感器,单总线(1-Wire)通信,精度 ±0.5°C / ±2%RH,挂在 PA0 上
☀️ BH1750环境光强度传感器,I²C 接口,0~65535 lux 量程,和 OLED 共用 PB6/PB7
📏 HC-SR04超声波测距模块,探测前方物体距离,用于"有人靠近"检测,PB0 发触发信号、PB1 输入捕获回波
🖥️ OLED SSD13060.96 寸 I²C 显示屏,5 页菜单循环切换(温湿度/光照/距离/WiFi/系统信息)
📡 ESP8266-01SWiFi 模块,通过 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Ω 外部上拉
⏱️ FreeRTOS6 个任务抢占式调度,3 个互斥量保护共享资源,2 条队列做任务间通信
🛡️ 自定义 PCBKiCad 10 设计,80×60mm 双面板,全插件 27 元件,双面 GND 铺铜

🧱 硬件架构

text
                    ┌──────────────────────────────────┐
                    │        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)

📐 引脚分配

引脚外设功能
PA0DHT221-Wire 单总线
PA4/PA5/PA6KEY1/KEY2/KEY3按键输入(10kΩ 上拉)
PA9/PA10ESP8266USART1 TX/RX
PB0HC-SR04 Trig触发信号
PB1HC-SR04 EchoTIM3_CH4 输入捕获
PB6/PB7OLED SSD1306I2C1 SCL/SDA
PB12/PB13/PB14LED_R/Y/G报警指示灯
PB15Buzzer有源蜂鸣器模块 IO
PA13/PA14SWDIO/SWCLKST-Link 调试(保留)

🖥️ 软件架构

text
                    ┌───────────────┐
                    │   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.54mm2H1, H2(Blue Pill 直焊)
排针1×4P 2.54mm3J2, J3, J4
排针2×4P 2.54mm1J5
排针1×3P 2.54mm1LS1
电阻330Ω 1/4W3R10, R11, R12
电阻4.7kΩ 1/4W3R4, R5, R6
电阻10kΩ 1/4W3R7, R8, R9
瓷片电容100nF (104)3C18, C19, C20
电解电容100µF/10V2C21, C22
LED 3mm红/黄/绿3D2, D3, D4
轻触开关6×6mm3SW2, SW3, SW4

外接模块(实际使用 5 个,闲置 2 个)

模块数量状态
STM32F103C8T6 Blue Pill1✅ 使用中
DHT22 温湿度传感器1✅ 使用中
OLED 0.96" SSD13061✅ 使用中
HC-SR04 超声波1✅ 使用中
ESP8266-01S WiFi1✅ 使用中
GY-302 光照 (BH1750)1❌ 未购买,固件已禁用
5V 有源蜂鸣器模块1❌ 电源冲突,已禁用

💰 全部物料实际花费约 90 元。BH1750 在设计阶段列入 BOM 但实际未采购。蜂鸣器模块已购买但因与 I2C 共用 5V 电源轨导致系统冻结,无法使用(需下一版 PCB 加独立去耦电路)。完整清单见 hardware/pcb/EnvMonitor/BOM_EnvMonitor.md


🔧 开发环境

工具用途
Keil MDK5固件编译/烧录
STM32CubeMX引脚配置 + HAL 代码生成
STM32CubeF1 V1.8.7HAL 库 + FreeRTOS 源码
ST-Link V2调试/烧录器
KiCad 10.0原理图 + PCB 设计
ThingSpeakIoT 数据可视化云平台

编译

  1. 用 CubeMX 打开 EnvMonitor.ioc 重新生成代码(如需要)
  2. EnvMonitor\MDK-ARM\EnvMonitor.uvprojx → Keil 打开
  3. 确认 Include Paths 包含:Drivers/*、App/、FreeRTOS/include、FreeRTOS/portable/RVDS/ARM_CM3
  4. Build (F7) → 0 Error → Download (F8)

ThingSpeak 配置

  1. 注册 https://thingspeak.com → Create Channel → 4 Fields
  2. 将 Write API Key 填入 esp8266.h 中的 THINGSPEAK_API_KEY
  3. 修改 WiFi 账号密码:esp8266.h → WIFI_SSID / WIFI_PASS

📂 项目结构

text
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 页菜单 + 报警 + 上云✅
P7FreeRTOS 6 任务重构✅
P8KiCad 原理图 → 布局 → 布线 → DRC → Gerber✅
P9嘉立创打样 → 焊接 → 联调 → 发布✅

🔥 关键问题与解决

完整记录见 docs/开发日志.md

#问题根因解决
1Keil 编译 cannot open oled.h循环包含:main.h ↔ 驱动 .h 互相 include驱动 .h 改用 stm32f1xx_hal.h,.c 先 include main.h
2FreeRTOS 链接 4 个 Undefined调试钩子未实现,V10.x 默认开启关闭 MallocFailedHook / StackOverflowHook / StaticAllocation
3KiCad 标签放空白处标签必须附着在导线上,否则 = 独立网络标签放在导线段上,高亮确认后放下
4按键消抖电路出错R/C/SW/MCU 未在同一节点,MCU 脚孤悬四者交汇一点,SW 另一脚 → GND
514 个元件 PCB 导入失败封装名缺脚距后缀(如 _P2.54mm_Vertical)编辑 .kicad_sch 批量替换封装名
6蜂鸣器方案紧急变更实物 3 脚模块 vs 原理图 2 脚+NPN 驱动换 3 脚排针,删 Q1/R13/R14/D5,MCU 直连
7GND 铺铜 DRC 仍报未连接铺铜只创建轮廓,没填充按 B 键填充所有区域
8Keil 缺 configUSE_16_BIT_TICKSFreeRTOS V10.x 新增必选宏FreeRTOSConfig.h 补定义
9面包板测试失败,跳过直接上 PCBSTM32 内部上拉 ~40kΩ 太弱,面包板寄生干扰导致引脚浮空、按键读值随机跳变外部 10kΩ 上拉 + PCB 实体焊点可彻底解决,不在面包板上浪费时间
10FreeRTOS 启动后无反应堆只有 6KB,6 任务栈+TCB+队列 ≈ 7.5KB堆→10KB,Sensor/Display 栈加大
11运行 ~90s 后系统卡死DHT22 反复调 HAL_GPIO_Init 切换 GPIOA PA0,与按键 PA4/5/6 累积冲突全程开漏 OUTPUT_OD,零 HAL_GPIO_Init 调用
12SR04 超声波无数据→卡死→中断风暴TIM3 NVIC 未使能、捕获极性残留、忙等阻塞非阻塞架构:发 Trig 即返回,ISR 后台捕获
13蜂鸣器任何时长都导致系统冻结有源蜂鸣器模块与 I2C 共用 5V 电源轨,电流冲击→3.3V 抖动→I2C 锁死永久禁用蜂鸣器,下一版 PCB 加独立去耦
14PCB 引脚与实物模块不匹配OLED/DHT22/ESP8266 的 KiCad 封装未按实物核对杜邦线按信号名对接,下版先拍照再画
15WiFi 连接反复失败AT 指令返回 no change 被误判 ERROR、CWJAP 超时忽略 CWMODE 返回值、15s 超时、30s 自动重试

💡 设计决策

决策选择理由
RTOSFreeRTOS 原生 API不依赖 CMSIS-RTOS 封装,社区资源多
WiFiESP8266 AT 指令 + HTTP GETThingSpeak 原生支持,无需 MQTT broker
PCB全插件 THT + 模块化新手可焊,Blue Pill 已有电路不重复画
EDAKiCad 10.0开源免费,S-expression 格式透明
I2COLED + BH1750 同总线地址不同(0x3C/0x46),不冲突,省 GPIO

📚 学习历程

这个项目最大的收获不是做出来一个东西,而是 5 天里从零啃下了 4 块硬骨头:

技能项目前项目后
STM32 开发方式只会标准库,没碰过 HALCubeMX 配置 + 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
QtyValueFootprintReferences
3100nFCapacitor_THT:C_Disc_D3.0mm_W2.0mm_P2.50mmC18, C19, C20
310kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P2.54mm_VerticalR7, R8, R9
3330Resistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P2.54mm_VerticalR10, R11, R12
34.7kResistor_THT:R_Axial_DIN0207_L6.3mm_D2.5mm_P2.54mm_VerticalR4, R5, R6
2100uF/10VCapacitor_THT:CP_Radial_D5.0mm_P2.50mmC21, C22
1BuzzerConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalLS1
1CoreBoard_LConnector_PinHeader_2.54mm:PinHeader_2x20_P2.54mm_VerticalH1
1CoreBoard_RConnector_PinHeader_2.54mm:PinHeader_2x20_P2.54mm_VerticalH2
1DHT22Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ2
1ESP8266-01SConnector_PinHeader_2.54mm:PinHeader_2x04_P2.54mm_VerticalJ5
1HC-SR04Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ4
1KEY1Button_Switch_THT:SW_PUSH_6mmSW2
1KEY2Button_Switch_THT:SW_PUSH_6mmSW3
1KEY3Button_Switch_THT:SW_PUSH_6mmSW4
1LED_红LED_THT:LED_D3.0mmD2
1LED_绿LED_THT:LED_D3.0mmD4
1LED_黄LED_THT:LED_D3.0mmD3
1OLED+BH1750Connector_PinHeader_2.54mm:PinHeader_1x04_P2.54mm_VerticalJ3

Similar boards

  • 4 layers95 × 76.2 mmDeWille Control, the printed circuit board in 3D

    DeWille Control

    zmeiresearch/DeWille

    A high-performance DIY audio DAC

    171 parts23
  • 2 layers138.8 × 55 mmMuxPi, the printed circuit board in 3D

    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 mmSr jv esp32, the printed circuit board in 3D

    Sr jv esp32

    connorzheng97/srjv

    SR-JV80 Programmable Expansion Card with ESP32 Wi-Fi

    84 parts18
  • 2 layers125.7 × 97.8 mmQdisk v4, the printed circuit board in 3D

    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 mmLochord hw, the printed circuit board in 3D

    Lochord hw

    kiwifruit0/LoChord

    An open-source version of the popular midi device: HiChord

    91 parts6
  • 2 layers99.9 × 100 mmHL2 Companion, the printed circuit board in 3D

    HL2 Companion

    bnamnaidu/HL2-Companion-board-codec-and-Filter-

    194 parts4
  • 2 layers127 × 71 mmRgb input, the printed circuit board in 3D

    Rgb input

    hoeken/yarrboard-hardware

    Hardware for the Yarrboard open hardware project

    118 parts4GPL-3.0

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.