createdts - 2022.1 English

creates device tree

Syntax

createdts [options]

Create a device tree for the hardware definition file.

Options

Option	Description
`-platform-name <software-platform name>`	Name of the software platform to be generated.
`-board <board name>`	Board name for device tree to be generated. Board names available at `<DTG Repo>`/device_tree/data/kernel_dtsi.
`-hw <handoff-file>`	Hardware description file to be used to create the device tree.
`-out <output-directory>`	The directory where the software platform needs to be created. Workspace will be default directory, if this option is not specified.
`-local-repo <directory location>`	Location of the directory were bsp for git repo is available. Device-tree repo will be cloned from git, if this option is not specified.
`-git-url <Git URL>`	Git URL of the dtg repo to be cloned. Default repo is https://github.com/Xilinx/device-tree-xlnx.git.
`-git-branch <Git Branch>`	Git branch to be checked out. Master branch selected default.
`-zocl`	Set zocl flag to enable zocl driver support, default set to False. zocl should only be used when the designs are PL enabled. Only master and xlnx_rel_v2021.2 branch supports zocl property.
`-overlay`	Set overlay flag to enable device-tree overlay support, default set to False.
`-compile`	Specify this option to compile the generated dts to create dtb. If this option is not specified, users can manually use dts to compile dtb. For example: `dtc -I dts -O dtb -o <file_name>.dtb <file_name>.dts` Compile dts (device tree source) or dtsi (device tree source include) files. `dtc -I dts -O dtb -f <file_name>.dts -o <file_name>.dtb` Convert dts(device tree source) to dtb(device tree blob). `dtc -I dtb -O dts -f <file_name>.dtb -o <file_name>.dts` Convert dtb (device tree blob) to dts (device tree source).
`-update`	Set update flag to enable existing device tree platform to update with new xsa.

Note(s)

This command is a shortcut of creating a device tree domain and generate the device tree. It clones device-tree repo, creates a platform with device_tree as OS, configure and generate the platform to create dts. -zocl should only be used when the designs are PL enabled. Only master and xlnx_rel_v2021.2 branch supports zocl property.

Returns

None.

Example(s)

createdts -hw zcu102.xsa -platform-name my_devicetree

Create a device tree for the handoff-file with Default repo as "https://github.com/Xilinx/device-tree-xlnx.git" and deault branch as "master".

createdts -hw zcu102.xsa -platform-name my_devicetree -git-url <Git URL> -git-branch <Git Branch>

Create a device tree for the handoff-file with user repo as repo mentioned in <Git URL> and user branch as <Git Branch>.

createdts -hw zc702.xsa -platform-name my_devicetree -local-repo /my_local_git_repo

Create a device tree for the handoff-file and use the local repo.

createdts -hw vck190.xsa -platform-name my_devicetree -out /device-tree_output_directory

Create a device tree at the out directory specified by device-tre output directory.

createdts -hw zcu102.xsa -platform-name my_devicetree -overlay -zocl -compile

Create device tree for the handoff-file with overlay and zocl node. Compile flag compiles the Devicetree Blob file from the DTS.

createdts -hw zcu102.xsa -platform-name my_devicetree -board <Board Name>

Creates a device tree adding board value to the library, Board names available at <DTG Repo>/device_tree/data/kernel_dtsi.

createdts -update -hw newdesign.xsa

Updates existing device tree platform with new xsa.