按需求去掉权限档位区分 (--unit/--privileged 选项移除): 始终以最高权限 运行, privileged 自带全部设备节点 (含 /dev/mem 与 USB 热插拔动态 /dev), 外挂仅保留设备树/debugfs/Wayland/X11 四个上下文目录; 保留 -d 与 --host-net (功能选项, 非权限档位)。 验证: hrt_ucp_monitor 容器内外行为一致 —— 同 BPULib 2.2.15 横幅 + Monitor 2.2.4 全表 (15 IP 负载/DDR/ION), BPU 满载时容器内实测读到 BPU0 78.8%/BPU1 71.6%/BPU2 50.8%/BPU3 19.4%; 命令对比 7 项: boardid/ socuid/gpioinfo/hb_version/i2cdetect/core_num 逐字一致, devmem 值一致 (包装脚本多一行无害 /proc/$PPID 提示)
runtime/ 板端运行时镜像 (全内置)
与 app_base 的"通用镜像 + 运行时挂载宿主目录"路线相反, 本线把板卡运行环境
全部内置进镜像, 容器运行时只透传设备节点, 不 bind-mount 任何宿主目录:
| 内容 | 内置方式 |
|---|---|
| TROS / ROS | apt 安装, 源与宿主机相同 (d-robotics sunrise.list + tuna ros2), 默认锁定宿主机当前版本 |
| hobot 栈 (libdnn/多媒体/IO/spdev/相机) | 同上, apt 安装 d-robotics 源内包 |
| /app 全量案例 (含专属测试用例) | build 时从目标板 /app 拷贝, 附 sha256 清单 (镜像内 /etc/rdk-runtime-image/app-manifest.txt) |
| hbm_runtime / Hobot.GPIO | 从目标板 dist-packages 拷贝 (与固件 BPU 驱动 ABI 配对, 不走 pip) |
| hobot_vio | apt 包 hobot-spdev 自带 wheel, 镜像内 pip 安装 |
| numpy/opencv/scipy | pip 安装, 版本锁定与宿主机一致 |
| /etc/version 板卡标识 | 从目标板拷贝 (平台检测依赖, 历史踩坑项) |
镜像线 (与仓库家族约定一致):
| family | 板卡 | BASE | d-robotics suite | ROS |
|---|---|---|---|---|
nashem |
S100 / S100P | ubuntu:22.04 | ubuntu-rdk-s100-beta (jammy) | humble |
nashp |
RDK S600 | ubuntu:24.04 | ubuntu-rdk-s600-beta (noble) | jazzy |
使用
在目标板上执行 (构建即以该板真实运行环境为基准):
cd examples/runtime
bash build.sh # 组装上下文 (/app 快照、版本锁) 并构建 rdk_runtime_<family>:<时间tag>
bash verify.sh # 零挂载容器内自测, 必须全绿
bash run.sh # 交互式进容器 (已加载 TROS 环境)
bash run.sh -d # sshd 常驻 (宿主 2222 -> 22, root/root)
可选参数: build.sh --no-pin (不锁宿主机版本, 装源内最新) / --keep-ctx (保留构建上下文调试);
run.sh --unit <bpu|gpu|vpu|dsp|vio|mcu|hbmem> (只透传指定单元, 最小权限模式)。
默认全量硬件映射 (run.sh)
默认模式下, 板上真实存在的硬件节点全部透传进容器, 手册外设类用例开箱即跑:
| 类别 | 节点 |
|---|---|
| 计算 | /dev/bpu /dev/bpu_core* /dev/ion /dev/hbmem* |
| 编解码 | /dev/vpu* /dev/jpu* /dev/codec0_* |
| GPU/显示 | `/dev/mali0 |
| VIO 全链 | sensor_ctrl/flow/deserial*/mipi*/port_*/vin*/isp*/pym*/gdc*/stitch*/ynr*/idu* |
| USB 摄像头 | /dev/video* /dev/media* /dev/v4l /dev/bus/usb |
| DSP/MCU | vdsp*/dcore*/dsp/ipcdrv/hrtc0 + 40pin (i2c*/spidev*/ttyS*/gpiochip*/pps*/ptp*) |
| 音频 | /dev/snd 整目录 |
| 显示桌面 | Wayland 会话自动挂载 /run/user/<uid> + 透传 WAYLAND_DISPLAY/XDG_RUNTIME_DIR/XAUTHORITY(Xwayland cookie); 另挂 /tmp/.X11-unix + DISPLAY (仅有的文件映射) |
不存在于本板的节点自动跳过; 用例失败若因节点缺失/设备打不开, 属硬件缺席
(宿主机上同样失败), 与镜像/映射无关 —— --unit 模式则收窄到单元最小集。
设计说明
- 版本锁:
build.sh用dpkg-query抓宿主机版本生成pkg-pins.txt, 镜像内apt install pkg=version—— 与固件同源同版。源里取不到该版本时 apt 会报错, 用--no-pin重跑改装源内最新 (镜像与宿主可能存在小版本差)。 - 设备透传:
run.sh默认全量透传本板存在的硬件 (见上表), 不使用 privileged;verify.sh复用common/app_base_common.sh的按单元设备集。 - 一致性回验: 镜像内带
/app的 sha256 清单,verify.sh逐文件校验, 固件升级后重跑verify.sh即可发现 APP 漂移。 - 与沙箱平台的关系: 该线是板端运行时镜像的全内置新版本试验田, 成熟后 沙箱 compose 可整体切换 (删除全部 bind-mount, 换 image 即可)。
已知边界
- X5 (bayese) 暂未纳入,
build.sh会明确拒绝。 - 镜像体积: nashem ~5G / nashp ~5.5G (TROS 全组件 + 模型 + /app 全量),
构建上下文同样量级 —— build 会优先把 staging 放
/root/ssd。 - S600 宿主机 dist-packages 中的 torch/nvidia/triton (~4.5G AI 计算栈) 不内置: 非硬件访问必备, 按需在容器内自装。
已知厂商缺陷 (实测确认, 宿主机同样失败, 非镜像/映射问题)
以下项在宿主机与容器内行为一致地失败, 根因在官方包/示例自身, 待厂商修复:
| 项 | 现象 | 根因 |
|---|---|---|
| hbtop (S100/S100P hobot-utils 4.0.5) | GLIBC_2.38 not found | 22.04 系统打包了 24.04 编译的二进制; 已从 4.0.4 板换回正常版本+补 libjsoncpp.so.21 (备份 .bak-noble) |
| hb_monitor.service (三板) | systemd 203/EXEC | unit ExecStart 用裸命令名; 已用 systemd override 补绝对路径并 enable |
| hbtop 容器内 | TCP 连上但不渲染 | 客户端依赖宿主 hb_monitor 服务(:1234), 且在容器内行为异常; 建议宿主机使用 (run.sh --host-net 供尝试) |
| FCOS 回灌 (S100) | 缺 fcosworkconfig.json 且 libdnn_node 缺 parser_fcos 符号 | 包未发布完整 |
| yolo26 (S100) | config 随包但模型 hbm 未发布 | 打包不一致 |
| hobot_cv crop/rotate 示例 | cvtColor !_src.empty 断言崩 | 上游示例 bug (resize 正常) |
| hobot_cv gaussian/neon 滤波 | launch+模型在, 可执行未随包发布 | 打包缺失 |
| mono2d 默认模型 | multitask_body_head_face_hand_kps hbm 未随包发布 | 用 yolo_pose 变体 (nashp/nashe) 正常 |
| locateanything (S600) | 需 3B 模型下载 + ion bpu_first + 重启 | 手册流程含系统级操作, 未纳入 |