Setting Up the Vitis Environment - 2025.2 English

Embedded Design Development Using Vitis User Guide (UG1701)
Document ID
UG1701
Release Date
2025-11-20
Version
2025.2 English

The AMD Vitis™ unified software platform includes three elements that must be installed and configured to work together properly: the Vitis core development kit and XRT. The requirements of installation and configuration are described in Vitis Software Platform Installation in the Vitis Software Platform Release Notes (UG1742).

If you have the elements of the Vitis software platform installed, you need to setup the environment to run in a specific command shell by running the following scripts (.csh scripts are also provided): 
 #setup XILINX_VITIS and XILINX_VIVADO variables
 source <Vitis_install_path>/settings64.sh
 #setup XILINX_XRT
 source /opt/xilinx/xrt/setup.sh
Tip: The PLATFORM_REPO_PATHS environment variable points to directories containing platform files (.xpfm).
Tip: .csh scripts are also provided.

This sets up the tools for the Vitis application development flow, the Vitis embedded software development flow, and the AI Engine tools for development on Versal adaptive SoC AI Engine devices.

To use any platforms you have downloaded as described in Installing Xilinx Runtime and Platforms in the Embedded Design Development Using Vitis (UG1701) , set the following environment variable to point to the location of the platforms:
export PLATFORM_REPO_PATHS=<path to platforms>

This identifies the location of platform files for the tools, and makes them accessible to your design projects.