inet::ieee80211::AARFRateControl Class Reference

Implements the ARF and AARF rate control algorithms. More...

#include <AARFRateControl.h>

Inheritance diagram for inet::ieee80211::AARFRateControl:

Public Member Functions
virtual const IIeee80211Mode *	getRate () override
virtual void	frameTransmitted (const Ieee80211Frame *frame, int retryCount, bool isSuccessful, bool isGivenUp) override
virtual void	frameReceived (const Ieee80211Frame *frame, const Ieee80211ReceptionIndication *receptionIndication) override
Public Member Functions inherited from inet::ieee80211::IRateControl
virtual	~IRateControl ()

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual void	handleMessage (cMessage *msg) override
virtual void	multiplyIncreaseThreshold (double factor)
virtual void	resetIncreaseThreshdold ()
virtual void	resetTimer ()
virtual void	increaseRateIfTimerIsExpired ()
virtual void	updateDisplayString ()
Protected Member Functions inherited from inet::ieee80211::RateControlBase
virtual void	receiveSignal (cComponent *source, simsignal_t signalID, cObject *obj, cObject *details) override
virtual void	emitDatarateSignal ()
const IIeee80211Mode *	increaseRateIfPossible (const IIeee80211Mode *currentMode)
const IIeee80211Mode *	decreaseRateIfPossible (const IIeee80211Mode *currentMode)

Protected Attributes
simtime_t	timer = SIMTIME_ZERO
simtime_t	interval = SIMTIME_ZERO
bool	probing = false
int	increaseThreshold = -1
int	maxIncreaseThreshold = -1
int	decreaseThreshold = -1
double	factor = -1
int	numberOfConsSuccTransmissions = 0
Protected Attributes inherited from inet::ieee80211::RateControlBase
const IIeee80211Mode *	currentMode = nullptr
Protected Attributes inherited from inet::ieee80211::ModeSetListener
Ieee80211ModeSet *	modeSet = nullptr

Additional Inherited Members
Static Public Attributes inherited from inet::ieee80211::RateControlBase
static simsignal_t	datarateSignal = cComponent::registerSignal("datarate")

Detailed Description

Implements the ARF and AARF rate control algorithms.

Member Function Documentation

void inet::ieee80211::AARFRateControl::frameReceived ( const Ieee80211Frame *  frame, const Ieee80211ReceptionIndication *  receptionIndication  )

overridevirtual

Implements inet::ieee80211::IRateControl.

{
}

void inet::ieee80211::AARFRateControl::frameTransmitted ( const Ieee80211Frame *  frame, int  retryCount, bool  isSuccessful, bool  isGivenUp  )

overridevirtual

Implements inet::ieee80211::IRateControl.

{
    increaseRateIfTimerIsExpired();

    if (!isSuccessful && probing) // probing packet failed
    {
        numberOfConsSuccTransmissions = 0;
        currentMode = decreaseRateIfPossible(currentMode);
        emitDatarateSignal();
        updateDisplayString();
        EV_DETAIL << "Decreased rate to " << *currentMode << endl;
        multiplyIncreaseThreshold(factor);
        resetTimer();
    }
    else if (!isSuccessful && retryCount >= decreaseThreshold - 1) // decreaseThreshold consecutive failed transmissions
    {
        numberOfConsSuccTransmissions = 0;
        currentMode = decreaseRateIfPossible(currentMode);
        emitDatarateSignal();
        updateDisplayString();
        EV_DETAIL << "Decreased rate to " << *currentMode << endl;
        resetIncreaseThreshdold();
        resetTimer();
    }
    else if (isSuccessful && retryCount == 0)
        numberOfConsSuccTransmissions++;

    if (numberOfConsSuccTransmissions == increaseThreshold)
    {
        numberOfConsSuccTransmissions = 0;
        currentMode = increaseRateIfPossible(currentMode);
        emitDatarateSignal();
        updateDisplayString();
        EV_DETAIL << "Increased rate to " << *currentMode << endl;
        resetTimer();
        probing = true;
    }
    else
        probing = false;

}

const IIeee80211Mode * inet::ieee80211::AARFRateControl::getRate ( )

overridevirtual

Implements inet::ieee80211::IRateControl.

