platform config - 2023.2 简体中文

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

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

配置活动平台。

语法

platform config [options]

配置活动平台的属性。

选项

选项 描述
-desc <description> 添加有关平台的简要描述。
-updatehw <hw-spec> 更新平台以使用由 <hw-spec> 指定的新硬件规格文件。
-samples <samples-dir> <samples-dir> 中指定的应用模板包含到平台中。该选项仅适用于可加速的应用。“repo -apps <platform-name>”可用于列出可供给定平台名称使用的应用模板。
-prebuilt-data <directory-name> 对于可扩展平台,目录名称中指定的预生成硬件数据将用于构建不包含加速器的用户应用。这将缩短构建时间。
-make-local 将引用的软件组件转变为平台的本地组件。
-fsbl-target <processor-type> 必须重新生成的现有 FSBL 的预处理器类型。该选项仅适用于 ZU+。
-create-boot-bsp 为平台生成启动组件。
-remove-boot-bsp 移除平台创建期间生成的所有启动组件。
-fsbl-elf <fsbl.elf> 预构建的 fsbl.elf,不指定“remove-boot-bsp”选项时,该组件将用作为启动组件。
-pmufw-elf <pmufw.elf> 预构建的 pmufw.elf,不指定“remove-boot-bsp”选项时,该组件将用作为启动组件。
-extra-compiler-flags <param> <value> 以提供的值为参数设置额外的编译器标志。仅支持使用 FSBL 和 PMUFW 作为参数。如果值未能通过,则将返回现有值。
-extra-linker-flags <param> <value> 以提供的值为参数设置额外的连接器标志。仅支持使用 FSBL 和 PMUFW 作为参数。如果值未能通过,则将返回现有值。
-reset-user-defined-flags <param> 将额外的编译器和连接器标志复位。仅支持使用 FSBL 和 PMUFW 作为参数。
-report <param> 返回设置到给定参数的额外编译器和连接器标志的列表。仅支持使用 FSBL 和 PMUFW 作为参数。

返回

如果平台配置成功,则返回空字符串。如果没有任何平台处于活动状态或者如果无法配置平台,则返回错误字符串。

示例

platform active zc702
platform config -desc "ZC702 with memory test application"
-samples /home/user/newDir

将 zc702 设为活动平台、配置平台描述,并将 /home/user/newDir 中的样本包含到平台中。

platform config -updatehw /home/user/newdesign.xsa

使用新的 XSA 更新平台工程。

platform config -fsbl-target psu_cortexr5_0

将 FSBL 目标更改为 psu_cortexr5_0。

platform config -extra-compiler-flags fsbl

获取额外的编译器标志。这些标志是除已添加的标志(衍生自库、处理器和操作系统)外,另行添加的标志。

platform config -extra-compiler-flags fsbl "-DFSBL_DEBUG_INFO [platform config
-extra-compiler-flags fsbl]"

构建 FSBL 应用时,在编译器选项之前添加 -DFSBL_DEBUG_INFO。

platform config -report fsbl

返回为 FSBL 设置的额外编译器和额外连接器标志的表格。

Platform config -create-boot-bsp

为平台创建启动组件。

Platform config -create-boot-bsp -arch 32-bit

为平台创建启动组件,创建 32 位 FSBL。此项仅适用于基于 Zynq UltraScale+ MPSoC 的平台。

Platform config -remove-boot-bsp

移除平台创建期间生成的所有启动组件。