Running an Application on the Board - 2025.1 English - UG1701

Embedded Design Development Using Vitis User Guide (UG1701)
Document ID
UG1701
Release Date
2025-07-16
Version
2025.1 English

The Linux application can be launched automatically at boot time or by executing the control application by a user on the command line. For bare metal, the application is launched automatically during boot.

When launching, the packaging need to use the defer running AIE at boot option. See --package Options in the Vitis Reference Guide (UG1702).

If you are using the common Linux components that are provided by AMD, perform the following to run an application on the platform:

  1. Write the sd_card.img generated by the Vitis compiler command v++ --package to the SD card.
  2. Boot the board.
  3. Run the command cd /mnt/sd-mmcblk0p1/.
  4. Run the command source init.sh.
  5. Run the application. For example, for vector addition, run ./vadd ./binary_container_1.xclbin.

The application uses Xilinx Runtime (XRT) to communicate with kernels. To set up the environment for XRT, run init.sh. This command does the following:

  • It sets the environment variable XILINX_XRT to /usr to allow the application to find the XRT environment.
  • It copies platform_desc.txt to /etc/xocl.txt to inform XRT which platform it is running on.
Note: If the sd_card.img file has already been written to the SD card and you are only updating the application, you can save time in the debugging phase by copying all files from <Vitis System Project>/Hardware/package/sd_card to a FAT32 partition on a SD card to replace existing files. The Ext4 partition does not change in sd_card.img.