INET Framework for OMNeT++/OMNEST
inet::queueing::QueueBasedTokenGenerator Class Reference

#include <QueueBasedTokenGenerator.h>

Inheritance diagram for inet::queueing::QueueBasedTokenGenerator:
inet::queueing::TokenGeneratorBase inet::queueing::PacketProcessorBase inet::queueing::IPacketProcessor inet::StringFormat::IDirectiveResolver

Public Member Functions

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 void receiveSignal (cComponent *source, simsignal_t signal, cObject *object, cObject *details) override
 
- Public Member Functions inherited from inet::queueing::TokenGeneratorBase
virtual const char * resolveDirective (char directive) const override
 
- 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 bool supportsPacketStreaming (cGate *gate) const override
 Returns true if the processor supports streaming packets at the given gate. More...
 
- Public Member Functions inherited from inet::queueing::IPacketProcessor
virtual ~IPacketProcessor ()
 

Protected Member Functions

virtual void initialize (int stage) override
 
virtual void generateTokens ()
 
- 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)
 
virtual void updateDisplayString () const
 

Protected Attributes

int minNumPackets = -1
 
b minTotalLength = b(-1)
 
ModuleRefByPar< IPacketQueuequeue
 
cPar * numTokensParameter = nullptr
 
- Protected Attributes inherited from inet::queueing::TokenGeneratorBase
ModuleRefByPar< ITokenStoragestorage
 
int numTokensGenerated = -1
 
- Protected Attributes inherited from inet::queueing::PacketProcessorBase
const char * displayStringTextFormat = nullptr
 
int numProcessedPackets = -1
 
b processedTotalLength = b(-1)
 

Additional Inherited Members

- Static Public Attributes inherited from inet::queueing::TokenGeneratorBase
static simsignal_t tokensCreatedSignal = cComponent::registerSignal("tokensCreated")
 
- Protected Types inherited from inet::queueing::PacketProcessorBase
enum  Action { PUSH, PULL }
 

Member Function Documentation

◆ generateTokens()

void inet::queueing::QueueBasedTokenGenerator::generateTokens ( )
protectedvirtual
46 {
47  auto numTokens = numTokensParameter->doubleValue();
48  numTokensGenerated += numTokens;
49  emit(tokensCreatedSignal, numTokens);
50  storage->addTokens(numTokens);
52 }

Referenced by initialize(), and receiveSignal().

◆ initialize()

void inet::queueing::QueueBasedTokenGenerator::initialize ( int  stage)
overrideprotectedvirtual

Reimplemented from inet::queueing::TokenGeneratorBase.

18 {
20  if (stage == INITSTAGE_LOCAL) {
21  minNumPackets = par("minNumPackets");
22  minTotalLength = b(par("minTotalLength"));
23  queue.reference(this, "queueModule", true);
24  check_and_cast<cSimpleModule *>(queue.get())->subscribe(packetPulledSignal, this);
25  numTokensParameter = &par("numTokens");
26  }
27  else if (stage == INITSTAGE_QUEUEING)
28  if (queue->getNumPackets() < minNumPackets || queue->getTotalLength() < minTotalLength)
30 }

◆ receiveSignal()

void inet::queueing::QueueBasedTokenGenerator::receiveSignal ( cComponent *  source,
simsignal_t  signal,
cObject *  object,
cObject *  details 
)
overridevirtual
33 {
34  Enter_Method("%s", cComponent::getSignalName(signal));
35 
36  if (signal == packetPulledSignal) {
37  Enter_Method("packetPulled");
38  if (queue->getNumPackets() < minNumPackets || queue->getTotalLength() < minTotalLength)
40  }
41  else
42  throw cRuntimeError("Unknown signal");
43 }

◆ supportsPacketPulling()

virtual bool inet::queueing::QueueBasedTokenGenerator::supportsPacketPulling ( cGate *  gate) const
inlineoverridevirtual

Returns true if the processor supports pulling packets at the given gate.

Pulling a packet is a synchronous operation that is initiated by the sink module. A pulled packet can be passed as a whole using pullPacket(), or it can be streamed from the source to the sink using pullPacketStart(), pullPacketEnd(), and pullPacketProgress().

