XSDB 流程 - 2022.1 简体中文

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

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

XSDB 流程如下所示:

  1. 如下步骤中所述,设置 xsdb 以连接到器件硬件。

    运行应用时,调试和剖析 IP 会将追踪数据存储在 DDR 存储器内。要捕获此数据并对其进行求值,必须使用 xsdb 连接到硬件器件。此命令通常用于执行器件编程和调试裸机应用。通过 JTAG 将您的系统连接到硬件平台或器件、在命令 shell 中启动 xsdb 命令,然后运行以下命令序列:

    xsdb% connect
    xsdb% ta
    xsdb% ta 1
    xsdb% source $::env(XILINX_VITIS)/scripts/vitis/util/aie_trace.tcl​
    xsdb% aietrace start -graphs mygraph -config-level functions_all_stalls -work-dir ./Work -link-summary $PROJECT/xsa.link_summary -base-address 0x900000000 -depth 0x800000 
    
    # Execute the PS host application (.elf) on Linux
    ## After the application completes processing.
    xsdb% aietrace stop

    其中:

    connect
    启动 hw_server 并将 xsdb 连接到器件。
    source $::env(XILINX_VITIS)/scripts/vitis/util/aie_trace.tcl
    使用 source 命令运行 Tcl trace 命令以设置 xsdb 环境。
    aietrace start -graphs mygraph PROJECT/xsa.link_summary -config-level functions_all_stalls -base-address 0x900000000 -depth 0x800000
    初始化 DPA IP,开始捕获追踪数据。-graphs 会指定一个或多个 graph 以收集事件追踪数据。如果倾向于处理特定拼块,请指定 -tiles 和拼块列表,以收集追踪数据。-config-level 用于指定要捕获的事件追踪级别的 functionsfunctions_partial_stallsfunctions_all_stalls。值 -base-address 0x900000000 -depth 0x800000 用于指定将追踪数据写入 AI 引擎的起始地址和要存储的数据量。
    重要: -base-address 0x900000000 中使用的 DDR 存储器地址必须为高位地址,以限制 xilinx_vck190_base_202210_1 平台上的操作系统或应用发生存储器冲突的几率。对于定制平台,请确保您已知当前使用的 DDR 存储器量并制定相应计划。
    aietrace stop
    指令 DPA IP 从 DDR 存储器卸载追踪事件数据。此命令必须等待至应用完成后才有效。数据写入当前工作目录中的 event_trace<N>.txt 文件,xsdb 同样是在此目录中启动的。此外还会创建 aie_trace_profile.run_summary 文件。在 Vitis 分析器中可打开此文件,如 在 Vitis 分析器中查看运行汇总 中所述。
    提示: 如果再次运行 graph 时不移除 event_trace<N>.txt,那么旧文件将被新的运行结果覆盖。
  2. 在硬件上运行设计以追踪硬件事件。
  3. 卸载捕获的追踪数据。
  4. 启动 Vitis 分析器以使用此命令导入和分析数据。
    vitis_analyzer aie_trace_profile.run_summary