v++ Command - 2025.2 English

This section describes the AMD Vitis™ compiler command, v++, and the various options it supports for building the device binaries. v++ is a standalone command line utility with three command modes.

--compile (-c)

Compiles C++ to create AI Engine binaries and PL modules.

For embedded applications, to develop AI Engine kernels and compile the AI Engine graph applications into a libadf.a file, refer to Compiling an AI Engine Graph Application in the AI Engine Tools and Flows User Guide (UG1076). For developing and compiling HLS PL kernel into a XO object file, refer to HLS Kernel Development in the Embedded Design Development Using Vitis (UG1701).

To target a data center card, refer to Compiling C/C++ PL Kernels in the Data Center Acceleration using Vitis (UG1700).

--link (-l)

For linking AI Engine kernels, HLS PL kernels, and Vitis subsystems into an extensible XSA platform to create a fixed XSA hardware design or emulation design. Also used to create Vitis subsystems and Vitis metadata archive that can be imported into a Vivado project for design iteration and completion.

--package (-p

For packaging AI Engine libadf.a binaries into .pdi and .xclbin images as described in Packaging for Vitis Flow in the Embedded Design Development Using Vitis (UG1701). Also generates an SD card image for Zynq Ultrascale target devices.

Beyond these three command modes, many other options are available to customize the build process. The following sections describe these options. Some of the options are supported for all three command modes, and some options are specific to compilation, linking, or packaging.