inet::ieee80211::QosRateSelection Class Reference

#include <QosRateSelection.h>

Inheritance diagram for inet::ieee80211::QosRateSelection:

Public Member Functions
virtual const physicallayer::IIeee80211Mode *	computeResponseCtsFrameMode (Packet *packet, const Ptr< const Ieee80211RtsFrame > &rtsFrame) override
virtual const physicallayer::IIeee80211Mode *	computeResponseAckFrameMode (Packet *packet, const Ptr< const Ieee80211DataOrMgmtHeader > &dataOrMgmtHeader) override
virtual const physicallayer::IIeee80211Mode *	computeResponseBlockAckFrameMode (Packet *packet, const Ptr< const Ieee80211BlockAckReq > &blockAckReq) override
virtual const physicallayer::IIeee80211Mode *	computeMode (Packet *packet, const Ptr< const Ieee80211MacHeader > &header, TxopProcedure *txopProcedure) override
virtual void	frameTransmitted (Packet *packet, const Ptr< const Ieee80211MacHeader > &header)
Public Member Functions inherited from inet::ieee80211::IQosRateSelection
virtual	~IQosRateSelection ()

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int stage) override
virtual void	receiveSignal (cComponent *source, simsignal_t signalID, cObject *obj, cObject *details) override
virtual const physicallayer::IIeee80211Mode *	getMode (Packet *packet, const Ptr< const Ieee80211MacHeader > &header)
virtual const physicallayer::IIeee80211Mode *	computeControlFrameMode (const Ptr< const Ieee80211MacHeader > &header, TxopProcedure *txopProcedure)
virtual const physicallayer::IIeee80211Mode *	computeDataOrMgmtFrameMode (const Ptr< const Ieee80211DataOrMgmtHeader > &dataOrMgmtHeader)
virtual bool	isControlResponseFrame (const Ptr< const Ieee80211MacHeader > &header, TxopProcedure *txopProcedure)

Protected Attributes
IRateControl *	dataOrMgmtRateControl = nullptr
const physicallayer::Ieee80211ModeSet *	modeSet = nullptr
std::map< MacAddress, const physicallayer::IIeee80211Mode * >	lastTransmittedFrameMode
const physicallayer::IIeee80211Mode *	multicastFrameMode = nullptr
const physicallayer::IIeee80211Mode *	fastestMandatoryMode = nullptr
const physicallayer::IIeee80211Mode *	dataFrameMode = nullptr
const physicallayer::IIeee80211Mode *	mgmtFrameMode = nullptr
const physicallayer::IIeee80211Mode *	controlFrameMode = nullptr
const physicallayer::IIeee80211Mode *	responseAckFrameMode = nullptr
const physicallayer::IIeee80211Mode *	responseCtsFrameMode = nullptr
const physicallayer::IIeee80211Mode *	responseBlockAckFrameMode = nullptr
Protected Attributes inherited from inet::ieee80211::ModeSetListener
physicallayer::Ieee80211ModeSet *	modeSet = nullptr

Member Function Documentation

computeControlFrameMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::computeControlFrameMode ( const Ptr< const Ieee80211MacHeader > &  header, TxopProcedure *  txopProcedure  )

protectedvirtual

