Generating and Analyzing AI Engine Status - 2025.2 English

Generating and Analyzing AI Engine Status - 2025.2 English - UG1076

AI Engine Tools and Flows User Guide (UG1076)

Document ID

UG1076

Release Date

2025-11-20

Version

2025.2 English

You can generate status output periodically during hardware emulation. The status and warnings can be analyzed in the Analysis View of the AMD Vitis™ Unified IDE for debug purposes.

Warning: Hardware Emulation does not support AI Engine Trace and Profile. AI Engine Status is the only AI Engine XRT-based available Debug Option. For Trace and Profile, use aiesimulator standard options.

Add the following options in your xrt.ini to output the AI Engine status. This is a one-time set up that results in periodic output of status data, including deadlock detection.
- aie_status=true: Turns on the output generation feature.
- aie_status_interval_us: Specifies the interval of the AI Engine status output.
  Example:
```
[Debug]
aie_status=true
aie_status_interval_us=1000
```
Hardware emulation generates the following files:
- xrt.run_summary: A summary file. Hardware emulation generates this file. You can open it in the Analysis View of the Vitis Unified IDE.
- aie_status_edge.json: A status of AI Engine and AI Engine memory.
- aieshim_status_edge.json: A status of AI Engine interface tiles.
- summary.csv: A summary CSV file.
Use the scp command to copy the summary and JSON files from the QEMU Linux system to your local system. The status files must be in a local directory prior to the analysis in Analysis View of the Vitis Unified IDE. For more details, see Running the System on Embedded Processor Platform in the Embedded Design Development Using Vitis (UG1701).
Analyze the summary and JSON files in Analysis View of the Vitis Unified IDE. For details, see Analyzing AI Engine Status.