TTAMachine::BaseFUPort Class Reference

#include <BaseFUPort.hh>

Inheritance diagram for TTAMachine::BaseFUPort:

Collaboration diagram for TTAMachine::BaseFUPort:

Public Member Functions
virtual	~BaseFUPort ()
FunctionUnit *	parentUnit () const
virtual int	width () const
void	setWidth (int width)
virtual bool	isTriggering () const =0
virtual bool	isOpcodeSetting () const =0
virtual ObjectState *	saveState () const
virtual void	loadState (const ObjectState *state)
Public Member Functions inherited from TTAMachine::Port
	Port (const std::string &name, Unit &parentUnit)
	Port (const ObjectState *state, Unit &parentUnit)
virtual	~Port ()
virtual std::string	name () const
virtual void	setName (const std::string &name)
virtual void	attachSocket (Socket &socket)
virtual void	detachSocket (Socket &socket)
virtual void	detachAllSockets ()
Unit *	parentUnit () const
virtual Socket *	inputSocket () const
virtual Socket *	outputSocket () const
virtual Socket *	unconnectedSocket (int index) const
virtual int	socketCount () const
virtual bool	isConnectedTo (const Socket &socket) const
virtual bool	isOutput () const
virtual bool	isInput () const
Public Member Functions inherited from Serializable
virtual	~Serializable ()

Static Public Attributes
static const std::string	OSKEY_WIDTH = "width"
	ObjectState attribute key for bit width of the port.
Static Public Attributes inherited from TTAMachine::Port
static const std::string	OSNAME_PORT = "port"
	ObjectState name for Port.
static const std::string	OSKEY_NAME = "name"
	ObjectState attribute key for the name of the port.
static const std::string	OSKEY_FIRST_SOCKET = "1_socket"
	ObjectState attribute key for the name of the connected socket.
static const std::string	OSKEY_SECOND_SOCKET = "2_socket"
	ObjectState attribute key for the name of the other connected socket.

Protected Member Functions
	BaseFUPort (const std::string &name, int width, FunctionUnit &parent)
	BaseFUPort (const ObjectState *state, Unit &parent)
Protected Member Functions inherited from TTAMachine::Port
	Port (const std::string &name, FunctionUnit &parentUnit)
Protected Member Functions inherited from TTAMachine::SubComponent
	SubComponent ()
virtual	~SubComponent ()
Protected Member Functions inherited from TTAMachine::MachinePart
	MachinePart ()
virtual	~MachinePart ()

Private Member Functions
void	loadStateWithoutReferences (const ObjectState *state)

Private Attributes
int	width_
	Bit width of the port.

Detailed Description

BaseFUPort is an abstract base class for FUPort and SpecialRegisterPort classes.

Definition at line 44 of file BaseFUPort.hh.

Constructor & Destructor Documentation

~BaseFUPort()

TTAMachine::BaseFUPort::~BaseFUPort ( )

virtual

The destructor.

Definition at line 84 of file BaseFUPort.cc.

                        {
}

BaseFUPort() [1/2]

TTAMachine::BaseFUPort::BaseFUPort ( const std::string &  name, int  width, FunctionUnit &  parent  )

protected

The constructor.

Parameters

name	Name of the port.
width	Bit width of the port.
parent	The function unit to which the port belongs.

Exceptions

InvalidName	If the given name is not a valid component name.
ComponentAlreadyExists	If the function unit already has another port by the same name or another port that sets operation code.
OutOfRange	If the given bit width is less or equal to zero.

Definition at line 58 of file BaseFUPort.cc.

    : Port(name, *static_cast<Unit*>(&parent)), width_(width) {
    if (width <= 0) {
        string procName = "BaseFUPort::BaseFUPort";
        throw OutOfRange(__FILE__, __LINE__, procName);
    }
}

References width().

Here is the call graph for this function:

BaseFUPort() [2/2]

TTAMachine::BaseFUPort::BaseFUPort ( const ObjectState *  state, Unit &  parent  )

protected

The constructor.

