AR# 72061

Using the KCU1500 platform with the SDAccel v2018.3 Release


You can use the KCU1500 acceleration platform with the 2018.3 release of the SDAccel Development Environment.

However, you must point to the platform files (.xpfm) from the 2018.2 release, and you must use the 2018.2 runtime library when compiling and running your application.

The following instructions describe how to set this environment up. 

Note 1: if you do not have a critical requirement to use the 2018.3 release, you should continue to use the KCU1500 platform with the 2018.2 release.

Note 2: This process should work with the operating systems supported by both the 2018.2 and 2018.3 releases: CentOS/RedHat 7.4, and Ubuntu 16.04. 

However, this has only been tested under CentOS 7.4.


Board runtime setup using 2018.2:

Install the KCU1500 card from the 2018.2 release as described in Appendix A of the KCU1500 User Guide (UG1260).

You should already have installed the platform and set it up in the 2018.2 environment.

Use the <xbinst_area>/ or setup.csh script to launch the Xilinx runtime, XRT, for the KCU1500 platform, as described in (UG1260). 

For example:

source /opt/dsa/xilinx_kcu1500_dynamic_5_0/xbinst/

Designing and deploying applications using 2018.3:

You also need to run the setup script for the 2018.3 XRT, or set up the XILINX_XRT environment variable to point to the 2018.3 runtime. 

For example:

source /opt/xilinx/xrt/

Open or Create an Application Project in the 2018.3 version of SDAccel, and point to the KCU1500 platform (xpfm) from the 2018.2 SDAccel installation. 

This is done by selecting Manage Platform Repositories and Add Custom Platform commands from within the Platform Selection dialog box. 

Refer to (UG1023) the SDAccel Development Environment User Guide for more information on managing platform repositories. 

You can also set this platform in the makefile, or from the XOCC command line by specifying the --platform option with the full path to the .xpfm file for the KCU1500 platform. 

For example:

xocc -t hw --platform /proj/xbuilds/released/2018.2/SDx/2018.2/platforms/xilinx_kcu1500_dynamic_5_0/xilinx_kcu1500_dynamic_5_0.xpfm

Prior to building your application project, you must include the 2018.2 version of the OpenCL runtime library in order to compile the kernel to run on the 2018.2 platform. 

This is done by setting the -I option for the XOCC compiler in either the build settings for the build configuration, or in the command script or makefile for the build.

To set it from the SDAccel GUI,  select the build configuration in the Assistant view (For example, System), and select the Settings command.

This opens the Build Configuration Settings dialog box. Select the Edit Toolchain Compiler Settings link in the dialog box.

This opens the Settings dialog box. Under both the SDx XOCC Kernel Compiler, and the SDx GCC Host Compiler, select the Includes setting and add the following Includes path (note, the path for your 2018.2 installation might vary):


You can also set this include path by editing the makefile produced when the build configuration is built.

Locate the CXXFLAGS and the XOCC -c options, and insert the following (note, the path for your 2018.2 installation might vary):


After compiling and linking the application and kernel binary files, you can run the application executable in a terminal window which has been configured for the 2018.2 platform runtime. 

Open a terminal, source the <xbinst_area>/ script or setup.csh script, and then run your application exe file. 

For example:

source /opt/dsa/xilinx_kcu1500_dynamic_5_0/xbinst/
host.exe kernel_binary.xclbin
AR# 72061
Date 04/02/2019
Status Active
Type General Article