Event Tracing Options - 2025.2 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: This option selects events traced in hardware through an xsdb command line or a line in the file xrt.ini.

event-trace-port

Sets 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. This option uses the AI Engine-PL pathway to capture trace data. The option uses programming logic resources to capture data from AI Engine to DDR. The default value is gmio. This value is the recommended event-trace-port configuration.

event-trace-port=plio

graph-iterator-event

Generates user_event() whenever the graph iterator increments. 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. Allows up to 16 streams. The default value is 4.

num-trace-streams=8

trace-plio-width

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