Installing Xilinx Runtime and Platforms - 2024.1 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
Release Date
2024.1 English

Xilinx Runtime (XRT)

Xilinx Runtime (XRT) is implemented as a combination of user-space and kernel driver components. XRT supports AMD Alveo PCIe-based cards, in addition to AMD Versal™ 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

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

x86 Platforms

For x86 platforms (e.g. AMD Alveo™ ), XRT installation uses standard Linux RPM and Linux DEB distribution files or built as custom package. Root access is required for all software and firmware installations.

For a guide on how to download and install the XRT, refer to XRT Software Stack for PCIE Accelerator Cards.

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 Embedded Platforms 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 -d <install_path>. See Setting Up the Environment to Run the Vitis Software Platform 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
Note: Using a common image does not require installing PetaLinux Tools.

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).

Note: Creating custom Linux platforms require installing PetaLinux. For details on how to use PetaLinux and determine output locations, refer to the PetaLinux Tools Reference Guide.

For examples on how to create a fully customizable design, refer to Versal Custom Thin Platform Extensible System.

For examples on how to customize a common image using PetaLinux Tools, refer to PetaLinux Customization.