chao.wu b4835a096d 新增 runtime/ 板端运行时镜像线 (全内置)
- TROS/ROS/hobot 栈走与宿主机相同的 apt 源 (d-robotics + tuna ros2),
  build.sh 默认锁宿主机版本 (源内已下架时 --no-pin 装源内最新)
- /app 全量案例与 hbm_runtime/Hobot.GPIO 从目标板拷贝, 附 sha256 清单回验
- 运行时仅 --device 透传 (复用 common 单元设备集), 零 bind-mount
- 适配 hobot-dnn postinst: 预置宿主机版本构建工具链 (新版 scikit-build-core
  无 clean 子命令会令 postinst 失败) + python-is-python3 + libcjson1 补未声明依赖
- nashem(S100P)/nashp(S600) 双线板上构建并 verify.sh 11/11 全绿
2026-11-02 21:38:29 +08:00

6.1 KiB
Raw Permalink Blame History

examples/ 案例索引

第一级分类是案例, 第二级分类是平台: 纯 CPU 案例与三板共用 Dockerfile 的单元案例用 any, bpu_model_perf 按板拆 nashem / bayese / nashp。每个案例目录内统一为: 一个 Dockerfile + build.sh + run.sh (+test.sh/selftest.sh) + output/(运行输出, 不入库)。

examples/
├── common/
│   └── app_base_common.sh    # 共享库: 板型检测/公共挂载/按硬件单元设备集
├── coremark/any/             # CoreMark-PRO CPU 基准 (纯 CPU, 平台无关)
│   │                         #   build.sh/run.sh/test.sh 三板均验证; 源码直接携带
│   │                         #   实测: S600=78305, S100=18497, X5=5379
├── bpu_model_perf/
│   ├── nashem/               # BPU 模型性能测试 (S100/S100P)
│   ├── bayese/               # 同上 (X5)
│   └── nashp/                # 同上 (S600, ubuntu:24.04 base)
├── app_base/any/             # /app 全案例基础镜像 (板型自适应) + shell/bench 工具
│   └── output/<family>/      # 三板测试报告与基准产物
├── bpu/any/                  # BPU 单元案例: mobilenetv2 分类 (自测判 top1=zebra)
├── gpu/any/                  # GPU 单元案例: OpenCL 矩阵乘
├── vpu/any/                  # VPU+JPU 单元案例: sample_codec 双路径 (H264 走 VPU, JPEG 走 JPU)
├── dsp/any/                  # DSP 单元案例: S600/S100 为 VDSP(vdsp_sample), X5 为 aDSP(sample_dsp)
├── hbmem/any/                # 共享内存单元案例: cached/uncached memset
├── runtime/                  # 板端运行时镜像 (全内置): TROS/ROS/hobot 走 apt 同源安装,
│   │                         #   /app 与硬件 python 包从板端拷贝, 运行时仅透传设备零挂载
│   └── apt/sunrise.gpg       # d-robotics 源公钥 (与宿主机 /usr/share/keyrings/sunrise.gpg 一致)
└── mcu/any/                  # MCU 单元案例: ipcbox_runcmd 经 IPCF 与 MCU 收发
    ├── firmware/             # MCU 固件 (BSP 版本记录见 firmware/README.md)
    └── install_mcu_runtime.sh# MCU 固件装载 + 开机自启服务

用法

每个案例在目标板上执行:

cd examples/<案例>/<平台>
bash build.sh     # 构建镜像 (案例编译进镜像)
bash run.sh       # 运行/自测 (精确 --device 透传该硬件单元, 日志写 output/)

app_base 基础镜像需先构建 (单元案例的构建层):

cd examples/app_base/any && bash build.sh
bash shell.sh bpu              # 交互式进入容器 (按单元透传设备)
bash bench.sh all              # 宿主机 vs 容器基准对比

硬件单元与设备透传

单元划分以硬件对端命名。IPCF (跨核通信框架, 共享内存 + 邮箱中断 + /dev/ipcdrv) 是互连底座而非计算单元: VDSP 走 IPCF ins22/42, BPU 有 rpmsg_bpu 通道, timesync/CAN 亦经 IPCF。ipcbox 案例的单元因此为 MCU, IPCF 只是到达它的总线。

