Important: Set up the command shell or
window as described in Setting Up the Vitis Environment prior to
running the tools.
The first stage in building the xclbin file is to compile the kernel code using the Xilinx
Vitis compiler. There are multiple
v++ options that need to be used to correctly compile your kernel. The
following is an example command line to compile the vadd
kernel:v++ -t sw_emu --platform xilinx_u200_xdma_201830_2 -c -k vadd \
-I'./src' -o'vadd.sw_emu.xo' ./src/vadd.cppThe various arguments used are described below. Note that some of the arguments are required.
-
-t <arg>: Specifies the build target, as discussed in Build Targets. Software emulation (sw_emu) is used as an example. Optional. The default is hw. -
--platform <arg>: Specifies the accelerator platform for the build. This is required because runtime features, and the target platform are linked as part of the FPGA binary. To compile a kernel for an embedded processor application, specify an embedded processor platform:--platform $PLATFORM_REPO_PATHS/zcu102_base/zcu102_base.xpfm. -
-c: Compile the kernel. Required. The kernel must be compiled (-c) and linked (-l) in two separate steps. -
-k <arg>: Name of the kernel associated with the source files. -
-o'<output>.xo': Specify the shared object file output by the compiler. Optional. -
<source_file>: Specify source files for the kernel. Multiple source files can be specified. Required.
The above list is a sample of the extensive options available. Refer to Vitis Compiler Command for details of the various command line options. Refer to Output Directories of the v++ Command to get an understanding of the location of various output files.