Installing Xilinx Runtime and Platforms - 2024.2 English - UG1701

Xilinx Runtime (XRT)

Xilinx Runtime (XRT) is implemented as a combination of user-space and kernel driver components. XRT supports Versal adaptive SoC and AMD Zynq™ UltraScale+™ MPSoC-based embedded system platforms. XRT provides a software interface to AMD programmable logic devices.

For XRT product details, refer to https://www.xilinx.com/xrt.

The XRT library is available for x86 and Arm® Linux OS. It is needed on both application development and deployment environments.

Embedded Platforms

For Embedded platforms (e.g. Arm), the most common method is developing applications on a server using the cross compiling technique. Embedded platforms require a Linux kernel, a rootfs with integrated Xilinx Runtime, and a sysroot to cross-compile the host application. These components can be extracted from a pre-built common Linux software image. See Installing the Vitis Platform in the Vitis Software Platform Release Notes (UG1742) for details and a list of compatible boards.

1. To install a platform, download the ZIP file and extract it into /opt/xilinx/platforms, or extract it into a separate location and add that location to the PLATFORM_REPO_PATHS environment variable.
2. Install the common image using sdk.sh -d <install_path>. See Setting Up the Vitis Environment for details.
3. After installation, set up the application project with:

   SYSROOT: <install_path>/sysroots/cortexa72-cortexa53-xilinx-linux
   Image: <install_path>/Image
   rootfs: <install_path>/rootfs.ext4

Custom Created Platforms

For custom created platforms, the required components are assembled and compiled using tools like PetaLinux or Yocto. Adding XRT to the target Linux image is done via PetaLinux config or Yocto recipes (see Build XRT from Yocto Recipes).

For examples on how to create a fully customizable design, refer to Versal Custom Thin Platform Extensible System in the Vitis Tutorials: AI Engine Development .

For examples on how to customize a common image using PetaLinux Tools, refer to PetaLinux Building and System Customization in the Vitis Tutorials: Vitis Platform Creation .