INET Framework for OMNeT++/OMNEST
inet::EligibilityTimeGate Class Reference

#include <EligibilityTimeGate.h>

Inheritance diagram for inet::EligibilityTimeGate:
inet::ClockUserModuleMixin< PacketGateBase > inet::queueing::PacketGateBase inet::queueing::PacketFlowBase inet::TransparentProtocolRegistrationListener inet::queueing::IPacketGate inet::queueing::PacketProcessorBase inet::queueing::IPacketFlow inet::queueing::IPacketCollection inet::IProtocolRegistrationListener inet::queueing::IPacketProcessor inet::StringFormat::IDirectiveResolver inet::queueing::IPacketSink inet::queueing::IPacketSource inet::queueing::IPassivePacketSink inet::queueing::IActivePacketSink inet::queueing::IPassivePacketSource inet::queueing::IActivePacketSource

Public Member Functions

virtual ~EligibilityTimeGate ()
 
virtual PacketpullPacket (cGate *gate) override
 Pulls the packet from the packet source at the given gate. More...
 
virtual void handleCanPullPacketChanged (cGate *gate) override
 Notifies about a change in the possibility of pulling some packet from the passive packet source at the given gate. More...
 
- Public Member Functions inherited from inet::ClockUserModuleMixin< PacketGateBase >
virtual void scheduleClockEventAt (clocktime_t time, ClockEvent *msg)
 
virtual void scheduleClockEventAfter (clocktime_t delay, ClockEvent *msg)
 
virtual cMessage * cancelClockEvent (ClockEvent *msg)
 
virtual void cancelAndDeleteClockEvent (ClockEvent *msg)
 
virtual void rescheduleClockEventAt (clocktime_t time, ClockEvent *msg)
 
virtual void rescheduleClockEventAfter (clocktime_t time, ClockEvent *msg)
 
virtual clocktime_t computeClockTimeFromSimTime (simtime_t time) const
 
virtual simtime_t computeSimTimeFromClockTime (clocktime_t time) const
 
virtual clocktime_t getClockTime () const
 
virtual clocktime_t getArrivalClockTime (ClockEvent *msg) const
 
- Public Member Functions inherited from inet::queueing::PacketGateBase
virtual bool isOpen () const override
 Returns true if the gate is open. More...
 
virtual bool isClosed () const
 
virtual void open () override
 Opens the gate and starts traffic go through. More...
 
virtual void close () override
 Closes the gate and stops traffic. More...
 
virtual IPassivePacketSinkgetConsumer (cGate *gate) override
 Returns the passive packet sink where packets are pushed or nullptr if the connected module doesn't implement the interface. More...
 
virtual IPassivePacketSourcegetProvider (cGate *gate) override
 Returns the passive packet source from where packets are pulled or nullptr if the connected module doesn't implement the interface. More...
 
virtual bool supportsPacketPushing (cGate *gate) const override
 Returns true if the processor supports pushing packets at the given gate. More...
 
virtual bool supportsPacketPulling (cGate *gate) const override
 Returns true if the processor supports pulling packets at the given gate. More...
 
virtual bool canPushSomePacket (cGate *gate) const override
 Returns false if the packet sink is full at the given gate and no more packets can be pushed into it without raising an error. More...
 
virtual bool canPushPacket (Packet *packet, cGate *gate) const override
 Returns true if the given packet can be pushed at the given gate into the packet sink without raising an error. More...
 
virtual bool canPullSomePacket (cGate *gate) const override
 Returns false if the packet source is empty at the given gate and no more packets can be pulled from it without raising an error. More...
 
virtual PacketcanPullPacket (cGate *gate) const override
 Returns the packet that can be pulled at the given gate. More...
 
virtual void handleCanPushPacketChanged (cGate *gate) override
 Notifies about a change in the possibility of pushing some packet into the passive packet sink at the given gate. More...
 
- Public Member Functions inherited from inet::queueing::PacketFlowBase
virtual bool supportsPacketStreaming (cGate *gate) const override
 Returns true if the processor supports streaming packets at the given gate. More...
 
virtual void pushPacket (Packet *packet, cGate *gate) override
 Pushes the packet into the packet sink at the given gate. More...
 
virtual void pushPacketStart (Packet *packet, cGate *gate, bps datarate) override
 Starts pushing the packet into the packet sink at the given gate. More...
 
virtual void pushPacketEnd (Packet *packet, cGate *gate) override
 Ends pushing the packet into the packet sink at the given gate. More...
 
virtual void pushPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength=b(0)) override
 Progresses pushing the packet into the packet sink at the given gate. More...
 