{
    ASSERT(!isControlResponseFrame(header, txopProcedure));
    if (controlFrameMode)
        return controlFrameMode;
    // This subclause describes the rate selection rules for control frames that initiate a TXOP and that are not carried
    // in an A-MPDU.
    if (txopProcedure->isTxopInitiator(header)) {
        // If a control frame other than a Basic BlockAckReq or Basic BlockAck is carried in a non-HT PPDU, the
        // transmitting STA shall transmit the frame using one of the rates in the BSSBasicRateSet parameter or a rate
        // from the mandatory rate set of the attached PHY if the BSSBasicRateSet is empty.
        if (!dynamicPtrCast<const Ieee80211BasicBlockAck>(header) && !dynamicPtrCast<const Ieee80211BasicBlockAckReq>(header)) {
            // TODO BSSBasicRateSet
            return fastestMandatoryMode;
        }
        // If a Basic BlockAckReq or Basic BlockAck frame is carried in a non-HT PPDU, the transmitting STA shall
        // transmit the frame using a rate supported by the receiver STA, if known (as reported in the Supported Rates
        // element and/or Extended Supported Rates element in frames transmitted by that STA). If the supported rate set
        // of the receiving STA or STAs is not known, the transmitting STA shall transmit using a rate from the
        // BSSBasicRateSet parameter or using a rate from the mandatory rate set of the attached PHY if the
        // BSSBasicRateSet is empty.
        else {
            // TODO supported rate set of the receiving STA
            return fastestMandatoryMode;
        }
    }
    // This subclause describes the rate selection rules for control frames that are not control response frames, are not
    // the frame that initiates a TXOP, are not the frame that terminates a TXOP, and are not carried in an A-MPDU.
    else if (!txopProcedure->isTxopTerminator(header)) {
        // A frame other than a BlockAckReq or BlockAck that is carried in a non-HT PPDU shall be transmitted by the
        // STA using a rate no higher than the highest rate in the BSSBasicRateSet parameter that is less than or equal to
        // the rate or non-HT reference rate (see 9.7.9) of the previously transmitted frame that was directed to the same
        // receiving STA. If no rate in the BSSBasicRateSet parameter meets these conditions, the control frame shall be
        // transmitted at a rate no higher than the highest mandatory rate of the attached PHY that is less than or equal to
        // the rate or non-HT reference rate (see 9.7.9) of the previously transmitted frame that was directed to the same
        // receiving STA.
        // TODO BSSBasicRateSet
        if (!dynamicPtrCast<const Ieee80211BasicBlockAck>(header) && !dynamicPtrCast<const Ieee80211BasicBlockAckReq>(header)) {
            // TODO frame sequence context
            auto it = lastTransmittedFrameMode.find(header->getReceiverAddress());
            return (it != lastTransmittedFrameMode.end()) ? it->second : fastestMandatoryMode;
        }
        // A BlockAckReq or BlockAck that is carried in a non-HT PPDU shall be transmitted by the STA using a rate
        // supported by the receiver STA, as reported in the Supported Rates element and/or Extended Supported Rates
        // element in frames transmitted by that STA. When the supported rate set of the receiving STA or STAs is not
        // known, the transmitting STA shall transmit using a rate from the BSSBasicRateSet parameter or from the
        // mandatory rate set of the attached PHY if the BSSBasicRateSet is empty.
        else {
            // TODO BSSBasicRateSet
            // TODO Supported Rates element and/or Extended Supported Rates
            return fastestMandatoryMode;
        }
    }
    else
        throw cRuntimeError("Control frames cannot terminate TXOPs");
}

computeDataOrMgmtFrameMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::computeDataOrMgmtFrameMode ( const Ptr< const Ieee80211DataOrMgmtHeader > &  dataOrMgmtHeader )

protectedvirtual

