platform - 2025.2 简体中文 - UG1400

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

Document ID
UG1400
Release Date
2025-11-20
Version
2025.2 简体中文
创建、配置、列出和报告平台。
表 1. platform - 创建、配置、列出和报告平台
XSCT 方法 实参 对应 Python API 实参 注释
active platform-name client.get_platform_component

必需实参:name = <platform_name> 平台名称。

Get 命令会返回可用于运行平台命令的平台对象。
clean   platform.clean    
config

-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

为平台生成启动组件。

  1. update_desc
  2. update_hw
  3. 不支持
  4. 不支持
  5. 不支持
  6. retarget_fsbl
  7. generate_boot_bsp
  8. remove_boot_bsp

    (对于 9 和 10,remove_boot_bsp 使用 fsbl_elf 和 pmufw_elf 选项)

必需实参:

desc = <description> 平台的描述

必需实参

hw = <hw_spec> 或 emulation_xsa_path = <xsa_path> 硬件规格文件或仿真 XSA 路径。

可选实参

target_processor = <target> 对于此处指定的处理器,必须为其重新生成现有 FSBL。

 
config(续)

-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 作为参数。

 

可选实参

target_processor = <processor> 用于生成启动 bsp 的目标处理器。默认值为 zynqmp_fsbl

可选实参

fsbl_path = <path> 预构建的 fsbl.elf,移除启动组件时,此文件将用作为启动组件。

pmufw_elf = <pmufw.elf> 预构建的 pmufw.elf,移除启动组件时,此文件将用作为启动组件。

 
list   client.list_platforms    
report   platform.report    
remove   platform-name    
read   在 Python CLI 中不受支持    
write   在 Python CLI 中不受支持