- 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 全绿
6.1 KiB
6.1 KiB
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。