inet::physicallayer::Ieee80211ModeSet Class Reference

#include <Ieee80211ModeSet.h>

Inheritance diagram for inet::physicallayer::Ieee80211ModeSet:

Classes
class	Entry
struct	EntryNetBitrateComparator

Public Member Functions
	Ieee80211ModeSet (const char *name, const std::vector< Entry > entries)
virtual std::ostream &	printToStream (std::ostream &stream, int level) const override
	Prints this object to the provided output stream. More...
const char *	getName () const override
bool	containsMode (const IIeee80211Mode *mode) const
bool	getIsMandatory (const IIeee80211Mode *mode) const
const IIeee80211Mode *	findMode (bps bitrate) const
const IIeee80211Mode *	getMode (bps bitrate) const
const IIeee80211Mode *	getSlowestMode () const
const IIeee80211Mode *	getFastestMode () const
const IIeee80211Mode *	getSlowerMode (const IIeee80211Mode *mode) const
const IIeee80211Mode *	getFasterMode (const IIeee80211Mode *mode) const
const IIeee80211Mode *	getSlowestMandatoryMode () const
const IIeee80211Mode *	getFastestMandatoryMode () const
const IIeee80211Mode *	getSlowerMandatoryMode (const IIeee80211Mode *mode) const
const IIeee80211Mode *	getFasterMandatoryMode (const IIeee80211Mode *mode) const
simtime_t	getSifsTime () const
simtime_t	getSlotTime () const
simtime_t	getPhyRxStartDelay () const
int	getCwMin () const
int	getCwMax () const
IIeee80211Mode *	_getSlowestMode () const
IIeee80211Mode *	_getFastestMode () const
IIeee80211Mode *	_getSlowestMandatoryMode () const
IIeee80211Mode *	_getFastestMandatoryMode () const
Public Member Functions inherited from inet::physicallayer::IPrintableObject
virtual	~IPrintableObject ()
virtual std::string	getInfoStringRepresentation () const
virtual std::string	getDetailStringRepresentation () const
virtual std::string	getDebugStringRepresentation () const
virtual std::string	getTraceStringRepresentation () const
virtual std::string	getCompleteStringRepresentation () const

Static Public Member Functions
static const Ieee80211ModeSet *	findModeSet (const char *mode)
static const Ieee80211ModeSet *	getModeSet (const char *mode)

Static Public Attributes
static const DelayedInitializer< std::vector< Ieee80211ModeSet > >	modeSets

Protected Member Functions
int	findModeIndex (const IIeee80211Mode *mode) const
int	getModeIndex (const IIeee80211Mode *mode) const

Protected Attributes
std::string	name
const std::vector< Entry >	entries

Additional Inherited Members
Public Types inherited from inet::physicallayer::IPrintableObject
enum	PrintLevel {   PRINT_LEVEL_TRACE, PRINT_LEVEL_DEBUG, PRINT_LEVEL_DETAIL, PRINT_LEVEL_INFO,   PRINT_LEVEL_COMPLETE = INT_MIN }

Constructor & Destructor Documentation

inet::physicallayer::Ieee80211ModeSet::Ieee80211ModeSet	(	const char *	name,
		const std::vector< Entry >	entries
	)

                                                                                   :
    name(name),
    entries(entries)
{
    std::vector<Entry> *nonConstEntries = const_cast<std::vector<Entry> *>(&this->entries);
    std::stable_sort(nonConstEntries->begin(), nonConstEntries->end(), EntryNetBitrateComparator());
    auto referenceMode = entries[0].mode;
    for (auto entry : entries) {
        auto mode = entry.mode;
        if (mode->getSifsTime() != referenceMode->getSifsTime() ||
            mode->getSlotTime() != referenceMode->getSlotTime() ||
            mode->getPhyRxStartDelay() != referenceMode->getPhyRxStartDelay())
        {
            // FIXME: throw cRuntimeError("Sifs, slot and phyRxStartDelay time must be identical within a ModeSet");
        }
    }
}

Member Function Documentation

IIeee80211Mode* inet::physicallayer::Ieee80211ModeSet::_getFastestMandatoryMode ( ) const

inline

