Installation

The Vitis™ environment supports the OpenCL Installable Client Driver (ICD) extension (cl_khr_icd). This extension allows multiple implementations of OpenCL to co-exist on the same system. The ICD Loader acts as a supervisor for all installed platforms, and provides a standard handler for all API calls.

Applications can choose an OpenCL platform from the list of installed platforms. Based on the platform ID specified by the application, the ICD dispatches the OpenCL host calls to the right runtime.

Xilinx does not provide the OpenCL ICD library, so the following should be used to install the library on your system.

sudo apt-get install ocl-icd-libopencl1
sudo apt-get install opencl-headers
sudo apt-get install ocl-icd-opencl-dev

sudo yum install ocl-icd
sudo yum install ocl-icd-devel
sudo yum install opencl-headers

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

You must install XRT for use in the Vitis application acceleration development flow. You do not need to reinstall it for every additional platform you choose to download.

To download and install the XRT package for your operating system, do the following.

1. Go to https://www.xilinx.com/xrt.
2. From the Getting Started page, you can choose to download the XRT package for a specific Alveo Data Center accelerator card, or for Embedded Platforms.
   Note: Installing XRT is not required when targeting Arm®-based embedded platforms: Vitis compiler has its own copy of xclbinutil for hardware generation, and for software compilation, you can use the XRT from the sysroot. Look for Common images for Embedded Vitis platforms on the downloads page.

   After choosing the platform, you will be redirected to a web site with instructions for downloading XRT and the required files for the selected platform.

3. Follow the directions to install XRT and your selected platform.
   TIP: The instructions for installing the Alveo Data Center accelerator cards are provided on the platform download page. Instructions for installing the Embedded Platforms can be found in the following section.

Embedded platforms are available to download from the Vitis Embedded Platforms download page for use in the Vitis unified software platform. For the Vitis embedded software development flow, you can use embedded platforms with Linux, standalone/bare metal, or RTOS domains. To support the Vitis application acceleration development flow, embedded platforms must run Linux, with XRT integrated into the rootfs. Some of the supported platforms are listed below. A complete list can be found on the downloads page.

xilinx_zcu102_base_202020_1

Provides the platform definition, XRT drivers, and shared libraries for the ZCU102 Zynq UltraScale+ MPSoC based platform.

xilinx_zcu102_base_dfx_202020_1

Provides the platform definition, XRT drivers, and shared libraries for the ZCU102 Zynq UltraScale+ MPSoC based platform with dynamic function exchange.

xilinx_zc702_base_202020_1

Provides the platform definition, XRT drivers, and shared libraries for the ZC702 Zynq-7000 SoC based platform.

xilinx_zc706_base_202020_1

Provides the platform definition, XRT drivers, and shared libraries for the ZC706 Zynq®-7000 SoC based platform.

xilinx_vck190_base_202020_1

Provides the platform definition, XRT drivers, and shared libraries for the Versal based platform.