Loads the state of the object from the given ObjectState tree.

Parameters

state	The ObjectState tree.
Unit	The parent unit of the port.

Exceptions

ObjectStateLoadingException

If an error occurs while loading the state.

Definition at line 76 of file BaseFUPort.cc.

    : Port(state, parent) {
    loadStateWithoutReferences(state);
}

References loadStateWithoutReferences().

Here is the call graph for this function:

Member Function Documentation

isOpcodeSetting()

virtual bool TTAMachine::BaseFUPort::isOpcodeSetting ( ) const

pure virtual

Implemented in TTAMachine::FUPort, and TTAMachine::SpecialRegisterPort.

Referenced by BEMGenerator::addPortCodes(), MachineStateBuilder::addPortToFU(), MachineStateBuilder::addVirtualOpcodeSettingPortsToFU(), BEMValidator::checkSocketCodeTable(), TTAProgram::TerminalFUPort::equals(), HDBToHtml::fuArchToHtml(), TTAMachine::FUPort::FUPort(), TTAProgram::TerminalFUPort::isOpcodeSetting(), TTAMachine::FUPort::loadStateWithoutReferences(), BEMValidator::needsSocketCodeTable(), TTAProgram::TerminalFUPort::operation(), FUTestbenchGenerator::parseFuPorts(), SimProgramBuilder::processBidirTerminal(), TTAProgram::TerminalFUPort::TerminalFUPort(), and DefaultDecoderGenerator::writeControlRulesOfFUInputPort().

isTriggering()

virtual bool TTAMachine::BaseFUPort::isTriggering ( ) const

pure virtual

Implemented in TTAMachine::FUPort, and TTAMachine::SpecialRegisterPort.

Referenced by ProgrammabilityValidator::addConnectionToProgram(), MachineStateBuilder::addPortToFU(), UtilizationStats::calculateForInstruction(), DefaultDecoderGenerator::completeDecoderBlock(), ProgrammabilityValidator::findConnections(), HDBToHtml::fuArchToHtml(), TTAProgram::TerminalFUPort::isTriggering(), ProgrammabilityValidator::printConnection(), TTAMachine::FUPort::setTriggering(), ExecutionPipelineBroker::setupResourceLinks(), ProgramOperation::triggeringMove(), GCUDialog::updatePortList(), and DefaultDecoderGenerator::writeControlRegisterMappings().

loadState()

void TTAMachine::BaseFUPort::loadState ( const ObjectState *  state )

virtual

Loads the state of the function unit port from the given ObjectState instance.

Parameters

state

The ObjectState instance.

Exceptions

ObjectStateLoadingException

If the given ObjectState instance is invalid or if connections to socket cannot be made.

Reimplemented from TTAMachine::Port.

Reimplemented in TTAMachine::FUPort, TTAMachine::SpecialRegisterPort, and UniversalFUPort.

Definition at line 153 of file BaseFUPort.cc.

                                              {
    loadStateWithoutReferences(state);
    Port::loadState(state);
}

References TTAMachine::Port::loadState(), and loadStateWithoutReferences().

Referenced by TTAMachine::FUPort::loadState(), and TTAMachine::SpecialRegisterPort::loadState().

Here is the call graph for this function:

loadStateWithoutReferences()

void TTAMachine::BaseFUPort::loadStateWithoutReferences ( const ObjectState *  state )

private

Loads its state from the given ObjectState instance but does not create connections to sockets.

Parameters

state

The ObjectState instance.

Exceptions

ObjectStateLoadingException

If the given ObjectState instance is invalid.

Definition at line 167 of file BaseFUPort.cc.

                                                               {
    const string procName = "BaseFUPort::loadStateWithoutReferences";
 
    try {
        setWidth(state->intAttribute(OSKEY_WIDTH));
    } catch (const Exception& e) {
        throw ObjectStateLoadingException(
            __FILE__, __LINE__, procName, e.errorMessage());
    }
}

References Exception::errorMessage(), ObjectState::intAttribute(), OSKEY_WIDTH, and setWidth().