{ return const_cast<IIeee80211Mode*>(getFastestMandatoryMode()); }

IIeee80211Mode* inet::physicallayer::Ieee80211ModeSet::_getFastestMode ( ) const

inline

{ return const_cast<IIeee80211Mode*>(getFastestMode()); }

IIeee80211Mode* inet::physicallayer::Ieee80211ModeSet::_getSlowestMandatoryMode ( ) const

inline

{ return const_cast<IIeee80211Mode*>(getSlowestMandatoryMode()); }

IIeee80211Mode* inet::physicallayer::Ieee80211ModeSet::_getSlowestMode ( ) const

inline

{ return const_cast<IIeee80211Mode*>(getSlowestMode()); }

bool inet::physicallayer::Ieee80211ModeSet::containsMode ( const IIeee80211Mode *  mode ) const

inline

Referenced by inet::physicallayer::Ieee80211DimensionalReceiver::computeIsReceptionPossible(), inet::physicallayer::Ieee80211ScalarReceiver::computeIsReceptionPossible(), inet::ieee80211::RateSelection::computeResponseAckFrameMode(), inet::ieee80211::QoSRateSelection::computeResponseAckFrameMode(), inet::ieee80211::RateSelection::computeResponseCtsFrameMode(), inet::ieee80211::QoSRateSelection::computeResponseCtsFrameMode(), and inet::physicallayer::Ieee80211TransmitterBase::computeTransmissionMode().

{ return findModeIndex(mode) != -1; }

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::findMode

(

bps

bitrate

)

const

Referenced by getMode(), and inet::physicallayer::Ieee80211TransmitterBase::setMode().

{
    for (int index = 0; index < (int)entries.size(); index++) {
        const IIeee80211Mode *mode = entries[index].mode;
        if (mode->getDataMode()->getNetBitrate() == bitrate)
            return entries[index].mode;
    }
    return nullptr;
}

int inet::physicallayer::Ieee80211ModeSet::findModeIndex ( const IIeee80211Mode *  mode ) const

protected

Referenced by getFasterMandatoryMode(), getFasterMode(), getModeIndex(), getSlowerMandatoryMode(), and getSlowerMode().

{
    for (int index = 0; index < (int)entries.size(); index++)
        if (entries[index].mode == mode)
            return index;
    return -1;
}

const Ieee80211ModeSet * inet::physicallayer::Ieee80211ModeSet::findModeSet ( const char *  mode )

static

Referenced by getModeSet().

{
    for (int index = 0; index < (int)(&modeSets)->size(); index++) {
        const Ieee80211ModeSet *modeSet = &(&modeSets)->at(index);
        if (strcmp(modeSet->getName(), mode) == 0)
            return modeSet;
    }
    return nullptr;
}

int inet::physicallayer::Ieee80211ModeSet::getCwMax ( ) const

inline

Referenced by inet::ieee80211::Dcaf::calculateTimingParameters(), and inet::ieee80211::Edcaf::calculateTimingParameters().

{ return entries[0].mode->getLegacyCwMax(); }

int inet::physicallayer::Ieee80211ModeSet::getCwMin ( ) const

inline

Referenced by inet::ieee80211::Dcaf::calculateTimingParameters(), and inet::ieee80211::Edcaf::calculateTimingParameters().

{ return entries[0].mode->getLegacyCwMin(); }

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getFasterMandatoryMode

(

const IIeee80211Mode *

mode

)

const

