Software Emulation Debug from the Vitis IDE - 2023.2 English

Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393)

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 English
To run and debug the application in the Software Emulation build target, you must use the following steps.
  1. With the System project active in the Flow Navigator, select the Build All command under the SOFTWARE EMULATION heading.
    Note: For software emulation the System project is built to run on the x86 processor as described in the Embedded Processor Emulation Using PS on x86, rather than the QEMU environment.
  2. After the build completes successfully, select the Debug command from the Flow Navigator under the Software Emulation heading.
    Note: If you have not setup a launch configuration for the build, you will be prompted to do so as described in Launch Configurations.
  3. The Debug view opens in the Vitis unified IDE as shown in Debug View, and connects to the PS application. The application is paused at the entry to main() function.

    The Source Code editor opens to display a source code file when a breakpoint in that file is triggered.

  4. Click Resume () from the Control Panel to step forward to the next breakpoint. You can also press Step Over, Step Into, or Step Out as needed.

    Looking at the Debug view, you can see the various threads spawned. The view also shows which thread has hit a breakpoint with the status Paused on Breakpoint.



    The Call Stack view shows the function call stack being updated as emulation runs.

From this point you can do all the debug activities like Step In, Step Over, Step Out, or viewing variables, expressions, and memory locations in the software emulation enviornment. Refer to Using the Debug Environment for more information.