单片机与物联网 / 系统课时
性能优化与项目交付
性能优化与项目交付
项目功能完成后,还需要证明它在目标资源和使用条件下稳定运行。本课将把处理器占用、内存、功耗和回归测试转化为可验收指标,并建立从测量、优化、复测到固件与文档打包的完整交付闭环。
学习目标
- 使用可量化指标识别处理器、内存和功耗瓶颈
- 在不破坏功能的前提下完成优化与回归验证
- 整理包含固件、源码、接线图和使用说明的可复现交付包
先建立基线和验收门槛
优化前必须保存同一固件、同一负载和同一测量窗口下的基线。处理器占用可用空闲任务计数或运行时统计测量;内存应同时记录静态占用、堆峰值和任务栈余量;功耗需区分运行、等待和唤醒阶段。没有基线时,“变快了”或“更省电”无法被复核。
| 指标 | 推荐记录值 | 示例门槛 |
|---|---|---|
| CPU 占用 | 平均值与峰值 | 峰值不超过 50% |
| RAM | 静态占用、堆峰值、最小栈余量 | 总占用不超过可用 RAM 的 80% |
| Flash | 固件大小与增长量 | 保留升级和日志空间 |
| 功耗 | 平均电流、峰值电流、唤醒时间 | 平均电流不超过 8.0 mA |
| 稳定性 | 长稳时长、复位次数、错误计数 | 验收窗口内无异常复位 |
按瓶颈顺序优化并回归
先定位占比最大的瓶颈,再做单一改动。CPU 优化通常从减少轮询、缩短临界区、批量处理和使用 DMA 开始;内存优化应先删除重复缓冲、缩小生命周期和检查任务栈,而不是直接压缩所有数组;功耗优化则要结合外设时钟关闭、任务事件化和 Sleep 或 Stop 模式。

每次优化只改变一个主要因素,并在相同输入下复测。若 CPU 下降但丢包率上升,优化不成立;若平均功耗降低但唤醒时间超过业务允许值,也不能通过验收。性能、功能和时序必须作为同一组约束检查。
用脚本自动执行验收检查
下面的示例使用一个 JSON 报告记录实测数据,再由 Python 脚本检查门槛和交付物。动态时间、构建路径和版本号可在真实项目中替换为 <TIME>、<PATH> 和 <ID>。
将以下内容保存为 project_report.json:
{
"cpu_percent": 43.5,
"cpu_limit_percent": 50.0,
"ram_used_bytes": 23840,
"ram_limit_bytes": 28672,
"average_current_ma": 7.8,
"current_limit_ma": 8.0,
"tests_passed": 42,
"tests_total": 42,
"artifacts": [
"firmware.bin",
"firmware.elf",
"source.zip",
"wiring.pdf",
"README.md"
]
}将以下程序保存为 acceptance_check.py:
import json
import sys
from pathlib import Path
REQUIRED_ARTIFACTS = [
"firmware.bin",
"firmware.elf",
"source.zip",
"wiring.pdf",
"README.md",
]
def load_report(path: Path) -> dict:
with path.open("r", encoding="utf-8") as file:
return json.load(file)
def main() -> int:
if len(sys.argv) != 2:
print("用法: python3 acceptance_check.py project_report.json")
return 2
report = load_report(Path(sys.argv[1]))
results = []
cpu_ok = report["cpu_percent"] <= report["cpu_limit_percent"]
results.append(cpu_ok)
print(
f"[{'PASS' if cpu_ok else 'FAIL'}] CPU 占用: "
f"{report['cpu_percent']:.1f}% <= {report['cpu_limit_percent']:.1f}%"
)
ram_ok = report["ram_used_bytes"] <= report["ram_limit_bytes"]
results.append(ram_ok)
print(
f"[{'PASS' if ram_ok else 'FAIL'}] RAM 使用: "
f"{report['ram_used_bytes']} B <= {report['ram_limit_bytes']} B"
)
power_ok = report["average_current_ma"] <= report["current_limit_ma"]
results.append(power_ok)
print(
f"[{'PASS' if power_ok else 'FAIL'}] 平均电流: "
f"{report['average_current_ma']:.1f} mA <= {report['current_limit_ma']:.1f} mA"
)
tests_ok = report["tests_passed"] == report["tests_total"]
results.append(tests_ok)
print(
f"[{'PASS' if tests_ok else 'FAIL'}] 回归测试: "
f"{report['tests_passed']}/{report['tests_total']}"
)
missing = [name for name in REQUIRED_ARTIFACTS if name not in report["artifacts"]]
artifacts_ok = not missing
results.append(artifacts_ok)
if artifacts_ok:
print("[PASS] 交付物完整: " + ", ".join(REQUIRED_ARTIFACTS))
else:
print("[FAIL] 缺少交付物: " + ", ".join(missing))
if all(results):
print("结论: 验收通过,可以生成发布包。")
return 0
print("结论: 验收失败,修复后重新执行完整回归。")
return 1
if __name__ == "__main__":
raise SystemExit(main())运行检查:
python3 acceptance_check.py project_report.json预期输出
[PASS] CPU 占用: 43.5% <= 50.0%
[PASS] RAM 使用: 23840 B <= 28672 B
[PASS] 平均电流: 7.8 mA <= 8.0 mA
[PASS] 回归测试: 42/42
[PASS] 交付物完整: firmware.bin, firmware.elf, source.zip, wiring.pdf, README.md
结论: 验收通过,可以生成发布包。整理可复现的交付包
交付包至少应包含可直接烧录的 firmware.bin、用于调试的 firmware.elf、与发布版本一致的源码归档、接线图、引脚表、构建说明、烧录步骤、通信协议、已知限制和验收报告。源码应标记版本,固件和归档文件应记录 SHA-256,便于确认传输后文件未被修改。
交付前应在一台未参与开发的计算机上按说明重新构建或至少重新烧录,并由未编写主要代码的人执行一次冒烟测试。这样可以发现隐藏的本地路径、遗漏依赖、默认参数和“只有开发者知道”的操作步骤。
常见失败与验收练习
常见失败包括只优化平均值而未检查峰值、缩小缓冲后未测试突发数据、关闭外设时钟后遗漏恢复顺序,以及只交付二进制却没有版本和配置记录。修复后必须重新执行功能、性能、掉电恢复和长稳测试,不能只复测被修改的一个场景。
- 把
cpu_percent改为56.0,运行验收脚本并记录失败项。要求脚本返回非零状态,且不影响 RAM、功耗、测试和交付物检查的输出。 - 为一个 64 KB Flash、20 KB RAM 的项目制定发布门槛。要求至少覆盖固件大小、RAM 峰值、任务栈余量、平均电流、连续运行时长和回归通过率;验收条件是每个指标都有测量方法与明确阈值。
本课总结
- 性能优化必须从统一条件下的基线开始,并用单一改动和完整回归验证收益
- CPU、内存、功耗、功能和时序是共同约束,不能只优化其中一个数字
- 合格交付包不仅包含固件,还要包含可追溯源码、接线资料、使用说明、测试证据和文件校验信息
下一课预告
本章到此完成。下一阶段可在真实硬件和目标负载上开展更长时间的可靠性测试、自动化构建与现场问题追踪,把课程中的方法扩展为持续维护流程。