inet::ieee80211::TxopProcedure Class Reference

#include <TxopProcedure.h>

Inheritance diagram for inet::ieee80211::TxopProcedure:

Public Types
enum	ProtectionMechanism { ProtectionMechanism::SINGLE_PROTECTION, ProtectionMechanism::MULTIPLE_PROTECTION, ProtectionMechanism::UNDEFINED_PROTECTION }

Public Member Functions
virtual void	startTxop (AccessCategory ac)
virtual void	stopTxop ()
virtual simtime_t	getStart () const
virtual simtime_t	getLimit () const
virtual simtime_t	getRemaining () const
virtual bool	isFinalFragment (Ieee80211Frame *frame) const
virtual bool	isTxopInitiator (Ieee80211Frame *frame) const
virtual bool	isTxopTerminator (Ieee80211Frame *frame) const
virtual ProtectionMechanism	getProtectionMechanism () const

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual s	getTxopLimit (const IIeee80211Mode *mode, AccessCategory ac)
virtual ProtectionMechanism	selectProtectionMechanism (AccessCategory ac) const
Protected Member Functions inherited from inet::ieee80211::ModeSetListener
virtual void	receiveSignal (cComponent *source, simsignal_t signalID, cObject *obj, cObject *details) override

Protected Attributes
simtime_t	start = -1
simtime_t	limit = -1
ProtectionMechanism	protectionMechanism = ProtectionMechanism::UNDEFINED_PROTECTION
Protected Attributes inherited from inet::ieee80211::ModeSetListener
Ieee80211ModeSet *	modeSet = nullptr

Member Enumeration Documentation

enum inet::ieee80211::TxopProcedure::ProtectionMechanism

strong

Enumerator
SINGLE_PROTECTION
MULTIPLE_PROTECTION
UNDEFINED_PROTECTION

                                       {
            SINGLE_PROTECTION,
            MULTIPLE_PROTECTION,
            UNDEFINED_PROTECTION
        };

Member Function Documentation

simtime_t inet::ieee80211::TxopProcedure::getLimit ( ) const

virtual

{
    return limit;
}

virtual ProtectionMechanism inet::ieee80211::TxopProcedure::getProtectionMechanism ( ) const

inlinevirtual

{ return protectionMechanism; }

simtime_t inet::ieee80211::TxopProcedure::getRemaining ( ) const

virtual

Referenced by inet::ieee80211::HcfFs::hasMoreTxOps().

{
    if (start == -1)
        throw cRuntimeError("Txop has not started yet");
    auto now = simTime();
    return now > start + limit ? 0 : now - start;
}

simtime_t inet::ieee80211::TxopProcedure::getStart ( ) const

virtual

{
    return start;
}

s inet::ieee80211::TxopProcedure::getTxopLimit ( const IIeee80211Mode *  mode, AccessCategory  ac  )

protectedvirtual

Referenced by startTxop().

{
    switch (ac)
    {
        case AC_BK: return s(0);
        case AC_BE: return s(0);
        case AC_VI:
            if (dynamic_cast<const Ieee80211DsssMode*>(mode) || dynamic_cast<const Ieee80211HrDsssMode*>(mode)) return ms(6.016);
            else if (dynamic_cast<const Ieee80211HTMode*>(mode) || dynamic_cast<const Ieee80211OFDMMode*>(mode)) return ms(3.008);
            else return s(0);
        case AC_VO:
            if (dynamic_cast<const Ieee80211DsssMode*>(mode) || dynamic_cast<const Ieee80211HrDsssMode*>(mode)) return ms(3.264);
            else if (dynamic_cast<const Ieee80211HTMode*>(mode) || dynamic_cast<const Ieee80211OFDMMode*>(mode)) return ms(1.504);
            else return s(0);
        default: throw cRuntimeError("Unknown access category = %d", ac);
    }
}

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{
    ModeSetListener::initialize(stage);
    if (stage == INITSTAGE_LOCAL) {
        limit = par("txopLimit");
    }
}

bool inet::ieee80211::TxopProcedure::isFinalFragment ( Ieee80211Frame *  frame ) const

virtual

Referenced by inet::ieee80211::SingleProtectionMechanism::computeDataOrMgmtFrameDurationField().

{
    return false;
}

bool inet::ieee80211::TxopProcedure::isTxopInitiator ( Ieee80211Frame *  frame ) const

virtual

Referenced by inet::ieee80211::QoSRateSelection::computeControlFrameMode(), and inet::ieee80211::QoSRateSelection::isControlResponseFrame().

{
    return false;
}

bool inet::ieee80211::TxopProcedure::isTxopTerminator ( Ieee80211Frame *  frame ) const

virtual

Referenced by inet::ieee80211::QoSRateSelection::computeControlFrameMode().

{
    return false;
}

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

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{ return NUM_INIT_STAGES; }

TxopProcedure::ProtectionMechanism inet::ieee80211::TxopProcedure::selectProtectionMechanism ( AccessCategory  ac ) const

protectedvirtual

Referenced by startTxop().

{
    return ProtectionMechanism::SINGLE_PROTECTION;
}

void inet::ieee80211::TxopProcedure::startTxop ( AccessCategory  ac )

virtual

{
    if (start != -1)
        throw cRuntimeError("Txop is already running");
    if (limit == -1) {
        auto referenceMode = modeSet->getSlowestMandatoryMode();
        limit = getTxopLimit(referenceMode, ac).get();
    }
    // The STA selects between single and multiple protection when it transmits the first frame of a TXOP.
    // All subsequent frames transmitted by the STA in the same TXOP use the same class of duration settings.
    protectionMechanism = selectProtectionMechanism(ac);
    start = simTime();
}

void inet::ieee80211::TxopProcedure::stopTxop ( )

virtual

{
    start = -1;
    protectionMechanism = ProtectionMechanism::UNDEFINED_PROTECTION;
}

Member Data Documentation

simtime_t inet::ieee80211::TxopProcedure::limit = -1

protected

Referenced by getLimit(), getRemaining(), initialize(), and startTxop().

ProtectionMechanism inet::ieee80211::TxopProcedure::protectionMechanism = ProtectionMechanism::UNDEFINED_PROTECTION

protected

Referenced by startTxop(), and stopTxop().

simtime_t inet::ieee80211::TxopProcedure::start = -1

protected

Referenced by getRemaining(), getStart(), startTxop(), and stopTxop().

---

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

• TxopProcedure.h
• TxopProcedure.cc