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

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

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 简体中文
构建完顶层系统工程后,您可使用以下步骤在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 Unified IDE 中设置 TCF 代理连接。此目标需连接到网络分配的 IP 地址。
  7. 在此 IDE 中,请选择或创建到远程加速器卡的目标连接,如下所示:
    1. 从主菜单中选中Vitis > Target Connections(Vitis > 目标连接)命令以打开Target Connections(目标连接)对话框。
    2. 选中现有 Linux TCF Agent 连接或者右键单击Linux TCF Agent(Linux TCF 代理),然后选中New Target(新建目标)命令打开New Target Connection(新建目标连接)对话框,如下图所示。

    3. 指定Target Name(目标名称)、启用Set as default target(设为默认目标)对话框,并指定您从 ifconfig 命令获取的加速器卡的Host(主机)IP 地址。
    4. 单击OK即可关闭此对话框并继续操作。
  8. Flow Navigator中,选中Debug(调试)命令旁的Open Settings(打开设置)命令,或者从 Vitis Components Explorer(Vitis 组件资源管理器)中的“System”(系统)工程打开 launch.json。确认“Hardware”(硬件)构建的启动配置,或者选中Add Configuration(添加配置)(+) 命令创建新配置,如下图所示:

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

    • Target Connection(目标连接):选择您使用指定 IP 地址为加速器卡构建的新 Linux TCF 代理
    • Host Executable(主机可执行文件):指定要从 SD 卡运行的 PS 应用
    • Cmd Line Args(命令行实参):指定软件应用所需的任意命令行实参,例如,要加载的 XCLBIN 文件
    • Work Directory(工作目录):指定 SD 卡的远程装载位置
    • Stop At Main(在 main 处停止)和Stop At Program Entry(在程序入口处停止):用于在启动调试进程前停止运行应用和 AI 引擎
  9. 单击Flow NavigatorHARDWARE标题下的Debug
    提示: 该工具将提示您,如果尚未创建启动配置,请创建 2 个启动配置。其中一个用于顶层系统工程,另一个用于 PS 应用。

    这样即可打开Debug视图(如 “Debug”视图 中所示)并连接到 PS 应用及其相应的核上运行的 AI 引擎计算图。此应用会在所有 ELF 文件的 main() 函数处自动中断。

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