inet::ieee80211::SingleProtectionMechanism Class Reference

#include <SingleProtectionMechanism.h>

Inheritance diagram for inet::ieee80211::SingleProtectionMechanism:

Public Member Functions
virtual	~SingleProtectionMechanism ()
virtual simtime_t	computeDurationField (Ieee80211Frame *frame, Ieee80211DataOrMgmtFrame *pendingFrame, TxopProcedure *txop, IRecipientQoSAckPolicy *ackPolicy)

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual simtime_t	computeRtsDurationField (Ieee80211RTSFrame *rtsFrame, Ieee80211DataOrMgmtFrame *pendingFrame, TxopProcedure *txop, IRecipientQoSAckPolicy *ackPolicy)
virtual simtime_t	computeCtsDurationField (Ieee80211CTSFrame *ctsFrame)
virtual simtime_t	computeBlockAckReqDurationField (Ieee80211BlockAckReq *blockAckReq)
virtual simtime_t	computeBlockAckDurationField (Ieee80211BlockAck *blockAck)
virtual simtime_t	computeDataOrMgmtFrameDurationField (Ieee80211DataOrMgmtFrame *dataOrMgmtFrame, Ieee80211DataOrMgmtFrame *pendingFrame, TxopProcedure *txop, IRecipientQoSAckPolicy *ackPolicy)
Protected Member Functions inherited from inet::ieee80211::ModeSetListener
virtual void	receiveSignal (cComponent *source, simsignal_t signalID, cObject *obj, cObject *details) override

Protected Attributes
IQoSRateSelection *	rateSelection = nullptr
Protected Attributes inherited from inet::ieee80211::ModeSetListener
Ieee80211ModeSet *	modeSet = nullptr

Constructor & Destructor Documentation

virtual inet::ieee80211::SingleProtectionMechanism::~SingleProtectionMechanism ( )

inlinevirtual

{ }

Member Function Documentation

simtime_t inet::ieee80211::SingleProtectionMechanism::computeBlockAckDurationField ( Ieee80211BlockAck *  blockAck )

protectedvirtual

Referenced by computeDurationField().

{
    throw cRuntimeError("Unimplemented");
}

simtime_t inet::ieee80211::SingleProtectionMechanism::computeBlockAckReqDurationField ( Ieee80211BlockAckReq *  blockAckReq )

protectedvirtual

Referenced by computeDurationField().

{
    //  TODO: ACK or BlockAck frame, as applicable
    if (dynamic_cast<Ieee80211BasicBlockAckReq*>(blockAckReq)) {
        simtime_t blockAckFrameDuration = rateSelection->computeResponseBlockAckFrameMode(blockAckReq)->getDuration(LENGTH_BASIC_BLOCKACK);
        simtime_t blockAckReqDurationPerId = blockAckFrameDuration + modeSet->getSifsTime();
        return blockAckReqDurationPerId;
    }
    else
        throw cRuntimeError("Compressed and Multi-Tid Block Ack Requests are not supported");
}

simtime_t inet::ieee80211::SingleProtectionMechanism::computeCtsDurationField ( Ieee80211CTSFrame *  ctsFrame )

protectedvirtual

Referenced by computeDurationField().

{
    throw cRuntimeError("Self CTS is not supported");
}

simtime_t inet::ieee80211::SingleProtectionMechanism::computeDataOrMgmtFrameDurationField ( Ieee80211DataOrMgmtFrame *  dataOrMgmtFrame, Ieee80211DataOrMgmtFrame *  pendingFrame, TxopProcedure *  txop, IRecipientQoSAckPolicy *  ackPolicy  )

protectedvirtual

Referenced by computeDurationField().

