createdts - 2024.2 English

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

Document ID
UG1400
Release Date
2024-11-13
Version
2024.2 English

Creates device tree

Table 1. createdts- Creates device tree
XSCT methods Arguments Corresponding Python API Arguments Comments
createdts

-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 is the 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 gets cloned from git, if this option is not specified.

-git-url <Git URL>

Git URL of the dtg repo to be cloned. For default repo, click here.

client.create_platform() Required Arguments:

name = <platform_name> Name of the platform.

hw = <handoff_file> Hardware description file to be used to create the platform.

emulation_xsa_path = <xsa_path> Path to the Emulation xsa on which the component is created.

platform_xpfm_path =<xpfm_path> Xpfm path of existing platorm.

Optional Arguments:

desc = <description> Description of the platform.

os = <os> The OS to be used to create the default domain.

cpu = <processor> The processor to be used to create the default domain.

domain_name = <domain_name> Name of the domain to be created in the platform.

Create platform creates a DTS and a platform project.
createdts (cont'd)

-git-branch <Git Branch>

Git branch to be checked out. 'xlnx_rel_v<Vitis-release>' is selected by 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.

-dtsi <custom-dtsi-file list>

Include custom-dtsi file in the device tree, if specified. The filepaths must be in the list format.

-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).

-updateSet update flag to enable existing device tree platform to update with new xsa.

client.create_platform() (cont'd)

template = <template_name>

Template for creating domain in case of Baremetal platform. "Empty" (Default)

no_boot_bsp = <bool> Mark the platform to build without generating boot components.

fsbl_target = <fsbl_target> Processor-type for which the existing fsbl has to be generated.

This option is valid only for ZU+. "psu_cortexa53_0" (Default)

fsbl_path = <path>

Fsbl path for custom fsbl. This option is used when no_boot_bsp is opted.

pmufw_Elf = <path>

Prebuilt fsbl.elf to be used as boot component. This option is used when no_boot_bsp is opted.