byucc.edif
Class EdifCellInterface

java.lang.Object
  byucc.edif.EdifCellInterface

All Implemented Interfaces:

EdifOut, Trimable, java.io.Serializable

public class EdifCellInterface
extends java.lang.Object
implements EdifOut, Trimable, java.io.Serializable

Represents the port interface of an EdifCell object.

Version:

$Id: EdifCellInterface.java,v 1.47 2005/06/06 21:53:40 wirthlin Exp $

Author:

Mike Wirthlin, Tyler Anderson

See Also:

Serialized Form

Field Summary

private EdifCell	_parent Parent EdifCell that owns this interface
private ArrayListNameSpaceResolver	_portList This List is used to hold all the EdifPort objects of the interface

Constructor Summary

EdifCellInterface(EdifCell parent)
Constructs an Empty EdifCellInterface Object with the passed-in EdifCell object as its parent.

Method Summary

EdifPort	addPort(EdifNameable name, int width, int direction) Adds a new port to the EdifCellInterface.
EdifPort	addPort(java.lang.String name, int width, int direction) Adds a new port to the EdifCellInterface.
boolean	contains(EdifPort contain) Checks to see if the passed-in EdifPort is already contained within this EdifCellInterface.
boolean	contains(EdifSingleBitPort esbp) Checks to see if the EdifSingleBitPort is containted within the interface.
EdifCellInterface	copy(EdifCell parent) Returns a deep copy of this EdifCellInterface Object.
void	deletePort(EdifPort port) Removes a port from this EdifCellInterface.
boolean	equals(EdifCellInterface cell) Determines whether the given EdifCell object matches the interface of the current EdifCell object.
static java.util.Collection	findMatchingSingleBitPorts(EdifPort busPort, EdifCellInterface cellIf) This method will search the passed in EdifCellInterface object for single-bit EdifPort objects that have a name that begins with the name provided by the passed in busPort.
EdifCell	getEdifCell() Return the parent EdifCell that owns this object.
java.util.Collection	getInOutPorts() Returns a Collection of only inout ports.
java.util.Collection	getInputOnlyPorts() Returns a Collection of only input ports.
java.util.Collection	getInputPorts() Returns a Collection of input and inout ports.
EdifPort	getMatchingPort(EdifPort port) Returns a port contained within this EdifCellInterface that matches the passed-in port by calling EdifPort.equals(EdifPort).
java.util.Collection	getOutputOnlyPorts() Returns a Collection of only output ports.
java.util.Collection	getOutputPorts() Returns a Collection of output and inout ports.
EdifPort	getPort(java.lang.String name) Returns the EdifPort object which defines a port on the current EdifCell object and corresponds to the given name.
java.util.List	getPortList() Returns a Collection containing all of the EdifPort objects currently associated with this EdifCell object.
java.util.Collection	getSingleBitPortCollection()
java.util.Collection	getSortedPortList() Returns a sorted Collection containing all of the EdifPort objects currently associated with this EdifCell object.
int	getTotalInoutBits()
int	getTotalInputOnlyBits()
int	getTotalInterfaceBits()
int	getTotalOutputOnlyBits()
boolean	portCountEquals(EdifCellInterface cell) Returns true if the # of output, input, and inout ports match for the current and passed-in cell interfaces.
void	toEdif(EdifPrintWriter epw) Writes the EDIF representation of this EdifCell object to the EdifPrintWriter passed as a parameter.
java.lang.String	toString()
void	trimToSize() Trims this object and all other contained Trimmable Objects down to size.

Methods inherited from class java.lang.Object

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

Field Detail

_portList

private ArrayListNameSpaceResolver _portList

This List is used to hold all the EdifPort objects of the interface

_parent

private EdifCell _parent

Parent EdifCell that owns this interface

Constructor Detail

EdifCellInterface

public EdifCellInterface(EdifCell parent)

Constructs an Empty EdifCellInterface Object with the passed-in EdifCell object as its parent.

Parameters:

parent - The parent EdifCell Object, or owner if this EdifCellInterface

Method Detail

addPort

public EdifPort addPort(EdifNameable name,
                        int width,
                        int direction)

Adds a new port to the EdifCellInterface. Returns null if the port wasn't added (most likely due to a name clash).

Parameters:

name - The name of the new port to add

width - The width of the new port to add

direction - The direction of the new port to add

Returns:

The port that was added, if it wasn't, null

addPort

public EdifPort addPort(java.lang.String name,
                        int width,
                        int direction)

Adds a new port to the EdifCellInterface. Returns null if the port wasn't added (most likely due to a name clash).

Parameters:

name - The name of the new port to add

width - The width of the new port to add

direction - The direction of the new port to add

Returns:

The port that was added, if it wasn't, null

contains

public boolean contains(EdifPort contain)

Checks to see if the passed-in EdifPort is already contained within this EdifCellInterface. Equality is done using ==.

Parameters:

contain - The EdifPort to compare against the EdifPort Objects contained within this EdifCellInterface Object to check to see if it already exists in this EdifCellInterface

Returns:

True if the passed-in EdifPort is already contained within this EdifCellInterface Object

contains

public boolean contains(EdifSingleBitPort esbp)

Checks to see if the EdifSingleBitPort is containted within the interface. This method operates by calling EdifCellInterface.contains on the parent of the single-bit port.

