单片机与物联网 / 系统课时

设计项目架构

设计项目架构

环境监测终端如果一开始只按“能读到传感器”来写,后续接入 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 边界固定下来,避免不同模块各自写一套常量。

yaml
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 或关键资源冲突的操作。

当每个故障都能定位到单一责任模块,数据主路径没有反向依赖,硬件和周期参数也有唯一来源时,这个架构才具备进入编码阶段的条件。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

设计项目架构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通