板端部署 YOLOv8 目标检测
本文档旨在演示如何在 rk3588 上运行板端推理 YOLOv8 目标检测模型,所需环境配 置请参考 RKNN 安装
此示例用 rknn_model_zoo 中预训练好的 ONNX 格式模型为例子通过模型转换到板端推理做完整示例,此示例目标平台为 rk3588。
利用 rknn 部署YOLOv8 需要两个步骤
- PC 端利用 rknn-toolkit2 将不同框架下的模型转换成 rknn 格式模型
- 板端利用 rknn-toolkit2-lite 的 Python API 板端推理模型
PC端模型转换
Radxa 已提供预转换好的 yolov8.rknn
模型,用户可直接参考板端推理 YOLOv8 跳过 PC 端模型转换章节
-
如使用 conda 请先激活 rknn conda 环境
conda activate rknn
-
下载 yolov8.onnx 模型
cd rknn_model_zoo/examples/yolov8/model
# 下载预训练好的 yolov8n.onnx 模型
bash download_model.sh如遇到网络问题,可访问 此页 下载对应的模型到对应文件夹
-
使用 rknn-toolkit2 转换成 yolov8n.rknn
cd rknn_model_zoo/examples/yolov8/python
python3 convert.py ../model/yolov8n.onnx rk3588参数解析:
<onnx_model>
: 指定 ONNX 模型路径<TARGET_PLATFORM>
: 指定 NPU 平台名称。支持的平台请参考这里<dtype>(可选)
: 指定为i8
或fp
。i8
用于 int8 量化,fp
用于 fp16 量化。默认为i8
<output_rknn_path>(可选)
: 指定 RKNN 模型的保存路径,默认保存在与 ONNX 模型相同的目录中,文件名为yolov8.rknn
-
将 yolov8n.rknn 模型拷贝到板端
板端推理 YOLOv8
-
下载 rknn-model-zoo-rk3588 获取 yolov8 demo(内含预转换 yolov8.rknn 模型)
sudo apt install rknn-model-zoo-rk3588
如您使用的是 CLI 版本可访问 rknn-model-zoo-rk3588 deb 包下载地址
-
运行 yolov8 示例代码
如你使用的是自己转换的模型需从 PC 端拷贝到板端,并用 --model_path 参数指定模型路径
cd /usr/share/rknn_model_zoo/examples/yolov8/python
sudo python3 yolov8.py --model_path ../model/yolov8.rknn --img_save$ sudo python3 yolov8.py --model_path ../model/yolov8.rknn --img_save
import rknn failed,try to import rknnlite
--> Init runtime environment
I RKNN: [09:01:01.819] RKNN Runtime Information, librknnrt version: 1.6.0 (9a7b5d24c@2023-12-13T17:31:11)
I RKNN: [09:01:01.819] RKNN Driver Information, version: 0.8.2
W RKNN: [09:01:01.819] Current driver version: 0.8.2, recommend to upgrade the driver to the new version: >= 0.8.8
I RKNN: [09:01:01.819] RKNN Model Information, version: 6, toolkit version: 1.6.0+81f21f4d(compiler version: 1.6.0 (585b3edcf@2023-12-11T07:56:14)), target: RKNPU v2, target platform: rk3588, framework name: ONNX, framework layout: NCHW, model inference type: static_shape
W RKNN: [09:01:01.836] query RKNN_QUERY_INPUT_DYNAMIC_RANGE error, rknn model is static shape type, please export rknn with dynamic_shapes
W Query dynamic range failed. Ret code: RKNN_ERR_MODEL_INVALID. (If it is a static shape RKNN model, please ignore the above warning message.)
done
Model-../model/yolov8.rknn is rknn model, starting val
infer 1/1
IMG: bus.jpg
person @ (211 241 282 507) 0.872
person @ (109 235 225 536) 0.860
person @ (477 225 560 522) 0.856
person @ (79 327 116 513) 0.306
bus @ (95 136 549 449) 0.860
Detection result save to ./result/bus.jpg参数解析:
--model_path
: 指定 rknn 模型路径--img_folder
: 进行推理的图片库, 默认 ../model--img_save
: 是否保存推理结果图到 ./result,默认 False -
所有推理结果保存在 ./result 中