make run_emu: Running Hardware Emulation - make run_emu: Running Hardware Emulation - 2025.2 English - XD100

Vitis Tutorials: AI Engine Development (XD100)

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

After packaging, everything is set to run hardware emulation. To run emulation, use the following command (default TARGET=hw_emu):

make run_emu 

or,

###########################################################################
Hardware Emulation Goto:
$(BUILD_TARGET_DIR)/package

and do:
./launch_hw_emu.sh or ./launch_hw_emu.sh -g (for waveform viewer)...

When hardware emulation is launched, you can see the QEMU simulator load. Wait for the autoboot countdown to go to zero. After a few minutes, the root Linux prompt comes up:

root@versal-rootfs-common-2025.2:~#

After the root prompt comes up, run the following commands to run the design:

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

The gemm_dsp_xrt.elf executes. After a few minutes, you can see the output with TEST PASSED on the console. When the system shows this, run the following keyboard command to exit the QEMU instance:

#To exit QEMU Simulation
Press CtrlA, let go of the keyboard, and then press x 

To run with waveform, do the following:

cd $(BUILD_TARGET_DIR)/package
./launch_hw_emu.sh -g

This launches the XSIM Waveform Viewer. Drag and drop the signals into the viewer and click Play to start the emulation. Go back to the terminal and wait for the Linux prompt to show up. In the XSIM Waveform Viewer, you can observe the signals that you added to the waveform adjusting over the execution of the design. When this completes, press the pause button and close the window to end the emulation. Data Integrity mismatch due to software issue in hardware emulation and design works in hardware run.