{
    if (dynamicPtrCast<const Ieee80211DataHeader>(dataOrMgmtHeader) && dataFrameMode)
        return dataFrameMode;
    if (dynamicPtrCast<const Ieee80211MgmtHeader>(dataOrMgmtHeader) && mgmtFrameMode)
        return mgmtFrameMode;
    // This subclause describes the rate selection rules for group addressed data and management frames, excluding
    // the following:
    //   — Non-STBC Beacon and non-STBC PSMP frames
    //   — STBC group addressed data and management frames
    //   — Data frames located in an FMS stream (see 10.23.7)
    if (dataOrMgmtHeader->getReceiverAddress().isMulticast()) {
        // If the BSSBasicRateSet parameter is not empty, a data or management frame (excluding the frames listed
        // above) with a group address in the Address 1 field shall be transmitted in a non-HT PPDU using one of the
        // rates included in the BSSBasicRateSet parameter or the rate chosen by the AP, described in 10.23.7, if the data
        // frames are part of an FMS stream.
        // TODO BSSBasicRateSet
        // If the BSSBasicRateSet parameter is empty and the BSSBasicMCSSet parameter is not empty, the frame shall
        // be transmitted in an HT PPDU using one of the MCSs included in the BSSBasicMCSSet parameter.
 
        // If both the BSSBasicRateSet parameter and the BSSBasicMCSSet parameter are empty (e.g., a scanning STA
        // that is not yet associated with a BSS), the frame shall be transmitted in a non-HT PPDU using one of the
        // mandatory PHY rates.
        if (dataOrMgmtRateControl)
            return dataOrMgmtRateControl->getRate();
        else
            return fastestMandatoryMode;
    }
    // A data or management frame not identified in 9.7.5.1 through 9.7.5.5 shall be sent using any data rate or MCS
    // subject to the following constraints:
    //    — A STA shall not transmit a frame using a rate or MCS that is not supported by the receiver STA or
    //      STAs, as reported in any Supported Rates element, Extended Supported Rates element, or
    //      Supported MCS field in management frames transmitted by the receiver STA.
    //    — A STA shall not transmit a frame using a value for the CH_BANDWIDTH parameter of the
    //      TXVECTOR that is not supported by the receiver STA.
    //    — A STA shall not initiate transmission of a frame at a data rate higher than the greatest rate in the
    //      OperationalRateSet or the HTOperationalMCSset, which are parameters of the MLME-
    //      JOIN.request primitive.
    else {
        // TODO Supported Rates element, Extended Supported Rates element
        // TODO OperationalRateSet or the HTOperationalMCSset
        if (dataOrMgmtRateControl)
            return dataOrMgmtRateControl->getRate();
        else
            return fastestMandatoryMode;
    }
}

computeMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::computeMode ( Packet *  packet, const Ptr< const Ieee80211MacHeader > &  header, TxopProcedure *  txopProcedure  )

overridevirtual

Implements inet::ieee80211::IQosRateSelection.

{
    if (auto dataOrMgmtHeader = dynamicPtrCast<const Ieee80211DataOrMgmtHeader>(header))
        return computeDataOrMgmtFrameMode(dataOrMgmtHeader);
    else
        return computeControlFrameMode(header, txopProcedure);
}

computeResponseAckFrameMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::computeResponseAckFrameMode ( Packet *  packet, const Ptr< const Ieee80211DataOrMgmtHeader > &  dataOrMgmtHeader  )

overridevirtual

Implements inet::ieee80211::IQosRateSelection.

{
    // TODO BSSBasicRateSet, alternate rate
    auto mode = getMode(packet, dataOrMgmtHeader);
    ASSERT(modeSet->containsMode(mode));
    if (!responseAckFrameMode) {
        if (modeSet->getIsMandatory(mode))
            return mode;
        else if (auto slowerMode = modeSet->getSlowerMandatoryMode(mode))
            return slowerMode;
        else
            throw cRuntimeError("Mandatory mode not found");
    }
    else
        return responseAckFrameMode;
}

computeResponseBlockAckFrameMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::computeResponseBlockAckFrameMode ( Packet *  packet, const Ptr< const Ieee80211BlockAckReq > &  blockAckReq  )

overridevirtual

Implements inet::ieee80211::IQosRateSelection.

{
    if (dynamicPtrCast<const Ieee80211BasicBlockAckReq>(blockAckReq))
        return responseBlockAckFrameMode ? responseBlockAckFrameMode : getMode(packet, blockAckReq);
    else
        throw cRuntimeError("Unknown BlockAckReq frame type");
}

computeResponseCtsFrameMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::computeResponseCtsFrameMode ( Packet *  packet, const Ptr< const Ieee80211RtsFrame > &  rtsFrame  )

overridevirtual

Implements inet::ieee80211::IQosRateSelection.

{
    // TODO BSSBasicRateSet, alternate rate
    auto mode = getMode(packet, rtsFrame);
    ASSERT(modeSet->containsMode(mode));
    if (!responseCtsFrameMode) {
        if (modeSet->getIsMandatory(mode))
            return mode;
        else if (auto slowerMode = modeSet->getSlowerMandatoryMode(mode))
            return slowerMode;
        else
            throw cRuntimeError("Mandatory mode not found");
    }
    else
        return responseCtsFrameMode;
}

frameTransmitted()

void inet::ieee80211::QosRateSelection::frameTransmitted ( Packet *  packet, const Ptr< const Ieee80211MacHeader > &  header  )

virtual

