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

项目需求与模块拆分

项目需求与模块拆分

本课把“做一个环境监测终端”从模糊想法转成可验收的工程任务,并将采集、显示、报警、通信和存储拆成边界清楚的模块。完成后,你会得到一份能指导原理图、固件接口、联调顺序和测试工作的需求基线。

学习目标

  • 将自然语言需求改写为可测量、可验收的条目
  • 按职责、数据流和依赖关系拆分软硬件模块
  • 使用自动检查确认每条需求都有唯一责任模块

先定义可验收的需求

需求不能只写“实时采集”“及时报警”或“稳定通信”,因为这些说法无法直接测试。应同时写明触发条件、输入输出、时间约束和失败处理,让开发者与测试者对“完成”的理解一致。

以下是一组适合教学项目的最小需求基线。阈值和周期是项目约束,不是所有设备都必须采用的固定数值。

编号 需求 验收条件
REQ-SAMPLE 周期采集温度数据 每 1000 ms 产生一次有效样本;传感器失败时上报错误状态
REQ-DISPLAY 显示最新温度与设备状态 新样本产生后 500 ms 内刷新;无效数据不得显示为正常值
REQ-ALARM 超过阈值时报警 温度连续 3 次高于 60 °C 后启动声光报警
REQ-COMM 通过串口输出状态帧 使用 115200 8N1;每秒发送一次温度、报警和错误字段
REQ-STORE 保存关键事件 报警开始、报警解除和传感器故障均写入非易失存储器

对每条需求,还应记录“暂不包含什么”。例如,本阶段只要求串口通信,不包含无线联网;只保存事件,不保存全部原始采样。明确非目标可以防止项目在实现过程中不断膨胀。

按职责拆分模块

模块拆分的目标不是文件越多越好,而是让每个模块拥有单一责任、稳定接口和可独立验证的行为。应用层负责业务编排,驱动层负责设备访问,底层硬件变化不应直接扩散到报警、显示或通信逻辑。

模块 主要输入 主要输出 责任边界
采集模块 定时触发、传感器原始值 温度样本、采集状态 读取与校验数据,不决定是否报警
显示模块 温度、报警状态、错误状态 屏幕内容 只负责呈现,不修改业务状态
报警模块 温度样本、阈值配置 报警状态、蜂鸣器与指示灯控制 实现连续超限判定与解除策略
通信模块 系统状态快照 串口数据帧 负责编码和发送,不直接读取传感器
存储模块 事件记录请求 写入结果、最近事件 负责格式、校验和写入策略
应用调度模块 系统时基、模块状态 调用顺序与状态分发 连接各模块,但不包含设备寄存器操作

最重要的依赖规则是“上层依赖接口,下层不反向调用业务”。例如,报警模块可以接收采集模块产生的样本,但传感器驱动不应知道报警阈值,更不应直接控制蜂鸣器。

项目需求到模块拆分与数据流关系

用接口和数据流连接模块

拆分完成后,应先约定模块交换的数据,而不是立即编写全部驱动。一个稳定的状态快照至少可以包含温度值、样本是否有效、报警状态和故障码;通信、显示和存储都读取这份快照,从而避免各自重复访问硬件。

接口设计还要区分“周期数据”和“事件”。温度样本适合按固定周期发布;报警开始、解除和设备故障适合形成事件,仅在状态变化时通知存储模块。这样既能降低 Flash 写入次数,也便于后续追踪故障发生顺序。

可运行的需求覆盖检查

下面的 Python 程序把需求编号与责任模块写成两份独立数据,并检查是否存在遗漏、未知编号或多模块重复负责。将代码保存为 requirement_check.py。

python
requirements = {
    "REQ-SAMPLE": "周期采集温度数据",
    "REQ-DISPLAY": "显示最新温度与设备状态",
    "REQ-ALARM": "连续超限后启动报警",
    "REQ-COMM": "串口输出状态帧",
    "REQ-STORE": "保存关键事件",
}

modules = {
    "采集模块": {"REQ-SAMPLE"},
    "显示模块": {"REQ-DISPLAY"},
    "报警模块": {"REQ-ALARM"},
    "通信模块": {"REQ-COMM"},
    "存储模块": {"REQ-STORE"},
}

owners = {}
errors = []

for module_name, requirement_ids in modules.items():
    for requirement_id in requirement_ids:
        if requirement_id not in requirements:
            errors.append(f"未知需求: {requirement_id}")
            continue
        owners.setdefault(requirement_id, []).append(module_name)

for requirement_id in requirements:
    module_owners = owners.get(requirement_id, [])
    if not module_owners:
        errors.append(f"需求未分配: {requirement_id}")
    elif len(module_owners) > 1:
        errors.append(
            f"需求重复分配: {requirement_id} -> {', '.join(module_owners)}"
        )

if errors:
    print("覆盖检查失败")
    for error in errors:
        print(f"- {error}")
    raise SystemExit(1)

print(f"覆盖检查通过:{len(requirements)} 条需求均有唯一责任模块。")
for requirement_id, description in requirements.items():
    print(f"{requirement_id} -> {owners[requirement_id][0]}:{description}")

运行命令:

bash
python3 requirement_check.py

预期输出:

text
覆盖检查通过:5 条需求均有唯一责任模块。
REQ-SAMPLE -> 采集模块:周期采集温度数据
REQ-DISPLAY -> 显示模块:显示最新温度与设备状态
REQ-ALARM -> 报警模块:连续超限后启动报警
REQ-COMM -> 通信模块:串口输出状态帧
REQ-STORE -> 存储模块:保存关键事件

这段检查只验证“责任归属”,不代表其他模块不能提供支持。例如,应用调度模块会调用采集模块并分发状态,但 REQ-SAMPLE 的实现责任仍归采集模块。保持唯一责任有助于定位缺陷和安排测试。

验收与变更控制

进入原理图和编码阶段前,应冻结一版需求基线,并为每条需求指定验证方法:周期类需求测量时间间隔,通信类需求抓取数据帧,报警类需求构造阈值边界,存储类需求执行断电重启检查。

需求发生变化时,先更新编号、验收条件和责任模块,再评估受影响的接口、引脚、存储容量与测试用例。不要只在代码中临时增加分支,否则文档、硬件和固件会逐渐失去一致性。

本课总结

  • 可验收需求必须包含明确条件、输出、时序和失败处理
  • 模块应按单一责任拆分,并通过稳定的数据结构和事件连接
  • 需求覆盖检查能在编码前发现遗漏、重复负责和边界不清

下一课预告

下一课将进入“原理图、物料与引脚规划”,把本课的模块边界落实为供电、总线、器件连接和 MCU 引脚分配,并提前排除复用功能冲突。

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

目录与阅读设置

阅读设置

17

记录一个想法

项目需求与模块拆分

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

登录哪都通