From the Performance Metrics view, you can identify if a stream stall needs to be analyzed, and also the tile/tiles that are causing the stall.
The following steps illustrate how a stream stall can be analyzed starting in the Performance Metrics tab in Vitis analyzer.
- In the Performance Metrics view,
select Stream Stall Time (%) to view
stream stalls across all tiles. Identify the tile(s) to be analyzed. Note that
the objects in Performance Metrics view
can be cross-probed with Trace view,
Graph view, and
Array view. For example, selecting
the tile in the Performance Metrics
view to highlight the tile in Trace
view can help quickly locate the tile.Figure 1. Stream Stall in Performance Metrics View
- Choose Trace view.Figure 2. Stream Stall in Trace View
- From the Stalls view, select
Stream Stalls from the drop-down
list. In the Stalls view, stream stalls
have the following information and the objects in blue can be cross-probed with
other views by clicking on it.
- Stall ID
- The stream stall is named
SS_<NUM>. The earlier the stall happens, the smaller the number. The number is unique across all types of stalls.
- Stalled Tile
- The AI Engine tile where the stalled kernel is located.
- Stalled Kernel
- The kernel that is stalled. It is named
<Kernel_function_name>.<Schedule_ID>.<Graph_instance_name>. Sometimes it is shown as
_mainand then cross-probe is required to find the real kernel function.
- Start (ns)
- The start time of the stall.
- Duration (ns)
- The duration of the stall.
- Stalled Port
- The port of the stalled kernel.
- Related Stalls
- Other stalls that can cause the stall.
- Full Destination Port
- The port that the stalled kernel cannot write into because it is full.
- Empty Source Port
- The port that the stalled kernel cannot read from because it is empty.
- Clicking on a stream stall in Stalls view will go to the start of the stall in Trace view. Right-click the stall and select Filter Trace as needed. After filtering trace, the signals related to the stall are shown in the Trace view. Non-related signals are hidden. Exploring the trace using filter trace is clearer when the design is large.
- Objects in blue in the Stalls view can be clicked and cross-probed. For example, clicking the kernel in Stalls view will highlight the kernel in Trace view.
- Zoom in and out of the Trace view to explore the stalls. From the position of the stall, how frequently do similar stalls occur, events before the stall and related stalls (if any), can give you a hint on why the stall occurs.
- To clear the previously filtered trace, right-click and select Clear All Filters.
- It is helpful to have an overview of the stall path in Graph view. Select Graph view and then select Tile View from the drop-down list.Figure 3. Stall Path in Graph View