Importing JSON Output Files - 2024.2 English - UG1702

Vitis Reference Guide (UG1702)
Document ID
UG1702
Release Date
2025-01-15
Version
2024.2 English

You can output a single snapshot of the AI Engine status to a JSON file at any time after the device has been loaded. This is a static snapshot of the AI Engine running status, along with the events that happened before. Refer to the chapter on Manual AI Engine Status Output in the AI Engine Tools and Flows User Guide (UG1076) for more information. An example command is: 

xbutil examine -r aie -d 0 -f json -o aie_status_xbutil.json

The aie_status_xbutil.json file can be imported into the Analysis view using the following specific steps.

  1. In the Summary Files section menu of the Analysis view select Import Xbutil/Xsdb JSON Output.
  2. In the displayed dialog box, set the following options.
    • Xbutil/Xsdb JSON Output File: Select the JSON file that was manually generated with the xbutil command. For example, select the file aie_status_xbutil.json.
    • AI Engine Compile Summary: Select the AI Engine compile summary file, for example ./Work/graph.aiecompile_summary.
    • Save Run Summary: The run summary file to be written. The run summary can be used to reload the analysis next time by Analysis > Open Summary or File > Open Recent > Summary .

The Graph and Array views are shown in the Analysis view.

Tip: If you load the JSON file before loading the compile workdir, the information will not be displayed because there is no graph report. An imported JSON file overrides any other JSON file previously set.

For more information, see Performance Analysis of AI Engine Graph Application during Simulation in the AI Engine Tools and Flows User Guide (UG1076) and Performance Analysis of AI Engine Graph Application on Hardware in the AI Engine Tools and Flows User Guide (UG1076).