易百纳玄武S3（RK3588+RK1828）边缘计算终端上部署Rockit_Yolo_Detect示例

硬件平台：易百纳玄武S3

简介

本文主要介绍rockit_yolo_detect示例在Ebaina玄武S3边缘计算AI终端上的部署与运行验证方法。该示例基于Rockit多媒体框架，完成视频码流解码→RGA图像处→RKNN3（RK182X）目标检测→OSD画框叠加→HDMI输出的完整链路，并配套yolox_debug调试工具动态管理码流。

示例功能：

• 支持RKNN3（RK182X协处理器）与RKNN2（RK3588本地NPU）双模型推理，由config.json分别指定模型路径；
• 通过yolox_debug动态添加/删除码流，支持无限循环播放与单次播放两种模式；
• 检测框、类别名称与置信度实时叠加到HDMI显示器输出画面；
• 置信度阈值（conf_threshold）与NMS阈值（nms_threshold）可通过配置文件调整。

整体流程分为四步：

1. 在SDK根目录交叉编译示例，生成install/安装目录；
2. 将install/推送到板端/userdata并重命名为rockit_yolo_detect；
3. 板端部署模型文件；
4. 运行yolox_detect主程序，通过yolox_debug添加测试视频验证检测效果。

环境准备

编译

//进入示例源码目录
cd <RK182X SDK>/examples/rockit_yolo_detect    
//编译
  ./build.sh \
  --host  /<rockchip_linux6.12_release所在文件路径>/rockchip_linux6.12_release/buildroot/output/latest/host \
  --arch aarch64  

编译和安装成功后生成install/目录，结构如下：

install/
├── bin/
│   ├── yolox_detect        //主程序，无参数运行
│   └── yolox_debug         //码流调试工具
├── lib/
│   ├── librockit.so
│   ├── librkdemuxer.so
│   ├── libgraphic_lsf.so
│   └── librknn3_api.so
└── usr/share/resource/
    ├── background-image.png        //启动背景图片
    └── model/
        ├── config.json             //模型配置文件
        ├── detect_classes.txt      //检测类别标签
        ├── yolov5s.rknn
        ├── yolov5s.weight
        └── yolov5s_relu_rk3588_i8.rknn

部署到开发板

推送install目录到板端

将编译后的install/目录推送到板端/userdata，并重命名为rockit_yolo_detect：

adb push <RK182X SDK>\examples\rockit_yolo_detect\install> /userdata
mv install rockit_yolo_detect

板端部署模型文件：

cd userdata/rockit_yolo_detect
cp usr / -r

板端运行与效果验证

运行应用程序

接好HDMI显示器，在板端运行主程序（无命令行参数）：

cd /userdata/rockit_yolo_detect
chmod +x bin/*    //添加可执行权限
export LD_LIBRARY_PATH="$PWD/lib:$LD_LIBRARY_PATH"    //指定动态库路径
./bin/yolox_detect    //启动主程序

启动成功后，HDMI显示器上可以看到背景图片。

测试命令

保持主程序运行，添加视频进去，需打开另一个板端终端，将测试视频推送到板端rockit_yolo_detect目录，本例以input.mp4演示：

# 板端新终端执行
adb push input.mp4 /userdata/rockit_yolo_detect
cd /userdata/rockit_yolo_detect
# 创建一路码流，无限循环播放
./bin/yolox_debug path add ./input.mp4 -1

添加成功后，显示器上开始循环播放视频：

# 添加一路码流，只播放一次
./bin/yolox_debug path add ./input.mp4 1

添加后屏幕分窗显示两路码流，检测框与类别置信度（如bird 0.55）实时叠加在画面上：

# 删除屏幕上第一路码流（ID为0）
./bin/yolox_debug path remove 0

删除后对应码流消失，屏幕恢复为背景画面：

相关代码

运行前确认板端rknn3服务正常：

rknn-smi info

常见问题

1. 启动后显示器无背景图片/黑屏：确认已接HDMI显示器，且已执行cp -r usr /；资源未拷贝时程序读取不到配置和背景图。
2. 添加码流后无画面：确认测试视频为MP4格式且路径正确，主程序yolox_detect处于运行状态；添加码流前不要退出主程序。