aiecompiler to Unified CLI Migration - aiecompiler to Unified CLI Migration - 2023.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)
Document ID
UG1076
Release Date
2023-12-04
Version
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

Here:

  • 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:

    –aie.stacksize=512

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
include=./aie
include=./data
include=./aie/kernels
include=./
platform=<PLATFORM_REPO_PATHS>/xilinx_vck190_base_20XXX0_1/xilinx_vck190_base_20XXX0_1.xpfm
target=hw
 
#AI Engine specific options
 
[aie]
 
stacksize=512
#Xelfgen=-j4
#workdir=./Work_3
#Xmapper=DisableFloorplanning
#output-archive=libadf.a
Note: The AI Engine specific options are added under the section [ aie ]. You can also find more AI Engine specific options(#commented) for reference.