{
    bool mgmtFrame = false;
    bool mgmtFrameWithNoAck = false;
    bool groupAddressed = dataOrMgmtFrame->getReceiverAddress().isMulticast();
    if (dynamic_cast<Ieee80211ManagementFrame*>(dataOrMgmtFrame)) {
        mgmtFrame = true;
        mgmtFrameWithNoAck = false; // FIXME: ack policy?
    }
    bool nonQoSData = dataOrMgmtFrame->getType() == ST_DATA;
    bool individuallyAddressedDataWithNormalAck = false;
    bool individuallyAddressedDataWithNoAckOrBlockAck = false;
    if (auto dataFrame = dynamic_cast<Ieee80211DataFrame*>(dataOrMgmtFrame)) {
        individuallyAddressedDataWithNormalAck = !groupAddressed && dataFrame->getAckPolicy() == AckPolicy::NORMAL_ACK;
        individuallyAddressedDataWithNoAckOrBlockAck = !groupAddressed && (dataFrame->getAckPolicy() == AckPolicy::NO_ACK || dataFrame->getAckPolicy() == AckPolicy::BLOCK_ACK);
    }
    if (mgmtFrame || nonQoSData || individuallyAddressedDataWithNormalAck) {
        simtime_t ackFrameDuration = rateSelection->computeResponseAckFrameMode(dataOrMgmtFrame)->getDuration(LENGTH_ACK);
        if (txop->isFinalFragment(dataOrMgmtFrame)) {
            return ackFrameDuration + modeSet->getSifsTime();
        }
        else {
            simtime_t ackFrameDuration = rateSelection->computeResponseAckFrameMode(dataOrMgmtFrame)->getDuration(LENGTH_ACK);
            simtime_t duration = ackFrameDuration + modeSet->getSifsTime();
            if (pendingFrame) {
                auto pendingFrameMode = rateSelection->computeMode(pendingFrame, txop);
                simtime_t pendingFrameDuration = pendingFrameMode->getDuration(pendingFrame->getBitLength());
                duration += pendingFrameDuration + modeSet->getSifsTime();
                if (ackPolicy->isAckNeeded(pendingFrame)) {
                    RateSelection::setFrameMode(pendingFrame, pendingFrameMode); // FIXME: Kludge
                    simtime_t ackToPendingFrameDuration = rateSelection->computeResponseAckFrameMode(pendingFrame)->getDuration(LENGTH_ACK);
                    duration += ackToPendingFrameDuration + modeSet->getSifsTime();
                }
            }
            return duration;
        }
    }
    if (individuallyAddressedDataWithNoAckOrBlockAck || mgmtFrameWithNoAck || groupAddressed) {
        if (txop->isFinalFragment(dataOrMgmtFrame))
            return 0;
        else {
            simtime_t duration = 0;
            if (pendingFrame) {
                auto pendingFrameMode = rateSelection->computeMode(pendingFrame, txop);
                simtime_t pendingFrameDuration = pendingFrameMode->getDuration(pendingFrame->getBitLength());
                duration = pendingFrameDuration + modeSet->getSifsTime();
                if (ackPolicy->isAckNeeded(pendingFrame)) {
                    RateSelection::setFrameMode(pendingFrame, pendingFrameMode); // FIXME: Kludge
                    simtime_t ackToPendingFrameDuration = rateSelection->computeResponseAckFrameMode(pendingFrame)->getDuration(LENGTH_ACK);
                    duration += ackToPendingFrameDuration + modeSet->getSifsTime();
                }
            }
            return duration;
        }
    }
    throw cRuntimeError("Unknown frame");
}

simtime_t inet::ieee80211::SingleProtectionMechanism::computeDurationField ( Ieee80211Frame *  frame, Ieee80211DataOrMgmtFrame *  pendingFrame, TxopProcedure *  txop, IRecipientQoSAckPolicy *  ackPolicy  )

virtual

Referenced by inet::ieee80211::Hcf::transmitFrame().

{
    if (auto rtsFrame = dynamic_cast<Ieee80211RTSFrame*>(frame))
        return computeRtsDurationField(rtsFrame, pendingFrame, txop, ackPolicy);
    else if (auto ctsFrame = dynamic_cast<Ieee80211CTSFrame*>(frame))
        return computeCtsDurationField(ctsFrame);
    else if (auto blockAckReq = dynamic_cast<Ieee80211BlockAckReq*>(frame))
        return computeBlockAckReqDurationField(blockAckReq);
    else if (auto blockAck = dynamic_cast<Ieee80211BlockAck*>(frame))
        return computeBlockAckDurationField(blockAck);
    else if (auto dataOrMgmtFrame = dynamic_cast<Ieee80211DataOrMgmtFrame*>(frame))
        return computeDataOrMgmtFrameDurationField(dataOrMgmtFrame, pendingFrame, txop, ackPolicy);
    else
        throw cRuntimeError("Unknown frame type");
}

simtime_t inet::ieee80211::SingleProtectionMechanism::computeRtsDurationField ( Ieee80211RTSFrame *  rtsFrame, Ieee80211DataOrMgmtFrame *  pendingFrame, TxopProcedure *  txop, IRecipientQoSAckPolicy *  ackPolicy  )

protectedvirtual

Referenced by computeDurationField().

{
    // TODO: We assume that the RTS frame is not part of a dual clear-to-send
    auto pendingFrameMode = rateSelection->computeMode(pendingFrame, txop);
    simtime_t pendingFrameDuration = pendingFrameMode->getDuration(pendingFrame->getBitLength());
    simtime_t ctsFrameDuration = rateSelection->computeResponseCtsFrameMode(rtsFrame)->getDuration(LENGTH_CTS);
    simtime_t durationId = ctsFrameDuration + modeSet->getSifsTime() + pendingFrameDuration + modeSet->getSifsTime();
    if (auto dataOrMgmtFrame = dynamic_cast<Ieee80211DataOrMgmtFrame*>(pendingFrame)) {
        if (ackPolicy->isAckNeeded(dataOrMgmtFrame)) {
            RateSelection::setFrameMode(dataOrMgmtFrame, pendingFrameMode); // FIXME: KLUDGE
            simtime_t ackFrameDuration = rateSelection->computeResponseAckFrameMode(dataOrMgmtFrame)->getDuration(LENGTH_ACK);
            durationId += ackFrameDuration + modeSet->getSifsTime();
        }
    }
    return durationId;
}

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{
    ModeSetListener::initialize(stage);
    if (stage == INITSTAGE_LOCAL) {
        rateSelection = check_and_cast<IQoSRateSelection*>(getModuleByPath(par("rateSelectionModule")));
    }
}

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

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{ return NUM_INIT_STAGES; }

Member Data Documentation

IQoSRateSelection* inet::ieee80211::SingleProtectionMechanism::rateSelection = nullptr

protected

Referenced by computeBlockAckReqDurationField(), computeDataOrMgmtFrameDurationField(), computeRtsDurationField(), and initialize().

---

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

• SingleProtectionMechanism.h
• SingleProtectionMechanism.cc