Compile using v++ (Unified Compiler) - 2023.2 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2023-12-04
Version
2023.2 English

The AMD provides a standalone command line utility v++ -c --mode aie to compile the AI Engine graph and generate the libadf.a file for use in simulation, emulation, and hardware flows. The AMD Vitis™ Unified IDE uses the v++ -c --mode aie command line to compile the AI Engine graph code for either x86simulator or aiesimulator based on the target of the compilation process.

Similar to the aiecompiler command , the v++ --mode aie command also takes the graph, platform or part, and compiler options as inputs which can be either specified directly on a command line or in a config file.

The config file can contain a variety of options ranging from general compilation options like include and target, which are generic to different compilation modes. AI Engine compilation specific options are listed in v++ Mode AI Engine.
Note: For the complete list of v++ General Compilation Options, see v++ General Compilation Options in the Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393).
Tip: To access the command help, enter v++ -c --mode aie --help and aiecompiler --help.

The contents of a configuration file can vary, but the sample aiecompiler.cfg file shown below uses the following commands.

include=<VITIS_INSTALL_PATH>/Vitis/2023.2/aietools/include
include=./aie
include=./data
include=./aie/kernels
include=./
platform= xilinx_vck190_base_202320_1.xpfm
target=hw

[AIE]
Xelfgen=-j4
workdir=./Work_3
Xmapper=DisableFloorplanning
output-archive=libadf_1.a

The options under the [AIE] heading are applicable only to the AI Engine compilation. The following sections describe the v++ -c --mode aie command usage with an example and an insight on different AI Engine compile options which can be used in the config file.