SST  10.0.0
StructuralSimulationToolkit
SST::Link Class Reference

Link between two components. More...

#include <link.h>

Inheritance diagram for SST::Link:
SST::SelfLink

Public Member Functions

 Link (LinkId_t id)
 Create a new link with a given ID.
 
void addSendLatency (int cycles, const std::string &timebase)
 Set additional Latency to be added to events being sent out of this link. More...
 
void addSendLatency (SimTime_t cycles, TimeConverter *timebase)
 Set additional Latency to be added to events being sent out of this link. More...
 
void addRecvLatency (int cycles, const std::string &timebase)
 Set additional Latency to be added on to events coming in on this link. More...
 
void addRecvLatency (SimTime_t cycles, TimeConverter *timebase)
 Set additional Latency to be added on to events coming in on this link. More...
 
void setFunctor (Event::HandlerBase *functor)
 Set the callback function to be called when a message is delivered. More...
 
void setPolling ()
 Specifies that this link has no callback, and is poll-based only.
 
void send (SimTime_t delay, TimeConverter *tc, Event *event)
 Send an event over the link with additional delay. More...
 
void send (SimTime_t delay, Event *event)
 Send an event with additional delay. More...
 
void send (Event *event)
 Send an event with the Link's default delay. More...
 
Eventrecv ()
 Retrieve a pending event from the Link. More...
 
void setDefaultTimeBase (TimeConverter *tc)
 Manually set the default detaulTimeBase. More...
 
TimeConvertergetDefaultTimeBase ()
 Return the default Time Base for this link.
 
void deliverEvent (Event *event) const
 Causes an event to be delivered to the registered callback.
 
LinkId_t getId ()
 Return the ID of this link.
 
void sendUntimedData (Event *data)
 Send data during the init() phase. More...
 
EventrecvUntimedData ()
 Receive an event (if any) during the init() phase.
 
void sendInitData (Event *init_data)
 Send data during the complete() phase. More...
 
EventrecvInitData ()
 Receive an event (if any) during the complete() phase.
 
void setAsConfigured ()
 
bool isConfigured ()
 

Protected Attributes

ActivityQueuerecvQueue
 Queue of events to be received by the owning component.
 
ActivityQueueuntimedQueue
 Queue of events to be received during init by the owning component.
 
ActivityQueueconfiguredQueue
 Currently active Queue.
 
Event::HandlerBaserFunctor
 Receive functor. More...
 
TimeConverterdefaultTimeBase
 Timebase used if no other timebase is specified. More...
 
SimTime_t latency
 Latency of the link. More...
 
Linkpair_link
 Pointer to the opposite side of this link.
 

Static Protected Attributes

static ActivityQueueuninitQueue = new UninitializedQueue("ERROR: Trying to send or recv from link during initialization. Send and Recv cannot be called before setup.")
 Uninitialized queue. More...
 
static ActivityQueueafterInitQueue = new UninitializedQueue("ERROR: Trying to call sendUntimedData/sendInitData or recvUntimedData/recvInitData during the run phase.")
 Uninitialized queue. More...
 
static ActivityQueueafterRunQueue = new UninitializedQueue("ERROR: Trying to call send or recv during complete phase.")
 Uninitialized queue. More...
 

Friends

class LinkPair
 
class NewRankSync
 
class NewThreadSync
 
class Simulation
 
class SyncBase
 
class ThreadSync
 
class SyncManager
 
class ComponentInfo
 

Detailed Description

Link between two components.

Carries events

Member Function Documentation

void SST::Link::addRecvLatency ( int  cycles,
const std::string &  timebase 
)

Set additional Latency to be added on to events coming in on this link.

Parameters
cyclesNumber of Cycles to be added
timebaseBase Units of cycles

References SST::TimeLord::getSimCycles(), SST::Simulation::getSimulation(), SST::Simulation::getTimeLord(), latency, and pair_link.

void SST::Link::addRecvLatency ( SimTime_t  cycles,
TimeConverter timebase 
)

Set additional Latency to be added on to events coming in on this link.

Parameters
cyclesNumber of Cycles to be added
timebaseBase Units of cycles

References SST::TimeConverter::convertToCoreTime(), latency, and pair_link.

void SST::Link::addSendLatency ( int  cycles,
const std::string &  timebase 
)

