从 Vitis IDE 进行硬件调试 - 2022.1 简体中文

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

Document ID
UG1076
Release Date
2022-05-25
Version
2022.1 简体中文
构建完顶层系统工程后,必须使用以下步骤在Hardware(硬件)构建目标中调试应用。
  1. <project>/Hardware/package/sd_card.img 烧写到物理 SD 卡上。这样即可为您的目标平台创建一个可启动的介质。
  2. 将此 SD 卡插入 VCK190 评估套件的读卡器。
  3. 将卡的启动模式设置更改为 SD 启动模式,然后给开发板上电。
  4. VCK190 启动后,在命令提示符处输入 mount 命令以获取装载点列表。如下图所示,mount 命令显示了系统的装载信息。
    提示: 根据 mount 命令结果,请务必捕获下一步中 cd 命令以及后续命令的适当路径。
  5. 执行下列命令:
    cd /run/media/mmcblk0p1
  6. 运行 ifconfig 以获取目标卡的 IP 地址。IP 地址用于在 Vitis IDE 中设置 TCF 代理连接。此目标需连接到网络分配的 IP 地址。
  7. 创建到远程加速器卡的目标连接。选择Window > Show view > Xilinx > Target connections(窗口 > 显示视图 > 赛灵思 > 目标连接)命令打开Target Connections视图。
  8. Target Connections视图上,右键单击Linux TCF Agent(Linux TCF 代理)并选择New Target(新建目标)命令打开New Target Connection(新建目标连接)对话框。
  9. 指定Target Name(目标名称)、启用Set as default target(设为默认目标)复选框,然后指定先前步骤中获取的加速器卡的Host(主机)IP 地址。

  10. 单击OK即可关闭此对话框并继续操作。
  11. 右键单击顶层系统工程,然后选择Debug As > Debug Configurations(调试方式 > 调试配置)命令。

    这样即可打开Debug Configurations对话框以供您设置工具。对于“Hardware”构建,您将需要创建两个launch(启动)配置:一种配置用于顶层系统工程,另一种配置则用于 PS 应用。

  12. Debug Configurations对话框中,选中New Launch Configuration(新建启动配置)() 命令以打开Debug Configurations对话框,如下所示。

    请务必在对话框中设置以下字段,如前图所示。

    • Remote Working Directory(远程工作目录):指定来自先前步骤中确定的加速器卡的远程装载位置。
    • Linux TCF Agent(Linux TCF 代理):选择您使用指定 IP 地址为加速器卡构建的新代理。
    • Disable build before launch(禁用启动前构建):需要该选项的原因是因为,如果不使用该选项,工具将尝试在运行应用前构建系统。
  13. 选择Apply(应用)以应用更改,然后选择Debug(调试)以启动此进程。

    这样即可在 Vitis IDE 中打开Debug透视图,并连接至 QEMU 中其各自的核上运行的 PS 应用和 AI 引擎 graph。此应用会在所有 ELF 文件的 main() 函数处自动中断。

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