hsi::current_dt_tree - 2020.2 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)
Document ID
UG1400
Release Date
2020-12-15
Version
2020.2 English

Description

Set or get current tree.

Syntax

current_dt_tree [-quiet] [-verbose] [<tree>]

Returns

Tree object, "" if failed.

Usage

Name Description
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
[<tree>] Tree to be set

Categories

DeviceTree

Description

Defines the current DT tree for use with the Hardware Software Interface, or returns the name of the current DT tree in the active session. The current DT tree is the target of the Hardware Software Interface - DeviceTree Tcl commands. You can use the get_dt_trees command to get a list of created DT trees in the active session.

Arguments

-quiet – (optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
Note: Any errors encountered on the command line while launching the command are returned. Only errors occurring inside the command are trapped.
-verbose – (optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

<dt_tree> - (optional) The name of a DT tree to set as the current DT tree in the session. If a <dt_tree> is not specified, the command returns the current DT tree of the active session.

Examples

Get the current DT tree object:

hsi::current_dt_tree

OR

Set the specified dt_tree as the current session: 

hsi::current_dt_tree pl.dtsi