TARGET=hw: Running on Hardware - TARGET=hw: 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 on hardware, rerun the following make steps with TARGET=hw and other applicable options (refer to the preceding make steps specified above).

make kernels TARGET=hw 
make xsa TARGET=hw 
make application TARGET=hw
make 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, XCLBIN, and package for a hardware run. Follow steps 1-9 to run the gemm_dsp_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-2025_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:

    mount /dev/mmcblk0p1 /mnt
    cd /mnt
    export XILINX_XRT=/usr
    
    ./gemm_dsp_xrt.elf a.xclbin