SDC命令详解：使用get_pins命令进行查询
相关阅读
SDC命令详解
https://blog.csdn.net/weixin_45791458/category_12931432.html?spm=1001.2014.3001.5482
get_pins命令用于创建一个引脚对象集合，关于设计对象和集合的更详细介绍，可以参考下面的博客。需要注意的是，在有些工具中还存在get_pin命令，它们没有任何差别。
Synopsys：设计对象https://chenzhang.blog.csdn.net/article/details/147015140?spm=1001.2014.3001.5502
本文针对Design Compiler，但该命令同样存在于PrimeTime、IC Compiler等工具中，它们大致相同，略有差别。get_pins命令的BNF范式（有关BNF范式，可以参考以往文章）为：
get_pins[-quiet][-regexp | -exact][-nocase][-filter expression][-hierarchical][patterns | -of_objects objects [-leaf]]//注：该命令的选项和参数顺序任意指定静默
-quiet选项用于指定静默输出，如果尝试匹配的引脚对象不存在，不会报错或警告（不过语法错误仍会报错），如例1所示。
// 例1
dc_shell> get_pins a
Warning: Can't find object 'a' in design 'top_module'. (UID-95)
dc_shell> get_pins -quiet a指定使用正则表达式
-regexp选项用于指定使用正则表达式，patterns参数将被视为正则表达式，而不是通配符模式串（默认），如例2所示。该选项还会修改-filter选项的expression过滤表达式中=~和!~的行为，使其使用正则表达式，而不是通配符模式串。
需要注意的是，正则表达式默认是开头和结尾“锚定”的：即表达式被假定为从对象名称的开头开始匹配，并在对象名称的结尾结束匹配，可以通过在表达式的开头或结尾添加".*"来扩大匹配范围。
-regexp选项和-exact选项是互斥的，只能使用其中一个。
// 例2
dc_shell> get_pins -regexp {u_middle/x1}
{u_middle/x1}
dc_shell> get_pins -regexp {u_middle/x}
Warning: Can't find object 'u_middle/x' in design 'top_module'. (UID-95)
dc_shell> get_pins -regexp {_middle/x1}
Warning: Can't find object '_middle/x1' in design 'top_module'. (UID-95)
dc_shell> get_pins -regexp {.*_middle/x1}
{u_middle/x1}
dc_shell> get_pins -regexp {u_middle/x.*}
{u_middle/x1 u_middle/x2 u_middle/x3}指定精确匹配
-exact选项用于指定精确匹配，patterns参数将不被视为正则表达式或通配符模式串（默认），如例3所示。该选项还会修改-filter选项的expression过滤表达式中=~和!~的行为，使其不被视为正则表达式或通配符模式串。
-regexp选项和-exact选项是互斥的，只能使用其中一个。
// 例3
dc_shell> get_pins u_middle/x*
{u_middle/x1 u_middle/x2 u_middle/x3}
dc_shell> get_pins -exact u_middle/x*
Warning: Can't find object 'u_middle/x*' in design 'top_module'. (UID-95)指定大小写不敏感
-nocase选项用于指定patterns参数和-filter选项的expression过滤表达式中==、=~和!~不区分大小写，如例4所示。
// 例4
dc_shell> get_pins U_MIDDLE/X1
Warning: Can't find object 'U_MIDDLE/X1' in design 'top_module'. (UID-95)
dc_shell> get_pins -nocase U_MIDDLE/X1
{u_middle/x1}指定过滤
-filter选项指定基于引脚属性对得到的引脚对象集合进行过滤，如例5所示。类似于filter_collection命令那样，可以使用==、!=、>、<、>=、<=、=~、!~构成布尔表达式，其中=~和!~支持在布尔表达式右端使用正则表达式或通配符。使用list_attributes -class pin -application命令可以列出一个引脚对象可以拥有的属性(Attribute)。
// 例5
dc_shell> set_dont_touch_network [get_pins u_middle/x1]
1
dc_shell> get_pins -filter "dont_touch_network==true"
{u_middle/x1}
dc_shell> get_pins -filter "dont_touch_network==false"指定跨层次
-hierarchical选项用于指定跨层次搜索，patterns参数应与层次引脚的最后一级或两级匹配（注意该命令与其他get_*命令的区别），如例6所示。此外，-hierarchical选项不能与-of_objects选项一起使用。
// 例6
dc_shell> get_pins
{u_middle/u_leaf/a u_middle/u_leaf/b u_middle/u_leaf/y u_middle/C7/A u_middle/C7/B u_middle/C7/Z}
dc_shell> get_pins -hierarchical
{u_middle/u_leaf/a u_middle/u_leaf/b u_middle/u_leaf/y u_middle/C7/A u_middle/C7/B u_middle/C7/Z u_middle/u_leaf/C7/A u_middle/u_leaf/C7/B u_middle/u_leaf/C7/Z}
dc_shell> get_pins -hierarchical a
{u_middle/u_leaf/a}
dc_shell> get_pins -hierarchical u_leaf/a
{u_middle/u_leaf/a}指定patterns参数
patterns参数用于指定一个字符串，根据-regexp选项和-exact选项的指定情况，作为正则表达式、通配符模式串或普通字符串。该字符串中可以包含层次分隔符/和通配符*与?，需要注意的是，通配符不能匹配层次分隔符/。
patterns参数和-of_objects选项是互斥的，只能使用其中一个。如果没有使用这些选项中的任何一个，则会以当前实例中的所有单元的引脚（如果使用-hierarchical选项，则包括层次单元的引脚）创建引脚对象集合（即以*为默认patterns参数，但这个此时*能匹配单元和引脚之间的分隔符），关于当前实例的详细解释，参考下面的博客。
SDC命令详解：使用相对路径访问设计对象(current_instance命令)https://chenzhang.blog.csdn.net/article/details/147156354?spm=1001.2014.3001.5502
指定设计对象
-of_objects选项用于指定设计对象，创建与这些设计对象相联系的引脚对象集合。对象可以是单元(Cell)和线网(Net)，如果指定对象为线网，默认只考虑相同或底一层次下的引脚，如例7所示。
patterns参数和-of_objects选项是互斥的，只能使用其中一个。如果没有使用这些选项中的任何一个，则会以当前实例中的所有单元的引脚（如果使用-hierarchical选项，则包括层次单元的引脚）创建引脚对象集合。此外，-hierarchical选项不能与-of_objects选项一起使用。
// 例7
dc_shell> get_pins -of_objects [get_cells u_middle]
{u_middle/x1 u_middle/x2 u_middle/x3 u_middle/z}
dc_shell> get_pins -of_objects [get_nets u_middle/x1]
{u_middle/u_leaf/a u_middle/x1}指定叶单元
-leaf选项用于-of_objects选项中指定对象为线网时，跨层次边界搜索并只考虑叶单元上的引脚，该选项只能与-of_objects选项一起使用，如例8所示。
// 例8
dc_shell> get_pins -of_objects [get_nets u_middle/x1] -leaf
{u_middle/u_leaf/C7/A}