The event trace build flow is as follows.
- Compile the graph with
--event-traceand other appropriate flags.
An example of the AI Engine compiler command for event tracing is as follows:
aiecompiler --verbose --pl-freq=100 --workdir=./myWork \ --event-trace-port=gmio --event-trace=runtime \ --num-trace-streams=1 --xlopt=0 --include="./" \ --include="./src" --include="./src/kernels" --include="./data" \ ./src/graph.cppNote:
- The preceding example illustrates compiling the
--event-trace=runtimeconfiguration. When you use this option, you can configure the type of events that AI Engine captures during runtime.
--event-trace-port=gmiooption uses GMIO to capture event trace data. This option uses the AI Engine-to-NoC event trace pathway. The alternative is to use PLIO which uses the AI Engine-PL pathway to capture event trace data. This uses programming logic resources to capture data from AI Engine to DDR.Recommended: Xilinx recommends using gmio option as the event-trace-port configuration. This avoids the usage of programming logic resources and avoids timing errors caused by the PL resource usage.
gmiois the AI Engine NoC event pathway. GMIO is the default event trace port configuration.
pliois the AI Engine to PL event trace pathway. Event data get transferred to the PL where it is stored within BRAMs and URAMs resources. This PL resource add-on may induce timing errors on the hardware design side.
- The preceding example illustrates compiling the design with
- Compile and link the design using the Vitis compiler.
After compiling the AI Engine graph application, you must build the other elements of the system as described in Integrating the Application Using the Vitis Tools Flow. With
--event-traceenabled in the libadf.a file from the AI Engine compiler, the system hardware generated by the Vitis compiler includes the compiled ELF file for the PS application, the compiled ELF files for the AI Engine processors, and the XCLBIN file for the PL. These are the elements you need to run the system on hardware.
- After linking to create the device binary, run the Vitis compiler
--packagestep to create the sd_card folder and files needed to boot the device, as described in Packaging. This step packages everything needed to build the
BOOT.BINfile for the system. When packaging the boot files for the device, you must also specify the
--package.defer_aie_runto load the AI Engine application with the ELF file, but wait to run it until
graph.rundirects it, as described in Graph Execution Control in AI Engine Kernel and Graph Programming Guide (UG1079).
A feature of the
aiecompiler --event-traceoption is that you can compile your design to capture data using the
runtimeargument. Using this option, you can compile the AI Engine graph to be set up for event trace, and specify the type of profile data to capture at run-time:
functions_all_stalls. Therefore, you do not need to recompile the design to capture a different type of data. Using this feature reduces the need to recompile the graph and re-package the design.
Table 1. Events Supported in Predefined Event Trace Levels Event Type Predefined Event Trace Level
Functions Calls/Returns Captured Captured Captured Stream Stalls NA Captured Captured Cascade Stalls NA Captured Captured Lock Stalls NA Captured Captured Memory Stalls NA NA Captured
- Functions Calls/Returns
- Event generated when kernel functions are being invoked and returned.
- Stream Stalls
- Event generated when core gets stalled. This can be due to either NO data at Input or backpressure on the stream output from the core.
- Cascade Stalls
- Event generated when core gets stalled. This can be due to either NO data at Input or due to backpressure on the stream output from the core.
- Lock Stalls
- Event generated when the core gets stalled due to the lock already being acquired.
- Memory Stalls
- Event generated when core gets stalled due to a memory conflict.