virtual void handlePushPacketProcessed (Packet *packet, cGate *gate, bool successful) override
 Notifies about the completion of the packet processing for a packet that was pushed earlier independently whether the packet is passed or streamed. More...
 
virtual PacketpullPacketStart (cGate *gate, bps datarate) override
 Starts pulling the packet from the packet source at the given gate. More...
 
virtual PacketpullPacketEnd (cGate *gate) override
 Ends pulling the packet from the packet source at the given gate. More...
 
virtual PacketpullPacketProgress (cGate *gate, bps datarate, b position, b extraProcessableLength) override
 Progresses pulling the packet from the packet source at the given gate. More...
 
virtual void handlePullPacketProcessed (Packet *packet, cGate *gate, bool successful) override
 Notifies about the completion of the packet processing for a packet that was pulled earlier independently whether the packet is passed or streamed. More...
 
virtual int getMaxNumPackets () const override
 Returns maximum allowed number of packets in the collection. More...
 
virtual int getNumPackets () const override
 Returns the number of available packets in the collection in the range [0, inf). More...
 
virtual b getMaxTotalLength () const override
 Returns maximum allowed total length of all packets in the collection. More...
 
virtual b getTotalLength () const override
 Returns the total length of all packets in the collection in the range [0, inf). More...
 
virtual PacketgetPacket (int index) const override
 Returns the packet at the given index. More...
 
virtual bool isEmpty () const override
 Returns true if there are no packets available in the collection. More...
 
virtual void removePacket (Packet *packet) override
 Removes a packet from the collection. More...
 
virtual void removeAllPackets () override
 Removes all packets from the collection. More...
 
- Public Member Functions inherited from inet::queueing::PacketProcessorBase
virtual bool supportsPacketSending (cGate *gate) const override
 Returns true if the processor supports sending packets at the given gate. More...
 
virtual bool supportsPacketPassing (cGate *gate) const override
 Returns true if the processor supports passing packets as a whole at the given gate. More...
 
virtual const char * resolveDirective (char directive) const override
 
- Public Member Functions inherited from inet::queueing::IPacketProcessor
virtual ~IPacketProcessor ()
 
- Public Member Functions inherited from inet::queueing::IPassivePacketSink
virtual ~IPassivePacketSink ()
 
- Public Member Functions inherited from inet::queueing::IActivePacketSink
virtual ~IActivePacketSink ()
 
- Public Member Functions inherited from inet::queueing::IPassivePacketSource
virtual ~IPassivePacketSource ()
 
- Public Member Functions inherited from inet::queueing::IActivePacketSource
virtual ~IActivePacketSource ()
 
- Public Member Functions inherited from inet::TransparentProtocolRegistrationListener
virtual void mapRegistrationForwardingGates (cGate *gate, std::function< void(cGate *)> f)
 
