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
5.2 KiB
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:
- 确认现场无人接触接线和运动/带电部件;
- 核对设备、镜像、fixture 标签和接线图;
- 电源/散热/网络/串口恢复通道正常;
device doctor无安全 fail/unknown;- 温度、磁盘、残留进程/workspace、安全状态正常;
- 获取所需设备租约和 R2 批准;
- 记录 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。