After packaging, you can run hardware emulation or hardware execution.
To run hardware emulation use the following command (default TARGET=hw_emu, N_FIR_FILTERS=1, N_FIR_TAPS=15, EN_TRACE=0):
make run_emu
or
cd build/fir_$(N_FIR_TAPS)_taps/x$(N_FIR_FILTERS)_firs/hw_emu/package
./launch_hw_emu.sh
The QEMU simulator loads. Wait for the auto boot countdown to reach zero. After a few minutes, the Linux root prompt appears:
root@versal-rootfs-common-2025_2:~#
You might see the following error on the screen:
root@versal-rootfs-common-2025_2:~## xinit: giving up
xinit: unable to connect to X server: Connection refused
xinit: server error
Enabling notebook extension jupyter-js-widgets/extension...
- Validating: OK
[C 13:46:09.233 NotebookApp] Bad config encountered during initialization:
[C 13:46:09.239 NotebookApp] No such notebook dir: ''/usr/share/example-notebooks''
Ignore this error and press
After the root prompt appears, run the following commands to run the design:
mount /dev/mmcblk0p1 /mnt
cd /mnt
./fir_hls_xrt.elf a.xclbin
The fir_hls_xrt.elf executes. After a few minutes, the console shows TEST PASSED. When it appears, enter the following keyboard command to exit the quick emulator (QEMU) instance:
#To exit QEMU Simulation
Press Ctrl-A, let go of the keyboard, and then press x
To run with waveform do the following:
cd build/fir_$(N_FIR_TAPS)_taps/x$(N_FIR_FILTERS)_firs/hw_emu/package
./launch_hw_emu.sh -g
The XSIM Waveform Viewer starts. Drag the signals into the viewer and click Play to start emulation. Return to the terminal and wait for the Linux prompt.
In the XSIM Waveform Viewer, watch the signals you added to the waveform adjust as the design runs. When done, press the Pause button and close the window to end emulation.