Referenced by BaseFUPort(), and loadState().

Here is the call graph for this function:

parentUnit()

FunctionUnit * TTAMachine::BaseFUPort::parentUnit

(

)

const

Returns the parent function unit of the port.

Returns NULL in case not registered to a function unit.

Returns

The parent function unit of the port.

Definition at line 96 of file BaseFUPort.cc.

                             {
    Unit* parentUnit = Port::parentUnit();
    FunctionUnit* fu = dynamic_cast<FunctionUnit*>(parentUnit);
    return fu;
}

References parentUnit(), and TTAMachine::Port::parentUnit().

Referenced by BEMGenerator::addEncodings(), MachineStateBuilder::addPortToFU(), MachineStateBuilder::addVirtualOpcodeSettingPortsToFU(), ImmediateAnalyzer::analyzeImmediateCapabilitiesForOperation(), TTAMachine::HWOperation::bindPort(), MachineStateBuilder::buildMachineState(), UtilizationStats::calculateForInstruction(), BEMValidator::checkGuardField(), TTAMachine::FunctionUnit::cleanupGuards(), TTAMachine::FUPort::cleanupOperandBindings(), FullyConnectedCheck::connectFUPort(), FullyConnectedCheck::connectSpecialRegisterPort(), ADFCombiner::copyGuards(), TTAProgram::ProgramWriter::createCodeSection(), POMDisassembler::createGuard(), ProximFUPortDetailsCmd::Do(), InterpolatingFUEstimator::estimatePortReadDelay(), InterpolatingFUEstimator::estimatePortWriteDelay(), DefaultDecoderGenerator::findGuard(), TTAProgram::TerminalFUPort::findNewOperationIndex(), MachineConnectivityCheck::findPossibleDestinationPorts(), ProgramOperation::fuFromOutMove(), TTAProgram::TerminalFUPort::functionUnit(), CostEstimator::Estimator::functionUnitPortReadDelay(), CostEstimator::Estimator::functionUnitPortWriteDelay(), CompiledSimCodeGenerator::generateAddFUResult(), DefaultDecoderGenerator::guardPortName(), TTAMachine::FUPort::loadStateWithoutReferences(), CostEstimator::Estimator::longestPath(), BEMGenerator::needsSocketCodeTable(), FUPortDialog::onOK(), SRPortDialog::onOK(), FUPortDialog::onSocketChoice(), SRPortDialog::onSocketChoice(), BFLateBypassGuard::operator()(), BFEarlyGuardBypass::operator()(), parentUnit(), TTAMachine::PortGuard::PortGuard(), TTAMachine::PortGuard::PortGuard(), BF2Scheduler::preAllocateFunctionUnits(), BF2Scheduler::releasePortForOp(), BF2Scheduler::reservePreallocatedFUs(), TTAMachine::PortGuard::saveState(), TTAMachine::ControlUnit::setReturnAddressPort(), TTAMachine::FUPort::setTriggering(), MachineInfo::supportsPortGuardedJump(), ProGe::RV32MicroCodeGenerator::throwInputPortError(), ProGe::RV32MicroCodeGenerator::throwOutputPortError(), ProGe::RV32MicroCodeGenerator::throwTriggeringPortError(), FUPortImplementationDialog::TransferDataToWindow(), FUGuardDialog::TransferDataToWindow(), ProgramOperation::triggeringMove(), TTAMachine::FUPort::updateBindingString(), BusDialog::updateGuardLists(), FUPortDialog::updateSockets(), SRPortDialog::updateSockets(), DefaultDecoderGenerator::writeControlRulesOfFUInputPort(), and DefaultDecoderGenerator::writeControlRulesOfFUOutputPort().

Here is the call graph for this function:

saveState()

ObjectState * TTAMachine::BaseFUPort::saveState ( ) const

virtual

Saves the contents of the function unit port to an ObjectState object.

Returns

The newly created ObjectState object.

Reimplemented from TTAMachine::Port.

