Compiling the Embedded Application for the Cortex-A72 Processor - 2023.1 English

After linking the AI Engine graph and PL kernels, the focus moves to the embedded application running in the PS that interacts with the AI Engine graph and kernels. The PS application is written in C/C++, using API calls to control the initialization, running, and closing of the AI Engine graph as described in Run-Time Graph Control API in AI Engine Kernel and Graph Programming Guide (UG1079).

For details about compiling and linking host code using the XRT API, see Compiling and Linking Host Code for Linux.

If any ADF API is used in the host code, compiling host code requires additional ADF API related include files and libraries files, and also aie_control_xrt.cpp from aiecompiler result, such as:

$CXX -std=c++17 -O0 -g -Wall -c \
-I./src -I${XILINX_VITIS}/aietools/include -o sw/host.o sw/host.cpp

$CXX -std=c++17 -O0 -g -Wall -c \
-I./src -I${XILINX_VITIS}/aietools/include -o sw/aie_control_xrt.o Work/ps/c_rts/aie_control_xrt.cpp

Many of the options in the preceding command are standard and can be found in a description of the g++ command. The more important options are listed as follows:

• -std=c++17
• -I./src
• -I${XILINX_VITIS}/aietools/include
• -o sw/host.o sw/host.cpp

aie_control_xrt.cpp is copied from the directory Work/ps/c_rts.

$CXX -ladf_api_xrt -lgcc -lc -lpthread -lrt -ldl \
-lcrypt -lstdc++ -lxrt_coreutil \
-L<platform_path>/sysroots/aarch64-xilinx-linux/usr/lib \
-L${XILINX_VITIS}/aietools/lib/aarch64.o -o sw/host.exe sw/host.o sw/aie_control_xrt.o

Note in the preceding linker script that it links the adf_api_xrt libraries, which is necessary for the ADF API to work with the XRT API.

xrt_coreutil are required libraries for XRT and for the XRT API.

While many of the options can be found in a description of the g++ command, some of the more important options are listed in the following table.