Tip: Set up the command shell or
window as described in Setting Up the Vitis Environment prior to
running the tools.
The following describes the steps required to run the debug flow in software emulation from the command line. Refer to Using the Vitis IDE for information on debugging in the IDE. Debugging in the Vitis core development kit uses the following steps:
- Compiling and linking the host code for debugging by adding the
-g
option to theg++
command line as described in Building the Host Program. - Compiling and linking the kernel code for debugging by adding the
-g
option to thev++
command line as described in Building the Device Binary.Note: When debugging OpenCL kernels, there are additional steps that you can take during compiling and linking as described in Debugging OpenCL Kernels. - Launching GDB to debug the application. There are currently two flows
supporting debug during software emulation:
- 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. - 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.
- Debugging PL or AI Engine kernels using the