List JTAG targets or switch between JTAG targets.
Syntax
jtag targets List available JTAG targets.
jtag targets <target id>Select <target id> as active
JTAG target.
Options
| Option | Description |
|---|---|
-set
|
Set current target to entry single entry in list. This is useful in combination with -filter option. An error is generated if 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 that 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 ==, !=, <=,
>=, <, >,
&&, ||, and () are supported. There operators behave like
Tcl expr operators. String matching operator =~ and !~ match LHS
string with RHS pattern using either regexp or string match.
|
-target-properties
|
Returns a Tcl list of dictionaries containing target properties. |
-open
|
Open all targets in list. List can be shorted by specifying target-ids and using filters. |
-close
|
Close all targets in list. List can be shorted by specifying target-ids and using filters. |
-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. The timeout value is in seconds. Default timeout is three seconds. |
Returns
The return value depends on the options used.
<none>: JTAG targets list when
no options are used.
-filter: Filtered JTAG targets list.
-target-properties: Tcl list
consisting of JTAG target properties.
An error is returned when JTAG target selection fails.
Examples
jtag targetsList all targets.
jtag targets -filter {name == "arm_dap"}List targets with name "arm_dap."
jtag targets 2Set target with id 2 as the current target.
jtag targets -set -filter {name =~ "arm*"}Set current target to target with name starting with "arm."
jtag targets -set -filter {level == 0}List JTAG cables.