README.md

C++例程

目录

• 1. 环境准备
  • 1.1 x86/arm/riscv PCIe平台
  • 1.2 SoC平台
• 2. 程序编译
  • 2.1 x86/arm/riscv PCIe平台
  • 2.2 SoC平台
• 3. 推理测试
  • 3.1 参数说明
  • 3.2 测试视频理解数据集

cpp目录下提供了C++例程以供参考使用，具体情况如下：

序号	C++例程	说明
1	slowfast_opencv	使用OpenCV解码、OpenCV前处理、BMRT推理

1. 环境准备

1.1 x86/arm/riscv PCIe平台

如果您在x86/arm/riscv平台安装了PCIe加速卡（如SC系列加速卡），可以直接使用它作为开发环境和运行环境。您需要安装libsophon、sophon-opencv和sophon-ffmpeg，具体步骤可参考x86-pcie平台的开发和运行环境搭建或arm-pcie平台的开发和运行环境搭建或riscv-pcie平台的开发和运行环境搭建。

1.2 SoC平台

如果您使用SoC平台（如SE、SM系列边缘设备），刷机后在/opt/sophon/下已经预装了相应的libsophon、sophon-opencv和sophon-ffmpeg运行库包，可直接使用它作为运行环境。通常还需要一台x86主机作为开发环境，用于交叉编译C++程序。

2. 程序编译

C++程序运行前需要编译可执行文件，下面以slowfast_opencv为例子。

2.1 x86/arm/riscv PCIe平台

可以直接在PCIe平台上编译程序：

cd cpp/slowfast_opencv
mkdir build && cd build
cmake ..
make
cd ..

编译完成后，会在slowfast_opencv目录下生成slowfast_opencv.pcie。

2.2 SoC平台

通常在x86主机上交叉编译程序，您需要在x86主机上使用SOPHON SDK搭建交叉编译环境，将程序所依赖的头文件和库文件打包至soc-sdk目录中，具体请参考交叉编译环境搭建。本例程主要依赖libsophon、sophon-opencv和sophon-ffmpeg运行库包。

交叉编译环境搭建好后，使用交叉编译工具链编译生成可执行文件：

cd cpp/slowfast_opencv
mkdir build && cd build
#请根据实际情况修改-DSDK的路径，需使用绝对路径。
cmake -DTARGET_ARCH=soc -DSDK=/path_to_sdk/soc-sdk ..
make

编译完成后，会在slowfast_opencv目录下生成slowfast_opencv.soc。

3. 推理测试

对于PCIe平台，可以直接在PCIe平台上推理测试；对于SoC平台，需将交叉编译生成的可执行文件及所需的模型、测试数据拷贝到SoC平台中测试。slowfast_opencv例程的测试参数及运行方式在两个平台是一致的，下面主要以PCIe 模式、slowfast_opencv例程进行介绍。

3.1 参数说明

可执行程序默认有一套参数，请注意根据实际情况进行传参，具体参数说明如下：

Usage: slowfast_opencv.pcie [params]

        --bmodel (value:../../models/BM1684X/slowfast_fp32_1b.bmodel)
                bmodel file path
        --classnames (value:../../datasets/kinetics_names.txt)
                Kinetics400 class names
        --dev_id (value:0)
                TPU device id
        --help (value:true)
                print help information.
        --input (value:../../datasets/sampled_k400)
                sampled Kinetics400 video directory

注意： CPP传参与python不同，需要用等于号，例如./slowfast_opencv.pcie --bmodel=xxx。

3.2 测试视频理解数据集

测试实例如下，对Kinetics400视频数据集的一个子集进行测试。

./slowfast_opencv.pcie --bmodel=../../models/BM1684X/slowfast_bm1684x_fp32_1b.bmodel --input=../../datasets/test --dev_id=0

测试结束后，同时会打印预测结果、推理时间等信息。

############################
SUMMARY: SlowFast detect
############################
[     SlowFast decode_time]  loops:    4 avg: 123.947 ms
[ SlowFast preprocess_time]  loops:    4 avg: 92.524 ms
[       SlowFast inference]  loops:    4 avg: 244.281 ms
[SlowFast postprocess_time]  loops:    4 avg: 0.369 ms
SlowFast delete bm_context