createdts - 2025.2 简体中文 - UG1400

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

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

创建设备树。

表 1. createdts - 创建设备树
XSCT 方法 实参 对应 Python API 实参 注释
createdts

-platform-name <software-platform name>

表示要生成的软件平台的名称。

-board <board name>

要生成的设备树的开发板名称。开发板名称可从如下位置获取:<DTG Repo>/device_tree/data/kernel_dtsi。

-hw <handoff-file>

表示用于创建设备树的硬件描述文件。

-out <output-directory>

表示需在其中创建软件平台的目录。如果不指定该选项,则以默认目录作为工作空间。

-local-repo <directory location>

此处指定的目录位置中包含 Git 仓库的 bsp。如果不指定该选项,则从 Git 克隆设备树仓库。

-git-url <Git URL>

要克隆的 dtg repo 的 Git URL。如需获取默认仓库,请单击此处

client.create_platform() 必需实参:

name = <platform_name> 平台名称。

hw = <handoff_file> 表示用于创建平台的硬件描述文件。

emulation_xsa_path = <xsa_path> 指向仿真 XSA 文件的路径,该组件是在此文件中创建的。

platform_xpfm_path =<xpfm_path> 现有平台的 Xpfm 路径。

可选实参:

desc = <description> 平台的描述。

os = <os> 该操作系统用于创建默认域。

cpu = <processor> 该处理器将用于创建默认域。

domain_name = <domain_name> 将在平台中创建的域的名称。

创建平台时会创建 DTS 和平台工程。
createdts(续)

-git-branch <Git Branch>

要检出的 Git 分支。默认选中 'xlnx_rel_v<Vitis-release>'。

-zocl 设置 zocl 标志以启用 zocl 驱动程序支持,默认设置为 False。仅当设计启用 PL 时,才应使用 zocl。仅限 master 和 xlnx_rel_v2021.2 分支才支持 zocl 属性。

-overlay 设置 overlay 标志以启用设备树覆层支持,默认设置为 False。

-dtsi <custom-dtsi-file list>

在设备树中包含 custom-dtsi 文件(如已指定)。文件路径必须采用列表格式。

-compile 指定该选项即可编译已生成的 dts 以创建 dtb。如果不指定该选项,则您可以手动使用 dts 来编译 dtb。

例如,dtc -I dts -O dtb -o <file_name>.dtb <file_name>.dts

编译 dts(设备树源文件)或 dtsi(设备树源文件 include)文件。

dtc -I dts -O dtb -f <file_name>.dts -o <file_name>.dtb

将 dts(设备树源文件)转换为 dtb(设备树二进制对象)。

dtc -I dtb -O dts -f <file_name>.dtb -o <file_name>.dts

将 DTB(设备树二进制对象)转换为 DTS(设备树源文件)。

-update 设置 update 标志,启用现有设备树平台随新 xsa 一起更新的功能。

client.create_platform()(续)

template = <template_name>

对于裸机平台,此模板用于创建域。默认值为 "Empty"

no_boot_bsp = <bool> 将平台标记为构建时不生成启动组件。

fsbl_target = <fsbl_target> 对于此处指定的处理器类型,必须为其生成现有 FSBL。

该选项仅适用于 ZU+。默认值为 "psu_cortexa53_0"

fsbl_path = <path>

定制 FSBL 的 FSBL 路径。选中 no_boot_bsp 时,会使用该选项。

pmufw_Elf = <path>

预构建的 fsbl.elf,将用作为启动组件。选中 no_boot_bsp 时,会使用该选项。