{
    int index = findModeIndex(mode);
    if (index >= 0)
        for (int i = index+1; i < (int)entries.size(); i++)
            if (entries[i].isMandatory)
                return entries[i].mode;
    return nullptr;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getFasterMode

(

const IIeee80211Mode *

mode

)

const

Referenced by inet::ieee80211::RateControlBase::increaseRateIfPossible().

{
    int index = findModeIndex(mode);
    if (index >= 0 && index < (int)entries.size()-1)
        return entries[index + 1].mode;
    else
        return nullptr;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getFastestMandatoryMode

(

)

const

Referenced by inet::ieee80211::RateSelection::initialize(), inet::ieee80211::RateControlBase::receiveSignal(), inet::ieee80211::RateSelection::receiveSignal(), and inet::ieee80211::QoSRateSelection::receiveSignal().

{
    for (int i = (int)entries.size()-1; i >= 0; i--)
        if (entries[i].isMandatory)
            return entries[i].mode;
    return nullptr;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getFastestMode

(

)

const

{
    return entries.back().mode;
}

bool inet::physicallayer::Ieee80211ModeSet::getIsMandatory

(

const IIeee80211Mode *

mode

)

const

Referenced by inet::ieee80211::RateSelection::computeResponseAckFrameMode(), inet::ieee80211::QoSRateSelection::computeResponseAckFrameMode(), inet::ieee80211::RateSelection::computeResponseCtsFrameMode(), and inet::ieee80211::QoSRateSelection::computeResponseCtsFrameMode().

{
    return entries[getModeIndex(mode)].isMandatory;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getMode

(

bps

bitrate

)

const

Referenced by inet::physicallayer::Ieee80211TransmitterBase::computeTransmissionMode(), inet::physicallayer::Ieee80211TransmitterBase::initialize(), inet::ieee80211::RateSelection::initialize(), inet::ieee80211::QoSRateSelection::initialize(), inet::ieee80211::RateControlBase::receiveSignal(), and inet::physicallayer::Ieee80211TransmitterBase::setModeSet().

{
    const IIeee80211Mode *mode = findMode(bitrate);
    if (mode == nullptr)
        throw cRuntimeError("Unknown bitrate: %g in operation mode: '%s'", bitrate.get(), getName());
    else
        return mode;
}

int inet::physicallayer::Ieee80211ModeSet::getModeIndex ( const IIeee80211Mode *  mode ) const

protected

Referenced by getIsMandatory().

{
    int index = findModeIndex(mode);
    if (index < 0)
        throw cRuntimeError("Unknown mode");
    else
        return index;
}

const Ieee80211ModeSet * inet::physicallayer::Ieee80211ModeSet::getModeSet ( const char *  mode )

static

Referenced by inet::physicallayer::Ieee80211Radio::handleUpperCommand(), inet::physicallayer::Ieee80211ReceiverBase::initialize(), inet::physicallayer::Ieee80211TransmitterBase::initialize(), and inet::ieee80211::Ieee80211Mac::initialize().

{
    const Ieee80211ModeSet *modeSet = findModeSet(mode);
    if (modeSet == nullptr) {
        std::string validModeSets;
        for (int index = 0; index < (int)(&modeSets)->size(); index++) {
            const Ieee80211ModeSet *modeSet = &(&modeSets)->at(index);
            validModeSets += std::string("'") + modeSet->getName() + "' ";
        }
        throw cRuntimeError("Unknown 802.11 operational mode: '%s', valid modes are: %s", mode, validModeSets.c_str());
    }
    else
        return modeSet;
}

const char* inet::physicallayer::Ieee80211ModeSet::getName ( ) const

inlineoverride

Referenced by findModeSet(), getMode(), and getModeSet().

{ return name.c_str(); }

simtime_t inet::physicallayer::Ieee80211ModeSet::getPhyRxStartDelay ( ) const

inline

{ return entries[0].mode->getPhyRxStartDelay(); }

simtime_t inet::physicallayer::Ieee80211ModeSet::getSifsTime ( ) const

inline

Referenced by inet::ieee80211::Dcaf::calculateTimingParameters(), inet::ieee80211::Edcaf::calculateTimingParameters(), inet::ieee80211::RecipientAckPolicy::computeAckDurationField(), inet::ieee80211::RecipientQoSAckPolicy::computeAckDurationField(), inet::ieee80211::RecipientQoSAckPolicy::computeBasicBlockAckDurationField(), inet::ieee80211::SingleProtectionMechanism::computeBlockAckReqDurationField(), inet::ieee80211::QoSCtsPolicy::computeCtsDurationField(), inet::ieee80211::CtsPolicy::computeCtsDurationField(), inet::ieee80211::OriginatorProtectionMechanism::computeDataFrameDurationField(), inet::ieee80211::SingleProtectionMechanism::computeDataOrMgmtFrameDurationField(), inet::ieee80211::OriginatorProtectionMechanism::computeMgmtFrameDurationField(), inet::ieee80211::OriginatorProtectionMechanism::computeRtsDurationField(), inet::ieee80211::SingleProtectionMechanism::computeRtsDurationField(), inet::ieee80211::OriginatorAckPolicy::getAckTimeout(), inet::ieee80211::OriginatorQoSAckPolicy::getAckTimeout(), inet::ieee80211::OriginatorQoSAckPolicy::getBlockAckTimeout(), inet::ieee80211::RtsPolicy::getCtsTimeout(), inet::ieee80211::QoSRtsPolicy::getCtsTimeout(), inet::ieee80211::FrameSequenceContext::getIfs(), inet::ieee80211::Dcf::transmitControlResponseFrame(), and inet::ieee80211::Hcf::transmitControlResponseFrame().

{ return entries[0].mode->getSifsTime(); }

simtime_t inet::physicallayer::Ieee80211ModeSet::getSlotTime ( ) const

inline

Referenced by inet::ieee80211::Dcaf::calculateTimingParameters(), inet::ieee80211::Edcaf::calculateTimingParameters(), inet::ieee80211::OriginatorAckPolicy::getAckTimeout(), inet::ieee80211::OriginatorQoSAckPolicy::getAckTimeout(), inet::ieee80211::OriginatorQoSAckPolicy::getBlockAckTimeout(), inet::ieee80211::QoSRtsPolicy::getCtsTimeout(), and inet::ieee80211::RtsPolicy::getCtsTimeout().

{ return entries[0].mode->getSlotTime(); }

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getSlowerMandatoryMode

(

const IIeee80211Mode *

mode

)

const

Referenced by inet::ieee80211::QoSRateSelection::computeResponseAckFrameMode(), and inet::ieee80211::QoSRateSelection::computeResponseCtsFrameMode().

{
    int index = findModeIndex(mode);
    if (index > 0)
        for (int i = index-1; i >= 0; i--)
            if (entries[i].isMandatory)
                return entries[i].mode;
    return nullptr;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getSlowerMode

(

const IIeee80211Mode *

mode

)

const

Referenced by inet::ieee80211::RateControlBase::decreaseRateIfPossible().

{
    int index = findModeIndex(mode);
    if (index > 0)
        return entries[index - 1].mode;
    else
        return nullptr;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getSlowestMandatoryMode

(

)

const

Referenced by inet::ieee80211::Dcaf::calculateTimingParameters(), inet::ieee80211::Edcaf::calculateTimingParameters(), and inet::ieee80211::TxopProcedure::startTxop().

{
    for (int i = 0; i < (int)entries.size(); i++)
        if (entries[i].isMandatory)
            return entries[i].mode;
    return nullptr;
}

const IIeee80211Mode * inet::physicallayer::Ieee80211ModeSet::getSlowestMode

(

)

const

{
    return entries.front().mode;
}

virtual std::ostream& inet::physicallayer::Ieee80211ModeSet::printToStream ( std::ostream &  stream, int  level  ) const

inlineoverridevirtual

Prints this object to the provided output stream.

Function calls to operator<< with pointers or references either const or not are all forwarded to this function.

Reimplemented from inet::physicallayer::IPrintableObject.

{ return stream << "Ieee80211ModeSet, name = " << name; }

Member Data Documentation

const std::vector<Entry> inet::physicallayer::Ieee80211ModeSet::entries

protected

Referenced by findMode(), findModeIndex(), getFasterMandatoryMode(), getFasterMode(), getFastestMandatoryMode(), getFastestMode(), getIsMandatory(), getSlowerMandatoryMode(), getSlowerMode(), getSlowestMandatoryMode(), getSlowestMode(), and Ieee80211ModeSet().

const DelayedInitializer< std::vector< Ieee80211ModeSet > > inet::physicallayer::Ieee80211ModeSet::modeSets

static

Referenced by findModeSet(), and getModeSet().

std::string inet::physicallayer::Ieee80211ModeSet::name

protected

---

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

• Ieee80211ModeSet.h
• Ieee80211ModeSet.cc