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

相关阅读

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

---

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

Synopsys：设计对象https://chenzhang.blog.csdn.net/article/details/147015140?spm=1001.2014.3001.5502

---

        本文针对Design Compiler，但该命令同样存在于PrimeTime、IC Compiler等工具中，它们大致相同，略有差别。get_lib_pins命令的BNF范式（有关BNF范式，可以参考以往文章）为： 

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

指定静默

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

// 例1
dc_shell> get_lib_cells a
Error: Can't find lib_cell 'a'. (UID-109)
dc_shell> get_lib_cells -quiet a
dc_shell> 

 

指定使用正则表达式

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

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

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

// 例2
dc_shell> get_lib_pins -regexp {fast/AND2X1/A}
{fast/AND2X1/A}
dc_shell> get_lib_pins -regexp {fast/AND2X1/}
Error: Can't find lib_pin 'fast/AND2X1/'. (UID-109)
dc_shell> get_lib_pins -regexp {ast/AND2X1/A}
Error: Can't find lib_pin 'ast/AND2X1/A'. (UID-109)
dc_shell> get_lib_pins -regexp {.*ast/AND2X1/A}
{fast/AND2X1/A}
dc_shell> get_lib_pins -regexp {fast/AND2X1/.*}
{fast/AND2X1/A fast/AND2X1/B fast/AND2X1/Y}

 

指定精确匹配

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

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

// 例3
dc_shell> get_lib_pins fast/AND2X1/*
{fast/AND2X1/A fast/AND2X1/B fast/AND2X1/Y}
dc_shell> get_lib_pins -exact fast/AND2X1/*
Error: Can't find lib_pin 'fast/AND2X1/*'. (UID-109)

指定大小写不敏感

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

// 例4
dc_shell> get_lib_pins FAST/AND2X1/A
Error: Can't find lib_pin 'FAST/AND2X1/A'. (UID-109)
dc_shell> get_lib_pins -nocase FAST/AND2X1/A
{fast/AND2X1/A}

指定过滤

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

// 例5
dc_shell> get_lib_pins fast/AND2X1/* -filter capacitance<0.002
{fast/AND2X1/A fast/AND2X1/B fast/AND2X1/Y}

指定patterns参数

        patterns参数用于指定一个字符串，根据-regexp选项和-exact选项的指定情况，作为正则表达式、通配符模式串或普通字符串。该字符串中可以包含层次分隔符/和通配符*与?，需要注意的是，通配符不能匹配层次分隔符/。

        patterns参数和-of_objects选项是互斥的，只能使用其中一个。

指定设计对象

        -of_objects选项用于指定设计对象，创建与这些设计对象相联系的库单元引脚对象集合。对象可以是库单元(Lib Cell)和库单元实例引脚(Lib Cell Instance Pin)，如例6所示。

        patterns参数和-of_objects选项是互斥的，只能使用其中一个。

// 例6
dc_shell> get_lib_pins -of_objects [get_pins u_middle/U4/Y]
{fast/OR2X1/Y}