Running on Hardware - Running on Hardware - 2025.2 English - XD100

Vitis Tutorials: AI Engine Development (XD100)

Document ID
XD100
Release Date
2026-03-27
Version
2025.2 English

To run the design in hardware, rerun the following make steps with TARGET=hw and other applicable options (see the preceding make steps specified above).

make kernels xsa package TARGET=hw 

These commands create a $(BUILD_TARGET_DIR) folder with the kernels, XSA, and package for a hardware run.

Run the following step to set up the execution file, generated images, and base images ($(BUILD_TARGET_DIR)/package/sd_card and $(BUILD_TARGET_DIR)/package/sd_card.img).

make run_emu TARGET=hw 

These commands create a build/hw folder with the kernels, XSA, and package for a hardware run. Follow steps 1-9 to run the gemm_aie_xrt.elf executable on your VCK190 board.

  1. Ensure your board is powered off.

  2. Use an SD card writer (such as balenaEtcher) to flash the sd_card.img file to an SD card.

  3. Plug the flashed SD card into the top slot of the VCK190 board.

  4. Set the switch (SW1 Mode\[3:0\]=1110 = OFF OFF OFF ON).

  5. Connect your computer to the VCK190 board using the USB cable included with the board.

  6. Open a Tera Term terminal and select the correct COM port. Set the port settings to the following:

    Port: <COMMXX>
    Speed: 115200
    Data: 8 bit
    Parity: none
    Stop Bits: 1 bit
    Flow control: none
    Transmit delay: 0 msec/char 0 msec/line
    
  7. Power on the board.

  8. Wait until you see the root@versal-rootfs-common-2024.2 Linux command prompt. Press Enter a few times to get past any xinit errors.

  9. Run the following commands in the Tera Term terminal:

    cd /mnt/sd-mmcblk0p1
    
    ./gemm_aie_xrt.elf a.xclbin