byucc.edif
Class EdifCellInstance

java.lang.Object
  byucc.edif.NamedPropertyObject
      byucc.edif.EdifCellInstance

All Implemented Interfaces:

EdifOut, Nameable, Properties, java.io.Serializable

public class EdifCellInstance
extends NamedPropertyObject
implements EdifOut, java.io.Serializable

Represents a specific instance of an EdifCell object. This object contains a reference to the EdifCell that is instanced and a reference to the parent EdifCell object that instanced this cell.

To Do:

• in addition to addProperty(Property p), what about addPropertyList(PropertyList pl) - this would help for TMR stuff, because there exists a method getPropertyList(), which returns a PropertyList object.
• Keep the setCellRef method? We may need it because when we do modifications to port interfaces (busses expanded to ports, or ports grouped into a bus)

Version:

$Id: EdifCellInstance.java,v 1.61 2005/11/11 20:47:19 ksm4 Exp $

Author:

Welson Sun, Mike Wirthlin, Tyler Anderson

See Also:

Serialized Form

Field Summary

private EdifCell	_cellType This EdifCell reference refers to the type of EdifCell that is instanced.
private EdifCell	_parent This EdifCell reference refers to the the parent EdifCell object that instanced the cell.

Constructor Summary

EdifCellInstance(EdifNameable name)
Constructs an Empty, named EdifCellInstance Object.

EdifCellInstance(EdifNameable name, EdifCell parent)
Constucts a typeless, named EdifCellInstace Object with the specified parent.

EdifCellInstance(EdifNameable name, EdifCell parent, EdifCell type)
Constructs a typed, named EdifCellInstace Object with the specified parent.

EdifCellInstance(java.lang.String name)
Constructs an Empty, named EdifCellInstance Object.

EdifCellInstance(java.lang.String name, EdifCell parent)
Constucts a typeless, named EdifCellInstace Object with the specified parent.

EdifCellInstance(java.lang.String name, EdifCell parent, EdifCell type)
Constructs a typed, named EdifCellInstace Object with the specified parent.

Method Summary

EdifCellInstance	copy()
EdifCellInstance	copy(EdifCell parent) Returns a deep copy of this EdifCellInstance using the passed-in EdifCell as the parent.
java.util.Map	getAllPortRefs() This method will determine the parent cell of an EdifCellInstance and search through the nets of this parent cell.
EdifCell	getCellType() Returns the cell that this EdifCellInstance object is referring to.
EdifNet	getEdifCellInstanceNet(EdifSingleBitPort esbp) This method will determine the parent cell of this instance and search through the nets of this parent cell for that net that connects to the EdifSingleBitPort specified as the parameter.
java.util.Collection	getHierarchicalPrimitiveList() Returns a Collection of List objects for each primitive instance within the hierarchy of this cell instance.
java.util.Map	getInnerNets()
java.util.Map	getOuterEPRs()
java.util.Map	getOuterNets() This method will determine the parent cell of an EdifCellInstance and search through the nets of this parent cell.
EdifCell	getParent() Returns the parent cell that is referring to the cell that this EdifCellInstance object is referring to.
EdifPortRef	getPortRef(EdifSingleBitPort port) TODO: Why isn't this method commented?
java.lang.String	getType() Returns the type of this cell as a String.
boolean	matchesWithin(java.util.Collection instanceList) Returns true if the current instance matches within the passed-in collection of EdifCellInstance Objects.
void	modifyCellRef(EdifCell newCellRef) Modify the internal cell reference used by this EdifCellInstance.
void	modifyCellRef(EdifCell newCellRef, boolean check) Modify the internal cell reference used by this EdifCellInstance.
(package private) void	setParent(EdifCell p) Sets the parent cell that is referring to the cell this EdifCellInstance object is referring to.
void	toEdif(EdifPrintWriter epw) Writes the EDIF representation of this EdifCellInstance object to the EdifPrintWriter passed as a parameter.
java.lang.String	toString() Returns a String representation of the EdifCellInstance object.

Methods inherited from class byucc.edif.NamedPropertyObject

addProperty, addProperty, copyProperties, equals, equalsProperties, getEdifNameable, getName, getOldName, getProperty, getPropertyList, rename, rename

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

_cellType

private EdifCell _cellType

This EdifCell reference refers to the type of EdifCell that is instanced.

_parent

private EdifCell _parent

This EdifCell reference refers to the the parent EdifCell object that instanced the cell.

Constructor Detail

EdifCellInstance

public EdifCellInstance(java.lang.String name)

Constructs an Empty, named EdifCellInstance Object.

Parameters:

name - The name of this EdifCellInstance Object

EdifCellInstance

public EdifCellInstance(EdifNameable name)

Constructs an Empty, named EdifCellInstance Object.

Parameters:

name - The Object that holds name information for this EdifCellInstance Object

EdifCellInstance

public EdifCellInstance(java.lang.String name,
                        EdifCell parent)

Constucts a typeless, named EdifCellInstace Object with the specified parent.

Parameters:

name - The name of this EdifCellInstance Object

parent - The EdifCell Object that contains this EdifCellInstace

EdifCellInstance

public EdifCellInstance(EdifNameable name,
                        EdifCell parent)

Constucts a typeless, named EdifCellInstace Object with the specified parent.

Parameters:

name - The Object that holds name information for this EdifCellInstance Object

parent - The EdifCell Object that contains this EdifCellInstace

EdifCellInstance

public EdifCellInstance(java.lang.String name,
                        EdifCell parent,
                        EdifCell type)

