嵌入式 Linux 系统工程 120：整机验收与故障报告

第 120 / 120 课 · 隔离与综合工程案例。返回课程合集。

机制与资源关系

验收将功能、性能和恢复能力放在明确条件下测试。固定固件、硬件、模型和配置，定义吞吐、尾延迟、资源上限、温度及恢复时间。未执行的板端实验不能记为通过。

实际用法与观察入口

以下是操作说明；先确认执行环境、工具帮助和目标对象。设备名、PID、地址及项目名示例需要按实际替换，不能将整段命令当通用板端脚本执行。

1
2

# 本课包含报告模板、资源索引和有界只读采集脚本
sh collect.sh

输出解读与排查顺序

每个结论关联原始证据及条件，区分已验证、条件有限和未执行。保存最小复现输入和修改前后对照；恢复成功仍需说明根因是否消除。

情境推演

修复后只跑一次启动成功不足以覆盖原本三天后出现的故障。回归至少覆盖触发条件、错误恢复和资源趋势，并把未完成的长期验证保留为未执行。

练习与参考分析

用本课模板完成一个故障闭环：现象→影响→证据→假设→实验→修复→回归。参考结论：只写“重启后正常”属于恢复记录，尚未完成根因分析。

独立实验包

有界只读采集和可填写模板；不执行板端压力、掉电、升级或可靠性测试。 默认入口、源文件和实际运行记录都在下载包中。

#!/bin/sh
set -eu
# /proc/self refers to each reader command, not a selected business process.
# Fixed allowlist: no environment, command lines, credentials or recursive traversal.
printf 'embedded Linux bounded read-only snapshot\n'
uname -srm
for file in /proc/uptime /proc/meminfo /proc/loadavg /proc/self/status /proc/self/limits /proc/self/cgroup /proc/net/dev; do
    printf '\nSOURCE %s (first 24 lines)\n' "$file"
    if [ -r "$file" ]; then
        sed -n '1,24p' "$file" || printf 'READ_FAILED %s\n' "$file"
    else
        printf 'UNAVAILABLE %s\n' "$file"
    fi
done
printf '\nEND snapshot; SDK, board revision and firmware manifest require manual entry\n'

cd 'content/posts/驱动、bootloader、文件系统/嵌入式Linux系统工程/120-整机验收与故障报告/code' && sh collect.sh

Linux 资源速查表

这些入口并非每个 BSP 都有；不存在、不可读与数值为零必须分别记录。查询其他进程需相应权限。可写属性不得当普通配置文件盲写。

按现象查证据

每轮只改变一个变量；复现前约定停止条件、资源上限和恢复办法。未知项保持未知，不能把日志里没有某事件当作事件没有发生。

工具与环境适用表

不要把 GNU 命令选项直接套给 BusyBox。工具的 --help 与版本输出优先于照抄网页；内核文档也应切到目标 BSP 对应版本核对。

板端实验与故障报告模板

身份与条件

• 硬件型号/修订/编号：待填
• 内核、设备树、根文件系统、SDK、模型、配置校验：待填
• 工具链及工具版本：待填
• 输入、负载、温度、供电、运行时长：待填
• 权限、内核配置与缺失功能：待填

实验协议

• 目标与可证伪假设：待填
• 操作步骤及只读/状态变更分类：待填
• 预期结果、通过阈值、停止条件：待填
• 恢复与回退方法：待填
• 观测开销与时钟域：待填

证据与结论

状态只使用：已验证、条件有限、未执行、失败。假设、观察值和最终结论分开记录。

修复与回归

记录现象、影响、首次出现版本、最小复现、排除过程、根因证据、修复行为及回归范围。重启恢复不等于根因已修复。未完成的长期验证继续保留为未执行。

官方资料与版本边界

• 本课参考资料

内核、工具和厂商 BSP 的支持范围需分别核对。参考资料可能对应较新版本；不要据此推定旧 BSP 支持所有接口。

上一课：案例：长期运行的内存与句柄增长