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 comibination with -filter option. An error will be 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 as well as (). 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 targets
List all targets.
jtag targets -filter {name == "arm_dap"}
List targets with name "arm_dap".
jtag targets 2
Set 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.