单片机与物联网 / 系统课时
项目需求与模块拆分
项目需求与模块拆分
本课把“做一个环境监测终端”从模糊想法转成可验收的工程任务,并将采集、显示、报警、通信和存储拆成边界清楚的模块。完成后,你会得到一份能指导原理图、固件接口、联调顺序和测试工作的需求基线。
学习目标
- 将自然语言需求改写为可测量、可验收的条目
- 按职责、数据流和依赖关系拆分软硬件模块
- 使用自动检查确认每条需求都有唯一责任模块
先定义可验收的需求
需求不能只写“实时采集”“及时报警”或“稳定通信”,因为这些说法无法直接测试。应同时写明触发条件、输入输出、时间约束和失败处理,让开发者与测试者对“完成”的理解一致。
以下是一组适合教学项目的最小需求基线。阈值和周期是项目约束,不是所有设备都必须采用的固定数值。
| 编号 | 需求 | 验收条件 |
|---|---|---|
REQ-SAMPLE |
周期采集温度数据 | 每 1000 ms 产生一次有效样本;传感器失败时上报错误状态 |
REQ-DISPLAY |
显示最新温度与设备状态 | 新样本产生后 500 ms 内刷新;无效数据不得显示为正常值 |
REQ-ALARM |
超过阈值时报警 | 温度连续 3 次高于 60 °C 后启动声光报警 |
REQ-COMM |
通过串口输出状态帧 | 使用 115200 8N1;每秒发送一次温度、报警和错误字段 |
REQ-STORE |
保存关键事件 | 报警开始、报警解除和传感器故障均写入非易失存储器 |
对每条需求,还应记录“暂不包含什么”。例如,本阶段只要求串口通信,不包含无线联网;只保存事件,不保存全部原始采样。明确非目标可以防止项目在实现过程中不断膨胀。
按职责拆分模块
模块拆分的目标不是文件越多越好,而是让每个模块拥有单一责任、稳定接口和可独立验证的行为。应用层负责业务编排,驱动层负责设备访问,底层硬件变化不应直接扩散到报警、显示或通信逻辑。
| 模块 | 主要输入 | 主要输出 | 责任边界 |
|---|---|---|---|
| 采集模块 | 定时触发、传感器原始值 | 温度样本、采集状态 | 读取与校验数据,不决定是否报警 |
| 显示模块 | 温度、报警状态、错误状态 | 屏幕内容 | 只负责呈现,不修改业务状态 |
| 报警模块 | 温度样本、阈值配置 | 报警状态、蜂鸣器与指示灯控制 | 实现连续超限判定与解除策略 |
| 通信模块 | 系统状态快照 | 串口数据帧 | 负责编码和发送,不直接读取传感器 |
| 存储模块 | 事件记录请求 | 写入结果、最近事件 | 负责格式、校验和写入策略 |
| 应用调度模块 | 系统时基、模块状态 | 调用顺序与状态分发 | 连接各模块,但不包含设备寄存器操作 |
最重要的依赖规则是“上层依赖接口,下层不反向调用业务”。例如,报警模块可以接收采集模块产生的样本,但传感器驱动不应知道报警阈值,更不应直接控制蜂鸣器。

用接口和数据流连接模块
拆分完成后,应先约定模块交换的数据,而不是立即编写全部驱动。一个稳定的状态快照至少可以包含温度值、样本是否有效、报警状态和故障码;通信、显示和存储都读取这份快照,从而避免各自重复访问硬件。
接口设计还要区分“周期数据”和“事件”。温度样本适合按固定周期发布;报警开始、解除和设备故障适合形成事件,仅在状态变化时通知存储模块。这样既能降低 Flash 写入次数,也便于后续追踪故障发生顺序。
可运行的需求覆盖检查
下面的 Python 程序把需求编号与责任模块写成两份独立数据,并检查是否存在遗漏、未知编号或多模块重复负责。将代码保存为 requirement_check.py。
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}")运行命令:
python3 requirement_check.py预期输出:
覆盖检查通过:5 条需求均有唯一责任模块。
REQ-SAMPLE -> 采集模块:周期采集温度数据
REQ-DISPLAY -> 显示模块:显示最新温度与设备状态
REQ-ALARM -> 报警模块:连续超限后启动报警
REQ-COMM -> 通信模块:串口输出状态帧
REQ-STORE -> 存储模块:保存关键事件这段检查只验证“责任归属”,不代表其他模块不能提供支持。例如,应用调度模块会调用采集模块并分发状态,但 REQ-SAMPLE 的实现责任仍归采集模块。保持唯一责任有助于定位缺陷和安排测试。
验收与变更控制
进入原理图和编码阶段前,应冻结一版需求基线,并为每条需求指定验证方法:周期类需求测量时间间隔,通信类需求抓取数据帧,报警类需求构造阈值边界,存储类需求执行断电重启检查。
需求发生变化时,先更新编号、验收条件和责任模块,再评估受影响的接口、引脚、存储容量与测试用例。不要只在代码中临时增加分支,否则文档、硬件和固件会逐渐失去一致性。
本课总结
- 可验收需求必须包含明确条件、输出、时序和失败处理
- 模块应按单一责任拆分,并通过稳定的数据结构和事件连接
- 需求覆盖检查能在编码前发现遗漏、重复负责和边界不清
下一课预告
下一课将进入“原理图、物料与引脚规划”,把本课的模块边界落实为供电、总线、器件连接和 MCU 引脚分配,并提前排除复用功能冲突。