List targets or switch between targets.
Syntax
targets [options]
List available targets.
targets <target id>
Select <target id>
as active target.
Options
Option | Description |
---|---|
-set
|
Set current target to entry single entry in list. This is useful in combination with the -filter option. An error is generated if the list is empty or contains more than one entry. |
-regexp
|
Use regexp for filter matching |
-nocase
|
Use case insensitive filter matching |
-filter <filter-expression>
|
Specify filter expression to control which targets are included in list
based on its properties. Filter expressions are similar to Tcl expr
syntax. Target properties are referenced by name, while Tcl
variables are accessed using the $ syntax string must be quoted.
Operators ==, !=, <=, > =,
<, > , &&, ||, ()
are supported. These operators behave like Tcl expr operators.
String matching operators =~ and !~ match the LHS string with the
RHS pattern using either regexp or string match. |
-target-properties
|
Returns a Tcl list of dicts containing target properties. |
-index <index>
|
Include targets based on the JTAG scan chain position. This is identical to specifying -filter {jtag_device_index==<index> }. |
-timeout <sec>
|
Poll until the targets specified by filter option are found on the scan chain, or until timeout. This option is valid only with filter option. This option is useful in case of soft processors on PL, as their initialization and detection takes some time. The timeout value is in seconds. Default timeout is three seconds. |
Returns
The return value depends on the options used.
<none>
: Targets list when no options are used.
-filter
: Filtered targets list.
-target-properties
: Tcl list consisting of target properties.
An error is returned when target selection fails.
Examples
targets
List all targets.
targets -filter {name =~ "ARM*#1"}
List targets with name starting with "ARM" and ending with "#1".
targets 2
Set target with id 2 as the current target.
targets -set -filter {name =~ "ARM*#1"}
Set current target to target with name starting with "ARM" and ending with "#1".
targets -set -filter {name =~ "MicroBlaze*"} -index 0
Set current target to target with name starting with "MicroBlaze" and which is on the first JTAG device.