Inheritance diagram for oaOccTerm:
Public Methods | |
oaBoolean | isImplicit () const |
oaBoolean | isInterface () const |
oaOccBitTerm * | getBit (oaUInt4 bitIndex) const |
oaOccNet * | getNet (oaBoolean preferred=false) const |
oaUInt4 | getNumBits () const |
oaTermType | getTermType () const |
oaUInt4 | getPosition () const |
oaOccNet * | getAssignedNet (oaBoolean ignoreDefault=false) const |
oaOccNet * | getAssignedNet (oaAssignedNetSpec &spec, oaBoolean ignoreDefault=false) const |
oaTerm * | getTerm () const |
oaModTerm * | getModTerm () const |
oaOccTerm * | getReflection (oaDomain d) const |
void | getName (oaName &name) const |
void | getName (const oaNameSpace &ns, oaString &name) const |
Static Public Methods | |
oaOccTerm * | find (const oaOccurrence *occurrence, const oaName &name) |
oaOccTerm * | find (const oaOccurrence *occurrence, oaUInt4 position) |
oaOccTerm * | find (const oaOccurrence *occurrence, const oaName &name, oaDomain d) |
oaOccTerm * | find (const oaOccurrence *occurrence, oaUInt4 position, oaDomain d) |
oaUInt4 | getMaxPosition (const oaOccurrence *occurrence) |
Public Types | |
enum | { dtIndex = oacTermDataType } |
oaModTerm, oaOccTerm, and oaTerm each represent bus terminals on a different kind of master, where in each case the master represents a level of hierarchy in the design.
For oaOccTerm, the master is an oaOccurrence, which corresponds to a unique usage of a module or a block in a design. Each oaOccurrence in a design will have a set of zero or more occTerms.
For oaModTerm, the master is an oaModule. For oaTerm, the master is an oaBlock, and the top block for the design will have a set of zero or more modTerms. Typically, many of the oaTerms on the top oaBlock have a corresponding oaModTerm on the top oaModule. The top oaOccurrence will have a corresponding oaOccTerm for each terminal in the union of the terminals between the top oaModule and the top oaBlock.
When oaTerm objects are created in the block domain, the corresponding oaOccTerm objects are automatically created on the top oaOccurrence.
Multi-bit terminals represent a group of logical connections to import or export from the module. The terminals can consist of busTerms having a single root name with an index range, or they can include bundleTerms that are a more complex grouping of terminals. Multi-bit terminals can have overlapping names. For example, you can have the busTerms "addr<7:0>" and "addr<3:0>" as long as the overlapping bits are connected to the same nets.
All oaOccBusTerms with the same root name are managed by an oaOccBusTermDef. The oaOccBusTermDef tracks the least significant and most significant bits of all the associated oaOccBusTerms, all of the oaOccBusTerms with the same base name, and all of the associated oaOccBusTermBits.
oaOccBusTermBits are automatically created for each bit of an oaOccBusTerm, if they do not already exist. oaOccBusTermBits are available for those applications performing scalarized connectivity traversal of the data.
oaOccBundleTerms can contain oaOccScalarTerms or oaOccBusTerms. When an oaOccBundleTerm is created, the constituent scalarTerms and busTermBits are automatically created in addition to the bundleTerm itself. All automatically created terminal objects are considered implicit.
Names are associated with terminals. The various terminal objects take and return names through the general oaName object but also use the oaScalarName, oaVectorBitName, oaVectorName, and oaBundleName objects. These name objects manage the mapping of names from one nameSpace to another. For example, you can create a terminal using a name in the CDBA nameSpace. Another application can retrieve the terminal name in the Verilog nameSpace directly from the database.
The oaOccTerm class can be observed by deriving from oaObserver<oaOccTerm>.
|
This function the specified occurrence for a terminal assigned to the specified position. The terminal is returned if found. Otherwise, NULL is returned. If the reflected block domain terminal was hidden and overridden, the domain argument determines whether the returned terminal corresponds to the hidden (oacModDomain) or overriding (oacBlockDomain) object. The default is to return the override terminal.
|
|
This function searches the terminals in the specified occurrence and in the specified domain for the terminal with the specified name. The specified name cannot be hierarchical since a terminal is local to an instance. If the reflected block domain terminal was hidden and overridden, the domain argument determines whether the returned terminal corresponds to the hidden (oacModDomain) or overriding (oacBlockDomain) object. The default is to return the override terminal.
|
|
This function the specified occurrence for a terminal assigned to the specified position. The terminal is returned if found. Otherwise, NULL is returned.
|
|
This function searches the terminals in the specified occurrence for one with the specified name. The specified name cannot be hierarchical since a terminal is local to an instance. If the terminal is found, it is returned. Otherwise NULL is returned.
|
|
This function returns the occurence net assigned to this terminal as per the inherited connections specification. NULL will be returned in the following cases:
Exceptions are thrown for cases when an assignment is found but a net with that name does not exist or if the default net name needs to be used, 'ignoreDefault' is false, but there is no net that matches the default net name specified. This version is for diagnostic use and returns the set of connectDefs and/or assignments that were looked at in the hierarchy for resolving the assigned net via the 'spec' parameter. Clients can inspect the array which will consist of pointers to either connectDef or assignment objects in the occurrence domain.
|
|
This function returns the occurence net assigned to this terminal as per the inherited connections specification. NULL will be returned in the following cases:
Exceptions are thrown for cases when an assignment is found but a net with that name does not exist or if the default net name needs to be used, 'ignoreDefault' is false, but there is no net that matches the default net name specified.
|
|
This function returns a pointer to the terminal that corresponds to the specified bitIndex bit of this terminal. For single-bit terminals, this function returns this terminal. For multi-bit terminals, a busTermBit is returned if this terminal is a busTerm, or a single-bit terminal is returned if this terminal is a bundleTerm. If a terminal is hidden and overridden, a pointer to the overriding terminal is returned.
|
|
This function returns the highest position occupied by a terminal in the specified occurrence. If there are no terminals in the occurrence or no position has been assigned a terminal, the value oacNullIndex is returned.
|
|
This function returns the module terminal corresponding to this occurrence terminal if there is one. There is always either a module terminal or a block terminal (oaTerm) or both. It returns NULL if there is no corresponding oaModTerm. Reimplemented in oaOccBundleTerm, oaOccBusTerm, oaOccBusTermBit, and oaOccScalarTerm. |
|
This function fills in name with the name of this terminal mapped to the specified nameSpace. |
|
This function fills out name with the name of this terminal. |
|
This function returns the net to which this terminal is attached. If preferred is true, the preferred equivalent net associated with the net will be returned instead.
|
|
This function returns the number of bits in this terminal. |
|
This function returns the position that this terminal is assigned to. The value oacNullIndex is returned if this terminal has not been assigned to a position. |
|
This function returns the object pointer corresponding to the reflection of the current object in the specified domain. If an object is overriden, it returns the pointer to the hidden or overriding sibling dependent on the specified domain.
|
|
This function returns the terminal in the block domain that corresponds to this occurrence terminal if there is one. There is always either a module terminal (oaModTerm) or a block terminal or both. It returns NULL if there is no corresponding oaTerm. Reimplemented in oaOccBundleTerm, oaOccBusTerm, oaOccBusTermBit, and oaOccScalarTerm. |
|
This function returns the terminal type of this terminal. |
|
This function returns a boolean value that indicates if this terminal is implicit. An implicit terminal is automatically created by the database as part of the explicit creation of a multi-bit terminal. |
|
This function returns a boolean indicating whether this terminal is an interface terminal. An interface terminal is one that was explicitly created by an application calling one of the create functions on the objects derived from oaTerm. Explicitly created terminals define the interface to the block that contains them. Note that an interface terminal that is scalarized is still considered an interface terminal. Implementation data may be added to the resulting bitTerms after scalarization, but the interface terminal remains as a reference to how the interface was originally defined. Further edits to the block may delete the interface terminal, indicating that the interface to the block has indeed changed. |
|
|
Copyright © 2002 - 2010 Cadence Design Systems, Inc.
All Rights Reserved.