{
    auto receiverAddr = header->getReceiverAddress();
    lastTransmittedFrameMode[receiverAddr] = getMode(packet, header);
}

getMode()

const IIeee80211Mode * inet::ieee80211::QosRateSelection::getMode ( Packet *  packet, const Ptr< const Ieee80211MacHeader > &  header  )

protectedvirtual

{
    const auto& modeReqTag = packet->findTag<Ieee80211ModeReq>();
    if (modeReqTag)
        return modeReqTag->getMode();
    const auto& modeIndTag = packet->findTag<Ieee80211ModeInd>();
    if (modeIndTag)
        return modeIndTag->getMode();
    throw cRuntimeError("Missing mode");
}

initialize()

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{
    ModeSetListener::initialize(stage);
    if (stage == INITSTAGE_LINK_LAYER) {
        dataOrMgmtRateControl = dynamic_cast<IRateControl *>(findModuleByPath(par("rateControlModule")));
        double multicastFrameBitrate = par("multicastFrameBitrate");
        multicastFrameMode = (multicastFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(multicastFrameBitrate));
        double dataFrameBitrate = par("dataFrameBitrate");
        dataFrameMode = (dataFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(dataFrameBitrate), Hz(par("dataFrameBandwidth")), par("dataFrameNumSpatialStreams"));
        double mgmtFrameBitrate = par("mgmtFrameBitrate");
        mgmtFrameMode = (mgmtFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(mgmtFrameBitrate));
        double controlFrameBitrate = par("controlFrameBitrate");
        controlFrameMode = (controlFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(controlFrameBitrate));
        double responseAckFrameBitrate = par("responseAckFrameBitrate");
        responseAckFrameMode = (responseAckFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(responseAckFrameBitrate));
        double responseBlockAckFrameBitrate = par("responseBlockAckFrameBitrate");
        responseBlockAckFrameMode = (responseBlockAckFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(responseBlockAckFrameBitrate));
        double responseCtsFrameBitrate = par("responseCtsFrameBitrate");
        responseCtsFrameMode = (responseCtsFrameBitrate == -1) ? nullptr : modeSet->getMode(bps(responseCtsFrameBitrate));
    }
}

isControlResponseFrame()

bool inet::ieee80211::QosRateSelection::isControlResponseFrame ( const Ptr< const Ieee80211MacHeader > &  header, TxopProcedure *  txopProcedure  )

protectedvirtual

{
    bool nonSelfCts = dynamicPtrCast<const Ieee80211CtsFrame>(header) && !txopProcedure->isTxopInitiator(header);
    bool blockAck = dynamicPtrCast<const Ieee80211BlockAck>(header) != nullptr;
    bool ack = dynamicPtrCast<const Ieee80211AckFrame>(header) != nullptr;
    return ack || blockAck || nonSelfCts;
}

numInitStages()

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

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

{ return NUM_INIT_STAGES; }

receiveSignal()

void inet::ieee80211::QosRateSelection::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);
        fastestMandatoryMode = modeSet->getFastestMandatoryMode();
    }
}

Member Data Documentation

controlFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::controlFrameMode = nullptr

protected

dataFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::dataFrameMode = nullptr

protected

dataOrMgmtRateControl

IRateControl* inet::ieee80211::QosRateSelection::dataOrMgmtRateControl = nullptr

protected

fastestMandatoryMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::fastestMandatoryMode = nullptr

protected

lastTransmittedFrameMode

std::map<MacAddress, const physicallayer::IIeee80211Mode *> inet::ieee80211::QosRateSelection::lastTransmittedFrameMode

protected

mgmtFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::mgmtFrameMode = nullptr

protected

modeSet

const physicallayer::Ieee80211ModeSet* inet::ieee80211::QosRateSelection::modeSet = nullptr

protected

multicastFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::multicastFrameMode = nullptr

protected

responseAckFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::responseAckFrameMode = nullptr

protected

responseBlockAckFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::responseBlockAckFrameMode = nullptr

protected

responseCtsFrameMode

const physicallayer::IIeee80211Mode* inet::ieee80211::QosRateSelection::responseCtsFrameMode = nullptr

protected

---

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

• QosRateSelection.h
• QosRateSelection.cc