inet::ieee80211::BasicMsduAggregationPolicy Class Reference

#include <BasicMsduAggregationPolicy.h>

Inheritance diagram for inet::ieee80211::BasicMsduAggregationPolicy:

Public Member Functions
virtual std::vector< Ieee80211DataFrame * > *	computeAggregateFrames (cQueue *queue) override
Public Member Functions inherited from inet::ieee80211::IMsduAggregationPolicy
virtual	~IMsduAggregationPolicy ()

Protected Member Functions
virtual void	initialize () override
virtual bool	isAggregationPossible (int numOfFramesToAggragate, int aMsduLength)
virtual bool	isEligible (Ieee80211DataFrame *frame, Ieee80211DataFrame *testFrame, int aMsduLength)

Protected Attributes
bool	qOsCheck = false
int	subframeNumThreshold = -1
int	aggregationLengthThreshold = -1
int	maxAMsduSize = -1

Member Function Documentation

std::vector< Ieee80211DataFrame * > * inet::ieee80211::BasicMsduAggregationPolicy::computeAggregateFrames ( cQueue *  queue )

overridevirtual

Implements inet::ieee80211::IMsduAggregationPolicy.

{
    ASSERT(!queue->isEmpty());
    int aMsduLength = 0;
    auto firstFrame = dynamic_cast<Ieee80211DataFrame *>(queue->front());
    auto frames = new std::vector<Ieee80211DataFrame *>();
    for (cQueue::Iterator it(*queue); !it.end(); it++)
    {
        auto dataFrame = dynamic_cast<Ieee80211DataFrame *>(*it);
        if (!dataFrame || !isEligible(dataFrame, firstFrame, aMsduLength))
            break;
        frames->push_back(dataFrame);
        aMsduLength += dataFrame->getEncapsulatedPacket()->getByteLength() + LENGTH_A_MSDU_SUBFRAME_HEADER / 8; // sum of MSDU lengths + subframe header
    }
    if (frames->size() <= 1 || !isAggregationPossible(frames->size(), aMsduLength)) {
        delete frames;
        return nullptr;
    }
    else
        return frames;
}

void inet::ieee80211::BasicMsduAggregationPolicy::initialize ( )

overrideprotectedvirtual

{
    subframeNumThreshold = par("subframeNumThreshold");
    aggregationLengthThreshold = par("aggregationLengthThreshold");
    maxAMsduSize = par("maxAMsduSize");
    qOsCheck = par("qOsCheck");
}

bool inet::ieee80211::BasicMsduAggregationPolicy::isAggregationPossible ( int  numOfFramesToAggragate, int  aMsduLength  )

protectedvirtual

Referenced by computeAggregateFrames().

{
    return ((subframeNumThreshold == -1 || subframeNumThreshold <= numOfFramesToAggragate) &&
            (aggregationLengthThreshold == -1 || aggregationLengthThreshold <= aMsduLength));
}

bool inet::ieee80211::BasicMsduAggregationPolicy::isEligible ( Ieee80211DataFrame *  frame, Ieee80211DataFrame *  testFrame, int  aMsduLength  )

protectedvirtual

Referenced by computeAggregateFrames().

{
//   Only QoS data frames have a TID.
    if (qOsCheck && frame->getType() != ST_DATA_WITH_QOS)
        return false;

//    The maximum MPDU length that can be transported using A-MPDU aggregation is 4095 octets. An
//    A-MSDU cannot be fragmented. Therefore, an A-MSDU of a length that exceeds 4065 octets (
//    4095 minus the QoS data MPDU overhead) cannot be transported in an A-MPDU.
    if (aMsduLength + testFrame->getEncapsulatedPacket()->getByteLength() + LENGTH_A_MSDU_SUBFRAME_HEADER / 8 > maxAMsduSize) // default value of maxAMsduSize is 4065
        return false;

//    The value of TID present in the QoS Control field of the MPDU carrying the A-MSDU indicates the TID for
//    all MSDUs in the A-MSDU. Because this value of TID is common to all MSDUs in the A-MSDU, only MSDUs
//    delivered to the MAC by an MA-UNITDATA.request primitive with an integer priority parameter that maps
//    to the same TID can be aggregated together using A-MSDU.
    if (testFrame->getTid() != frame->getTid())
        return false;

//    An A-MSDU contains only MSDUs whose DA and SA parameter values map to the same receiver address
//    (RA) and transmitter address (TA) values, i.e., all the MSDUs are intended to be received by a single
//    receiver, and necessarily they are all transmitted by the same transmitter. The rules for determining RA and
//    TA are independent of whether the frame body carries an A-MSDU.
    if (testFrame->getReceiverAddress() != frame->getReceiverAddress() ||
        testFrame->getTransmitterAddress() != frame->getTransmitterAddress())
        return false;

    return true;
}

Member Data Documentation

int inet::ieee80211::BasicMsduAggregationPolicy::aggregationLengthThreshold = -1

protected

Referenced by initialize(), and isAggregationPossible().

int inet::ieee80211::BasicMsduAggregationPolicy::maxAMsduSize = -1

protected

Referenced by initialize(), and isEligible().

bool inet::ieee80211::BasicMsduAggregationPolicy::qOsCheck = false

protected

Referenced by initialize(), and isEligible().

int inet::ieee80211::BasicMsduAggregationPolicy::subframeNumThreshold = -1

protected

Referenced by initialize(), and isAggregationPossible().

---

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

• BasicMsduAggregationPolicy.h
• BasicMsduAggregationPolicy.cc