chao.wu 3be23a8a07 runtime: run.sh 简化为单一全能模式 (privileged + 全上下文挂载)
按需求去掉权限档位区分 (--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 提示)
2026-11-04 18:35:43 +08:00
..

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 + 重启 手册流程含系统级操作, 未纳入