单元 透传设备
bpu /dev/bpu, /dev/bpu_core0-7, /dev/ion
gpu /dev/mali0 或 /dev/galcore, /dev/dri
vpu(+jpu) /dev/vpu(1,2), /dev/jpu(1,2), /dev/codec0_cap, /dev/codec0_src, /dev/ion
dsp /dev/vdsp0(1), /dev/dcore0/1_rpmsg_op, /dev/dcore0/1_device_op, /dev/dsp, /dev/ipcdrv, /dev/ion
vio /dev/i2c-, /dev/vin, /dev/isp*, /dev/pym*, /dev/stitch*, /dev/gdc*, /dev/ynr*, /dev/idu*, /dev/port_, /dev/deserial_, /dev/sensor_ctrl, /dev/mipi*, /dev/video*, /dev/media*, /dev/flow, /dev/ion
mcu /dev/ipcdrv, /dev/i2c-, /dev/spidev, /dev/ttyS*, /dev/gpiochip*, /dev/hrtc0, /dev/pps*, /dev/ptp*
hbmem /dev/ion, /dev/hbmem*
all --privileged 全量

三板实测结论

案例 S600 S100 X5
bpu PASS PASS PASS (pydev 特例)
gpu PASS PASS PASS
vpu+jpu PASS PASS PASS
dsp PASS (VDSP) PASS (VDSP) 不测 (按约定)
hbmem PASS PASS PASS
mcu PASS (ADC 回显) PASS (ADC 回显) 不适用

容器 vs 宿主机性能差异均在运行噪声内 (无损调用): 字符设备直通、宿主原库挂载、 零虚拟化层。完整报告见 app_base/any/output//report.md。

公共镜像仓库 (已推送并实测验证)

以下 25 个镜像已全部推送至 BCR 公共仓库 ccr-29eug8s3-pub.cnc.bj.baidubce.com/rlark/, 均经过三板真实构建与运行验证。拉取时直接使用完整地址即可,无需登录 (public 仓库)。

基础镜像

板 公共地址
S600 ccr-29eug8s3-pub.cnc.bj.baidubce.com/rlark/app_base_nashp:261020_113638
S100 ccr-29eug8s3-pub.cnc.bj.baidubce.com/rlark/app_base_nashem:261020_114116
X5 ccr-29eug8s3-pub.cnc.bj.baidubce.com/rlark/app_base_bayese:261020_114308

硬件单元案例镜像

单元 S600 S100 X5
bpu .../rlark/case_bpu_nashp:261020_113827 .../rlark/case_bpu_nashem:261020_114139 .../rlark/case_bpu_bayese:261020_114330
gpu .../rlark/case_gpu_nashp:261020_113920 .../rlark/case_gpu_nashem:261020_114147 .../rlark/case_gpu_bayese:261020_114339
vpu(+jpu) .../rlark/case_vpu_nashp:261020_113931 .../rlark/case_vpu_nashem:261020_114201 .../rlark/case_vpu_bayese:261020_114415
dsp .../rlark/case_dsp_nashp:261020_113946 .../rlark/case_dsp_nashem:261020_114218 不适用
hbmem .../rlark/case_hbmem_nashp:261020_113952 .../rlark/case_hbmem_nashem:261020_114225 .../rlark/case_hbmem_bayese:261020_114430
mcu .../rlark/case_mcu_nashp:261020_114000 .../rlark/case_mcu_nashem:261020_114233 不适用

表中 ... 为 ccr-29eug8s3-pub.cnc.bj.baidubce.com 前缀。

独立测试案例镜像

案例 S600 S100 X5
bpu_model_perf .../rlark/hrt_perf_nashp:261020_114006 .../rlark/hrt_perf_nashem:261020_114239 .../rlark/hrt_perf_bayese:261020_114435
coremark .../rlark/coremark_pro_rdk_arm:261020_114037 .../rlark/coremark_pro_rdk_arm:261020_114249 .../rlark/coremark_pro_rdk_arm:261020_114445

注意: coremark 三板共用同一仓库名但 tag 不同 (每次构建独立生成时间戳)。 各镜像的运行方式见各案例目录内的 run.sh / test.sh。