Vitis IDE Layout for Software Emulation Debug - 2023.1 English

AI Engine Tools and Flows User Guide (UG1076)

Document ID
Release Date
2023.1 English

This section describes all the aspects of the Vitis IDE for effective debugging for Emulation-SW.

The following figure shows the typical layout of the Vitis IDE when in the Debug perspective.

The numbered sections are as follows:

  1. The Debug view displays the list of threads that are associated with the running the PL, AI Engine, and PS applications as the PS host application, PL kernels, and AI Engine kernels.
  2. The code window. This window opens up the source file when a breakpoint in that file is triggered.
  3. The Variables, Breakpoints, Expressions, and Registers views.
    • Variables view shows all the available variables used in the perspective of the triggered breakpoint. For example, if a breakpoint is in the host application source file, it will display all objects and variables associated with that code.
    • Breakpoints view shows all breakpoints, enabled or disabled, for the design that is being debugged.
    • Expressions allows for specific expressions to be written in which to trigger a pause in code execution. For example, checking and breaking when a for loop variable reaches a certain value.
    • Registers view shows the registers of the Cortex┬«-A72 when a breakpoint is triggered in the host application source code, and the AI Engine when a breakpoint is triggered in the AI Engine kernel.
  4. The Emulation Console and the XSCT Console views.
    • Emulation Console provides a transcript of QEMU, as well as allows you to run Linux commands.
    • XSCT Console allows you to see the program memory and snippet of code when a breakpoint is triggered.
  5. The Console view displays output from program execution results.