单片机与物联网 / 系统课时
设计项目架构
设计项目架构
环境监测终端如果一开始只按“能读到传感器”来写,后续接入 MQTT、离线缓存和 OTA 时很容易互相耦合。本节先冻结功能边界,再把采集、网络、上报、存储和升级拆成可独立替换的模块,形成可实现、可排障的项目蓝图。
学习目标
- 为环境监测终端定义明确的功能边界和非目标
- 按职责拆分硬件驱动、业务服务与网络能力,避免循环依赖
- 固化数据流、硬件清单和验收条件,为后续实现建立统一接口
先冻结最小功能边界
本项目把 ESP32 做成一个 Wi-Fi 环境监测终端:每 5 秒采集温湿度和照度,每 30 秒向 MQTT 上报一次;网络断开时继续采样并保留最近数据,恢复后继续上报;设备还要能接收维护指令并进入 OTA 流程。
第一版暂不做云端仪表盘、复杂规则引擎和长期本地数据库。把这些内容排除在边界之外很重要,因为架构设计的目标不是“把未来所有需求都提前实现”,而是让当前需求有清晰的所有者,并给高概率变化点留下接口。
模块按变化原因拆分
驱动层只处理具体硬件,服务层处理可复用能力,应用层负责调度。传感器型号变化时只改驱动和 SensorService;MQTT 主题或编码格式变化时只改 MqttService;OTA 失败也不应让采样模块失去工作能力。
| 模块 | 核心职责 | 不应该负责 |
|---|---|---|
SensorService |
读取传感器并生成统一样本 | 连接 Wi-Fi、发布 MQTT |
SampleStore |
保存最新样本和短时离线队列 | 直接访问传感器寄存器 |
NetworkService |
管理 Wi-Fi 连接与重连状态 | 解析业务数据 |
MqttService |
编码遥测数据并发布、接收命令 | 控制具体 GPIO |
OtaService |
检查版本、下载升级、报告结果 | 周期采样 |
AppController |
定时调度与状态协调 | 实现各驱动细节 |

固定数据流和故障隔离
遥测主路径应是“驱动读取原始值 → SensorService 生成统一样本 → SampleStore 保存 → MqttService 编码并发布”。模块之间传递稳定的数据结构,不让上层知道 I2C 寄存器或具体传感器型号,这样更换传感器时不会影响 MQTT 代码。
控制路径与遥测路径分开:云端维护命令由 MqttService 接收,再交给 AppController 判断是否进入维护状态,最后调用 OtaService。网络断开时 NetworkService 负责重连,采集任务继续运行;传感器读取失败时只标记该次样本无效,不阻塞网络维护能力。
用架构清单固化关键约束
下面是片段示例:project-architecture.yaml 是用于评审和任务拆分的项目约束清单,不是 ESP-IDF 原生配置文件。它把采样周期、引脚、队列容量和 MQTT/OTA 边界固定下来,避免不同模块各自写一套常量。
device:
id: env-terminal-01
timing:
sample_ms: 5000
publish_ms: 30000
hardware:
i2c:
sda_gpio: 21
scl_gpio: 22
sensors:
temperature_humidity: sht31
light: bh1750
services:
sample_store:
queue_depth: 60
mqtt:
telemetry_topic: devices/${device_id}/telemetry
command_topic: devices/${device_id}/commands
ota:
enabled: true
transport: https这份清单的生效行为不是“被 ESP-IDF 自动读取”,而是作为实现契约:各模块只能使用这里约定的引脚、周期和主题。验证时检查每个需求是否只有一个责任模块、同一 GPIO 是否被重复占用、采样周期是否短于上报周期,并确认离线队列容量能覆盖预期的短时网络抖动。
硬件清单先满足接口再谈型号
| 硬件 | 数量 | 接口 | 选择理由 |
|---|---|---|---|
| ESP32 开发板 | 1 | Wi-Fi、I2C | 提供主控、联网和 OTA 能力 |
| SHT31 模块 | 1 | I2C | 温湿度采集,接口简单 |
| BH1750 模块 | 1 | I2C | 环境照度采集,可与 SHT31 共总线 |
| 0.96 英寸 OLED | 0~1 | I2C | 本地显示状态,可先不装 |
| 稳定 5V 电源 | 1 | USB/5V | 避免 Wi-Fi 发射和升级时供电波动 |
实际接线前要用 I2C 扫描确认模块地址,并核对开发板引脚是否适合当前硬件版本。硬件清单里还应预留调试串口和可控复位方式,它们在综合排障阶段比“多一个传感器”更有价值。
用故障场景验收架构
架构图不是交付物本身,能否隔离故障才是验收标准。断开 Wi-Fi 两分钟后,采样应继续并进入本地队列;恢复网络后 MQTT 能继续发送。拔掉一个传感器时,网络重连和 OTA 仍应可用;升级期间进入维护状态后,要暂停可能与 Flash 或关键资源冲突的操作。
当每个故障都能定位到单一责任模块,数据主路径没有反向依赖,硬件和周期参数也有唯一来源时,这个架构才具备进入编码阶段的条件。