platforminfo 实用工具 - 2022.1 简体中文

Vitis 统一软件平台文档 应用加速开发 (UG1393)
Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 简体中文

platforminfo 命令行实用工具可用于以结构化格式来报告平台元数据，包括有关接口、时钟、有效的 SLR 和已分配的资源的信息以及有关存储器的信息。举例来说，在向 SLR 或存储器资源分配内核时，可参考此信息。

以下命令选项可搭配 platforminfo 一起使用：

表 1. platforminfo 命令
选项 描述
-f [ --force ] 覆盖现有输出文件。
-h [ --help ] 打印帮助消息并退出。
-k [ --keys ] 获取给定平台的密钥。返回 JSON 路径的列表。
-l [ --list ] 列出平台。搜索用户存储库路径 $PLATFORM_REPO_PATHS，然后搜索安装位置，以查找 .xpfm 文件。
-e [ --extended ] 列出含扩展信息的平台。搭配“--list”一起使用。
-d [ --hw ] <arg> 指定平台定义 (*.dsa)，用户基于此定义执行操作。该值必须为完整路径，包括文件名和 .dsa 扩展名。
-s [ --sw ] <arg> 指定软件平台定义 (*.spfm)，用户基于此定义执行操作。该值必须为完整路径，包括文件名和 .spfm 扩展名。
-p [ --platform ] <arg> 赛灵思平台定义 (*.xpfm)，用户在此平台上执行操作。--platform 的值可以是包含文件名和 .xpfm 扩展名的完整路径，如以下示例 1 所示。如果仅提供文件名和 .xpfm 扩展名但不提供路径，则此实用工具将仅搜索当前工作目录。您还可以仅指定平台的基本名称。如果提供的值为基本名称，那么该实用工具将搜索 $PLATFORM_REPO_PATHS 和安装位置，以查找对应的 .xpfm 文件，如以下示例 2 所示。
Example 1: --platform /opt/xilinx/platforms/xilinx_u50_gen3x16_xdma_201920_3.xpfm

Example 2: --platform xilinx_u200_gen3x16_xdma_2_202110_1
-o [ --output ] <arg> 指定结果要写入的输出文件。默认情况下，输出将返回至终端 (stdout)。
-j [ --json ] <arg> 指定生成的输出的 JSON 格式。如果使用时不提供值，那么 platforminfo 实用工具会以 JSON 格式打印整个平台。该选项还接受指定 JSON 路径的实参，此路径为 -k 选项返回的路径。此 JSON 路径如果有效，则用于提取 JSON 子树、列表或值。
Example 1: 
platforminfo --json="hardwarePlatform" --platform <platform base name>

Example 2: Specify the index when referring to an item in a list.
platforminfo --json="hardwarePlatform.devices[0].name" --platform <platform base name>

Example 3: When using the short option form (-j), the value must follow immediately.
platforminfo -j"hardwarePlatform.systemClocks[]" -p <platform base name>
-v [ --verbose ] 指定含更多详细信息的输出。默认行为是生成人类可读的报告，其中包含指定平台的最重要的特性。
注释： 除非使用 --help 或 --list 选项，否则必须指定平台。您可以使用 --platform 选项或者使用 --hw 或 --sw 来指定平台。您也可以直接在命令行中的具体位置插入平台名称或完整路径。

要了解生成的报告，请基于以下命令复查简明输出 log 日志。请注意，此报告拆分为多个特定部分以便于理解。

platforminfo -p $PLATFORM_REPO_PATHS/xilinx_u200_gen3x16_xdma_2_202110_1.xpfm
提示： 请参阅 xilinx_zcu104_base_202010_1 的平台信息 以获取嵌入式处理器平台的示例。