Running the Design on Hardware - 2025.1 English - XD100

NOTE: Run this step only if you are interested to learn how to run the design and observe TEST PASSED in hardware. You can skip to the steps Analyzing Run Results and Error Handling and Reporting in the Host Application, where it is required do some code changes, regenerate the hardware image, and run on hardware.

Before starting this tutorial:

• It is expected that you cloned the git repository, and the design files are ready to build.

• It is expected that you have run the steps to set the environment variables as described in Introduction.

1. Navigate to the tutorial directory cmd_src/, and do make all TAERGET=hw.

   This step:

   • Compiles the AI Engine kernels and generates libadf.a.

   • Compiles the PL kernels, s2mm and mm2s and generates .xo.

   • Hardware linking step to link AI Engine kernels and PL kernels using the system.cfg file. This generates the .xsa file.

   • Compiles the host application and generates the executable file, host.exe.

   • Packages libadf.a,.xsa, andhost.exe files.

2. Observe the hardware image file (sd_card.img) generated in the sw/ directory.

3. Once the image is generated, you are ready to run the hardware image on board. The following are some steps to run on the board:

   • Flash the SD card with the built sd_card.img.

   • Plug the flashed SD card into the SD card slot of the VCK190 board.

   • Connect the USB type C cable to the board and computer that supports serial port connection.

   • Set the serial port configuration with Speed=115200, Data=8 bit, Parity=none, Stop bits=1 bit, and flow control=none.

   • Power up the VCK190 board to see the boot messages from the serial connection.

4. In the console, run the application by:

   cd /run/media/mmcblk0p1
   ./host.exe a.xclbin
   

5. Observe the TEST PASSED message in the Linux console.