Running and Analyzing the Graph - 2022.1 English

Versal ACAP AI Engine Programming Environment User Guide (UG1076)

Document ID
UG1076
Release Date
2022-05-25
Version
2022.1 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.
  3. To run the program for hardware emulation, in the Assistant view click the Run button () 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 during Simulation 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.