emconfigutil 实用工具 - 2022.1 简体中文

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

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

在命令行流程中运行软件或硬件仿真时,需要创建仿真配置文件 emconfig.json 供运行时库在仿真期间使用。此仿真配置文件可定义要为指定平台进行仿真的器件的类型和数量。针对软件仿真和硬件仿真可使用同一个 emconfig.json 文件。

注释: 在真实硬件上运行时,运行时和驱动程序会查询已安装的硬件以判定安装的器件类型和数量以及器件特性。

要使用 emconfigutil 实用工具来自动创建仿真文件,请在 emconfigutil 命令行中指定目标平台和其它选项:

emconfigutil --platform <platform_name> [options]

至少必须通过 -f-–platform 选项来指定目标平台,以生成所需的 emconfig.json 文件。此处指定的平台必须与主机和硬件构建期间指定的平台相同。

下表中提供了 emconfigutil 选项。

表 1. emconfigutil 选项
选项 有效值 描述
-f--platform 目标器件 必需。用于定义来自指定平台的目标器件。

要获取受支持的器件列表,请参阅 受支持的平台

--nd 任何正整数值 可选。用于指定器件数量。默认值为 1。
--od 有效目录 可选。指定输出目录。运行仿真时,emconfig.json 文件必须与主机可执行文件位于相同目录中。默认操作将输出写入当前目录。
-s--save-temps 不适用 可选。指定执行此命令后不删除中间文件,而是将其保留。默认操作是移除临时文件。
--xp 有效的赛灵思参数和属性。 可选。指定其它参数和属性。例如:
--xp prop:solution.platform_repo_paths=<xsa_path>
此示例用于为目标平台设置搜索路径。
-h--help 不适用 打印命令帮助。
emconfigutil 命令会在输出目录或当前工作目录内生成 emconfig.json 配置文件。
提示: 运行仿真时,可通过 $EMCONFIG_PATH 变量来指定 emconfig.json 文件的位置,或者必须在主机可执行文件所在目录中找到此文件。

以下示例会创建以 2 个 xilinx_u200_qdma_201910_1 器件为目标的配置文件。

$emconfigutil --xilinx_u200_qdma_201910_1 --nd 2