对于边缘器件 - 2.5 简体中文

Vitis AI Library 用户指南 (UG1354)

Document ID

UG1354

Release Date

2022-06-15

Version

2.5 简体中文

Vitis AI 运行时包和 Vitis AI Library 样本与模型都已内置在开发板镜像中。您可直接运行示例。如有新程序，请在主机侧对其进行编译并将可执行程序复制到目标。

使用 scp 命令将 vitis_ai_library_r2.5.x_images.tar.gz 和 vitis_ai_library_r2.5.x_video.tar.gz 从主机复制到目标，如下所示：

[Host]$scp vitis_ai_library_r2.5.x_images.tar.gz root@IP_OF_BOARD:~/
[Host]$scp vitis_ai_library_r2.5.x_video.tar.gz root@IP_OF_BOARD:~/

在目标上解压镜像和视频程序包。

cd ~
tar -xzvf vitis_ai_library_r2.5*_images.tar.gz -C Vitis-AI/examples/Vitis-AI-Library
tar -xzvf vitis_ai_library_r2.5*_video.tar.gz -C Vitis-AI/examples/Vitis-AI-Library

进入目标开发板上示例的解压后目录，然后编译示例。以 facedetect 为例。
```
cd ~/Vitis-AI/examples/Vitis-AI-Library/samples/facedetect
```

运行示例。

./test_jpeg_facedetect densebox_320_320 sample_facedetect.jpg

注释：它支持批处理模式。如果 DPU 批次数大于 1，也可运行以下命令。

./test_jpeg_facedetect densebox_320_320 <img1_url> [<img2_url> ...]

查看运行结果。
有两种方法可用于查看结果：一种方法是通过打印信息来查看结果。另一种方法是下载 sample_facedetect_result.jpg 图像查看结果，如下图所示：
要运行视频示例，请运行以下命令：
```
./test_video_facedetect densebox_320_320 video_input.webm -t 8
```
其中，video_input.webm 与输入的视频文件名相同，-t 即线程数。您必须自行准备视频。
注释：
- 官方系统镜像仅支持 webm 或 raw 格式的视频文件输入。如果所使用的视频文件格式与输入格式不同，则必须在系统上安装相关程序包，例如，ffmpeg 程序包。
- 由于基本平台系统中的视频回放和显示存在限制，只能按显示标准的帧率来显示视频，这无法反映真实的处理性能。但您可通过以下命令来检查实际视频处理性能，搭配多线程使用尤其有效：
```
env DISPLAY=:0.0 DEBUG_DEMO=1 ./test_video_facedetect \
densebox_320_320 'multifilesrc location=~/video_input.webm \
! decodebin  !  videoconvert ! appsink sync=false' -t 2
```
要以 USB 摄像头作为输入来测试程序，请运行以下命令：
```
./test_video_facedetect densebox_320_320 0 -t 8
```
此处 0 是首个 USB 摄像头器件节点。如有多个 USB 摄像头，则该值为 1、2、3 以此类推，其中 -t 表示线程数。
重要：由于视频示例需要 Linux 窗口系统才能正常工作，使用 SSH 终端登录开发板时，请使用以下命令启用 X11 前传（在此示例中假设主机 IP 地址为 192.168.0.10）。
```
export DISPLAY=192.168.0.10:0.0
```
要测试模型性能，请运行以下命令：
```
./test_performance_facedetect densebox_320_320 test_performance_facedetect.list -t 8 -s 60 
```
此处，-t 是线程数，-s 是秒数。

要查看更多参数信息，请输入 -h。
要运行演示，请参阅应用演示。