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