Compiling and Linking Host Code for Bare-Metal - 2025.2 English - UG1076

To build the PS application for the bare-metal flow, use the Vitisplatform generated in the previous step

To do this, you need the PS application (main.cpp), and the bare-metal AI Engine control file (aie_control.cpp). The ./Work/ps/c_rts folder contains the control file created by the AI Engine compiler.

You can set up the PS application with the Vitis IDE. See this link for details. For bare-metal, in the Symbols section under Compiler Settings, add __PS_BARE_METAL__. When creating a Vitis application, a linker script lscript.ld is generated in the src folder. To set stack and heap size, open or double click on lscript.ld for the project. Use 0x10000 (1 MB) heap size as the starting size.

Compile the main.cpp file using the following command:

aarch64-none-elf-gcc \
-I<path_to_app_source> \
-I<path_to_aie_source> \
-I<path_to_bsp>/include \
-D__PS_BARE_METAL__ \
-g -c -std=c++17 -o main.o main.cpp

where, vitis_pfm_name is the user-defined Vitis platform name.

Compile the aie_control.cpp file using the following command:

aarch64-none-elf-gcc \
-I<path_to_app_source> \
-I<path_to_aie_source> \
-I<path_to_aie_control_app_source> \-I<path_to_bsp>/include \
-D__PS_BARE_METAL__ \
-g -c -std=c++17 -o aie_control.o ../Work/ps/c_rts/aie_control.cpp

Link the PS application using the two compiled object files:

aarch64-none-elf-gcc main.o aie_control.o -g -mcpu=<target_cpu> -Wl,-T -Wl,./lscript.ld \-L<path_to_bsp>/lib  \
-D__PS_BARE_METAL__ \
-ladf_api -Wl,--start-group,-lxil,-lgcc,-lc,-lstdc++,--end-group -o main.elf