Running an Application on the Board - 2025.2 English - UG1701

Embedded Design Development Using Vitis User Guide (UG1701)

Document ID
UG1701
Release Date
2025-11-20
Version
2025.2 English

The Linux application can be launched automatically at boot time. You can also execute the control application on the command line. For bare metal, the application is launched automatically during boot.

When launching, the packaging uses 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 steps 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 /run/media/sd-mmcblk0p1/.
  4. Run the application. For example, for vector addition, run ./vadd ./binary_container_1.xclbin.

The application uses Xilinx Runtime (XRT) to communicate with kernels.

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.