Xilinx Runtime 库 GDB 扩展 - 2022.1 简体中文

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

Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 简体中文
Vitis 调试器 (xgdb) 支持全新的 GDB 命令,这些命令可便于您从主机应用查看 XRT 库。
注释: 如果您在 Vitis 调试器外部启动 GDB,则需使用 appdebug.py 脚本启用命令扩展,如 启动主机和内核调试 中所述。

有两种命令可从 gdb 命令行调用:

  1. xprint 命令支持查看 XRT 库数据结构(cl_command_queuecl_eventcl_mem)。这些命令解释如下。
  2. xstatus 命令支持在硬件执行期间进行调试时查看 Vitis 目标平台上运行的 IP。

您可通过在 gdb 命令提示符中使用 help <command> 来获取有关 xprint 命令和 xstatus 命令的更多信息。

典型应用场景是当您发现主机应用挂起时,即可使用这些命令。在此情况下,主机应用可能正在等待命令队列完成,或者正在等待事件列表。使用 xprint queue 命令打印命令队列即可告知您有哪些事件尚未完成,以便您分析事件之间的依赖关系。

使用 Vitis IDE 进行调试时,会自动追踪这两种命令的输出。在这种情况下,调试透视图左上角的变量、断点和寄存器的常用选项卡旁边还提供了三个选项卡。这些选项卡标记为“Command Queue”(命令队列)、“Memory Buffers”(存储缓冲器)和“Platform Debug”(平台调试),分别显示 xprint queuexprint mem 以及 xstatus 的输出。