#include <QoSRateSelection.h>

Inheritance diagram for inet::ieee80211::QoSRateSelection:

Public Member Functions
virtual const IIeee80211Mode *	computeResponseCtsFrameMode (Ieee80211RTSFrame *rtsFrame) override

virtual const IIeee80211Mode *	computeResponseAckFrameMode (Ieee80211DataOrMgmtFrame *dataOrMgmtFrame) override

virtual const IIeee80211Mode *	computeResponseBlockAckFrameMode (Ieee80211BlockAckReq *blockAckReq) override

virtual const IIeee80211Mode *	computeMode (Ieee80211Frame frame, TxopProcedure txopProcedure) override

virtual void	frameTransmitted (Ieee80211Frame *frame)

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 IIeee80211Mode *	getMode (Ieee80211Frame *frame)

virtual const IIeee80211Mode *	computeControlFrameMode (Ieee80211Frame frame, TxopProcedure txopProcedure)

virtual const IIeee80211Mode *	computeDataOrMgmtFrameMode (Ieee80211DataOrMgmtFrame *dataOrMgmtFrame)

virtual bool	isControlResponseFrame (Ieee80211Frame frame, TxopProcedure txopProcedure)

Protected Attributes
IRateControl *	dataOrMgmtRateControl = nullptr

const Ieee80211ModeSet *	modeSet = nullptr

std::map< MACAddress, const IIeee80211Mode * >	lastTransmittedFrameMode

const IIeee80211Mode *	multicastFrameMode = nullptr

const IIeee80211Mode *	fastestMandatoryMode = nullptr

const IIeee80211Mode *	dataFrameMode = nullptr

const IIeee80211Mode *	mgmtFrameMode = nullptr

const IIeee80211Mode *	controlFrameMode = nullptr

const IIeee80211Mode *	responseAckFrameMode = nullptr

const IIeee80211Mode *	responseCtsFrameMode = nullptr

const IIeee80211Mode *	responseBlockAckFrameMode = nullptr

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

Member Function Documentation

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::computeControlFrameMode	(	Ieee80211Frame *	frame,
		TxopProcedure *	txopProcedure
	)

protectedvirtual