virtual bool isForwardingProtocol (const Protocol &protocol, cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingProtocolGroup (const ProtocolGroup &protocolGroup, cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingAnyProtocol (cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingProtocol (cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingService (const Protocol &protocol, cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingServiceGroup (const ProtocolGroup &protocolGroup, cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingAnyService (cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual bool isForwardingService (cGate *gate, ServicePrimitive servicePrimitive) const
 
virtual void handleRegisterService (const Protocol &protocol, cGate *gate, ServicePrimitive servicePrimitive) override
 
virtual void handleRegisterProtocol (const Protocol &protocol, cGate *gate, ServicePrimitive servicePrimitive) override
 
virtual void handleRegisterServiceGroup (const ProtocolGroup &protocolGroup, cGate *gate, ServicePrimitive servicePrimitive) override
 
virtual void handleRegisterProtocolGroup (const ProtocolGroup &protocolGroup, cGate *gate, ServicePrimitive servicePrimitive) override
 
virtual void handleRegisterAnyService (cGate *gate, ServicePrimitive servicePrimitive) override
 
virtual void handleRegisterAnyProtocol (cGate *gate, ServicePrimitive servicePrimitive) override
 

Static Public Attributes

static simsignal_t remainingEligibilityTimeChangedSignal = cComponent::registerSignal("remainingEligibilityTimeChanged")
 
- Static Public Attributes inherited from inet::queueing::PacketGateBase
static simsignal_t gateStateChangedSignal = registerSignal("gateStateChanged")
 

Protected Member Functions

virtual void initialize (int stage) override
 
virtual void handleMessage (cMessage *message) override
 
virtual void finish () override
 
virtual void updateOpen ()
 
virtual void emitEligibilityTimeChangedSignal ()
 
- Protected Member Functions inherited from inet::queueing::PacketGateBase
virtual cGate * getRegistrationForwardingGate (cGate *gate) override
 
virtual void processPacket (Packet *packet) override
 
virtual bool canPacketFlowThrough (Packet *packet) const
 
virtual void updateDisplayString () const override
 
- Protected Member Functions inherited from inet::queueing::PacketFlowBase
virtual bool isStreamingPacket () const
 
virtual void startPacketStreaming (Packet *packet)
 
virtual void endPacketStreaming (Packet *packet)
 
virtual void checkPacketStreaming (Packet *packet)
 
- Protected Member Functions inherited from inet::queueing::PacketProcessorBase
virtual int numInitStages () const override
 
virtual void refreshDisplay () const override
 
virtual void handlePacketProcessed (Packet *packet)
 
virtual void checkPacketOperationSupport (cGate *gate) const
 
virtual void checkPacketOperationSupport (cGate *startGate, cGate *endGate) const
 
virtual void animate (Packet *packet, cGate *gate, const SendOptions &sendOptions, Action action) const
 
virtual void animatePacket (Packet *packet, cGate *gate, Action action) const
 
virtual void animatePacketStart (Packet *packet, cGate *gate, bps datarate, long transmissionId, Action action) const
 
virtual void animatePacketStart (Packet *packet, cGate *gate, bps datarate, const SendOptions &sendOptions, Action action) const
 
virtual void animatePacketEnd (Packet *packet, cGate *gate, long transmissionId, Action action) const
 
virtual void animatePacketEnd (Packet *packet, cGate *gate, const SendOptions &sendOptions, Action action) const
 
virtual void animatePacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, long transmissionId, Action action) const
 
virtual void animatePacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions, Action action) const
 
virtual void pushOrSendPacket (Packet *packet, cGate *gate, IPassivePacketSink *consumer)
 
virtual void pushOrSendPacketStart (Packet *packet, cGate *gate, IPassivePacketSink *consumer, bps datarate, int transmissionId)
 
virtual void pushOrSendPacketEnd (Packet *packet, cGate *gate, IPassivePacketSink *consumer, int transmissionId)
 
virtual void pushOrSendPacketProgress (Packet *packet, cGate *gate, IPassivePacketSink *consumer, bps datarate, b position, b extraProcessableLength, int transmissionId)
 
virtual void animatePush (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePushPacket (Packet *packet, cGate *gate) const
 
virtual void animatePushPacketStart (Packet *packet, cGate *gate, bps datarate, long transmissionId) const
 
virtual void animatePushPacketStart (Packet *packet, cGate *gate, bps datarate, const SendOptions &sendOptions) const
 
virtual void animatePushPacketEnd (Packet *packet, cGate *gate, long transmissionId) const
 
virtual void animatePushPacketEnd (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePushPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, long transmissionId) const
 
virtual void animatePushPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions) const
 
virtual void animatePull (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePullPacket (Packet *packet, cGate *gate) const
 
virtual void animatePullPacketStart (Packet *packet, cGate *gate, bps datarate, long transmissionId) const
 
virtual void animatePullPacketStart (Packet *packet, cGate *gate, bps datarate, const SendOptions &sendOptions) const
 
virtual void animatePullPacketEnd (Packet *packet, cGate *gate, long transmissionId) const
 
virtual void animatePullPacketEnd (Packet *packet, cGate *gate, const SendOptions &sendOptions) const
 
virtual void animatePullPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, long transmissionId) const
 
virtual void animatePullPacketProgress (Packet *packet, cGate *gate, bps datarate, b position, b extraProcessableLength, const SendOptions &sendOptions) const
 
virtual void dropPacket (Packet *packet, PacketDropReason reason, int limit=-1)
 

Protected Attributes

ClockEventeligibilityTimer = nullptr
 
simtime_t lastRemainingEligibilityTimeSignalValue = -1
 
simtime_t lastRemainingEligibilityTimeSignalTime = -1
 
PacketlastRemainingEligibilityTimePacket = nullptr
 
- Protected Attributes inherited from inet::queueing::PacketGateBase
bps bitrate = bps(NaN)
 
b extraLength = b(-1)
 
simtime_t extraDuration
 
bool isOpen_ = false
 
- Protected Attributes inherited from inet::queueing::PacketFlowBase
cGate * inputGate = nullptr
 
ModuleRef< IActivePacketSourceproducer
 
ModuleRef< IPassivePacketSourceprovider
 
ModuleRef< IPacketCollectioncollection
 
cGate * outputGate = nullptr
 
ModuleRef< IPassivePacketSinkconsumer
 
ModuleRef< IActivePacketSinkcollector
 
int inProgressStreamId = -1
 
- Protected Attributes inherited from inet::queueing::PacketProcessorBase
const char * displayStringTextFormat = nullptr
 
int numProcessedPackets = -1
 
b processedTotalLength = b(-1)
 

Additional Inherited Members

- Protected Types inherited from inet::queueing::PacketProcessorBase
enum  Action { PUSH, PULL }
 

Constructor & Destructor Documentation

◆ ~EligibilityTimeGate()

virtual inet::EligibilityTimeGate::~EligibilityTimeGate ( )
inlinevirtual
39 { cancelAndDelete(eligibilityTimer); }

Member Function Documentation

◆ emitEligibilityTimeChangedSignal()

void inet::EligibilityTimeGate::emitEligibilityTimeChangedSignal ( )
protectedvirtual
64 {
65  simtime_t now = simTime();
66  simtime_t signalValue;
68  auto packet = provider->canPullPacket(inputGate->getPathStartGate());
69  signalValue = packet == nullptr ? 0 : CLOCKTIME_AS_SIMTIME(packet->getTag<EligibilityTimeTag>()->getEligibilityTime() - getClockTime());
71  }
72  else
74  emit(remainingEligibilityTimeChangedSignal, signalValue);
77 }

Referenced by finish(), handleCanPullPacketChanged(), initialize(), and pullPacket().

◆ finish()

void inet::EligibilityTimeGate::finish ( )
overrideprotectedvirtual
40 {
42 }

◆ handleCanPullPacketChanged()

void inet::EligibilityTimeGate::handleCanPullPacketChanged ( cGate *  gate)
overridevirtual

Notifies about a change in the possibility of pulling some packet from the passive packet source at the given gate.

This method is called, for example, when a new packet is inserted into a queue. It allows the sink to pull a new packet from the queue.

The gate parameter must be a valid gate of this module.

Reimplemented from inet::queueing::PacketGateBase.

90 {
91  Enter_Method("handleCanPullPacketChanged");
93  updateOpen();
96 }

◆ handleMessage()

void inet::EligibilityTimeGate::handleMessage ( cMessage *  message)
overrideprotectedvirtual

Reimplemented from inet::queueing::PacketFlowBase.

32 {
33  if (message == eligibilityTimer)
34  updateOpen();
35  else
36  throw cRuntimeError("Unknown message");
37 }

◆ initialize()

void inet::EligibilityTimeGate::initialize ( int  stage)
overrideprotectedvirtual

Reimplemented from inet::queueing::PacketGateBase.

19 {
20  ClockUserModuleMixin::initialize(stage);
21  if (stage == INITSTAGE_LOCAL) {
22  eligibilityTimer = new ClockEvent("EligibilityTimer");
24  }
25  else if (stage == INITSTAGE_QUEUEING) {
26  updateOpen();
28  }
29 }

◆ pullPacket()

Packet * inet::EligibilityTimeGate::pullPacket ( cGate *  gate)
overridevirtual

Pulls the packet from the packet source at the given gate.

This operation pulls the packet as a whole. The onwership of the packet is transferred to the sink.

The source must not be empty at the given gate. The returned packet must not be nullptr. The gate must be a valid gate of this module and it must support pulling and passing packets.

Reimplemented from inet::queueing::PacketFlowBase.

80 {
81  Enter_Method("pullPacket");
83  auto packet = PacketGateBase::pullPacket(gate);
84  updateOpen();
86  return packet;
87 }

◆ updateOpen()

void inet::EligibilityTimeGate::updateOpen ( )
protectedvirtual
45 {
46  auto packet = provider->canPullPacket(inputGate->getPathStartGate());
47  if (packet == nullptr || packet->getTag<EligibilityTimeTag>()->getEligibilityTime() <= getClockTime()) {
48  if (isClosed())
49  open();
50  }
51  else {
52  if (isOpen())
53  close();
54  }
55  packet = provider->canPullPacket(inputGate->getPathStartGate());
56  if (packet != nullptr) {
57  clocktime_t eligibilityTime = packet->getTag<EligibilityTimeTag>()->getEligibilityTime();
58  if (eligibilityTime > getClockTime())
59  rescheduleClockEventAt(eligibilityTime, eligibilityTimer);
60  }
61 }

Referenced by handleCanPullPacketChanged(), handleMessage(), initialize(), and pullPacket().

Member Data Documentation

◆ eligibilityTimer

ClockEvent* inet::EligibilityTimeGate::eligibilityTimer = nullptr
protected

◆ lastRemainingEligibilityTimePacket

Packet* inet::EligibilityTimeGate::lastRemainingEligibilityTimePacket = nullptr
protected

◆ lastRemainingEligibilityTimeSignalTime

simtime_t inet::EligibilityTimeGate::lastRemainingEligibilityTimeSignalTime = -1
protected

◆ lastRemainingEligibilityTimeSignalValue

simtime_t inet::EligibilityTimeGate::lastRemainingEligibilityTimeSignalValue = -1
protected

◆ remainingEligibilityTimeChangedSignal

simsignal_t inet::EligibilityTimeGate::remainingEligibilityTimeChangedSignal = cComponent::registerSignal("remainingEligibilityTimeChanged")
static

The documentation for this class was generated from the following files:
inet::EligibilityTimeGate::updateOpen
virtual void updateOpen()
Definition: EligibilityTimeGate.cc:44
inet::clocktime_t
ClockTime clocktime_t
Definition: contract/ClockTime.h:25
inet::queueing::PacketGateBase::close
virtual void close() override
Closes the gate and stops traffic.
Definition: PacketGateBase.cc:52
inet::EligibilityTimeGate::remainingEligibilityTimeChangedSignal
static simsignal_t remainingEligibilityTimeChangedSignal
Definition: EligibilityTimeGate.h:21
CLOCKTIME_AS_SIMTIME
#define CLOCKTIME_AS_SIMTIME(x)
Definition: contract/ClockTime.h:19
inet::EligibilityTimeGate::lastRemainingEligibilityTimeSignalTime
simtime_t lastRemainingEligibilityTimeSignalTime
Definition: EligibilityTimeGate.h:27
inet::INITSTAGE_QUEUEING
INET_API InitStage INITSTAGE_QUEUEING
Initialization of queueing modules.
inet::queueing::PacketGateBase::handleCanPullPacketChanged
virtual void handleCanPullPacketChanged(cGate *gate) override
Notifies about a change in the possibility of pulling some packet from the passive packet source at t...
Definition: PacketGateBase.cc:99
inet::ClockUserModuleMixin< PacketGateBase >::getClockTime
virtual clocktime_t getClockTime() const
Definition: ClockUserModuleMixin.h:72
inet::ClockEvent
cMessage ClockEvent
Definition: contract/ClockEvent.h:18
inet::queueing::PacketGateBase::isClosed
virtual bool isClosed() const
Definition: PacketGateBase.h:46
inet::queueing::PacketFlowBase::provider
ModuleRef< IPassivePacketSource > provider
Definition: PacketFlowBase.h:24
inet::queueing::PacketGateBase::open
virtual void open() override
Opens the gate and starts traffic go through.
Definition: PacketGateBase.cc:39
inet::INITSTAGE_LOCAL
INET_API InitStage INITSTAGE_LOCAL
Initialization of local state that don't use or affect other modules includes:
inet::queueing::PacketFlowBase::inputGate
cGate * inputGate
Definition: PacketFlowBase.h:22
inet::EligibilityTimeGate::lastRemainingEligibilityTimeSignalValue
simtime_t lastRemainingEligibilityTimeSignalValue
Definition: EligibilityTimeGate.h:26
inet::EligibilityTimeGate::eligibilityTimer
ClockEvent * eligibilityTimer
Definition: EligibilityTimeGate.h:24
inet::ClockUserModuleMixin< PacketGateBase >::rescheduleClockEventAt
virtual void rescheduleClockEventAt(clocktime_t time, ClockEvent *msg)
Definition: ClockUserModuleMixin.h:68
inet::EligibilityTimeGate::emitEligibilityTimeChangedSignal
virtual void emitEligibilityTimeChangedSignal()
Definition: EligibilityTimeGate.cc:63
Enter_Method
#define Enter_Method(...)
Definition: SelfDoc.h:71
inet::queueing::PacketGateBase::isOpen
virtual bool isOpen() const override
Returns true if the gate is open.
Definition: PacketGateBase.h:45
inet::EligibilityTimeGate::lastRemainingEligibilityTimePacket
Packet * lastRemainingEligibilityTimePacket
Definition: EligibilityTimeGate.h:28
inet::queueing::PacketFlowBase::pullPacket
virtual Packet * pullPacket(cGate *gate) override
Pulls the packet from the packet source at the given gate.
Definition: PacketFlowBase.cc:151