Cross-Probing - 2021.1 English

Versal ACAP AI Engine Programming Environment User Guide (UG1076)

Document ID
UG1076
Release Date
2021-07-19
Version
2021.1 English
Debugging a design is a complicated process and often needs to switch between views/reports. The Vitis analyzer supports this functionality and allows detailed inspection of events and their associated timing. Cross-probing allows you to probe data in different views allowing you to view I/O data from different perspectives, including data on a particular tile or port, and at what time an event occurred, all within the same window. The Trace and Graph views can be shown in the same window and moving the time marker in the Trace view or selecting object(s) in the Graph view applies to both views simultaneously.
  1. Use the Window Layout toolbar (circled in the following image) to manage views/reports. In the following image, the Trace and Graph view are selected to appear in the same window.

  2. The filter button function, shown circled in the following image, selects tiles, functions, input/output ports, DMA, locks to be included or excluded from trace view to focus on areas of interest.

  3. Drag the time marker to move the time backwards and forwards to evaluate events at a given time. Events occurring after the selected time are highlighted in the events table of the Trace view at the bottom of the screen.

  4. Select objects in the Graph view to map graph, tiles, I/O ports, and net connections to see the object ID, type, direction, data type, buffers, and connected ports.

  5. Values of I/O ports are available in the Trace view, shown circled in the following image. This example design uses complex 16 bits value type (cint16).

These steps show the Trace and Graph view for an output port object in the Graph view (on the right side) at 4,341,000 ns into the design execution and in the Trace view (on the left side) where the output data is available. Moving the time marker to a later time in the Trace view, the events in the events table (lower portion of the Trace view) are highlighted to indicate which events happened at that time. This information is useful to relate events in a multi-processor environment. Other examples can leverage this cross-probing feature in the Vitis analyzer tool.