v++ Mode AI Engine - 2023.2 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
Release Date
2023.2 English

The AI Engine compilation mode provides for the development, optimization, analysis, and export of AI Engine graph applications (libadf.a). The AI Engine compilation mode uses the following command:

v++ -c --mode aie --target hw --platform xilinx_vck190_base_202320_1 \
--work_dir ./myWork --config ./config.cfg <Input File>
  • v++ -c --mode aie --target hw: Indicates compilation of an AI Engine component for the HW target indicating the generation of the libadf.a file for use in AI Engine simulation and to run on the physical device. You can also specify x86sim for the target to build the component for x86 functional simulator. The contents of the output directory depend on the target.

  • --platform xilinx_vck190_base_202320_1: Specifies the platform or physical device to build the component for.
  • --work_dir ./myWork: Specifies the work directory to use for building the AI Engine component.
    Tip: By default the compiler writes all outputs to a directory called Work in a sub-directory of the current directory where the tool was launched, and creates a file called libadf.a in the current directory.
  • --config ./config.cfg: Specifies the AI Engine component config file containing a variety of options available to the AI Engine compiler, x86 Simulator, and AI Engine Simulator which are part of the analysis and profiling tools for the AI Engine component.
  • <Input File> specifies the data flow graph code that defines the main() application for the AI Engine graph. The input flow graph is specified using a data flow graph language. For a description of the data flow graph, refer to Introduction to Graph Programming in the AI Engine Kernel and Graph Programming Guide (UG1079).

The v++ -c --mode aie command options are described in the following sections. The AI Engine options should be added to a configuration file under the [AIE] heading.

Tip: Some [AIE] options can be specified on the command line instead of in a config file, although using a config file is the recommended approach. To use an [AIE] option on the command line add --aie. to the start of the command name from the following sections. For example, to specify the constraints from the command line use --aie.constraints