Reimplemented in TTAMachine::FUPort, and TTAMachine::SpecialRegisterPort.

Definition at line 136 of file BaseFUPort.cc.

                            {
    ObjectState* fuPort = Port::saveState();
    fuPort->setAttribute(OSKEY_WIDTH, width_);
    return fuPort;
}

References OSKEY_WIDTH, TTAMachine::Port::saveState(), ObjectState::setAttribute(), and width_.

Referenced by TTAMachine::FUPort::saveState(), and TTAMachine::SpecialRegisterPort::saveState().

Here is the call graph for this function:

setWidth()

void TTAMachine::BaseFUPort::setWidth

(

int

width

)

Sets the bit width of the port.

Parameters

width

The new bit width.

Exceptions

OutOfRange

If the given bit width is less or equal to zero.

Definition at line 121 of file BaseFUPort.cc.

                              {
    if (width <= 0) {
        string procName = "FUPort::setWidth";
        throw OutOfRange(__FILE__, __LINE__, procName);
    }
 
    width_ = width;
}

References width(), and width_.

Referenced by ProGe::NetlistGenerator::addFUToNetlist(), ProGe::ProcessorGenerator::iMemAddressWidth(), loadStateWithoutReferences(), FUPortDialog::onOK(), and SRPortDialog::onOK().

Here is the call graph for this function:

width()

int TTAMachine::BaseFUPort::width ( ) const

virtual

Returns the bit width of the port.

Returns

Bit width of the port.

Implements TTAMachine::Port.

Definition at line 109 of file BaseFUPort.cc.

                        {
    return width_;
}

References width_.

Referenced by HDB::HDBManager::addFUArchitecture(), ProGe::NetlistGenerator::addFUToNetlist(), MachineStateBuilder::addPortToFU(), BaseFUPort(), OpsetDialog::bindPorts(), CostDatabase::buildFunctionUnits(), MachineValidator::checkIMemAddrWidth(), MachineValidator::checkRAPortHasSameWidthAsPCPort(), FUGen::createMandatoryPorts(), OpsetDialog::createOperation(), FUGen::createOutputPipeline(), FUGen::createPortPipeline(), InterpolatingFUEstimator::createSearch(), FUGen::createShadowRegisters(), FUTestbenchGenerator::createStimulusArrays(), FUTestbenchGenerator::createTbInstantiation(), UniversalFunctionUnit::ensureInputPorts(), UniversalFunctionUnit::ensureOutputPorts(), ComponentImplementationSelector::fuArchsByOpSetWithMinLatency(), HDBToHtml::fuArchToHtml(), ProGeTestBenchGenerator::generate(), CompiledSimCodeGenerator::generateHeaderAndMainCode(), CompiledSimCodeGenerator::handleOperationWithoutDag(), ProGe::ProcessorGenerator::iMemAddressWidth(), TTAMachine::FUPort::isArchitectureEqual(), HDB::HDBManager::isMatchingArchitecture(), HDB::FUArchitecture::operator==(), UniversalFunctionUnit::portCountWithWidth(), UniversalFunctionUnit::portWithWidth(), ProGe::ProGeUI::readImemParameters(), PlatformIntegrator::readLsuParameters(), FUGen::scheduleOperations(), setWidth(), FUPortDialog::TransferDataToWindow(), SRPortDialog::TransferDataToWindow(), FUDialog::updatePortList(), and GCUDialog::updatePortList().

Member Data Documentation

OSKEY_WIDTH

const string TTAMachine::BaseFUPort::OSKEY_WIDTH = "width"

static

ObjectState attribute key for bit width of the port.

Definition at line 60 of file BaseFUPort.hh.

Referenced by loadStateWithoutReferences(), and saveState().

width_

int TTAMachine::BaseFUPort::width_

private

Bit width of the port.

Definition at line 70 of file BaseFUPort.hh.

Referenced by saveState(), setWidth(), and width().

---

The documentation for this class was generated from the following files:

• BaseFUPort.hh
• BaseFUPort.cc