Follow these instructions to enable waveform data collection from the command line during hardware emulation and open the viewer.
- Enable debug code generation during compilation and linking using
the
-g
option.v++ -c -g -t hw_emu ...
- Create an xrt.ini file in the
same directory as the host executable with the following contents (see xrt.ini File for more
information).
[Emulation] debug_mode=batch
The
debug_mode=batch
enables the capture of waveform data (.wdb) by running simulation in batch mode. You can also enable the Live Waveform Viewer to launch simulation in interactive mode using the following setting in the xrt.ini.[Emulation] debug_mode=gui
Tip: If Live Waveform Viewer is enabled, the simulation waveform opens during the hardware emulation run. - Run the hardware emulation build of the application as described in Simulating the Application with the Emulation Flow. The hardware transaction data is collected in the waveform database file, <hardware_platform>-<device_id>-<xclbin_name>.wdb. Refer to Output Directories of the v++ Command or Output Directories of the Vitis Unified IDE for more information on locating these reports.
- Open the Waveform view in the Vitis analyzer by opening the Run Summary, and opening the
Waveform
report.
vitis_analyzer xrt.run_summary
- Waveforms for TLM transactions can also be dumped for
third-party simulators (support limited to Mentor Graphics Questa Advanced
Simulator and Cadence Xcelium). Wave data dump is enabled when
v++
link is done with-g
option (as mentioned in step 1). The format of the wave database dumped is simulator specific (for example, .wlf for Questa Advanced Simulator and .shm for Xcelium).