Event Tracing Options - 2024.1 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2024-06-27
Version
2024.1 English

Options to define the event-tracing characteristics of the compiled kernels and graph. These options prepare the design for event tracing during runtime. See Event Trace Build Flow for more information.

event-trace

Event trace configuration value. Where the specified <value> indicates the following:

  • functions: Function transition view without stalls.
  • functions_partial_stalls: Function transition view with stream/lock/cascade stalls.
  • functions_all_stalls: Function transition view with all stalls (stream/lock/cascade/memory).
  • runtime: Runtime event tracing configuration.
event-trace=runtime
event-trace-port

Set the AI Engine event tracing port. Accepted values are plio and gmio. The gmio option uses the AI Engine-to-NoC pathway to capture trace data. The alternative is to use plio which uses the AI Engine-PL pathway to capture trace data. This uses programming logic resources to capture data from AI Engine to DDR. The default value is gmio which is the recommended event-trace-port configuration.

event-trace-port=plio
graph-iterator-event

Generates user_event() whenever the graph iterator is incremented. This provides the ability to delay the start of the hardware event trace based on the graph iteration.

num-trace-streams

Specifies the number of trace streams. The default value is 16.

num-trace-streams=32
trace-plio-width

PLIO width for trace streams (default: 64)