Installation

Prerequisites

To use the test harness, up-to-date installations of the following softwares and libraries are required:

• Vitis tools (https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vitis.html)
• Xilinx Runtime (https://www.xilinx.com/products/design-tools/vitis/xrt.html#gettingstarted)
• Versal common image for Vitis embedded platforms (https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/embedded-platforms.html)

Installation Instructions

1. Clone test harness repository:

   git clone https://github.com/Xilinx/AI-Engine-Test-Harness.git
   

2. Download the prebuilt test harness XSAs:

   cd AI-Engine-Test-Harness/bin
   source download.sh
   

Caution

The prebuilt XSAs can only be used with the 2023.2 version of the Vitis tool. To build and test your AI Engine graph using other versions of Vitis, you must first rebuild the XSA with the corresponding version of the Vitis tool, as described in the section below.

Rebuilding from Source

The prebuilt test harness XSA can optionally be rebuilt from source as follows:

cd AI-Engine-Test-Harness/test_harness
source <path to Vitis installation>/settings64.sh
make clean
# To build functional/performance testing mode XSA for VCK190
make <vck190_func_xsa/vck190_perf_xsa> TARGET=hw DEVICE=vck190
# Or to build performance testing mode only XSA for VEK280
make vek280_xsa TARGET=hw DEVICE=vek280