Software Setup

Software Setup#

This section describes the software setup for the Vitis AI compiler and the steps to download the required release packages. These steps prepare the host machine for cross-compilation.

This section includes instructions to download the Docker image for model compilation, extract prebuilt boot images and design sources into a consistent directory structure, review licensing documents, and install the sysroot for building target applications.

This section also covers environment considerations such as permissions and path selection. This section ends with instructions to install Vivado 2025.2 for hardware development.

Follow these steps in sequence to create a reproducible, ready-to-use environment for evaluating example models and developing custom applications.

Release Packages#

To access these files, click the following links, accept the AMD Software License Agreement, and download the packages:

Vitis AI Docker Image#

Use this Docker image to compile models. See Docker setup to set up Docker.

Prebuilt Boot Images and Design Sources#

This package contains the Integrated System Reference Design. Extract the package under /home on the host machine. You can extract the package to another path, but you must update commands to match your path.

Extract To /home#

sudo mkdir -p /home/amd/boot_images
sudo tar -xvf vitis_ai_2ve_prebuilt_boot_images_v6.2_RevB.tar -C /home/amd/boot_images --strip-components=1
sudo git clone -b release/6.2 https://github.com/amd/Vitis-AI.git /home/Vitis-AI
cd /home

Extract To A User-Owned Directory#

mkdir -p <your_preferred_path>/amd/boot_images
tar -xvf vitis_ai_2ve_prebuilt_boot_images_v6.2_RevB.tar -C <your_preferred_path>/amd/boot_images --strip-components=1
git clone -b release/6.2 https://github.com/amd/Vitis-AI.git <your_preferred_path>/Vitis-AI
cd <your_preferred_path>

Note

Verify directory ownership and permissions before extraction. Use sudo when the extraction directory belongs to root (for example, /home). For a user-owned directory, you might not need sudo.

Directory Structure#

This document assumes you extract vitis_ai_2ve_prebuilt_boot_images_v6.2_RevB.tar to /home/amd/boot_images. The following directory structure shows the extracted contents:

 /home/
|-- amd/
|   |-- boot_images/
|   |      |-- amd-end-user-license-agreement.pdf
|   |      |-- vitis-ai-vaiml-versal-2ve-vai-6.2-third-party-notices.pdf

AMD End User License Agreement#

Review the licensing files under /home/amd/boot_images:

  • amd-end-user-license-agreement.pdf

  • vitis-ai-vaiml-versal-2ve-vai-6.2-third-party-notices.pdf

Host Setup#

Install Sysroot#

The sysroot provides the cross-compilation environment and libraries required to build applications for the target device. If the sysroot is not installed, complete the following steps before you cross-compile target applications on the host machine.

# Copy the SDK installer to a temporary location.
cp vitis_ai_2ve_sdk_v6.2.sh /tmp/sdk.sh

# Make the installer executable.
chmod +x /tmp/sdk.sh

# Clear the library path to avoid conflicts.
unset LD_LIBRARY_PATH

# Install the SDK to the specified path.
/tmp/sdk.sh -y -d <SYSROOT_PATH>

# Source the sysroot environment for cross-compilation.
source <SYSROOT_PATH>/environment-setup-cortexa72-cortexa53-amd-linux

Install Vivado#

Install Vivado 2025.2 by following the instructions in UG973.

Contents