Vitis IDE 调试流程 - 2022.1 简体中文

Vitis 统一软件平台文档 应用加速开发 (UG1393)

Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 简体中文

Vitis™ IDE 支持轻松访问调试功能。手动执行时,设置用于调试的可执行文件需经历多个步骤。使用调试流程时,这些步骤由 Vitis IDE 自动处理。

注释: Vitis IDE 中的调试流程在调试期间依赖于 shell 脚本。这就要求设置文件(例如,.bashrc.cshrc)不干预环境设置,例如,LD_LIBRARY_PATH

为了准备用于调试的可执行文件,您必须更改构建配置以启用Host debug(主机调试)和Kernel debug(内核调试)。请在 Vitis IDE 的Project Editor(工程编辑器)视图中设置这些选项,如下图所示。在“Active build configuration”(活动的构建配置)下的Options(选项)部分中提供了两个复选框:

  • “Host debug”(主机调试)支持在主机编译中调试构造,可用于所有构建类型。
  • “Kernel debug”(内核调试)则可启用内核调试,但仅在软件和硬件仿真构建中可用。要在硬件构建中启用调试,请使用Chipscope Debug(Chipscope 调试)设置,如 Vitis 硬件函数设置 中所述。

这些复选框可在 g++Vitis 编译器中启用 -g--debug 选项。

图 1. 工程编辑器视图的调试选项

也可以从Build Configuration Settings(构建配置设置)对话框启用调试功能,方法是选中Assistant(助手)视图中的构建配置并单击Settings(设置)按钮,如 Vitis 构建配置设置 中所示。或者,您可双击构建配置。这样同样可以显示以上两个复选框。尽管您可以在所有目标上启用主机调试,但只有软件仿真和硬件仿真构建目标才支持内核调试。

Vitis IDE 运行 GDB 会话即可处理所有必要的设置。它会自动为软件仿真管理环境设置。它通过配置 XRT 来确保运行应用时支持调试(如 xrt.ini 文件 中所述),并可管理执行主机代码、内核代码和调试服务器所需的不同控制台。

在嵌入式平台上运行时,Vitis IDE 还会配置并启动 QEMU 系统模式、用于 PL 内核的逻辑仿真器,并管理其同步。如需了解更多信息,请参阅 launch_emulator 实用工具

设置用于调试的构建配置后,请清除构建目录,并重构应用以确保工程准备好在 GDB 调试环境下运行。

要启动调试会话,请在“Assistant”视图中选中构建配置,然后单击Debug(调试)()。在 Vitis IDE 中启动调试会话时,透视图会切换至Debug透视图,后者配置为显示另一个窗口,用于管理不同的调试视图和源代码窗口。下图显示了Debug透视图。

图 2. 调试透视图

启动调试环境后,默认情况下,在主机代码中 main 函数体开始时,应用会停止。正同任何 GDB 图形前端一样,此时您可以设置断点并检查主机代码中的变量。Vitis IDE 会以用户不可知方式为已加速的内核实现启用相同的功能。如需了解更多信息,请参阅 调试应用与内核