createdts - 2022.1 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
UG1400
Release Date
2022-04-26
Version
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.