Running and Analyzing the Graph - 2020.2 English

Versal ACAP AI Engine Programming Environment User Guide (UG1076)

Document ID
Release Date
2020.2 English
After the build is successfully finished, you can run the Emulation-SW build, or Emulation-AIE build in the Vitis IDE. You can examine various reports generated by the compiler and simulate your design. For the hardware build, you can copy the SD card output for instance and then use it to boot and run the application on the hardware card.
  1. In the Assistant view expand a specific build target, right-click the Compile Summary (graph) and select Open in Vitis Analyzer. This opens the Compile Summary report as described in Viewing Compilation Results in the Vitis Analyzer.
  2. Find additional compiler-generated reports in the Explorer view by navigating from your project and select Emulation AIE > Work > Reports in the Project Explorer.
  3. To run the program for hardware emulation, in the Assistant view click the Run icon () and select Run Configurations. This opens the Run Configurations dialog box to create a new run configuration or edit an existing one as shown.
    • You can specify a name for the configuration, which allows you to create multiple configurations to apply at different times, or to different build targets as your design flow progresses.
    • You can enable Generate Trace, and enable event trace for the emulation build using --dump-vcd in the AI Engine simulator. See Performance Analysis of AI Engine Graph Application for more details.
    • You can enable Generate Profile to specify the --profile option in the AI Engine simulator and trigger a profile for all AI Engine processors or selected tiles. Reports are generated in the project ./Emulation-AIE/aiesimulator_output directory.
      Tip: Clock cycle count reports are generated with this option enabled for the selected tiles.
    • To add additional AI Engine simulator options, select the Arguments tab and enter the option as you would from the command line.

    When ready to run emulation, select Apply > Run.

  4. To debug the program, right click on the application and select Debug As > Launch AIE Emulator. The simulator starts in debug mode with the AI Engines stopping at their respective main(). You can set breakpoints, single-step, and resume execution, as well as examine registers, local variables, and memory data structures. See Hardware Emulation Debug from the Vitis IDE for more information.