Command Line Debug Flow for Software Emulation - 2023.2 English

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

Document ID
Release Date
2023.2 English
Important: You should import your command-line project into the Vitis unified IDE as described in Working with User-Managed Flows, and debug it as described in Debugging the System Project and AI Engine Components.

The following describes the steps required to run the debug flow for software emulation from the command line:

  1. Set up the command shell or window as described in Setting Up the Vitis Environment prior to running the tools.
  2. Compile and Link the host code and System project for debugging by adding the -g option to the g++ command line as described in Building and Running the System.
  3. Launch GDB to debug the application. There are currently two flows supporting debug during software emulation:
    1. Debugging PL or AI Engine kernels using the kernel-dbg option as explained in Software Emulation Debug for Embedded Processors, or Software Emulation Debug for Alveo Accelerators. This is a simple flow, but only enables debugging of the kernels in the .xclbin, and not the host application.
    2. Debugging the host application and PL kernels using three command terminals and xrt_server as described in Launching Host and Kernel Debug. This is a more complex flow, but supports concurrent debug of both the host and kernels.