rdkagentsun/docs/testing/HIL_LAB_SPEC.md
Codex dd3a2044e6
Some checks failed
ci / python (push) Has been cancelled
ci / typescript (push) Has been cancelled
feat(S1-A): multi-surface foundation + closeout fixes
M0/S0 base + S1-A non-GUI slice (docs/S1-PLAN.md, docs/12):
- s100-readonly Helper profile (rejects run.*, real S100 inventory)
- device registration + SSH transport + host-key TOFU (OpenSSH-standard fingerprint, cross-process candidate)
- rdk-agent-host serve --stdio rename; packages/rdk-agent-surface (CLI device + MCP stdio, 2 tools)
- atomic cross-process approval consumption + idempotency flock takeover + approval crash recovery

Evidence: docs/testing/evidence/{M0,S1-A}.md
2026-08-14 14:45:52 +08:00

5.2 KiB
Raw Permalink Blame History

RDK Agent 硬件在环实验室规范

状态:Baseline v0.7,当前台位适用 S100P 只读/BPU/USB Camera 子集

GPIO/舵机/执行器和企业设备池不属于当前台位。日常只执行 ADR-012/013、CAT-001–006 和 CURRENT_HARDWARE_BASELINE.md 允许的低风险真机项目。CAT-010 真实烧录必须使用单独标记的可恢复测试板和人工值守流程,不能由 Agent 或普通 CI 在当前工作板上执行。

1. 目的

本规范定义真实 RDK 测试的设备、工装、安全门禁和证据。没有满足前置条件的用例应标为 blocked,而不是降低断言或使用 mock 冒充 HIL。

2. 当前台位与目标台位

当前实际台位:

  • RDK S100P 裸板(记录资产 ID,报告中只存序列号 hash);
  • 非端侧主机经网线 direct 连接,Host 到设备链路可控断开;
  • 当前无相机、舵机和 GPIO 工装;USB 摄像头已购买但尚未到货。

稳定电源/散热、串口恢复通道、可控电源和物理标签的实际情况尚未确认,首次 HIL 盘点时记录;缺少恢复前置时,相应故障注入用例必须 blocked,不能假定具备。USB 摄像头到货后,台位增加 USB 摄像头、固定光照和测试卡。用于 BPU 的固定摘要模型与静态输入不依赖摄像头,可先准备。带保护的 GPIO loopback 小板仅属于 Preview;舵机不属于当前台位。

3. 设备镜像与基线

  • 使用记录过 hash/版本的官方 RDK OS;
  • 首次建立 golden snapshot:/etc/version/rdkos_info、kernel、packages、BPU runtime、TROS、pinmux、外设和 worker;
  • 测试数据放专用分区/目录,不与个人/客户项目混用;
  • 设备无生产密钥、云凭据和个人数据;
  • 自动测试不做 apt full-upgrade、flash、bootloader、partition 或系统配置漂移;
  • 每个 release suite 前后做 snapshot diff,未声明漂移使 session fail/blocked。

S5 烧录 HIL 另需:专用可恢复设备、稳定电源、已验证串口/恢复通道、官方镜像摘要、操作人员和失败恢复演练。只满足部分条件时 CAT-010 真机段保持 blocked。

4. GPIO loopback 工装

在硬件工程师审核具体板型 pin map 前,GPIO 测试保持禁用。完成后记录:

  • 物理 pin、SoC signal、库编号三方映射;
  • pinmux 初始和安全终态;
  • 输出与输入之间串联限流/保护,禁止输出对输出直连;
  • 使用的逻辑电平与载板电压域;
  • 不连接 5V/3.3V power pin、复位、boot strap 或未知 pin;
  • 最大翻转频率、次数、持续时间;
  • 断开设备后如何用仪表人工确认;
  • fixture EEPROM/标签或配置摘要,防止错工装运行。

自动 preflight 必须比对 fixture revision、board model、pin map plugin version 和 pinmux。任一 unknown/不一致则拒绝。

5. Camera 工装

  • MIPI 摄像头安装/更换必须断开 RDK 电源;Agent 流程不得远程指导带电插拔;
  • 固定相机位置、测试卡距离与光照范围;
  • 保存期望的最小图像属性或检测结果容差,不使用一次帧的逐像素完全相等;
  • 隐私区域不放人脸/屏幕/敏感纸张;
  • cancellation 后通过独立 reopen 测试确认资源释放。

6. BPU 工装/数据

  • 模型、输入、标签、预期输出均记录 SHA-256 和来源许可证;
  • 记录 runtime/toolchain compatibility,不允许 Agent 自动替换未知模型;
  • 用数值容差/结构断言,避免浮点/版本细节造成假失败;
  • 采集开始/峰值/结束温度与推理延迟;
  • 高温由官方保护和策略阻断,禁止修改频率、电压、降频或关机阈值。

7. 测试前门禁

每次 session:

  1. 确认现场无人接触接线和运动/带电部件;
  2. 核对设备、镜像、fixture 标签和接线图;
  3. 电源/散热/网络/串口恢复通道正常;
  4. device doctor 无安全 fail/unknown;
  5. 温度、磁盘、残留进程/workspace、安全状态正常;
  6. 获取所需设备租约和 R2 批准;
  7. 记录 before snapshot 和台位照片(若流程要求)。

8. 测试后门禁

  • 所有 run 终态,进程/cgroup 无残留;
  • camera 可重新打开;GPIO 回安全态;无未知设备句柄;
  • 温度回落、磁盘配额正常;
  • after snapshot 无未声明系统漂移;
  • evidence 拉取/摘要完成,device spool ack;
  • 清理不确定时保持设备冻结并贴/记录故障标识,不交给下一测试。

9. 人工安全与禁止项

自动 HIL 永不:刷机、改 bootloader/partition、改电压/频率/thermal limit、远程切主电源、驱动电机/机械臂/继电器负载、操作未评审 CAN 总线、热插拔 MIPI、短接输出或电源引脚。若未来增加任何项目,必须独立风险评估、硬件安全控制和新版规范,不得靠普通 run approval 临时开放。

10. 故障处理

  • 烟雾、异味、异常温度/电流:人工立即断电,停止自动收集,按实验室事故流程;
  • Agent/worker 无法终止:使用外部控制台/人工断电,不继续发命令试探;
  • 文件系统或系统异常:隔离设备,保存最小只读证据,重建镜像而非让 Agent 任意修复;
  • fixture 损坏/标签不符:blocked 并撤销相关 capability label;
  • 任何安全终态无法证明:cleanup_unconfirmed + device frozen。