platform create - 2025.2 简体中文 - UG1725

软件调试器 参考指南 (UG1725)

Document ID
UG1725
Release Date
2025-11-20
Version
2025.2 简体中文

创建新平台。

语法

platform create [options]

通过导入硬件定义文件来创建新平台。也可以使用预定义的硬件平台来创建平台。受支持的预定义平台为 zc702、zcu102、zc706 和 zed。

选项

选项 描述
-name <software-platform name> 表示要生成的软件平台的名称。
-desc <description> 表示有关软件平台的简要描述。
-hw <handoff-file> 表示用于创建平台的硬件描述文件。
-out <output-directory> 表示需在其中创建软件平台的目录。如已设置工作空间,则不应使用该选项。使用该选项会阻止在 Vitis IDE 中使用此平台。
-prebuilt 将此平台标记为根据已构建的软件工件来构建的平台。仅当已有现有软件平台工件时,才应使用该选项。
-proc <processor> 表示要使用的处理器;该工具会创建默认域。
-arch <processor architecture> 32 位或 64 位,该选项仅对 A53 处理器有效。
-samples <samples-directory> <samples-directory> 中的样本包含在此平台内。
-os <os> 表示要使用的操作系统。该工具会创建默认域。该选项可搭配 -proc 选项一起使用。
-xpfm <platform-path> 对应一个现有平台,必须将工程从该平台导入到当前平台中。
-no-boot-bsp 将平台标记为构建时不生成启动组件。
-arch <arch-type> 处理器架构,<arch-type> 可为 32 位或 64 位。该选项用于构建含 32/64 位工具链的工程。
-rp <slot-info> DFX 流程的可重配置分区时隙信息。该选项取 Tcl 词典并搭配键值对。多个时隙可作为单个阵列来传递。

返回

如果平台创建成功,则返回空字符串。如果无法创建平台,则返回错误字符串。

示例

platform create -name "zcu102_test" -hw zcu102

为预定义的硬件描述文件定义软件平台。

platform create -name "zcu102_test" -hw zcu102 -proc psu_cortexa53_0 -os standalone

为预定义的硬件描述文件定义软件平台。创建默认域,其中包含在 psu_Cortexa53_0 上运行的独立操作系统。

platform create -name "zcu102_32bit" -hw zcu102 -proc psu_cortexa53_0 -arch 32-bit -os standalone

为预定义的硬件描述文件定义软件平台。创建默认域,其中包含在 psu_Cortexa53_0 上以 32 位模式运行的独立操作系统。

platform create -name "zcu102_test" -hw zcu102 -proc psu_cortexa53 -os linux -arch 32-bit 

为预定义的硬件描述文件定义软件平台。创建默认域,其中包含在 psu_Cortexa53 上以 32 位运行的 Linux 操作系统。

platform create -xpfm /path/zc702.xpfm

这样会为 XPFM 文件所指向的平台创建平台工程。

platform create -name "ZC702Test" -hw /path/zc702.xsa

为硬件描述文件定义软件平台。

platform create -name "testplat" -hw static.xsa -rp { id 1 hw ./hw.xsa hw_emu ./hw_emu.xsa }

这样会创建含单时隙 DFX 的平台工程。您必须指定指向 hw XSA 和 hw_emu XSA 的路径。

platform create -name :testplat: -hw static.xsa -rp { { id 1 hw ./rp_1.xsa hw_emu ./hw_emu.xsa } { id 2 hw ./rp_2.xsa hw_emu ./hw_emu.xsa } }

这样会创建含多时隙 DFX 的平台工程。第一个时隙是默认可重配置分区。对于多时隙平台,会有多个硬件 XSA,并且每个时隙都有一个 slot_id,此外还可能包含多个 hw_emu XSA 或单个 XSA。