Constructs a typed, named EdifCellInstace Object with the specified parent.

Parameters:

name - The name of this EdifCellInstance Object

parent - The EdifCell Object that contains this EdifCellInstace

type - The type of this EdifCellInstance Object, or the EdifCell Object that this EdifCellInstance is instancing

EdifCellInstance

public EdifCellInstance(EdifNameable name,
                        EdifCell parent,
                        EdifCell type)

Constructs a typed, named EdifCellInstace Object with the specified parent.

Parameters:

name - The Object that holds name information for this EdifCellInstance Object

parent - The EdifCell Object that contains this EdifCellInstace

type - The type of this EdifCellInstance Object, or the EdifCell Object that this EdifCellInstance is instancing

Method Detail

copy

public EdifCellInstance copy(EdifCell parent)

Returns a deep copy of this EdifCellInstance using the passed-in EdifCell as the parent. All new Objects are created using the 'new' statement, except Strings.

Parameters:

parent - The EdifCell that will contain the new EdifCellInstance

Returns:

A new EdifCellInstance Object

copy

public EdifCellInstance copy()

getOuterNets

public java.util.Map getOuterNets()

This method will determine the parent cell of an EdifCellInstance and search through the nets of this parent cell. Those nets that connect to the given EdifCellInstance are returned as a List. These nets are termed "outer nets" because they are the "outside" nets that connect to a given instance of a particular cell.

Returns:

A Map where the key is a EdifSingleBitPort of the instance and the value is the EdifNet Object connected to single-bit port.

getInnerNets

public java.util.Map getInnerNets()

getOuterEPRs

public java.util.Map getOuterEPRs()

Returns:

A Map where the key is a EdifSingleBitPort of the instance and the value is the EdifPortRef Object connected to single-bit port.

getEdifCellInstanceNet

public EdifNet getEdifCellInstanceNet(EdifSingleBitPort esbp)

This method will determine the parent cell of this instance and search through the nets of this parent cell for that net that connects to the EdifSingleBitPort specified as the parameter. This method will return null if no net exists or if the EdifSingleBit port is not owned by the cell type of this instance.

Parameters:

esbp -

Returns:

The EdifNet object that is connected to the given EdifSingleBitPort. Returns null when there is no net connected to this port or when the port is not owned by the cellType of this instance.

getAllPortRefs

public java.util.Map getAllPortRefs()

This method will determine the parent cell of an EdifCellInstance and search through the nets of this parent cell. Those nets that connect to the given EdifCellInstance are returned as a Map. The value is the EdifPortRef and the Value is the EdifNet.

Returns:

A Map object that contains a mapping between EdifPortRef Objects of this EdifCellInstance Object and EdifNet Objects that connect to EdifPortRefs of this EdifCellInstance Object TODO: a Map is not necessary here (The EPR has all of the information in the Map). Return a Collection of EPRs instead.

getCellType

public EdifCell getCellType()

Returns the cell that this EdifCellInstance object is referring to.

Returns:

An EdifCell Object Referring to the type of this EdifCellInstance, or the EdifCell that this EdifCellInstance is instancing

getHierarchicalPrimitiveList

public java.util.Collection getHierarchicalPrimitiveList()

Returns a Collection of List objects for each primitive instance within the hierarchy of this cell instance.

Returns:

A Collection of hierarchical primitives

getParent

public EdifCell getParent()

Returns the parent cell that is referring to the cell that this EdifCellInstance object is referring to.

Returns:

The EdifCell Object that contains this EdifCellInstance

getPortRef

public EdifPortRef getPortRef(EdifSingleBitPort port)

TODO: Why isn't this method commented? It seems to be broken. (keith)

Parameters:

port -

Returns:

getType

public java.lang.String getType()

Returns the type of this cell as a String.

Returns:

A String representing what type of cell this is.

matchesWithin

public boolean matchesWithin(java.util.Collection instanceList)

Returns true if the current instance matches within the passed-in collection of EdifCellInstance Objects. Equality done by doing a deep compare on the cell types of each instance, and the name of each instance.

Parameters:

instanceList - This EdifCellInstance Object will be compared against all the elements in this passed-in Collection to see if a match exists within the Collection

modifyCellRef

public void modifyCellRef(EdifCell newCellRef)

Modify the internal cell reference used by this EdifCellInstance.

Parameters:

newCellRef - An EdifCell Object--The cell this EdifCellInstance object will now refer to

modifyCellRef

public void modifyCellRef(EdifCell newCellRef,
                          boolean check)

Modify the internal cell reference used by this EdifCellInstance.

Parameters:

newCellRef - An EdifCell Object--The cell this EdifCellInstance object will now refer to

check - If true, will check to see if the interfaces are equal, and if it's ok to make the switch. For speed, and if it's known that the match will succeed, use false

setParent

void setParent(EdifCell p)

Sets the parent cell that is referring to the cell this EdifCellInstance object is referring to.

Parameters:

p - An EdifCell Object--The parent referring to the cell of this EdifCellInstance.

toEdif

public void toEdif(EdifPrintWriter epw)

Writes the EDIF representation of this EdifCellInstance object to the EdifPrintWriter passed as a parameter.

Specified by:

toEdif in interface EdifOut

Parameters:

epw - EdifPrintWriter to which EDIF will be written

toString

public java.lang.String toString()

Returns a String representation of the EdifCellInstance object. This simply corresponds to the name of the EdifCellInstance and its type.

Overrides:

toString in class java.lang.Object

Returns:

String description of the EdifCell object