Profiling for Interface Tiles - 2024.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2024-11-28
Version
2024.2 English

The following tables list the pre-defined metric set configurations available for interface tiles. In the xrt.ini file all of these metric names should be in lower case and assigned to the metric selector tile_based_interface_tile_metrics or graph_based_interface_tile_metrics.

All these metric sets are targeted to a single channel in each PLIO which is optionally specified right after the metric set. For example, tile_based_interface_tile_metrics=all:input_throughputs:2 will profile all the channels numbered 2 which are used in all the input PLIOs across the AI Engine interface. If not specified in the parameter list, the selected channel will be the latest appearing in the list of used channels generated by the aiecompiler.

Table 1. input_throughputs (mm2s_throughputs)
Metric Name Description
Stalled Time/% The time spent in stalled state (for example, master is ready, slave is stalled).
Transfer Time/% The time spent transferring data.
Idle Time/% The time spent in idle state (for example, master is idle).
Throughput (MB/s) Throughput used by master/slave (MB/s).
Table 2. output_throughputs (s2mm_throughputs)
Metric Name Description
Stalled Time/% The time spent in stalled state (for example, master is ready, slave is stalled).
Transfer Time/% The time spent in transferring data.
Idle Time/% The time spent in idle state (for example, master is idle).
Throughput (MB/s) Throughput used by master/slave (MB/s).
Table 3. input_stalls (mm2s_stalls) for AI Engine
Metric Name Description
DMA MM2S Channel 0 Stall Time/% DMA MM2S Channel 0 Stall Time/%
DMA MM2S Channel 0 Idle Time/% DMA MM2S Channel 0 Idle Time/%
Table 4. output_stalls (s2mm_stalls) for AI Engine
Metric Name Description
DMA S2MM Channel 0 Stall Time/% DMA S2MM Channel 0 Stall Time/%
DMA S2MM Channel 0 Idle Time/% DMA S2MM Channel 0 Idle Time/%
Table 5. input_stalls (mm2s_stalls) for AI Engine-ML
Metric Name Description
DMA MM2S Channel 0 Stall Time/% DMA MM2S Channel 0 Stall Time/%
DMA MM2S Channel 0 Idle Time/% DMA MM2S Channel 0 Idle Time/%
DMA MM2S Channel 0 Stream Backpressure Time/% DMA MM2S Channel 0 Stream Backpressure Time/%
DMA MM2S Channel 1 Stream Backpressure Time/% DMA MM2S Channel 1 Stream Backpressure Time/%
DMA MM2S Channel 0 Memory Starvation Time/% DMA MM2S Channel 0 Memory Starvation Time/%
DMA MM2S Channel 1 Memory Starvation Time/% DMA MM2S Channel 1 Memory Starvation Time/%
Table 6. output_stalls (s2mm_stalls) for AI Engine-ML
Metric Name Description
DMA S2MM Channel 0 Stall Time/% DMA S2MM Channel 0 Stall Time/%
DMA S2MM Channel 0 Idle Time/% DMA S2MM Channel 0 Idle Time/%
DMA S2MM Channel 0 Memory Backpressure Time/% DMA S2MM Channel 0 Memory Backpressure Time/%
DMA S2MM Channel 1 Memory Backpressure Time/% DMA S2MM Channel 1 Memory Backpressure Time/%
DMA S2MM Channel 0 Lock Stall Time/% DMA S2MM Channel 0 Lock Stall Time/%
DMA S2MM Channel 1 Lock Stall Time/% DMA S2MM Channel 1 Lock Stall Time/%
Table 7. packets
Metric Name Description
TLAST event count on port 0 Reports the number of input packets
TLAST event count on port 1 Reports the number of output packets

These values are referring to a specific input channel of all the PLIOs (PL to AI Engine) among the 8 available (0 to 7).