Profiling for Interface Tiles - 2024.1 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2024-05-30
Version
2024.1 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.

All these metric sets are targeted to a single channel in each PLIO which is 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.

Table 1. input_throughputs
Metric Name Description
Stalled Time/% The time spent in stalled state (for example, master is ready, slave is stalled).
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
Metric Name Description
Stalled Time/% The time spent in stalled state (for example, master is ready, slave is stalled).
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 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 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 for AI Engine-ML
Metric Name Description
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 for AI Engine-ML
Metric Name Description
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).