按 在 Vitis IDE 中构建裸机 AI 引擎 中所述完成裸机系统工程构建后,您必须使用以下步骤来调试 AI 引擎 graph 和Hardware(硬件)构建目标上的裸机 PS 应用。
此进程比在 Vitis IDE 中调试 Linux 应用略复杂。后者中 PS 主机应用是作为顶层系统工程的一部分来完成构建的。此处的 PS 应用则是作为独立工程来构建的,并且必须在启动调试环境时单独包含在调试配置内。欲知详情,请参阅下列步骤。
- 右键单击顶层系统工程,然后选择
这样即可打开Debug Configurations对话框以供您设置工具。
重要: 对于“Hardware”构建,您将需要创建两个Debug(调试)配置:一种配置用于顶层系统工程,另一种配置则用于裸机 PS 应用。
(调试方式 > 调试配置)命令。 - 在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(禁用启动前构建):启用此项可以防止该工具在启动应用前构建系统。
- 选中Apply(应用)以保存并应用您的更改,选中Close(关闭)即可关闭对话框。
- 右键单击Explorer(资源管理器)视图中的baremetal_app工程,然后选中 ,如下所示。
- 这样会打开Single Application Debug Configurations(单应用调试配置)对话框,如下图所示。
- 指定Name(名称)以识别要应用到 PS 应用的配置。对于本地硬件,Connection(连接)会自动完成设置。
- 切换为选中Debug Configurations对话框的Target Setup(目标设置)选项卡,取消选中对话框中的Reset entire system(复位整个系统)和Program Device(器件编程)复选框。
- 单击Apply(应用)以继续。
- 您还需要创建启动组,其中包含您刚创建的两种调试配置。启动组允许您将多种配置作为一个分组一起启动。使用主工具栏菜单,选中Debug Configurations对话框,然后选中Launch Group(启动组),如下所示。 重要: 您必须使用主工具栏菜单Debug命令,因为它提供了完整的Debug Configuration选项集合,而不只是Explorer或Assistant视图中的精简选项,您的选择会限制后两个视图中的选项。
单击Launch Group,然后为新的组提供Name。单击Add以将顶层工程和 PS 应用调试配置添加到前图中所示的分组中。单击OK(确定)以创建启动组。
以打开 - 对于添加的两个调试配置,都会显示Launch Group(启动组)。单击Debug以启动Debug透视图。
- 由于您当前正在单一目标连接上同时启动顶层工程和 PS 调试配置,因此 Vitis IDE 将显示Launch Config Conflict(启动配置冲突)消息。在冲突消息上单击No(否)以继续。
- 这样会打开Debug透视图,如下图所示。由于存在两个调试配置,您将看到两个 PS 应用实例。您可以忽略 PS 应用的第二个实例。
此时,您即可在仿真环境中执行下列所有调试活动:单步进入、单步跳过、查看变量或应用断点。如需了解更多信息,请参阅 使用调试环境。