Event Tracing Options - 2024.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID
UG1076
Release Date
2024-11-28
Version
2024.2 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.

event-trace=runtime
Note: The following event trace configuration values are now deprecated: functions, functions_partial_stalls, functions_all_stalls. For ease of use purpose, these configuration values must now be specified in the xrt.ini file for hardware emulation or hardware run.
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)