从 Vitis IDE 进行裸机调试 - 2022.1 简体中文

Versal ACAP AI 引擎编程环境 用户指南 (UG1076)

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

在 Vitis IDE 中构建裸机 AI 引擎 中所述完成裸机系统工程构建后,您必须使用以下步骤来调试 AI 引擎 graph 和Hardware(硬件)构建目标上的裸机 PS 应用。

此进程比在 Vitis IDE 中调试 Linux 应用略复杂。后者中 PS 主机应用是作为顶层系统工程的一部分来完成构建的。此处的 PS 应用则是作为独立工程来构建的,并且必须在启动调试环境时单独包含在调试配置内。欲知详情,请参阅下列步骤。

  1. 右键单击顶层系统工程,然后选择Debug As > Debug Configurations(调试方式 > 调试配置)命令。

    这样即可打开Debug Configurations对话框以供您设置工具。

    重要: 对于“Hardware”构建,您将需要创建两个Debug(调试)配置:一种配置用于顶层系统工程,另一种配置则用于裸机 PS 应用。
  2. Debug Configurations对话框中,选中New Launch Configuration(新建启动配置)() 命令以打开Debug Configurations对话框,如下所示。

    请注意Debug Configurations对话框上的下列字段:

    • Project(工程):反映顶层系统工程的名称,其中包括 AI 引擎 graph 应用、PL 内核以及 HW-Link(硬件链接)工程。
    • Hardware Server(硬件服务器):指定到开发板的本地连接。对于远程连接的开发板,可指定不同配置。
    • Linux TCF Agent(Linux TCF 代理):对于裸机系统禁用此项。
    • Disable build before launch(禁用启动前构建):启用此项可以防止该工具在启动应用前构建系统。
  3. 选中Apply(应用)以保存并应用您的更改,选中Close(关闭)即可关闭对话框。
  4. 右键单击Explorer(资源管理器)视图中的baremetal_app工程,然后选中Debug As > Debug Configurations,如下所示。

  5. 这样会打开Single Application Debug Configurations(单应用调试配置)对话框,如下图所示。

  6. 指定Name(名称)以识别要应用到 PS 应用的配置。对于本地硬件,Connection(连接)会自动完成设置。
  7. 切换为选中Debug Configurations对话框的Target Setup(目标设置)选项卡,取消选中对话框中的Reset entire system(复位整个系统)和Program Device(器件编程)复选框。
  8. 单击Apply(应用)以继续。
  9. 您还需要创建启动组,其中包含您刚创建的两种调试配置。启动组允许您将多种配置作为一个分组一起启动。使用主工具栏菜单,选中Debug > Debug Configurations以打开Debug Configurations对话框,然后选中Launch Group(启动组),如下所示。
    重要: 您必须使用主工具栏菜单Debug命令,因为它提供了完整的Debug Configuration选项集合,而不只是ExplorerAssistant视图中的精简选项,您的选择会限制后两个视图中的选项。


    单击Launch Group,然后为新的组提供Name。单击Add以将顶层工程和 PS 应用调试配置添加到前图中所示的分组中。单击OK(确定)以创建启动组。

  10. 对于添加的两个调试配置,都会显示Launch Group(启动组)。单击Debug以启动Debug透视图。
  11. 由于您当前正在单一目标连接上同时启动顶层工程和 PS 调试配置,因此 Vitis IDE 将显示Launch Config Conflict(启动配置冲突)消息。在冲突消息上单击No(否)以继续。
  12. 这样会打开Debug透视图,如下图所示。由于存在两个调试配置,您将看到两个 PS 应用实例。您可以忽略 PS 应用的第二个实例。

此时,您即可在仿真环境中执行下列所有调试活动:单步进入、单步跳过、查看变量或应用断点。如需了解更多信息,请参阅 使用调试环境