Profiling for Interface Tiles - 2025.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2025-11-20
Version
2025.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 must 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 target a single channel in each PLIO, which is optionally specified after the metric set. For example, tile_based_interface_tile_metrics=all:input_throughputs:2 profiles 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 is the latest 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).

Latency

Latency between the input and output ports is measurable. This is not a metric that can be used as the other ones. This is a specific command issued in the XRT or XSDB flow.