相关阅读
SDC命令详解https://blog.csdn.net/weixin_45791458/category_12931432.html?spm=1001.2014.3001.5482
目录
指定静默
指定使用正则表达式
指定精确匹配
指定大小写不敏感
指定过滤
指定跨层次
指定patterns参数
指定设计对象
指定叶单元
Multicorner-Multimode支持
特殊版本
写在最后
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 dcnxt_shell> get_pins a Warning: Can't find object 'a' in design 'top_module'. (UID-95) dcnxt_shell> get_pins -quiet a dcnxt_shell>指定使用正则表达式
-regexp选项用于指定使用正则表达式，patterns参数将被视为正则表达式，而不是通配符模式串（默认），如例2所示。该选项还会修改-filter选项的expression过滤表达式中=~和!~的行为，使其使用正则表达式，而不是通配符模式串。
需要注意的是，正则表达式默认是开头和结尾“锚定”的：即表达式被假定为从对象名称的开头开始匹配，并在对象名称的结尾结束匹配，可以通过在表达式的开头或结尾添加".*"来扩大匹配范围。
-regexp选项和-exact选项是互斥的，只能使用其中一个。
// 例2 dcnxt_shell> get_pins -regexp {u_middle/x1} {u_middle/x1} dcnxt_shell> get_pins -regexp {u_middle/x} Warning: Can't find object 'u_middle/x' in design 'top_module'. (UID-95) dcnxt_shell> get_pins -regexp {_middle/x1} Warning: Can't find object '_middle/x1' in design 'top_module'. (UID-95) dcnxt_shell> get_pins -regexp {.*_middle/x1} {u_middle/x1} dcnxt_shell> get_pins -regexp {u_middle/x.*} {u_middle/x1 u_middle/x2 u_middle/x3}指定精确匹配
-exact选项用于指定精确匹配，patterns参数将不被视为正则表达式或通配符模式串（默认），如例3所示。该选项还会修改-filter选项的expression过滤表达式中=~和!~的行为，使其不被视为正则表达式或通配符模式串。
-regexp选项和-exact选项是互斥的，只能使用其中一个。
// 例3 dcnxt_shell> get_pins u_middle/x* {u_middle/x1 u_middle/x2 u_middle/x3} dcnxt_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 dcnxt_shell> get_pins U_MIDDLE/X1 Warning: Can't find object 'U_MIDDLE/X1' in design 'top_module'. (UID-95) dcnxt_shell> get_pins -nocase U_MIDDLE/X1 {u_middle/x1}指定过滤
-filter选项指定基于引脚属性对得到的引脚对象集合进行过滤，如例5所示。类似于filter_collection命令那样，可以使用==、!=、>、<、>=、<=、=~、!~构成布尔表达式，其中=~和!~支持在布尔表达式右端使用正则表达式或通配符。使用list_attributes -class pin -application命令可以列出一个引脚对象可以拥有的属性(Attribute)。
// 例5 dcnxt_shell> set_dont_touch_network [get_pins u_middle/x1] 1 dcnxt_shell> get_pins -filter "dont_touch_network==true" {u_middle/x1} dcnxt_shell> get_pins -filter "dont_touch_network==false" dcnxt_shell>指定跨层次
-hierarchical选项用于指定跨层次搜索，patterns参数应与引脚层次名的最后一级或两级匹配（注意该命令与其他get_*命令的区别），如例6所示。此外，-hierarchical选项不能与-of_objects选项一起使用。
// 例6 dcnxt_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} dcnxt_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} dcnxt_shell> get_pins -hierarchical a {u_middle/u_leaf/a} dcnxt_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 dcnxt_shell> get_pins -of_objects [get_cells u_middle] {u_middle/x1 u_middle/x2 u_middle/x3 u_middle/z} dcnxt_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 dcnxt_shell> get_pins -of_objects [get_nets u_middle/x1] -leaf {u_middle/u_leaf/C7/A}Multicorner-Multimode支持
该命令对所有场景生效。
关于场景的更多介绍，可以参考下面的博客。
Design Compiler：多工艺角和多工作模式(Multicorner-Multimode, MCMM)https://blog.csdn.net/weixin_45791458/article/details/149578771?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522e3267dcc7cc26380435f53994dc8b9b8%2522%252C%2522scm%2522%253A%252220140713.130102334.pc%255Fblog.%2522%257D&request_id=e3267dcc7cc26380435f53994dc8b9b8&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~blog~first_rank_ecpm_v1~rank_v31_ecpm-1-149578771-null-null.nonecase&utm_term=MCMM&spm=1018.2226.3001.4450
特殊版本
除了get_pins命令外，还存在get_flat_pins命令，该命令的大部分选项与get_pins命令相同。不同之处在于，该命令只能创建叶单元（即非层次单元）引脚对象集合，且没有-hierarchical选项和-leaf选项，如果在patterns参数中使用通配符*与?，它们可以匹配作为层次分隔符的/。如例9所示。
// 例9 dcnxt_shell> get_flat_pins {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} dcnxt_shell> get_flat_pins u_middle* {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}对于get_flat_pins命令，引脚层次名是相对当前设计而不是当前实例指定的。
get_pins命令按照逻辑层级进行匹配，与Design Compiler、PrimeTime体系一致。get_flat_pins命令则在当前设计中对所有叶单元引脚的完整名字进行匹配，不依赖当前层级实例，更符合布局布线工具（如IC Compiler、IC Compiler II、Fusion Compiler）视角。
由于get_flat_pins命令匹配范围相较于get_pins命令更大，性能可能较差，如果使用正则或通配符时应尽量减少调用次数。
由于get_flat_pins命令并不是一个SDC命令，因此如果使用read_sdc命令读取约束时，其中不能包含该命令（如果定义约束时使用了get_flat_pins命令，使用write_sdc命令输出时会使用get_pins命令等价实现），对于跨工具的脚本也不建议使用该命令。
写在最后
get_pins命令返回的是引脚对象集合，但该命令会自动调用query_objects命令显示对象名列表，执行该命令后可看到对应列表（列表中的对象名数量最多由collection_result_display_limit变量控制，默认为100）。
)
