inet::ieee80211::Dcaf Class Reference

#include <Dcaf.h>

Inheritance diagram for inet::ieee80211::Dcaf:

Public Member Functions
virtual queueing::IPacketQueue *	getPendingQueue () const
virtual InProgressFrames *	getInProgressFrames () const
virtual void	requestChannel (IChannelAccess::ICallback *callback) override
virtual void	releaseChannel (IChannelAccess::ICallback *callback) override
virtual void	channelAccessGranted () override
virtual void	expectedChannelAccess (simtime_t time) override
virtual void	incrementCw () override
virtual void	resetCw () override
virtual int	getCw () override
Public Member Functions inherited from inet::ieee80211::IChannelAccess
virtual	~IChannelAccess ()
Public Member Functions inherited from inet::ieee80211::IContention::ICallback
	~ICallback ()
Public Member Functions inherited from inet::ieee80211::IRecoveryProcedure::ICwCalculator
virtual	~ICwCalculator ()

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual void	refreshDisplay () const override
virtual void	calculateTimingParameters ()
virtual void	receiveSignal (cComponent *source, simsignal_t signalID, cObject *obj, cObject *details) override

Protected Attributes
physicallayer::Ieee80211ModeSet *	modeSet = nullptr
IContention *	contention = nullptr
IChannelAccess::ICallback *	callback = nullptr
queueing::IPacketQueue *	pendingQueue = nullptr
InProgressFrames *	inProgressFrames = nullptr
bool	owning = false
simtime_t	slotTime = -1
simtime_t	sifs = -1
simtime_t	ifs = -1
simtime_t	eifs = -1
int	cw = -1
int	cwMin = -1
int	cwMax = -1
Protected Attributes inherited from inet::ieee80211::ModeSetListener
physicallayer::Ieee80211ModeSet *	modeSet = nullptr

Additional Inherited Members
Static Public Attributes inherited from inet::ieee80211::IChannelAccess
static simsignal_t	channelOwnershipChangedSignal = cComponent::registerSignal("channelOwnershipChanged")

Member Function Documentation

calculateTimingParameters()

void inet::ieee80211::Dcaf::calculateTimingParameters ( )

protectedvirtual

{
    slotTime = modeSet->getSlotTime();
    sifs = modeSet->getSifsTime();
    int difsNumber = par("difsn");
    // The PIFS and DIFS are derived by the Equation (9-2) and Equation (9-3), as illustrated in Figure 9-14.
    // PIFS = aSIFSTime + aSlotTime (9-2)
    // DIFS = aSIFSTime + 2 × aSlotTime (9-3)
    ifs = difsNumber == -1 ? sifs + 2 * slotTime : difsNumber * slotTime;
    // The EIFS is derived from the SIFS and the DIFS and the length of time it takes to transmit an ACK frame at the
    // lowest PHY mandatory rate by Equation (9-4).
    // EIFS = aSIFSTime + DIFS + ACKTxTime
    eifs = sifs + ifs + modeSet->getSlowestMandatoryMode()->getDuration(LENGTH_ACK);
    EV_DEBUG << "Timing parameters are initialized: slotTime = " << slotTime << ", sifs = " << sifs << ", ifs = " << ifs << ", eifs = " << eifs << std::endl;
    ASSERT(ifs > sifs);
    cwMin = par("cwMin");
    cwMax = par("cwMax");
    if (cwMin == -1)
        cwMin = modeSet->getCwMin();
    if (cwMax == -1)
        cwMax = modeSet->getCwMax();
    cw = cwMin;
    EV_DEBUG << "Contention window parameters are initialized: cw = " << cw << ", cwMin = " << cwMin << ", cwMax = " << cwMax << std::endl;
}

channelAccessGranted()

void inet::ieee80211::Dcaf::channelAccessGranted ( )

overridevirtual

Implements inet::ieee80211::IContention::ICallback.

{
    Enter_Method("channelAccessGranted");
    ASSERT(callback != nullptr);
    owning = true;
    emit(channelOwnershipChangedSignal, owning);
    callback->channelGranted(this);
}

expectedChannelAccess()

void inet::ieee80211::Dcaf::expectedChannelAccess ( simtime_t  time )

overridevirtual

Implements inet::ieee80211::IContention::ICallback.

{
    // don't care
}

getCw()

virtual int inet::ieee80211::Dcaf::getCw ( )

inlineoverridevirtual

Implements inet::ieee80211::IRecoveryProcedure::ICwCalculator.

{ return cw; }

getInProgressFrames()

virtual InProgressFrames* inet::ieee80211::Dcaf::getInProgressFrames ( ) const

inlinevirtual

{ return inProgressFrames; }

getPendingQueue()

virtual queueing::IPacketQueue* inet::ieee80211::Dcaf::getPendingQueue ( ) const

