aiecompiler to Unified CLI Migration - 2023.2 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
Release Date
2023.2 English

Using the v++ CLI Command Line Options

The AI Engine applications developed to compile using the aiecompiler command can be migrated to use the Unified CLI command (v++ c -mode aie) and this section describes the procedure to migrate using an example.

Consider the following aiecompiler command.

aiecompiler --include="<Vitis Installation Path>/20XX.X/aietools/include" --stacksize=512 --include="./aie" --include="./data" --include="./aie/kernels" --include="./" --platform <PLATFORM_REPO_PATHS>/xilinx_vck190_base_20XXX0_1/xilinx_vck190_base_20XXX0_1.xpfm --workdir=./Work --target=hw aie/graph.cpp

You can convert the above command to use unified CLI as shown below.

v++ -c --mode aie --include="<Vitis Installation Path>/20XX.X/aietools/include" --aie.stacksize=512 --include="./aie" --include="./data" --include="./aie/kernels" --include="./" --platform <PLATFORM_REPO_PATHS>/xilinx_vck190_base_20XXX0_1/xilinx_vck190_base_20XXX0_1.xpfm --work_dir=./Work --target=hw aie/graph.cpp


  • v++ c - mode aie is the unified CLI compile option.
  • Some generic options, such as --include, and --platform, are common across different v++ compile modes (e.g., v++ c - mode hls).
  • The option –stacksize=512 is specific to the aie mode. So, in the unified CLI command you need to prepend the option with "–aie." as in:


Note: The –work_dir option in the unified CLI command is the equivalent option to the –workdir in the aiecompiler command.

Using the v++ Configuration File

Another way to migrate from aiecompiler to Unified CLI command is to specify all the options in the configuration file and pass that file to the Unified CLI command using --config option as shown below.

v++ -c --mode aie --config aiecompiler.cfg --target=hw aie/graph.cpp

A sample aiecompiler.cfg file is shown below.

include=<Vitis Installation Path>/20XX.X/aietools/include
#AI Engine specific options
Note: The AI Engine specific options are added under the section [ aie ]. You can also find more AI Engine specific options(#commented) for reference.