创建设备树。
语法
createdts [options]为硬件定义文件创建设备树。
选项
| 选项 | 描述 |
|---|---|
-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 repo 的 bsp 的目录所在位置。如果不指定该选项，则将从 git 克隆设备树仓库。 |
-git-url <Git URL>
|
要克隆的 dtg repo 的 Git URL。默认仓库为 https://github.com/Xilinx/device-tree-xlnx.git。 |
-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 一起更新的功能。 |
注释
- 此命令是用于创建设备树域和生成设备树的快捷方式。它会克隆设备树仓库、以 device_tree 作为操作系统来创建平台，配置并生成此平台以创建 dts。仅当设计启用 PL 时才应使用 -zocl。仅限 master 和 xlnx_rel_v2021.2 分支才支持 zocl 属性。需 Git 1.5.4 或更高版本以避免 createdts 命令所使用的 GIT 命令出现任何问题。
返回
无。
示例
createdts -hw zcu102.xsa -platform-name my_devicetree为交接文件创建设备树，默认仓库为“https://github.com/Xilinx/device-tree-xlnx.git”，默认分支为“xlnx_rel_v<Vitis-release>”。
createdts -hw zcu102.xsa -platform-name my_devicetree -git-url <Git URL>
-git-branch <Git Branch>为交接文件创建设备树，用户仓库采用 <Git URL> 中提及的仓库，用户分支为 <Git Branch>。
createdts -hw zc702.xsa -platform-name my_devicetree
-local-repo /my_local_git_repo为交接文件创建设备树，并使用本地仓库。
createdts -hw vck190.xsa -platform-name my_devicetree
-out /device-tree_output_directory在设备树输出目录指定的 out 目录中创建设备树。
createdts -hw zcu102.xsa -platform-name my_devicetree -overlay
-zocl -compile为交接文件创建设备树，其中包含 overlay 和 zocl 节点。Compile 标志用于编译来自 DTS 的设备树二进制对象文件。
createdts -hw zcu102.xsa -platform-name my_devicetree -board <Board Name>创建设备树则会将 board 值添加到库中，开发板名称可从如下位置获取：<DTG Repo>/device_tree/data/kernel_dtsi。
createdts -update -hw newdesign.xsa以新 XSA 更新现有设备树平台。
createdts -hw vck190 -platform-name vck190 -out <out_dir>
-dtsi [list path/system-conf.dtsi path/system-user.dtsi]创建设备树并包含 custom-dtsi-files。