cpp目录下提供了C++例程以供参考使用,具体情况如下:
序号 | C++例程 | 说明 |
---|---|---|
1 | yolov5_bmcv | 使用FFmpeg解码、BMCV前处理、BMRT推理 |
2 | yolov5_sail | 使用SAIL解码、SAIL前处理、SAIL推理 |
如果您在x86/arm平台安装了PCIe加速卡(如SC系列加速卡),可以直接使用它作为开发环境和运行环境。您需要安装libsophon、sophon-opencv和sophon-ffmpeg,具体步骤可参考x86-pcie平台的开发和运行环境搭建或arm-pcie平台的开发和运行环境搭建。
如果您使用SoC平台(如SE、SM系列边缘设备),刷机后在/opt/sophon/
下已经预装了相应的libsophon、sophon-opencv和sophon-ffmpeg运行库包,可直接使用它作为运行环境。通常还需要一台x86主机作为开发环境,用于交叉编译C++程序。
C++程序运行前需要编译可执行文件。
可以直接在PCIe平台上编译程序:
cd cpp/yolov5_bmcv
mkdir build && cd build
cmake ..
make
cd ..
编译完成后,会在yolov5_bmcv目录下生成yolov5_bmcv.pcie。
如果您使用sophon-sail接口,需要编译安装sophon-sail,然后进行如下步骤。
cd cpp/yolov5_sail
mkdir build && cd build
cmake ..
make
cd ..
编译完成后,会在yolov5_sail目录下生成yolov5_sail.pcie。
通常在x86主机上交叉编译程序,您需要在x86主机上使用SOPHON SDK搭建交叉编译环境,将程序所依赖的头文件和库文件打包至soc-sdk目录中,具体请参考交叉编译环境搭建。本例程主要依赖libsophon、sophon-opencv和sophon-ffmpeg运行库包。
交叉编译环境搭建好后,使用交叉编译工具链编译生成可执行文件:
cd cpp/yolov5_bmcv
mkdir build && cd build
#请根据实际情况修改-DSDK的路径,需使用绝对路径。
cmake -DTARGET_ARCH=soc -DSDK=/path_to_sdk/soc-sdk ..
make
编译完成后,会在yolov5_bmcv目录下生成yolov5_bmcv.soc。
如果您使用sophon-sail接口,需要参考交叉编译安装sophon-sail,给soc环境配置sophon-sail,然后进行如下步骤。
cd cpp/yolov5_sail
mkdir build && cd build
#请根据实际情况修改-DSDK和-DSAIL_PATH的路径,需使用绝对路径。
cmake -DTARGET_ARCH=soc -DSDK=/path_to_sdk/soc-sdk -DSAIL_PATH=/path_to_sail/sophon-sail/build_soc/sophon-sail ..
make
编译完成后,会在yolov5_sail目录下生成yolov5_sail.soc。
对于PCIe平台,可以直接在PCIe平台上推理测试;对于SoC平台,需将交叉编译生成的可执行文件及所需的模型、测试数据、libbm1684x_kernel_module.so
拷贝到SoC平台中测试。测试的参数及运行方式是一致的,下面主要以PCIe模式进行介绍。
可执行程序默认有一套参数,请注意根据实际情况进行传参,yolov5_bmcv.pcie与yolov5_sail.pcie参数相同。
以yolov5_bmcv.pcie为例,具体参数说明如下:
Usage: yolov5_bmcv.pcie [params]
--bmodel (value:../../models/BM1684X/yolov5s_tpukernel_fp32_1b.bmodel)
bmodel file path
--classnames (value:../../datasets/coco.names)
class names file path
--conf_thresh (value:0.5)
confidence threshold for filter boxes
--dev_id (value:0)
TPU device id
--help (value:true)
print help information.
--input (value:../../datasets/test)
input path, images direction or video file path
--nms_thresh (value:0.5)
iou threshold for nms
--tpu_kernel_module_path (value:../../tpu_kernel_module/libbm1684x_kernel_module.so)
TPUKernel Shared Object
注意: CPP传参与python不同,需要用等于号,例如
./yolov5_bmcv.pcie --bmodel=xxx
。
图片测试实例如下,支持对整个图片文件夹进行测试。
./yolov5_bmcv.pcie --input=../../datasets/test --bmodel=../../models/BM1684X/yolov5s_tpukernel_fp32_1b.bmodel --dev_id=0 --conf_thresh=0.5 --nms_thresh=0.5 --classnames=../../datasets/coco.names --tpu_kernel_module_path=../../tpu_kernel_module/libbm1684x_kernel_module.so
测试结束后,会将预测的图片保存在results/images
下,预测的结果保存在results/yolov5s_tpukernel_fp32_1b.bmodel_test_bmcv_cpp_result.json
下,同时会打印预测结果、推理时间等信息。
视频测试实例如下,支持对视频流进行测试。
./yolov5_bmcv.pcie --input=../../datasets/test_car_person_1080P.mp4 --bmodel=../../models/BM1684X/yolov5s_tpukernel_fp32_1b.bmodel --dev_id=0 --conf_thresh=0.5 --nms_thresh=0.5 --classnames=../../datasets/coco.names --tpu_kernel_module_path=../../tpu_kernel_module/libbm1684x_kernel_module.so
测试结束后,会将预测结果画在图片上并保存在results/images
中,同时会打印预测结果、推理时间等信息。
注意:
若在SoC模式下执行报错:
./yolov5_sail.soc: error while loading shared libraries: libsail.so: cannot open shared object file: No such file or directory
请设置如下环境变量:
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/sophon/sophon-sail/lib