inet::ieee80211::FrameSequenceHandler Class Reference

#include <FrameSequenceHandler.h>

Inheritance diagram for inet::ieee80211::FrameSequenceHandler:

Public Member Functions
virtual void	startFrameSequence (IFrameSequence *frameSequence, FrameSequenceContext *context, IFrameSequenceHandler::ICallback *callback) override
virtual void	processResponse (Ieee80211Frame *frame) override
virtual void	transmissionComplete () override
virtual void	handleStartRxTimeout () override
virtual bool	isSequenceRunning () override
virtual	~FrameSequenceHandler ()
Public Member Functions inherited from inet::ieee80211::IFrameSequenceHandler
virtual	~IFrameSequenceHandler ()

Protected Member Functions
virtual void	startFrameSequenceStep ()
virtual void	finishFrameSequenceStep ()
virtual void	finishFrameSequence ()
virtual void	abortFrameSequence ()

Protected Attributes
IFrameSequenceHandler::ICallback *	callback = nullptr
IFrameSequence *	frameSequence = nullptr
FrameSequenceContext *	context = nullptr

Constructor & Destructor Documentation

inet::ieee80211::FrameSequenceHandler::~FrameSequenceHandler ( )

virtual

{
    delete frameSequence;
    delete context;
}

Member Function Documentation

void inet::ieee80211::FrameSequenceHandler::abortFrameSequence ( )

protectedvirtual

Referenced by finishFrameSequenceStep(), and handleStartRxTimeout().

{
    EV_INFO << "Frame sequence aborted\n";
    auto step = context->getLastStep();
    auto failedTxStep = check_and_cast<ITransmitStep*>(dynamic_cast<IReceiveStep*>(step) ? context->getStepBeforeLast() : step);
    auto frameToTransmit = failedTxStep->getFrameToTransmit();
    if (auto dataOrMgmtFrame = dynamic_cast<Ieee80211DataOrMgmtFrame *>(frameToTransmit))
        callback->originatorProcessFailedFrame(dataOrMgmtFrame);
    else if (auto rtsTxStep = dynamic_cast<RtsTransmitStep *>(failedTxStep))
        callback->originatorProcessRtsProtectionFailed(rtsTxStep->getProtectedFrame());
    delete context;
    delete frameSequence;
    context = nullptr;
    frameSequence = nullptr;
    callback->frameSequenceFinished();
    callback = nullptr;
}

void inet::ieee80211::FrameSequenceHandler::finishFrameSequence ( )

protectedvirtual

Referenced by startFrameSequenceStep().

{
    EV_INFO << "Frame sequence finished\n";
    delete context;
    delete frameSequence;
    context = nullptr;
    frameSequence = nullptr;
    callback->frameSequenceFinished();
    callback = nullptr;
}

void inet::ieee80211::FrameSequenceHandler::finishFrameSequenceStep ( )

protectedvirtual

Referenced by processResponse(), and transmissionComplete().

{
    ASSERT(isSequenceRunning());
    auto lastStep = context->getLastStep();
    auto stepResult = frameSequence->completeStep(context);
    // EV_INFO << "Frame sequence history:" << frameSequence->getHistory() << endl;
    if (!stepResult) {
        lastStep->setCompletion(IFrameSequenceStep::Completion::REJECTED);
        abortFrameSequence();
    }
    else {
        lastStep->setCompletion(IFrameSequenceStep::Completion::ACCEPTED);
        switch (lastStep->getType()) {
            case IFrameSequenceStep::Type::TRANSMIT: {
                auto transmitStep = static_cast<ITransmitStep *>(lastStep);
                callback->originatorProcessTransmittedFrame(transmitStep->getFrameToTransmit());
                break;
            }
            case IFrameSequenceStep::Type::RECEIVE: {
                auto receiveStep = static_cast<IReceiveStep *>(lastStep);
                auto transmitStep = check_and_cast<ITransmitStep *>(context->getStepBeforeLast());
                callback->originatorProcessReceivedFrame(receiveStep->getReceivedFrame(), transmitStep->getFrameToTransmit());
                break;
            }
            default:
                throw cRuntimeError("Unknown frame sequence step type");
        }
    }
}

void inet::ieee80211::FrameSequenceHandler::handleStartRxTimeout ( )

overridevirtual

Implements inet::ieee80211::IFrameSequenceHandler.

{
    auto lastStep = context->getLastStep();
    switch (lastStep->getType()) {
        case IFrameSequenceStep::Type::RECEIVE:
            abortFrameSequence();
            break;
        case IFrameSequenceStep::Type::TRANSMIT:
            throw cRuntimeError("Received timeout while in transmit step");
        default:
            throw cRuntimeError("Unknown step type");
    }
}

