Product Documentation
Virtuoso Studio Design Environment SKILL Reference
Product Version IC23.1, November 2023

hdbSetObjBindRule

hdbSetObjBindRule(
h_configId
g_specifier
g_rule
)
=> t / nil

Description

Sets or deletes a binding rule on a cell, instance, or occurrence (path). You can set the following binding rules: library list, view list, binding, or stop point.

Arguments

h_configId

The ID of the configuration that is opened in write or append mode; the return value of hdbOpen.

g_specifier

A list of lists specifying the cell, instance, or occurrence on which to set the binding rule.

To set a binding rule on a cell, specify a list that contains a single list of four elements:

 ((lib cell nil nil))

Here,

  • Value of lib is a string or nil to indicate that the library list should be used to locate the specified cell.
  • cell is a required string.

Example:

   (("lib1" "cell1" nil nil))

Sets a binding rule on the cell lib1.cell1.

To set a binding rule on an instance, specify a list that contains a single list of four elements:

((lib cell view instance))

Here,

  • Value of lib is a string or nil to indicate that the library list should be used to locate the specified cell.
  • cell is a required string
  • Value of view is a string or nil to indicate that the view should be determined using the view list.
  • instance is a required string.

Example:

   (("lib1" "cell1" "view1" "inst1"))   

Sets a binding rule on instance (lib1.cell1.view1).inst1.

To set a binding rule on an occurrence, specify a list of lists, each of which must have a library, cell, view, and instance. The list specifies the path to the occurrence, beginning with the top design.

((lib cell view inst) (lib cell view inst) ...)

g_rule

One of the following rules:

Rule

Specified as ...

Library list

(’hdbcLibListRule ("lib1" "lib2" "lib3" ...))

View list

(’hdbcViewListRule ("view1" "view2" "view3" ...))

Binding

(’hdbcBindingRule ("lib "cell" "view"))

where lib, cell, or view can also be nil. For example:

(’hdbcBindingRule ("lib1 "cell1" "view1"))
(’hdbcBindingRule (nil "cell1" "view1"))
(’hdbcBindingRule (nil nil "view1"))

Note: When setting a binding rule on an occurrence (path), all fields must be specified in the rule. For example,

rule = list (’hdbcBindingRule list ("worklib" "subsub" "schematic2"))

Stop list

(’hdbcStopRule t)

To delete a rule, specify nil as the second element of the list. For example: (’hdbcStopRule nil)

Value Returned

t

The binding is set or deleted.

nil

There was an error.

Examples

hdbSetObjBindRule(myConfigID list(list("lib1" "cell1" nil nil)) list(’hdbcStopRule t))

To set a binding rule on an occurrence, the specifier for the path list could be specified as:

spec= list(list ("worklib" "top" "schematic" "IO") list("worklib" "sub" "schematic" "IO")

and the corresponding rule could be defined as:

rule= list(’hdbcBindingRule list ("worklib" "subsub" "schematic2")

Related Topics

Hierarchy Database Functions

Occurrence Property Functions

Parent/Child Database Functions


Return to top
 ⠀
X