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 generate 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 which
targets are included in list based on its properties. Filter
expressions are similar to Tcl expr syntax. Target properties are
references 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 3 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.
Example(s)
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.