Set additional Latency to be added to events being sent out of this link.

Parameters
cyclesNumber of Cycles to be added
timebaseBase Units of cycles

References SST::TimeLord::getSimCycles(), SST::Simulation::getSimulation(), SST::Simulation::getTimeLord(), and latency.

void SST::Link::addSendLatency ( SimTime_t  cycles,
TimeConverter timebase 
)

Set additional Latency to be added to events being sent out of this link.

Parameters
cyclesNumber of Cycles to be added
timebaseBase Units of cycles

References SST::TimeConverter::convertToCoreTime(), and latency.

Event * SST::Link::recv ( )

Retrieve a pending event from the Link.

For links which do not have a set event handler, they can be polled with this function. Returns nullptr if there is no pending event.

References SST::ActivityQueue::empty(), SST::Output::fatal(), SST::ActivityQueue::front(), SST::Simulation::getCurrentSimCycle(), SST::Activity::getDeliveryTime(), SST::Simulation::getSimulation(), SST::Simulation::getSimulationOutput(), SST::ActivityQueue::pop(), and recvQueue.

void SST::Link::send ( SimTime_t  delay,
TimeConverter tc,
Event event 
)

Send an event over the link with additional delay.

Sends an event over a link with an additional delay specified with a TimeConverter. I.e. the total delay is the link's delay + the additional specified delay.

Parameters
delay- additional delay
tc- time converter to specify units for the additional delay
event- the Event to send

References SST::TimeConverter::convertToCoreTime(), SST::Output::fatal(), SST::Simulation::getCurrentSimCycle(), SST::Simulation::getSimulation(), SST::Simulation::getSimulationOutput(), SST::ActivityQueue::insert(), latency, pair_link, and recvQueue.

Referenced by send().

void SST::Link::send ( SimTime_t  delay,
Event event 
)
inline

Send an event with additional delay.

Sends an event over a link with additional delay specified by the Link's default timebase.

Parameters
delayThe additional delay, in units of the default Link timebase
eventThe event to send

References defaultTimeBase, and send().

void SST::Link::send ( Event event)
inline

Send an event with the Link's default delay.

Parameters
eventThe event to send

References send().

void SST::Link::sendInitData ( Event init_data)
inline

Send data during the complete() phase.

References sendUntimedData().

Referenced by SST::Interfaces::SimpleMem::sendInitData().

void SST::Link::sendUntimedData ( Event data)
void SST::Link::setDefaultTimeBase ( TimeConverter tc)

Manually set the default detaulTimeBase.

Parameters
tcTimeConverter object for the timebase

References defaultTimeBase.

Referenced by SST::BaseComponent::configureLink(), and SST::Simulation::performWireUp().

void SST::Link::setFunctor ( Event::HandlerBase functor)
inline

Set the callback function to be called when a message is delivered.

References rFunctor.

Referenced by SST::BaseComponent::configureLink().

Field Documentation

ActivityQueue * SST::Link::afterInitQueue = new UninitializedQueue("ERROR: Trying to call sendUntimedData/sendInitData or recvUntimedData/recvInitData during the run phase.")
staticprotected

Uninitialized queue.

Used for error detection

ActivityQueue * SST::Link::afterRunQueue = new UninitializedQueue("ERROR: Trying to call send or recv during complete phase.")
staticprotected

Uninitialized queue.

Used for error detection

TimeConverter* SST::Link::defaultTimeBase
protected

Timebase used if no other timebase is specified.

Used to specify the units for added delays when sending, such as in Link::send(). Often set by the Component::registerClock() function if the regAll argument is true.

Referenced by getDefaultTimeBase(), send(), and setDefaultTimeBase().

SimTime_t SST::Link::latency
protected

Latency of the link.

It is used by the partitioner as the weight. This latency is added to the delay put on the event by the component.

Referenced by addRecvLatency(), addSendLatency(), and send().

Event::HandlerBase* SST::Link::rFunctor
protected

Receive functor.

This functor is set when the link is connected. Determines what the receiver wants to be called

Referenced by setFunctor().

ActivityQueue * SST::Link::uninitQueue = new UninitializedQueue("ERROR: Trying to send or recv from link during initialization. Send and Recv cannot be called before setup.")
staticprotected

Uninitialized queue.

Used for error detection

Referenced by Link().


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