Launching Debug from the Command Line - 2021.2 English

Versal ACAP AI Engine Programming Environment User Guide (UG1076)

Document ID
UG1076
ft:locale
English (United States)
Release Date
2021-12-17
Version
2021.2 English

Debugging projects built from the command line is a special challenge because the various elements of the system, the compiled graph application (libadf.a), the device binary (XCLBIN), and the top-level application (host.cpp), must be gathered together and presented as a system. In the Vitis IDE this is done through the system-level project that is created when you first created the graph project. In the command line flow, this service is provided by the Vitis compiler package process. As described in Packaging, the v++ --package command gathers the elements of the system together to create a boot container for either hardware emulation or hardware builds.

In addition, you must separately manage the different elements of the debug environment, running the QEMU emulation environment, or running the xrt_server for connecting to the hardware, and launching the Vitis IDE to run the debug process. The steps and requirements for command line debug are detailed in the following topics.