The waveform debugging process can be enabled through the
v++command using the following steps:
- Enable debug features in the kernel code during compilation and linking, as
described in Building the Device Binary.
v++ -g ...
- Create an xrt.ini file in the same
directory as the host executable, as described in xrt.ini File, with the following contents:
- Run the application, host and kernel, in hardware emulation mode. The
waveform database, reflecting the hardware transaction data, is collected in a
file named <hardware_platform>-<device_id>-<xclbin_name>.wdb.
This file can directly be opened in the Vitis analyzer as described in Using the Vitis Analyzer.Tip: If
debug_mode=guiin the xrt.ini, a live waveform viewer is launched when the application is run, as described in Waveform View and Live Waveform Viewer. This is especially useful when debugging a
hw_emuhang issue, because you can interrupt the simulation process in the simulator and observe the waveform up to that time.