{
    Enter_Method_Silent("getRate()");
    increaseRateIfTimerIsExpired();
    EV_INFO << "The current mode is " << currentMode << " the net bitrate is " << currentMode->getDataMode()->getNetBitrate() << std::endl;
    return currentMode;
}

void inet::ieee80211::AARFRateControl::handleMessage ( cMessage *  msg )

overrideprotectedvirtual

{
    throw cRuntimeError("This module doesn't handle self messages");
}

void inet::ieee80211::AARFRateControl::increaseRateIfTimerIsExpired ( )

protectedvirtual

Referenced by frameTransmitted(), and getRate().

{
    if (simTime() - timer >= interval)
    {
        currentMode = increaseRateIfPossible(currentMode);
        emitDatarateSignal();
        updateDisplayString();
        EV_DETAIL << "Increased rate to " << *currentMode << endl;
        resetTimer();
    }
}

void inet::ieee80211::AARFRateControl::initialize ( int  stage )

overrideprotectedvirtual

Reimplemented from inet::ieee80211::RateControlBase.

{
    RateControlBase::initialize(stage);
    if (stage == INITSTAGE_LOCAL) {
        factor = par("increaseThresholdFactor");
        increaseThreshold = par("increaseThreshold");
        maxIncreaseThreshold = par("maxIncreaseThreshold");
        decreaseThreshold = par("decreaseThreshold");
        interval = par("interval");
        WATCH(factor);
        WATCH(increaseThreshold);
        WATCH(maxIncreaseThreshold);
        WATCH(decreaseThreshold);
        WATCH(interval);
        WATCH(probing);
        WATCH(numberOfConsSuccTransmissions);
    }
    else if (stage == INITSTAGE_LINK_LAYER_2) {
        updateDisplayString();
    }
}

void inet::ieee80211::AARFRateControl::multiplyIncreaseThreshold ( double  factor )

protectedvirtual

Referenced by frameTransmitted().

{
    if (increaseThreshold * factor <= maxIncreaseThreshold)
        increaseThreshold *= factor;
}

virtual int inet::ieee80211::AARFRateControl::numInitStages ( ) const

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::RateControlBase.

{ return NUM_INIT_STAGES; }

void inet::ieee80211::AARFRateControl::resetIncreaseThreshdold ( )

protectedvirtual

Referenced by frameTransmitted().

{
    increaseThreshold = par("increaseThreshold");
}

void inet::ieee80211::AARFRateControl::resetTimer ( )

protectedvirtual

Referenced by frameTransmitted(), and increaseRateIfTimerIsExpired().

{
    timer = simTime();
}

void inet::ieee80211::AARFRateControl::updateDisplayString ( )

protectedvirtual

Referenced by frameTransmitted(), increaseRateIfTimerIsExpired(), and initialize().

{
    getDisplayString().setTagArg("t", 0, currentMode->getName());
}

Member Data Documentation

int inet::ieee80211::AARFRateControl::decreaseThreshold = -1

protected

Referenced by frameTransmitted(), and initialize().

double inet::ieee80211::AARFRateControl::factor = -1

protected

Referenced by frameTransmitted(), initialize(), and multiplyIncreaseThreshold().

int inet::ieee80211::AARFRateControl::increaseThreshold = -1

protected

Referenced by frameTransmitted(), initialize(), multiplyIncreaseThreshold(), and resetIncreaseThreshdold().

simtime_t inet::ieee80211::AARFRateControl::interval = SIMTIME_ZERO

protected

Referenced by increaseRateIfTimerIsExpired(), and initialize().

int inet::ieee80211::AARFRateControl::maxIncreaseThreshold = -1

protected

Referenced by initialize(), and multiplyIncreaseThreshold().

int inet::ieee80211::AARFRateControl::numberOfConsSuccTransmissions = 0

protected

Referenced by frameTransmitted(), and initialize().

bool inet::ieee80211::AARFRateControl::probing = false

protected

Referenced by frameTransmitted(), and initialize().

simtime_t inet::ieee80211::AARFRateControl::timer = SIMTIME_ZERO

protected

Referenced by increaseRateIfTimerIsExpired(), and resetTimer().

---

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

• AARFRateControl.h
• AARFRateControl.cc