Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page provides usage information and release notes for the xlnx-vai-lib-samples snap available from the Canonical snap store at http://snapcraft.io.

Info

This snap is currently only compatible with the Ubuntu 20.04 image.

Table of Contents

Table of Contents
minLevel1
maxLevel7
excludeTable of Contents

...

The xlnx-vai-lib-samples snap provides a set of pre-built Vitis AI sample applications that are available in source form in the Vitis-AI Github repository. Source code for the sample apps can be found at:

https://github.com/Xilinx/Vitis-AI/tree/v1.3.2/demo/Vitis-AI-Library/samples/

Info

The current version supports Vitis-AI v1.3.2. The compatible models are v1.3.1.

...

The xlnx-vai-lib-samples app provides wrappers for these tests, implemented as “sub-applications”, which will check the supplied “sample app” and “model name” arguments, and confirm that they are a valid combination. Then, the snap will call the appropriate sub-application with the proper arguments such that the proper test-specific application is called. The snap will also download models on demand from the Xilinx model zoo and store them locally for future use. info

Model & DPU Compatibility

The xlnx-vai-lib-samples app snap is compatible only with DPUs DPU configurations compatible with that match the Xilinx Model Zoo models associated with the zcu102/zcu104 (ex: densebox_320_320-zcu102_zcu104-r1.3.1.tar.gz)and the KV260 accelerated applications. It is compatible with all three of the platforms provided by the Ubuntu 20.04 Certified Image for Xilinx ZCU10x Evaluation Boards and the firmware provided by the xlnx-nlp-smartvision snap.

Custom designs that include a DPU compatible with the v1.3.1 Model Zoo Models for the zcu102/zcu104 and the KV260 will work as well.

The compatible model download filenames are:

  • <model name>-zcu102_zcu104-r1.3.1.tar.gz

  • <model name>-DPUCZDX8G_ISA0_B3136_MAX_BG2-1.3.1-r241.tar.gz

The supported DPU fingerprints are:

  • zcu10x OOB image : 0x1000020f6014407 (B4096)

  • kv260 w/xlnx-nlp-smartvision : 0x1000020f6014406 (B3136)

Installation

Code Block
sudo snap install xlnx-vai-lib-samples

...

Info

Note: If you ran the xilinx-setup-env.sh script as instructed on the Getting Started page, xlnx-config should already be installed. You can confirm by running “snap list” from a terminal.

...

Code Block
Usage:  xlnx-vai-lib-samples.<test name> <sample name> <model name> <test specific arguments>

...

test-jpeg

To run the test-jpeg  jpeg  test, with the facedetect sample app, the densebox_320_320 model, and the input file sample_facedetect.jpg the command would be as follows: 

Code Block
xlnx-vai-lib-samples.test-jpeg facedetect densebox_320_320 sample_facedetect.jpg

test-video

Info

For help determining which /dev/videoX interface to use below, you can use the following command: v4l2-ctl --list-devices

Info

If you want to run the test-video app over SSH, first export the following environment variable: export XAUTHORITY=$HOME/.Xauthority

To run the test-video app , with the openpose sample app, the openpose_pruned_0_3 model, and the USB camera at /dev/video2 as the input, use the following command: 

Code Block
xlnx-vai-lib-samples.test-video openpose openpose_pruned_0_3 2

To run the test-video app over SSH with X forwarding, set the XAUTHORITY variable before running the test. 

...

Code Block
export XAUTHORITY=$HOME/.Xauthority

For help determine with /dev/videoX interface to use, you can use the following command

...

Code Block
v4l2-ctl --list-devices

Anchor
samples
samples
Available Sample Applications and Models

...

Date

Snap Revision

Snap Version

Notes

8/11/21

8

1.3.2

Initial Public Release

9/23/21

10

1.3.2

Package refresh

11/24/21

13

1.3.2

Updated for KV260

1/24/22

17

1.3.2

Added gstreamer into package

1/25/23

18

1.3.2

Security update