Event Tracing Options - 2025.1 English - UG1702

This section describes the 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 in the AI Engine Tools and Flows User Guide (UG1076) for more information.

event-trace

Event trace configuration value.

event-trace=runtime

Note: The events which will be traced in hardware will be selected through an xsdb command line or a line in the file xrt.ini.

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. Up to 16 streams can be specified. The default value is 16.

num-trace-streams=8

trace-plio-width

PLIO width for trace streams: 32, 64 (default), 128