在硬件上运行系统 - 2023.2 简体中文

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

Document ID
UG1393
Release Date
2023-12-13
Version
2023.2 简体中文

系统运行取决于构建目标。在物理硬件上运行的进程不同于运行软件或硬件仿真。如需了解有关运行仿真的更多信息,请参阅 运行仿真目标

运行系统工程硬件构建允许您查看嵌入式处理器平台上运行的应用,此类平台目标一般为 AMD Versal™ 自适应 SoC 器件、AMD Zynq™ UltraScale+™ MPSoC 器件或者加速器卡(如 AMD Alveo™ 数据中心加速器卡)。此处捕获的性能数据和结果均为加速应用的实际性能。但此运行生成的剖析数据可能仍表示有机会进一步最优化设计。

提示: 要使用加速器卡,必须按 Alveo 数据中心加速器卡入门指南(UG1301) 中所述方式完成卡安装。
  1. xrt.ini 文件 中所述,编辑 xrt.ini 文件。

    这是可选操作,但在硬件上运行以进行仿真时建议执行此操作。您可通过 xrt.ini 文件来配置 XRT 以在应用运行时捕获调试和剖析数据。要在运行硬件时捕获事件追踪数据,请参阅 在应用中启用剖析。要调试运行硬件,请参阅 硬件执行期间的调试

    提示: 编译内核代码以进行调试时,请务必使用v++ -g选项。
  2. 取消设置 XCL_EMULATION_MODE 环境变量。
    重要: 如果 XCL_EMULATION_MODE 环境变量设置为仿真目标,那么硬件构建将无法运行。
  3. 对于嵌入式平台,请启动 SD 卡。
    提示: 仅限使用 AMD 嵌入式器件(如,Versal 自适应 SoC 或 Zynq UltraScale+ MPSoC)的平台才需要此步骤。

    对于嵌入式处理器平台,请将 v++ --package 命令生成的 ./sd_card 文件夹内容复制到 SD 卡,作为系统的启动器件。从 SD 卡启动系统。您需要登录 PetaLinux 才能从 SD 卡运行应用,步骤如下:

    1. 使用用户名 petalinux 登录,如果是首次登录,请为此用户设置密码。此密码也将作为 sudo 密码。
    2. 切换至 sudo 用户,以便从 SD 卡运行主机应用:sudo -i
    3. 切换至 SD 卡所在目录:cd /run/media/mmcblk0p1
    4. 按上一步中所述运行应用。
  4. 运行应用。

    用于运行应用的具体命令行取决于您的主机代码。以下提供了 AMD 教程中使用的常用实现及示例:

    ./host.exe kernel.xclbin
提示: 此命令行假定主机程序编写时采用 xclbin 文件的名称作为实参,就像大部分 AMD Vitis™ 示例和教程一样。但您的应用可能已将 xclbin 文件的名称硬编码到主机程序中,或者可能要求采用其他方法来运行此应用。

运行设计时,可按 在应用中启用剖析 中所述指定多个追踪选项以便在运行时期间捕获设计数据。运行期间生成的任意报告都会收集到 xrt.run_summary 文件中。此报告集合可通过在 Vitis 分析器中打开 run_summary 来查看,其中包含汇总报告、用于演示硬件设计的系统和平台框图、提供系统性能改进建议的运行指南以及运行时期间在 xrt.ini 文件中启用的“剖析汇总”和“时间线轨迹”。如需了解更多信息,请参阅 使用“Analysis”视图 (Vitis Analyzer)