v++ Command - 2024.2 English

Vitis Reference Guide (UG1702)

Document ID
UG1702
Release Date
2025-01-15
Version
2024.2 English

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

  • --compile (-c):
    • For compiling the Data Center HLS PL kernel into a XO object file refer to Compiling C/C++ PL Kernels in the Data Center Acceleration using Vitis (UG1700).
    • 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).
  • --link (-l): For linking PL kernels(.xo), AI Engine graph applications (libadf.a), and a target hardware platform (.xpfm) into a device binary (.xclbin), a hardware design (.xsa), or a Vivado export file (.vma) as described in Linking the System in the Data Center Acceleration using Vitis (UG1700)
  • --package (-p): For packaging an AI Engine libadf.a file into the xclbin, and generating an SD card file or QSPI/OSPI file as needed to initialize and boot the accelerated system as described in Packaging for Vitis Flow in the Embedded Design Development Using Vitis (UG1701)

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