Generating and Opening the Waveform Reports - 2020.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2021-03-22
Version
2020.2 English

Follow these instructions to enable waveform data collection from the command line during hardware emulation and open the viewer:

  1. Enable debug code generation during compilation and linking using the -g option.
    v++ -c -g -t hw_emu ...
  2. Create an xrt.ini file in the same directory as the host executable with the following contents (see xrt.ini File for more information):
    [Debug]
    profile=true
    timeline_trace=true
    
    [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.
  3. Run the hardware emulation build of the application as described in Running the Application Hardware Build. 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 from the Vitis IDE for more information on locating these reports.
  4. Open the Waveform view in the Vitis analyzer by opening the Run Summary, and opening the Waveform report:
    vitis_analyzer <project>.run_summary