targets - 2023.2 简体中文

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

Document ID
UG1400
Release Date
2023-12-13
Version
2023.2 简体中文

列出目标或者在目标间进行切换。

语法

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 器件上的目标。