inet::ieee80211::DcfFs Class Reference

#include <DcfFs.h>

Inheritance diagram for inet::ieee80211::DcfFs:

Public Member Functions
	DcfFs ()
virtual int	selectDcfSequence (AlternativesFs *frameSequence, FrameSequenceContext *context)
virtual int	selectSelfCtsOrRtsCts (AlternativesFs *frameSequence, FrameSequenceContext *context)
virtual int	selectMulticastDataOrMgmt (AlternativesFs *frameSequence, FrameSequenceContext *context)
virtual bool	hasMoreFragments (RepeatingFs *frameSequence, FrameSequenceContext *context)
virtual bool	isSelfCtsNeeded (OptionalFs *frameSequence, FrameSequenceContext *context)
virtual bool	isRtsCtsNeeded (OptionalFs *frameSequence, FrameSequenceContext *context)
virtual bool	isCtsOrRtsCtsNeeded (OptionalFs *frameSequence, FrameSequenceContext *context)
virtual bool	isBroadcastManagementOrGroupDataSequenceNeeded (AlternativesFs *frameSequence, FrameSequenceContext *context)
virtual bool	isFragFrameSequenceNeeded (AlternativesFs *frameSequence, FrameSequenceContext *context)
Public Member Functions inherited from inet::ieee80211::AlternativesFs
virtual	~AlternativesFs ()
	AlternativesFs (std::vector< IFrameSequence * > elements, std::function< int(AlternativesFs *, FrameSequenceContext *)> selector)
virtual int	getStep ()
virtual int	selectSequence (FrameSequenceContext *context)
virtual void	startSequence (FrameSequenceContext *context, int firstStep) override
virtual IFrameSequenceStep *	prepareStep (FrameSequenceContext *context) override
virtual bool	completeStep (FrameSequenceContext *context) override
virtual std::string	getHistory () override
Public Member Functions inherited from inet::ieee80211::IFrameSequence
virtual	~IFrameSequence ()

Additional Inherited Members
Protected Attributes inherited from inet::ieee80211::AlternativesFs
int	firstStep = -1
int	step = -1
int	elementIndex = -1
std::vector< IFrameSequence * >	elements
std::function< int(AlternativesFs *, FrameSequenceContext *)>	selector

Constructor & Destructor Documentation

inet::ieee80211::DcfFs::DcfFs

(

)

             :
    // Excerpt from G.2 Basic sequences (p. 2309)
    // frame-sequence =
    //   ( [ CTS ] ( Management + broadcast | Data + group ) ) |
    //   ( [ CTS | RTS CTS] {frag-frame ACK } last-frame ACK )
    //
    // frag-frame = ( Data | Management ) + individual + frag;
    // last-frame = ( Data | Management ) + individual + last;
    //
    AlternativesFs({new SequentialFs({new OptionalFs(new SelfCtsFs(), OPTIONALFS_PREDICATE(isSelfCtsNeeded)),
                                      new AlternativesFs({new ManagementFs(), new DataFs()}, ALTERNATIVESFS_SELECTOR(selectMulticastDataOrMgmt))}),
                    new SequentialFs({new OptionalFs(new AlternativesFs({new SelfCtsFs(), new SequentialFs({new RtsFs(), new CtsFs()})},
                                                                        ALTERNATIVESFS_SELECTOR(selectSelfCtsOrRtsCts)),
                                                     OPTIONALFS_PREDICATE(isCtsOrRtsCtsNeeded)),
                                      new RepeatingFs(new FragFrameAckFs(), REPEATINGFS_PREDICATE(hasMoreFragments)),
                                      new LastFrameAckFs()})},
                   ALTERNATIVESFS_SELECTOR(selectDcfSequence))
{
}

Member Function Documentation

bool inet::ieee80211::DcfFs::hasMoreFragments ( RepeatingFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by DcfFs().

{
    return context->getInProgressFrames()->hasInProgressFrames() && context->getInProgressFrames()->getFrameToTransmit()->getMoreFragments();
}

bool inet::ieee80211::DcfFs::isBroadcastManagementOrGroupDataSequenceNeeded ( AlternativesFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by selectDcfSequence().

{
    if (context->getInProgressFrames()->hasInProgressFrames()) {
        auto frameToTransmit = context->getInProgressFrames()->getFrameToTransmit();
        return frameToTransmit->getReceiverAddress().isMulticast();
    }
    else
        return false;
}

bool inet::ieee80211::DcfFs::isCtsOrRtsCtsNeeded ( OptionalFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by DcfFs().

{
    bool selfCts = isSelfCtsNeeded(frameSequence, context);
    bool rtsCts = isRtsCtsNeeded(frameSequence, context);
    return selfCts || rtsCts;
}

bool inet::ieee80211::DcfFs::isFragFrameSequenceNeeded ( AlternativesFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by selectDcfSequence().

{
    return context->getInProgressFrames()->hasInProgressFrames() && dynamic_cast<Ieee80211DataOrMgmtFrame*>(context->getInProgressFrames()->getFrameToTransmit());
}

bool inet::ieee80211::DcfFs::isRtsCtsNeeded ( OptionalFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by isCtsOrRtsCtsNeeded(), and selectSelfCtsOrRtsCts().

{
    auto protectedFrame = context->getInProgressFrames()->getFrameToTransmit();
    return context->getRtsPolicy()->isRtsNeeded(protectedFrame);
}

bool inet::ieee80211::DcfFs::isSelfCtsNeeded ( OptionalFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by DcfFs(), isCtsOrRtsCtsNeeded(), and selectSelfCtsOrRtsCts().

{
    return false; // TODO: Implement
}

int inet::ieee80211::DcfFs::selectDcfSequence ( AlternativesFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by DcfFs().

{
    bool multicastMgmtOrDataSequence = isBroadcastManagementOrGroupDataSequenceNeeded(frameSequence, context);
    bool fragFrameSequence = isFragFrameSequenceNeeded(frameSequence, context);
    if (multicastMgmtOrDataSequence) return 0;
    else if (fragFrameSequence) return 1;
    else throw cRuntimeError("One alternative must be chosen");
}

int inet::ieee80211::DcfFs::selectMulticastDataOrMgmt ( AlternativesFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by DcfFs().

{
    auto frameToTransmit = context->getInProgressFrames()->getFrameToTransmit();
    return dynamic_cast<Ieee80211ManagementFrame*>(frameToTransmit) ? 0 : 1;
}

int inet::ieee80211::DcfFs::selectSelfCtsOrRtsCts ( AlternativesFs *  frameSequence, FrameSequenceContext *  context  )

virtual

Referenced by DcfFs().

{
    bool selfCts = isSelfCtsNeeded(nullptr, context); // TODO
    bool rtsCts = isRtsCtsNeeded(nullptr, context); // TODO
    if (selfCts) return 0;
    else if (rtsCts) return 1;
    else throw cRuntimeError("One alternative must be chosen");
}

---

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

• DcfFs.h
• DcfFs.cc