Compiling and Linking for Arm - 2023.1 English

For embedded processor-based platforms, the host program (host.exe), is cross-compiled and linked for an Arm processor using the GNU Arm cross-compiler version of g++ in the following two step process:

1. Compile the host.cpp into an object file (.o):

   $XILINX_VITIS/gnu/aarch64/lin/aarch64-linux/bin/aarch64-linux-gnu-g++ -c \
   -D__USE_XOPEN2K8 -I$SYSROOT/usr/include/xrt -I$XILINX_VIVADO/include \
   -I$SYSROOT/usr/include -fmessage-length=0 -std=c++14 --sysroot=$SYSROOT \
   -o src/host.o ../src/host.cpp

2. Link the object file with required libraries to build the executable application.

   $XILINX_VITIS/gnu/aarch64/lin/aarch64-linux/bin/aarch64-linux-gnu-g++ -l \
   -lxrt_coreutil -lpthread -lrt -lstdc++ -lgmp -L$SYSROOT/usr/lib/ \
   --sysroot=$SYSROOT -o host.exe src/host.o 

When compiling the application for use with an embedded process, you must specify the sysroot for the application. The sysroot is part of the platform where the basic system root file structure is defined, and is installed as described in Installing Embedded Platforms .

The following are key elements to compiling the host code for an edge platform:

Compilation

• -I$SYSROOT/usr/include
• -I$SYSROOT/usr/include/xrt
• -std=c++14: Define the C++ language standard. Compiling host code with XRT native C++ API requires C++ standard with -std=c++14 or newer. However, on GCC versions older than 4.9.0, use -std=c++1y instead.

Linking

• -L$SYSROOT/usr/lib: Library paths location.
• -lxrt_coreutil: Required library for use with the XRT native API.
• -pthread: Required by XRT library for multithreading.

g++ -g -std=c++1y -I$XILINX_XRT/include -L$XILINX_XRT/lib -o host.exe host.cpp \
-lOpenCL -pthread