Referenced by computeMode().

 {
     ASSERT(!isControlResponseFrame(frame, 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(frame)) {
         // 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 (!dynamic_cast<Ieee80211BasicBlockAck *>(frame) && !dynamic_cast<Ieee80211BasicBlockAckReq *>(frame)) {
             // 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(frame)) {
         // 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 (!dynamic_cast<Ieee80211BasicBlockAck *>(frame) && !dynamic_cast<Ieee80211BasicBlockAckReq *>(frame)) {
             // TODO: frame sequence context
             auto it = lastTransmittedFrameMode.find(frame->getReceiverAddress());
             if (it != lastTransmittedFrameMode.end()) {
                 return it->second;
             }
             else
                 return 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");
 }

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::computeDataOrMgmtFrameMode ( Ieee80211DataOrMgmtFrame * dataOrMgmtFrame )

protectedvirtual

Referenced by computeMode().

 {
     if (dynamic_cast<Ieee80211DataFrame*>(dataOrMgmtFrame) && dataFrameMode)
         return dataFrameMode;
     if (dynamic_cast<Ieee80211ManagementFrame*>(dataOrMgmtFrame) && 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 (dataOrMgmtFrame->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;
     }
 }

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::computeMode	(	Ieee80211Frame *	frame,
		TxopProcedure *	txopProcedure
	)

overridevirtual

Implements inet::ieee80211::IQoSRateSelection.

 {
     if (auto dataOrMgmtFrame = dynamic_cast<Ieee80211DataOrMgmtFrame*>(frame))
         return computeDataOrMgmtFrameMode(dataOrMgmtFrame);
     else
         return computeControlFrameMode(frame, txopProcedure);
 }

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::computeResponseAckFrameMode ( Ieee80211DataOrMgmtFrame * dataOrMgmtFrame )

overridevirtual

Implements inet::ieee80211::IQoSRateSelection.

 {
     // TODO: BSSBasicRateSet, alternate rate
     auto mode = getMode(dataOrMgmtFrame);
     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;
 }

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::computeResponseBlockAckFrameMode ( Ieee80211BlockAckReq * blockAckReq )

overridevirtual

Implements inet::ieee80211::IQoSRateSelection.

 {
     if (dynamic_cast<Ieee80211BasicBlockAckReq *>(blockAckReq))
         return responseBlockAckFrameMode ? responseBlockAckFrameMode : getMode(blockAckReq);
     else
         throw cRuntimeError("Unknown BlockAckReq frame type");
 }

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::computeResponseCtsFrameMode ( Ieee80211RTSFrame * rtsFrame )

overridevirtual

Implements inet::ieee80211::IQoSRateSelection.

 {
     // TODO: BSSBasicRateSet, alternate rate
     auto mode = getMode(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;
 }

void inet::ieee80211::QoSRateSelection::frameTransmitted ( Ieee80211Frame * frame )

virtual

 {
     auto receiverAddr = frame->getReceiverAddress();
     lastTransmittedFrameMode[receiverAddr] = getMode(frame);
 }

const IIeee80211Mode * inet::ieee80211::QoSRateSelection::getMode ( Ieee80211Frame * frame )

protectedvirtual

Referenced by computeResponseAckFrameMode(), computeResponseBlockAckFrameMode(), computeResponseCtsFrameMode(), and frameTransmitted().

 {
     auto txReq = dynamic_cast<Ieee80211TransmissionRequest*>(frame->getControlInfo());
     if (txReq)
         return txReq->getMode();
     auto rxInd = dynamic_cast<Ieee80211ReceptionIndication*>(frame->getControlInfo());
     if (rxInd)
         return rxInd->getMode();
     throw cRuntimeError("Missing mode");
 }

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

 {
     ModeSetListener::initialize(stage);
     if (stage == INITSTAGE_LINK_LAYER_2) {
         dataOrMgmtRateControl = dynamic_cast<IRateControl*>(getModuleByPath(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));
         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));
     }
 }

bool inet::ieee80211::QoSRateSelection::isControlResponseFrame	(	Ieee80211Frame *	frame,
		TxopProcedure *	txopProcedure
	)

protectedvirtual

Referenced by computeControlFrameMode().

 {
     bool nonSelfCts = dynamic_cast<Ieee80211CTSFrame *>(frame) && !txopProcedure->isTxopInitiator(frame);
     bool blockAck = dynamic_cast<Ieee80211BlockAck *>(frame);
     bool ack = dynamic_cast<Ieee80211ACKFrame *>(frame);
     return ack || blockAck || nonSelfCts;
 }

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

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

62 { return NUM_INIT_STAGES; }

inet::NUM_INIT_STAGES

The number of initialization stages.

Definition: InitStages.h:116

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::ModeSetListener.

 {
     Enter_Method("receiveModeSetChangeNotification");
     if (signalID == NF_MODESET_CHANGED) {
         modeSet = check_and_cast<Ieee80211ModeSet*>(obj);
         fastestMandatoryMode = modeSet->getFastestMandatoryMode();
     }
 }

Member Data Documentation

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::controlFrameMode = nullptr

protected

Referenced by computeControlFrameMode(), and initialize().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::dataFrameMode = nullptr

protected

Referenced by computeDataOrMgmtFrameMode(), and initialize().

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

protected

Referenced by computeDataOrMgmtFrameMode(), and initialize().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::fastestMandatoryMode = nullptr

protected

Referenced by computeControlFrameMode(), computeDataOrMgmtFrameMode(), and receiveSignal().

std::map<MACAddress, const IIeee80211Mode *> inet::ieee80211::QoSRateSelection::lastTransmittedFrameMode

protected

Referenced by computeControlFrameMode(), and frameTransmitted().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::mgmtFrameMode = nullptr

protected

Referenced by computeDataOrMgmtFrameMode(), and initialize().

const Ieee80211ModeSet* inet::ieee80211::QoSRateSelection::modeSet = nullptr

protected

Referenced by computeResponseAckFrameMode(), computeResponseCtsFrameMode(), initialize(), and receiveSignal().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::multicastFrameMode = nullptr

protected

Referenced by initialize().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::responseAckFrameMode = nullptr

protected

Referenced by computeResponseAckFrameMode(), and initialize().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::responseBlockAckFrameMode = nullptr

protected

Referenced by computeResponseBlockAckFrameMode(), and initialize().

const IIeee80211Mode* inet::ieee80211::QoSRateSelection::responseCtsFrameMode = nullptr

protected

Referenced by computeResponseCtsFrameMode(), and initialize().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Member Function Documentation

Member Data Documentation