virtual bool inet::ieee80211::FrameSequenceHandler::isSequenceRunning ( )

inlineoverridevirtual

Implements inet::ieee80211::IFrameSequenceHandler.

Referenced by finishFrameSequenceStep(), processResponse(), startFrameSequence(), startFrameSequenceStep(), and transmissionComplete().

{ return frameSequence != nullptr; }

void inet::ieee80211::FrameSequenceHandler::processResponse ( Ieee80211Frame *  frame )

overridevirtual

Implements inet::ieee80211::IFrameSequenceHandler.

{
    ASSERT(callback != nullptr);
    auto lastStep = context->getLastStep();
    switch (lastStep->getType()) {
        case IFrameSequenceStep::Type::RECEIVE: {
            // TODO: check if not for us and abort
            auto receiveStep = check_and_cast<IReceiveStep *>(context->getLastStep());
            receiveStep->setFrameToReceive(frame);
            finishFrameSequenceStep();
            if (isSequenceRunning())
                startFrameSequenceStep();
            break;
        }
        case IFrameSequenceStep::Type::TRANSMIT:
            throw cRuntimeError("Received frame while current step is transmit");
        default:
            throw cRuntimeError("Unknown step type");
    }
}

void inet::ieee80211::FrameSequenceHandler::startFrameSequence ( IFrameSequence *  frameSequence, FrameSequenceContext *  context, IFrameSequenceHandler::ICallback *  callback  )

overridevirtual

Implements inet::ieee80211::IFrameSequenceHandler.

{
    this->callback = callback;
    if (!isSequenceRunning()) {
        this->frameSequence = frameSequence;
        this->context = context;
        frameSequence->startSequence(context, 0);
        startFrameSequenceStep();
    }
    else
        throw cRuntimeError("Channel access granted while a frame sequence is running");
}

void inet::ieee80211::FrameSequenceHandler::startFrameSequenceStep ( )

protectedvirtual

Referenced by processResponse(), startFrameSequence(), and transmissionComplete().

{
    ASSERT(isSequenceRunning());
    auto nextStep = frameSequence->prepareStep(context);
    // EV_INFO << "Frame sequence history:" << frameSequence->getHistory() << endl;
    if (nextStep == nullptr)
        finishFrameSequence();
    else {
        context->addStep(nextStep);
        switch (nextStep->getType()) {
            case IFrameSequenceStep::Type::TRANSMIT: {
                auto transmitStep = static_cast<TransmitStep *>(nextStep);
                EV_INFO << "Transmitting, frame = " << transmitStep->getFrameToTransmit() << "\n";
                callback->transmitFrame(transmitStep->getFrameToTransmit(), transmitStep->getIfs());
                // TODO: lifetime
                // if (auto dataFrame = dynamic_cast<Ieee80211DataFrame *>(transmitStep->getFrameToTransmit()))
                //    transmitLifetimeHandler->frameTransmitted(dataFrame);
                break;
            }
            case IFrameSequenceStep::Type::RECEIVE: {
                // start reception timer, break loop if timer expires before reception is over
                auto receiveStep = static_cast<IReceiveStep *>(nextStep);
                callback->scheduleStartRxTimer(receiveStep->getTimeout());
                break;
            }
            default:
                throw cRuntimeError("Unknown frame sequence step type");
        }
    }
}

void inet::ieee80211::FrameSequenceHandler::transmissionComplete ( )

overridevirtual

Implements inet::ieee80211::IFrameSequenceHandler.

{
    if (isSequenceRunning()) {
        finishFrameSequenceStep();
        if (isSequenceRunning())
            startFrameSequenceStep();
    }
}

Member Data Documentation

IFrameSequenceHandler::ICallback* inet::ieee80211::FrameSequenceHandler::callback = nullptr

protected

Referenced by abortFrameSequence(), finishFrameSequence(), finishFrameSequenceStep(), processResponse(), startFrameSequence(), and startFrameSequenceStep().

FrameSequenceContext* inet::ieee80211::FrameSequenceHandler::context = nullptr

protected

Referenced by abortFrameSequence(), finishFrameSequence(), finishFrameSequenceStep(), handleStartRxTimeout(), processResponse(), startFrameSequence(), startFrameSequenceStep(), and ~FrameSequenceHandler().

IFrameSequence* inet::ieee80211::FrameSequenceHandler::frameSequence = nullptr

protected

Referenced by abortFrameSequence(), finishFrameSequence(), finishFrameSequenceStep(), startFrameSequence(), startFrameSequenceStep(), and ~FrameSequenceHandler().

---

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

• FrameSequenceHandler.h
• FrameSequenceHandler.cc