For output gates, true means that the connected module can pull packets from this module. For input gates, true means that this module can pull packets from the connected module. For example, a packet server module can pull packets from a queue module.

Connecting incompatible gates raises an error during initialize. The gate parameter must be a valid gate of this module. The gate should be marked with @labels(pull) in the NED file.

Reimplemented from inet::queueing::TokenGeneratorBase.

33 { return false; }

◆ supportsPacketPushing()

virtual bool inet::queueing::QueueBasedTokenGenerator::supportsPacketPushing ( cGate *  gate) const
inlineoverridevirtual

Returns true if the processor supports pushing packets at the given gate.

Pushing a packet is a synchronous operation that is initiated by the source module. A pushed packet can be passed as a whole using pushPacket(), or it can be streamed from the source to the sink using pushPacketStart(), pushPacketEnd(), and pushPacketProgress().

For output gates, true means that this module can push packets into the connected module. For input gates, true means that the connected module can push packets into this module. For example, a packet generator module can push packets into a queue module.

Connecting incompatible gates raises an error during initialize. The gate parameter must be a valid gate of this module. The gate should be marked with @labels(push) in the NED file.

Reimplemented from inet::queueing::TokenGeneratorBase.

32 { return false; }

Member Data Documentation

◆ minNumPackets

int inet::queueing::QueueBasedTokenGenerator::minNumPackets = -1
protected

Referenced by initialize(), and receiveSignal().

◆ minTotalLength

b inet::queueing::QueueBasedTokenGenerator::minTotalLength = b(-1)
protected

Referenced by initialize(), and receiveSignal().

◆ numTokensParameter

cPar* inet::queueing::QueueBasedTokenGenerator::numTokensParameter = nullptr
protected

Referenced by generateTokens(), and initialize().

◆ queue

ModuleRefByPar<IPacketQueue> inet::queueing::QueueBasedTokenGenerator::queue
protected

Referenced by initialize(), and receiveSignal().


The documentation for this class was generated from the following files:
inet::queueing::QueueBasedTokenGenerator::minNumPackets
int minNumPackets
Definition: QueueBasedTokenGenerator.h:21
inet::INITSTAGE_QUEUEING
INET_API InitStage INITSTAGE_QUEUEING
Initialization of queueing modules.
inet::queueing::TokenGeneratorBase::numTokensGenerated
int numTokensGenerated
Definition: TokenGeneratorBase.h:26
inet::packetPulledSignal
simsignal_t packetPulledSignal
Definition: Simsignals.cc:105
inet::queueing::QueueBasedTokenGenerator::minTotalLength
b minTotalLength
Definition: QueueBasedTokenGenerator.h:22
inet::queueing::TokenGeneratorBase::initialize
virtual void initialize(int stage) override
Definition: TokenGeneratorBase.cc:17
inet::INITSTAGE_LOCAL
INET_API InitStage INITSTAGE_LOCAL
Initialization of local state that don't use or affect other modules includes:
inet::units::values::b
value< int64_t, units::b > b
Definition: Units.h:1241
inet::queueing::PacketProcessorBase::updateDisplayString
virtual void updateDisplayString() const
Definition: PacketProcessorBase.cc:399
inet::queueing::TokenGeneratorBase::storage
ModuleRefByPar< ITokenStorage > storage
Definition: TokenGeneratorBase.h:25
Enter_Method
#define Enter_Method(...)
Definition: SelfDoc.h:71
inet::queueing::QueueBasedTokenGenerator::generateTokens
virtual void generateTokens()
Definition: QueueBasedTokenGenerator.cc:45
inet::queueing::QueueBasedTokenGenerator::numTokensParameter
cPar * numTokensParameter
Definition: QueueBasedTokenGenerator.h:24
inet::queueing::TokenGeneratorBase::tokensCreatedSignal
static simsignal_t tokensCreatedSignal
Definition: TokenGeneratorBase.h:22
inet::queueing::QueueBasedTokenGenerator::queue
ModuleRefByPar< IPacketQueue > queue
Definition: QueueBasedTokenGenerator.h:23