SDC命令详解：使用get_ports命令进行查询

相关阅读

SDC命令详解https://blog.csdn.net/weixin_45791458/category_12931432.html?spm=1001.2014.3001.5482

---

        get_ports命令用于创建一个端口对象集合，关于设计对象和集合的更详细介绍，可以参考下面的博客。需要注意的是，在有些工具中还存在get_port命令，它们没有任何差别。

Synopsys：设计对象https://chenzhang.blog.csdn.net/article/details/147015140?spm=1001.2014.3001.5502        本文针对Design Compiler，但该命令同样存在于PrimeTime、IC Compiler等工具中，它们大致相同，略有差别。get_ports命令的BNF范式（有关BNF范式，可以参考以往文章）为：

get_ports[-quiet][-regexp | -exact][-nocase][-filter expression][patterns | -of_objects objects]//注：该命令的选项和参数顺序任意

指定静默

        -quiet选项用于指定静默输出，如果尝试匹配的端口对象不存在，不会报错或警告（不过语法错误仍会报错），如例1所示。

 // 例1
dc_shell> get_ports a
Warning: Can't find port 'a' in design 'top_module'. (UID-95)
dc_shell> get_ports -quiet a
dc_shell> 

指定使用正则表达式

        -regexp选项用于指定使用正则表达式，patterns参数将被视为正则表达式，而不是通配符模式串（默认），如例2所示。该选项还会修改-filter选项的expression过滤表达式中=~和!~的行为，使其使用正则表达式，而不是通配符模式串。

        需要注意的是，正则表达式默认是开头和结尾“锚定”的：即表达式被假定为从对象名称的开头开始匹配，并在对象名称的结尾结束匹配，可以通过在表达式的开头或结尾添加".*"来扩大匹配范围。

        -regexp选项和-exact选项是互斥的，只能使用其中一个。

// 例2
dc_shell> get_ports -regexp {in1}
{in1}
dc_shell> get_ports -regexp {in}
Warning: Can't find port 'in' in design 'top_module'. (UID-95)
dc_shell> get_ports -regexp {n1}
Warning: Can't find port 'n1' in design 'top_module'. (UID-95)
dc_shell> get_ports -regexp {.*n1}
{in1}
dc_shell> get_ports -regexp {in.*}
{in1 in2 in3}

指定精确匹配

        -exact选项用于指定精确匹配，patterns参数将不被视为正则表达式或通配符模式串（默认），如例3所示。该选项还会修改-filter选项的expression过滤表达式中=~和!~的行为，使其不被视为正则表达式或通配符模式串。

        -regexp选项和-exact选项是互斥的，只能使用其中一个。

// 例3
dc_shell> get_ports in*
{in1 in2 in3}
dc_shell> get_ports -exact in*
Warning: Can't find port 'in*' in design 'top_module'. (UID-95)

指定大小写不敏感

        -nocase选项用于指定patterns参数和-filter选项的expression过滤表达式中==、=~和!~不区分大小写，如例4所示。

// 例4
dc_shell> get_ports IN1
Warning: Can't find port 'IN1' in design 'top_module'. (UID-95)
dc_shell> get_ports -nocase IN1
{in1}

指定过滤

        -filter选项指定基于端口属性对得到的端口对象集合进行过滤，如例5所示。类似于filter_collection命令那样，可以使用==、!=、>、<、>=、<=、=~、!~构成布尔表达式，其中=~和!~支持在布尔表达式右端使用正则表达式或通配符。使用list_attributes -class port -application命令可以列出一个端口对象可以拥有的属性(Attribute)。

// 例5
dc_shell> set_ideal_network [get_ports in1]
1
dc_shell> get_ports -filter "ideal_network_source==true"
{in1}
dc_shell> get_ports -filter "ideal_network_source==false"

指定patterns参数

        patterns参数用于指定一个字符串，根据-regexp选项和-exact选项的指定情况，作为正则表达式、通配符模式串或普通字符串。该字符串中可以包含通配符*与?。

        patterns参数和-of_objects选项是互斥的，只能使用其中一个。如果没有使用这两个选项中的任何一个，则会以当前设计中的所有端口创建端口对象集合（即以*为默认patterns参数）。

指定设计对象

        -of_objects选项用于指定设计对象，创建与这些设计对象相联系的端口对象集合。对象可以是线网(Net)、物理端口(Terminal)、绑定(Bound)和通孔区域(Via Region)，如例6所示。

       patterns参数和-of_objects选项是互斥的，只能使用其中一个。如果没有使用这两个选项中的任何一个，则会以当前设计中的所有端口创建端口对象集合（即以*为默认patterns参数）。

// 例6
dc_shell> get_ports -of_objects [get_nets in1]
{in1}
dc_shell> get_ports -of_objects [get_nets out]
{out}