在数据中心加速器卡上运行仿真

在数据中心加速器卡上运行仿真 - 2023.2 简体中文

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

Document ID

UG1393

Release Date

2023-12-13

Version

2023.2 简体中文

提示：运行构建前，请按设置 Vitis 环境中所述设置命令 shell 或窗口。

在 xrt.ini 文件中设置期望的运行时设置。这是可选步骤。
如 xrt.ini 文件中所述，运行主机应用和内核执行时，此文件可指定各种参数用于控制 XRT 中的调试、剖析和消息日志记录。这样即可支持运行时在运行应用时捕获调试和剖析数据。xrt.ini 中的 Emulation 组可以提供影响仿真运行的功能特性。

提示：为仿真 (emulation) 模式编译内核代码时，请务必使用 v++ -g 选项。
从目标平台创建 emconfig.json 文件，如 emconfigutil 实用工具中所述。此步骤对于运行硬件或软件仿真而言是必需的。
仿真配置文件 emconfig.json 是使用 emconfigutil 命令从指定平台生成的，可提供信息以供 XRT 库在仿真期间使用。以下示例为指定目标平台创建了 emconfig.json 文件：
```
emconfigutil --platform xilinx_u200_xdma_201830_2
```
在仿真 (emulation) 模式下，运行时会在 $EMCONFIG_PATH 变量指定的位置或者在主机可执行文件所在的目录中查找 emconfig.json 文件。
提示：您必须拥有最新 JSON 文件才能在自己的目标平台上运行仿真。
将 XCL_EMULATION_MODE 环境变量设置为相应的 sw_emu（软件仿真）或 hw_emu（硬件仿真）。这样即可将应用执行模式更改为仿真模式。
以下语法可用于为 C shell (csh) 设置环境变量：
```
setenv XCL_EMULATION_MODE sw_emu
```
Bash shell：
```
export  XCL_EMULATION_MODE=sw_emu
```
重要：如不正确设置 XCL_EMULATION_MODE 环境变量，仿真目标将不会运行。
运行应用。
设置好运行时初始化文件 (xrt.ini)、仿真配置文件 (emconfig.json) 和 XCL_EMULATION_MODE 环境变量后，请使用所需的命令行实参来运行主机可执行文件。

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