hsi::get_nets - 2022.1 Chinese

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

Document ID
UG1400
Release Date
2022-04-26
Version
2022.1 简体中文

描述

获取信号线列表。

语法

get_nets [-regexp] [-filter <arg>] [-boundary_type <arg>] [-hierarchical] [-of_objects <args>] [-quiet] [-verbose] [<patterns>...] 

返回

信号线对象。如果该命令失败,则不返回任何结果。

用法

名称 描述
[-regexp] 模式为正则表达式。
[-filter] 使用表达式筛选列表
[-boundary_type] 当源对象位于分层块的管脚上时使用。有效值为“upper”、“lower”或“both”。如果选择对应下边界的“lower”选项,则从层级下层开始逐级向上搜索。该选项仅对 connected_to 关系有效。默认值:upper
[-hierarchical] 从分层单元的所有层级中获取信号线。
[-of_objects] 获取以下类型的“net”对象:“hw_design cell port”。
[-quiet] 忽略命令错误
[-verbose] 命令执行期间暂挂消息限制
[<patterns>] 根据模式匹配单元名称;默认设置:*

类别

硬件

描述

获取当前硬件设计中与指定搜索模式相匹配的信号线列表。默认命令会获取子系统设计中的所有信号线的列表。

实参

-regexp -(可选)指定以正则表达式方式编写搜索 <patterns>。使用该实参时,搜索 <patterns> 和 -filter 表达式都必须以正则表达式方式来编写。赛灵思正则表达式 Tcl 命令始终锚定到搜索字符串开始位置。您可在搜索字符串开始或结束处添加 .* 来拓宽搜索范围,以包含子字符串。如需获取正则表达式语法相关帮助信息,请参阅该网页
注释: Tcl 内置命令 regexp 不予锚定,充当标准 Tcl 命令来使用。如需了解更多信息,请参阅该网页

-filter <args> -(可选)使用指定表达式来筛选结果列表。-filter 实参会根据对象的属性值来筛选返回的对象列表。您可使用 report_propertylist_property 命令来查找对象上的属性。

使用引号将筛选搜索模式括起,可以避免对信号线、管脚或单元名称中可能出现的特殊字符或者其它属性进行转义。字符串匹配区分大小写,并且始终锚定到搜索字符串的开始和结束位置。在搜索字符串的开始或结束位置,可以使用通配符字符 * 来拓宽搜索范围,以包含属性值的子字符串。
注释: 如果在对象上存在指定的属性,并且指定的模式与该对象上的属性值相匹配,那么筛选会返回该对象。对于 * 通配符字符,它与含已定义的值 "" 的属性相匹配。

为便于字符串比较,在筛选表达式中可使用下列特定运算符:equal (==)、not-equal (!=)、match (=~) 和 not-match (!~)。数字比较运算符 <><=>= 同样可供使用。通过 ANDOR&&||)即可将多个筛选表达式连接在一起。

对于“硬件设计”对象,您可使用“NAME”属性来筛选结果。

-boundary_type:(可选)当源对象位于分层块的管脚上时使用。有效值为“upper”、“lower”或“both”。如果选择对应下边界的“lower”选项,则从层级下层开始逐级向上搜索。该选项仅对 connected_to 关系有效。默认值:upper。

-hierarchical:(可选)从分层单元的所有层级中获取信号线。

-of_objects:(可选)获取以下类型的“net”对象:“hw_design cell port”。

-quiet -(可选)以静默方式执行命令,不返回来自该命令的任何消息。此命令还会返回 TCL_OK,忽略执行期间遇到的所有错误。
注释: 启动该命令时,会返回命令行上遇到的任何错误。仅捕获该命令内部发生的错误。
-verbose -(可选)暂时改写任何消息限制,并返回来自该命令的所有消息。
注释: 可使用 set_msg_config 命令定义消息限制。

<patterns:(可选)将硬件设计信号线与指定模式相匹配。默认模式为通配符 `*`,用于获取当前 IP integrator 子系统设计内的所有信号线的列表。您可指定多个模式,根据不同搜索条件来查找多条信号线。

注释: 您必须使用括号 {} 将多个搜索模式括起,表示此列表是单个元素。

示例

以下示例会获取已连接到硬件设计模块的指定管脚的信号线,并返回这两条信号线:

hsi::get_nets -of_objects [get_pins aclk]
注释: 如果未找到与该模式匹配的信号线,则将显示警告。