喜欢就争取，得到就珍惜，错过就忘记—dbGet（二）
通过前面一篇对dbGet基本用法的介绍，大家应该对它有一定了解了吧。那接来下，我们就要学习一下进阶的dbGet用法了。
dbGet是由它基本的语法加上各种object的attribute的组合构成的。大家在熟悉基本语法之后，就应该去学习各个object的attribute了。说实话，这很难，因为attribute很多，而且有的attribute写法相当奇怪，怎么看都看不懂，比如hInstTerms、hTerms、instTerms的区别。。。那我们怎么去了解这些attribute的意思呢？平时要多学多用，还有多看doc。
其实，我们dbGet本身是提供一些简单的attribute介绍信息的，上一篇文章里也讲过，采用.?h来查询。比如说我们不知道insts下面的pStatus属性是什么意思，就可以采用如下命令，它会简单介绍pStatus的意思和用途
[DEV]innovus 3> dbGet top.insts.?h pStatus
pStatus(settable): enum(cover fixed placed softFixed unplaced), This attribute is the placement status of an instance during placement and optimization. The placer will look at both place_status and place_status_cts and use the more restrictive value.
可能你会觉得这样去查询一个介绍有点繁琐，不像别的cmd只要help一下就行了。这里，dbTcl提供了另外一个很方便去查询的命令，dbSchema。怎么使用呢？比如说你想知道net的意思，可以采用下面命令：
[DEV]innovus 16> dbSchema net
=====================
net: Canonical (flat) net (equivalent to connectivity in DEF NETS and SPECIALNETS)
--------------------------------------
allTerms: objList(instTerm term), List of pointers to connections (terms and instTerms)
area: area, Area of the net as defined by the LEF MACRO SIZE or OVERLAP information
看到木有，是不是和.?h具有相同功能，而且方便多了，它还会把这个attribute下一级子attribute都列出来。
它也支持通配符匹配，下面命令就会得到net和netgroup的信息
[DEV]innovus 17> dbSchema net*
=======================
net: Canonical (flat) net (equivalent to connectivity in DEF NETS and SPECIALNETS)
-----------------------------------------
allTerms: objList(instTerm term), List of pointers to connections (terms and instTerms)
area: area, Area of the net as defined by the LEF MACRO SIZE or OVERLAP information
===================
netGroup: Net group
--------------------------------------
excludeNet(settable): enum(allLayer allLayerInGuidedArea inclusive sameLayer), Indicates group net exclude type(allLayer, sameLayer, inclusive, allLayerInGuidedArea)
它更加有用的地方在于，它还能帮你查询到上一级的attribute是什么，这样我们就能很方便地写出我们想要的dbGet命令。比如说我们不知道在哪些attribute下面有net属性，可以采用下面命令：
[DEV]innovus 18> dbSchema -parent net
也可以采用通配符来匹配，功能和-parent一样
[DEV]innovus 20> dbSchema * net
采用-list就可以只列出parent attribute的名字
[DEV]innovus 18> dbSchema -parent net -list
bump bus hInstTerm hNet hTerm inst instTerm net netGroup pWire pd routeType sViaInst sWire term topCell vWire viaInst wire
但是如果你不知道想要查询的attribute名字，上一级或者下一级都完全没思路的话，那就没办法。只能查询doc了，下面我们就来介绍一下各个attribute的意思，（由于数目太庞大，简单的或者很冷门的属性我就直接跳过了，按字母顺序来介绍吧）
得到design中fence,region,guide的place信息
Parent Object
fPlan, hInst
Child Object
area，box，box_area，box_ll，box_llx，box_lly，box_size，box_sizex，box_sizey，box_ur，box_urx，box_ury，boxes，hInst，objtype，prop，type
经常有人问我，dbGet怎么没法得到fence，region，guide属性。那这个attribute就是来得到这些东西的。前面的box，area，size就不介绍了，大家试一下就知道了。
hInst: 这边可能有些新人不理解hInst, inst和cell的区别，cell是netlist里面最基本的单元，inst是cell被实例化以后的东西，而hInst则是带有hierarchy结构的module，它的下层还有东西，那它就是hInst。下面这张图很好地表达了三者的区别
所以这边dbGet bndrys的hinst的话，
[DEV]innovus 3> dbget top.fPlan.bndrys.hInst.name
SUB_INTER_PH SUB_Tran_PH
objtype: 该attribute的类型是什么，通常可以用于检查一个指针是什么类型
prop: 可以自己使用define_property来定义新的property
type: 这个类型就是指module的约束属性了，分别是fence,region,guide,none,cluster. （注意的是，这里的cluster指的是softGuide）。这些约束的区别如下：
得到design中的bump信息
Parent Object
topCell
Child Object
cell: bump cell
net: bump上assign的net
pStatus: bump placement status，分为cover, fixed, placed, softFixed, unplaced
term: bump的terminal
type: bump的terminal属性，分为analogTerm, asyncCtrlTerm, clockTerm, dQTerm, dTerm, fFQTerm, feedTerm, gatedClockTerm, groundTerm, latchQTerm, normalTerm, powerTerm, rSTerm, triStateTerm
大致知道powerTerm，groundTerm，normalTerm区别就行了。
具体内容参考：
得到design中bus net的属性
Parent Object
net, term
Child Object
baseName，bits，lsb，msb
baseName: bus的基本名，比如A[7:0]的base name 就是A
bits: bus的每个bit
lsb: bus最小的有效bit
msb: bus最大的有效bit
得到floorplan中bus guide的信息
Parent Object
fplan
Child Object
area，botLayer，box，box_area，box_ll，box_llx，box_lly，box_size，box_sizex，box_sizey，box_ur，box_urx，box_ury，netGroup，topLayer
这个比较简单，就是bus guide本身的一些内容了，可以参考以下文章：
这是一个很常用的属性了，基本上physical的东西都能在这个parent下搜到
Parent Object
topCell
Child Object
这些child 属性都会在下文或者前文中介绍过，暂时不重复一遍了。
得到design中gcell grid的属性，其实输出的就是def文件中gcell grid的内容
Parent Object
fPlan
Child Object
dir，numGrids，start，step
dir: design中所有类型的gcell grid的方向
numGrids:design中所有类型gcell grid的属性
start: design中所有类型gcell grid的起始点
step:design中所有类型gcell grid的间距
可以参考以下文章
得到design中inst group的信息
Parent Object
fPlan, hInst, inst, pd
Child Object
area，boxes，conType，density，members，name，parent，pd，props
conType：得到instance group所添加的constrain属性
members：得到添加到instance group中的instance属性
parent：得到sub group所属的parent group属性
pd: 得到instance group的power domain
可以参考以下文章
head是整个design中包括库在内的所有东西总和。
Parent Object
No Parents
Child Object
allCells，cellEdgeSpacings，dbUnits，finGridDirection，finGridOffset，finGridPitch，instMaskShiftLayers，layers，libCells，mfgGrid，props，ptnCells，routeTypes，rules，sites，topCells，vCells，vias
instMaskShiftLayers：得到instance哪层layer可以shift
ptnCells： 得到partition cell名字
rules： design中的ndr rules
vCells：verilog中的module
hierarchical insts
Parent Object
bndry，group，hInstTerm，hTerm， inst，ptn，topCell，vCell
Child Object
allInsts，allTreeInsts，area，bndry，box，box_area，box_ll，box_llx，box_lly，box_size，box_sizex，box_sizey，box_ur，box_urx，box_ury，boxes，cell，group，hInstTerms，hInsts，hNets，insts，name，parent，props，ptn，treeHInsts，treeInsts
Hierarchical的db object总是有点复杂，这里也一样
allInsts：指的是当前hinst level下的所有insts
allTreeInsts: 指的是所有hinst以及所有子level下的insts
hInstTerms: hinst的terminal，就是传统意义上的hinst的port口，如下图所示：红圈圈的就是top下hinst的hInstTerms
[DEV]innovus 13>dbGet top.hInst.hInsts.hInstTerms.name
SUB_PH/cpureq
hNets：指hinst的net，如下图中红圈就是top下hinst的hNet
[DEV]innovus 14> dbGet top.hInst.hInsts.hNets.name
SUB_PH/sec_mem_t_req
parent：指的是hinst上一级parent hinst的属性
treeHInsts：得到所有的hinsts属性
treeInsts：得到所有的insts属性，treeInsts加上treeHInsts就是allTreeInsts
hinst的terminal
Parent Object
hInst, hNet
Child Object
downHNet，hInst，hTerm，layer，name，net，props，pt，pt_x，pt_y，term，upHNet
这个概念在hInst里已经解释过，但它下面还有很多child Object比较混乱
downHNet/upHNet: 这两个得放一起讲，如下图所示，对一条hierarchical net来说，对交接处的port口来说，往下走的net就是downHNet，就是蓝色圆圈；往上走的net的就是upHNet，就是红色圆圈。
[DEV]innovus 15> dbGet top.hInst.hInsts.hInstTerms.downHNet.name
SUB_PH/lx_dmu_debug_enable
[DEV]innovus 16> dbGet top.hInst.hInsts.hInstTerms.upHNet.name
lmi_lmipl_vid_maX1X
hTerm：hierarchical term，这个和hinstTerm的区别在于，hinstTerm是对一个hinst来说，从外往里看的teminal；而hTerm是从里往外看的teminal，是flat的
[DEV]innovus 16> dbGet top.hInst.hinsts.hinsts.hInstTerms.hTerm.name
target_1_asb_add[9]
对应着下面的图片上的红圈，就是这条命令get的hterm名字
term：term的概念是cell的terminal，可以是lib cell，partition cell或者top cell
先介绍到这里吧，剩余的下期再一起介绍~~