日志

liberty parser - liberty格式的library文件解析器

热度 3已有 3489 次阅读| 2019-6-5 14:45 |个人分类:开源工具|系统分类:芯片设计| liberty, parser, parser

做K库工作的小伙伴可能都有接触到如下的应用场景：

1. 查看lib文件中的内容，比如cell-pin，area/leakage_power/timing/internal_power。

2. lib文件内容的再处理，包括table的删除和插入，values的替换。

3. 针对lib文件的quality检查，包括格式，数值，变化趋势等。

当然有一些EDA工具可以帮我们完成一部分工作，比如liberate的merge_library可以帮忙做lib的内容合并，qualib可以做lib文件的部分检查，但是这些EDA工具涉及的都是common的需求，而且往往是不全面的，不能覆盖所有人各种special的需求，所以对于定制化需求，你需要一款“自主可控”的liberty parser来做library数据的抽取工作，这个工作我已经帮你做好了，并且愿意把代码分享出来和大家一起使用。

所以先说主题，liberty parser的github地址为https://github.com/liyanqing1987/libertyParser。

libertyParser下载下来以后包括以下内容。

examples libertyParser.py LICENSE README

其中libertyParser.py包含了核心代码，包括parser和一些实用的function。

README文件中则对liberty parser的基本原理和代码结构做了详细说明。

examples目录中包含一个library文件范例example.lib和一个使用脚本范例example.py，我们就从这个脚本的使用来了解一下libertyParser.py的应用。

example.py

首先应该将libertyParser.py中的类libertyParser实例化，实例化的时候同时传入library file(s)，此时liberty parser会逐行解析library file(s)，报告不规范行和非法行，同时将library file(s)的数据记录到python dict（字典）的数据结构之中。（数据结构请参阅README）

myLibertyParser = libertyParser.libertyParser(libFile)

对于myLibertyParser，其使用有两种。

1. 直接获取数据结构myLibertyParser.libDic，自己逐层拨开libDic取出所需数据。

2. 如果对libDic的结构了解不充分，也可以使用libertyParser内置的一些函数来获取基本数据，内置函数有以下几种。

* getUnit() ：返回字典unitDic，里面包含library file中所有关于unit的定义。

* getCellList() ：返回列表cellList，里面包含library file中所有cell。

* getCellArea() : 返回字典cellAreaDic，里面包含library file中所有cell的area信息。

* getCellLeakagePower() ：返回字典cellLeakagePowerDic，里面包含library file中所有cell的leakage_power信息，因为一个cell会包含多个leakage_power，所以每个leakage_power的数据结构中会同时包含when/related_pg_pin/values这三个数据以示区分。

* getLibPinInfo() : 返回字典libPinDic，里面包含library file中所有pin层级的timing和internal_power信息，最小单位是timing table和internal_power table中所包含的index及values数据。

那么我们用范例lib（非常简单的一个lib，包含了三个简单cell）来运行一下范例脚本。