aiecompiler to Unified CLI Migration - 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

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