Profiling Memory Tiles - 2023.2 English

AI Engine Tools and Flows User Guide (UG1076)
Document ID
UG1076
Release Date
2023-12-04
Version
2023.2 English

The following tables list the pre-defined metric set configurations available for memory tiles. In the xrt.ini file, all of these metric names should be in lowercase and assigned to one of the following metric selectors:

  • tile_based_memory_tile_metrics
  • graph_based_memory_tile_metrics
Table 1. input_channels
Metric Name Event ID Description
Port_Running_<N> 80+4*N For monitored port <N>, the event is asserted when it is in running condition. Running when master TVALID is high and slave TREADY high
Port_Stalled_<N> 81+4*N For monitored port <N>, the event is asserted when it is in stalled condition. Stalled when master TVALID is high and slave TREADY low
Port_TLAST_<N> 82+4*N For monitored port <N>, the event is asserted when TLAST is high
DMA_S2MM_Sel0_finished_BD 25 The S2MM channel selected by Sel0 (<N>) completes one call of a buffer descriptor. The buffer descriptor is complete when all data pushed to memory.
Table 2. input_channels_details
Metric Name Event ID Description
DMA_S2MM_Sel0_stalled_lock 33 The S2MM channel selected by Sel0 is stalled on a lock request (acquire).
DMA_S2MM_Sel0_stream_starvation 37 The S2MM channel selected by Sel0 is stalled due to no data on stream input.
DMA_S2MM_Sel0_memory_backpressure 41 The S2MM channel selected by Sel0 is stalled due to conflicts writing to memory, or strided writes to neighbor memories
DMA_S2MM_Sel0_finished_BD 25 The S2MM channel selected by Sel0 (<N>) completes one call of a buffer descriptor. The buffer descriptor is complete when all data pushed to memory.
Table 3. output_channels
Metric Name Event ID Description
Port_Running_<N> 80+4*N For monitored port <N>, the event is asserted when it is in running condition. Running when master TVALID is high and slave TREADY is high.
Port_Stalled_<N> 81+4*N For monitored port <N>, the event is asserted when it is in stalled condition. Stalled when master TVALID is high and slave TREADY low.
Port_TLAST_<N> 82+4*N For monitored port <N>, the event is asserted when TLAST is high.
DMA_MM2S_Sel0_finished_BD 25 The S2MM channel selected by Sel0 (<N>) completes one call of a buffer descriptor. The buffer descriptor is complete when all data pushed to memory.
Table 4. output_channels_details
Metric Name Event ID Description
DMA_MM2S_Sel0_stalled_lock 35 The MM2S channel is selected by Sel0 is stalled on a lock request (acquire).
DMA_MM2S_Sel0_stream_backpressure 39 The MM2S channel is selected by Sel0 is stalled due to stream backpressure.
DMA_MM2S_Sel0_memory_starvation 43 The MM2S channel is selected by Sel0 is stalled due to conflicts reading from memory, or strided reads to neighboring memories.
DMA_MM2S_Sel0_finished_BD 27 The MM2S channel is selected by Sel0 (<N>) completes one call of a buffer descriptor. The buffer descriptor is complete when last word is ready to be pushed to the stream port.
Table 5. memory_stats
Metric Name Event ID Description
Group_Memory_Conflict 111 Event is triggered when any memory bank has a conflict.
Group_Errors 128 Any of the following events triggers this event:
  • Scrubber has fixed a 1-bit ECC.
  • ECC scrubber detects 2-bit ECC error.
  • 1-bit ECC error is detected during access.
  • 2-bit ECC error is detected during access.
  • Any error in any of the 6 S2MM channels (including task queue overflow).
  • Any error in any of the 6 MM2S channels (including task queue overflow).
  • Any parity error at stream endpoints.
  • Parity error in the packet header.
  • Any error processing ctrl-pkt (slave error).
  • AXI-MM port access results in slave error
  • Underflow or overflow in locks.
  • Any channel stalled due to task-complete-token backpressure, or from FoT count FIFO full.
Group_Lock 45 Any of the following events for eight selected locks will trigger this event:
  • For selected lock <0...7>, granted acquire-equal request.
  • For selected lock <0...7>, granted acquire-greater-equal request.
  • For selected lock <0...7>, completed release request.
  • Selected lock <0...7> reached value set in register.
Group_Watchpoint 15 Event triggered by a memory access to a configured address, sets in register four specific registers.