inlinevirtual

{ return pendingQueue; }

incrementCw()

void inet::ieee80211::Dcaf::incrementCw ( )

overridevirtual

Implements inet::ieee80211::IRecoveryProcedure::ICwCalculator.

{
    Enter_Method("incrementCw");
    int newCw = 2 * cw + 1;
    if (newCw > cwMax)
        cw = cwMax;
    else
        cw = newCw;
    EV_DEBUG << "Contention window is incremented: cw = " << cw << std::endl;
}

initialize()

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{
    if (stage == INITSTAGE_LOCAL) {
        getContainingNicModule(this)->subscribe(modesetChangedSignal, this);
    }
    else if (stage == INITSTAGE_LINK_LAYER) {
        // TODO calculateTimingParameters()
        pendingQueue = check_and_cast<queueing::IPacketQueue *>(getSubmodule("pendingQueue"));
        inProgressFrames = check_and_cast<InProgressFrames *>(getSubmodule("inProgressFrames"));
        contention = check_and_cast<IContention *>(getSubmodule("contention"));
        auto rx = check_and_cast<IRx *>(getModuleByPath(par("rxModule")));
        rx->registerContention(contention);
        calculateTimingParameters();
        WATCH(owning);
        WATCH(slotTime);
        WATCH(sifs);
        WATCH(ifs);
        WATCH(eifs);
        WATCH(cw);
        WATCH(cwMin);
        WATCH(cwMax);
    }
}

numInitStages()

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

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{ return NUM_INIT_STAGES; }

receiveSignal()

void inet::ieee80211::Dcaf::receiveSignal ( cComponent *  source, simsignal_t  signalID, cObject *  obj, cObject *  details  )

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{
    Enter_Method("%s", cComponent::getSignalName(signalID));
 
    if (signalID == modesetChangedSignal) {
        modeSet = check_and_cast<Ieee80211ModeSet *>(obj);
        calculateTimingParameters();
    }
}

refreshDisplay()

void inet::ieee80211::Dcaf::refreshDisplay ( ) const

overrideprotectedvirtual

{
    std::string text;
    if (owning)
        text = "Owning";
    else if (contention != nullptr && contention->isContentionInProgress())
        text = "Contending";
    else
        text = "Idle";
    getDisplayString().setTagArg("t", 0, text.c_str());
}

releaseChannel()

void inet::ieee80211::Dcaf::releaseChannel ( IChannelAccess::ICallback *  callback )

overridevirtual

Implements inet::ieee80211::IChannelAccess.

{
    Enter_Method("releaseChannel");
    owning = false;
    emit(channelOwnershipChangedSignal, owning);
    this->callback = nullptr;
    EV_INFO << "Channel released.\n";
}

requestChannel()

void inet::ieee80211::Dcaf::requestChannel ( IChannelAccess::ICallback *  callback )

overridevirtual

Implements inet::ieee80211::IChannelAccess.

{
    Enter_Method("requestChannel");
    this->callback = callback;
    if (owning)
        callback->channelGranted(this);
    else if (!contention->isContentionInProgress())
        contention->startContention(cw, ifs, eifs, slotTime, this);
    else
        EV_DEBUG << "Contention has been already started.\n";
}

resetCw()

void inet::ieee80211::Dcaf::resetCw ( )

overridevirtual

Implements inet::ieee80211::IRecoveryProcedure::ICwCalculator.

{
    Enter_Method("resetCw");
    cw = cwMin;
    EV_DEBUG << "Contention window is reset: cw = " << cw << std::endl;
}

Member Data Documentation

callback

IChannelAccess::ICallback* inet::ieee80211::Dcaf::callback = nullptr

protected

contention

IContention* inet::ieee80211::Dcaf::contention = nullptr

protected

cw

int inet::ieee80211::Dcaf::cw = -1

protected

cwMax

int inet::ieee80211::Dcaf::cwMax = -1

protected

cwMin

int inet::ieee80211::Dcaf::cwMin = -1

protected

eifs

simtime_t inet::ieee80211::Dcaf::eifs = -1

protected

ifs

simtime_t inet::ieee80211::Dcaf::ifs = -1

protected

inProgressFrames

InProgressFrames* inet::ieee80211::Dcaf::inProgressFrames = nullptr

protected

modeSet

physicallayer::Ieee80211ModeSet* inet::ieee80211::Dcaf::modeSet = nullptr

protected

owning

bool inet::ieee80211::Dcaf::owning = false

protected

pendingQueue

queueing::IPacketQueue* inet::ieee80211::Dcaf::pendingQueue = nullptr

protected

sifs

simtime_t inet::ieee80211::Dcaf::sifs = -1

protected

slotTime

simtime_t inet::ieee80211::Dcaf::slotTime = -1

protected

---

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

• Dcaf.h
• Dcaf.cc