Parameters:

esbp -

Returns:

true if the passed-in EdifSingleBitPort is owned by a EdifPort object contained in this interface.

copy

public EdifCellInterface copy(EdifCell parent)

Returns a deep copy of this EdifCellInterface Object. All copies are done using the 'new' statement, except String Objects.

Parameters:

parent - The EdifCell that will be the parent to this copy

Returns:

The copied EdifCellInterface Object

deletePort

public void deletePort(EdifPort port)

Removes a port from this EdifCellInterface.

Parameters:

port - The port to remove

equals

public boolean equals(EdifCellInterface cell)

Determines whether the given EdifCell object matches the interface of the current EdifCell object. To make this test, each port is compared for equality. Two EdifCell port interfaces are the same if each of the following conditions are met:

• The number of ports in each interface is the same.
• A matching port in the passed in EdifCell is found for each port in this EdifCell (see EdifPort.equals(byucc.edif.EdifPort)).

The internal structure of the two EdifCell objects are not checked for equality.

Parameters:

cell - EdifCell object to compare against the current EdifCell object

comparePossibleBus - Allows that the case when one port is a bus and the other port isn't or vice versa to be considered for interface equality

ignoreBusDirection - If true, the direction of the individual ports will be ignored

Returns:

boolean indicating whether the two EdifCell objects have equivalent port interfaces

findMatchingSingleBitPorts

public static java.util.Collection findMatchingSingleBitPorts(EdifPort busPort,
                                                              EdifCellInterface cellIf)

This method will search the passed in EdifCellInterface object for single-bit EdifPort objects that have a name that begins with the name provided by the passed in busPort. If there is a match, a collection of the matching single bit EdifPort objects will be returned. A match will only occur when the following are true: 1) The prefix of each single bit port is the same as the multi-bit port 2) Each single bit port can be identified as a valid "bus signal" 3) The number of single-bit ports is the same as the number of bits in the multi-bit port

Parameters:

busPort - A EdifPort object that is multiple bits (i.e. a bus). The full name of this Port will be used to find matching single-bit EdifPort objects.

cellIf - The EdifCellInterface object that will be searched.

Returns:

A Collection of single-bit EdifPort objects that correspond to the given multi-bit EdifPort. A null will be returned if a complete match did not occur.

getEdifCell

public EdifCell getEdifCell()

Return the parent EdifCell that owns this object.

Returns:

An EdifCell Object that is the parent to this EdifCellInterface

getPort

public EdifPort getPort(java.lang.String name)

Returns the EdifPort object which defines a port on the current EdifCell object and corresponds to the given name. If no such EdifPort is found, a null object is returned.

Parameters:

name - A string indicating the name of the EdifPort object desired to be found

Returns:

The EdifPort corresponding to the passed-in port

getMatchingPort

public EdifPort getMatchingPort(EdifPort port)

Returns a port contained within this EdifCellInterface that matches the passed-in port by calling EdifPort.equals(EdifPort).

Parameters:

port - The EdifPort Object to match within this interface

getInputOnlyPorts

public java.util.Collection getInputOnlyPorts()

Returns a Collection of only input ports.

Returns:

A Collection of Input ports only

getInputPorts

public java.util.Collection getInputPorts()

Returns a Collection of input and inout ports.

Returns:

A Collection of Input and InOut ports

getOutputOnlyPorts

public java.util.Collection getOutputOnlyPorts()

Returns a Collection of only output ports.

Returns:

A Collection of Output ports only

getOutputPorts

public java.util.Collection getOutputPorts()

Returns a Collection of output and inout ports.

Returns:

A Collection of Output and InOut ports

getTotalInterfaceBits

public int getTotalInterfaceBits()

Returns:

The total number of bits in this interface. This is the sum of the port width of each port in the interface.

getTotalInputOnlyBits

public int getTotalInputOnlyBits()

getTotalOutputOnlyBits

public int getTotalOutputOnlyBits()

getTotalInoutBits

public int getTotalInoutBits()

getInOutPorts

public java.util.Collection getInOutPorts()

Returns a Collection of only inout ports.

Returns:

A Collection of InOut ports

getPortList

public java.util.List getPortList()

Returns a Collection containing all of the EdifPort objects currently associated with this EdifCell object.

Returns:

Collection containing the EdifPort objects associated with the current EdifCell object

getSingleBitPortCollection

public java.util.Collection getSingleBitPortCollection()

getSortedPortList

public java.util.Collection getSortedPortList()

Returns a sorted Collection containing all of the EdifPort objects currently associated with this EdifCell object. The objects in the Collection are sorted by their names.

Returns:

sorted Collection containing the EdifPort objects associated with the current EdifCell object

portCountEquals

public boolean portCountEquals(EdifCellInterface cell)

Returns true if the # of output, input, and inout ports match for the current and passed-in cell interfaces.

Parameters:

cell - The interface used for comparison

Returns:

True if the # of each type of port that exists in each cell is the same

toEdif

public void toEdif(EdifPrintWriter epw)

Writes the EDIF representation of this EdifCell 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()

Overrides:

toString in class java.lang.Object

trimToSize

public void trimToSize()

Trims this object and all other contained Trimmable Objects down to size.

Specified by:

trimToSize in interface Trimable