列出 JTAG 目标或者在 JTAG 目标间进行切换。
语法
jtag targets
列出可用 JTAG 目标。
jtag targets <target id>
选择 <target id>
作为活动的 JTAG 目标。
选项
选项 | 描述 |
---|---|
-set
|
将当前目标设置为在列表中输入单一条目。可搭配 -filter 选项一起使用。如果列表为空或者包含多个条目,则将生成错误。 |
-regexp
|
使用正则表达式进行筛选匹配。 |
-nocase
|
使用不区分大小写的筛选匹配。 |
-filter <filter-expression>
|
指定筛选表达式,基于该属性来控制列表中包含哪些目标。筛选表达式与 Tcl 表达式语法相似。目标属性按名称来引用,而 Tcl 变量则使用 $ 语法来访问,字符串必须使用引号括起。运算符 ==、!=、<=, > =、<, > 、&& 和 || 以及 () 均受支持。这些运算符与 Tcl 表达式运算符的行为方式相似。匹配运算符 =~ 和 !~ 的字符串使用正则表达式或字符串匹配来将 LHS 字符串与 RHS 模式相匹配。 |
-target-properties
|
返回包含目标属性的词典的 Tcl 列表。 |
-open
|
打开列表中的所有目标。通过指定 target-id 并使用筛选可以缩短列表。 |
-close
|
关闭列表中的所有目标。通过指定 target-id 并使用筛选可以缩短列表。 |
-timeout <sec>
|
轮询直至在扫描链上找到筛选选项所指定的目标或者直至超时为止。该选项仅对筛选选项有效。超时值以秒为单位。默认超时为 3 秒。 |
返回
返回值取决于所使用的选项。
<none>
:不使用任何选项时,则使用 JTAG 目标列表。
-filter
:已筛选的 JTAG 目标列表。
-target-properties
:包含 JTAG 目标属性的 Tcl 列表。
当 JTAG 目标选择失败时,返回错误。
示例
jtag targets
列出所有目标。
jtag targets -filter {name == "arm_dap"}
列出名为“arm_dap”的目标。
jtag targets 2
将 id 为 2 的目标设置为当前目标。
jtag targets -set -filter {name =~ "arm*"}
将当前目标设为名称以“arm”开头的目标。
jtag targets -set -filter {level == 0}
列出 JTAG 线缆。