inet::ieee80211::Ieee80211MgmtSTASimplified Class Reference

Used in 802.11 infrastructure mode: handles management frames for a station (STA). More...

#include <Ieee80211MgmtSTASimplified.h>

Inheritance diagram for inet::ieee80211::Ieee80211MgmtSTASimplified:

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int) override
virtual void	handleTimer (cMessage *msg) override
	Implements abstract Ieee80211MgmtBase method. More...
virtual void	handleUpperMessage (cPacket *msg) override
	Implements abstract Ieee80211MgmtBase method. More...
virtual void	handleCommand (int msgkind, cObject *ctrl) override
	Implements abstract Ieee80211MgmtBase method – throws an error (no commands supported) More...
virtual Ieee80211DataFrame *	encapsulate (cPacket *msg)
	Utility function for handleUpperMessage() More...
virtual cPacket *	decapsulate (Ieee80211DataFrame *frame)
	Utility method to decapsulate a data frame. More...
Processing of different frame types
virtual void	handleDataFrame (Ieee80211DataFrame *frame) override
virtual void	handleAuthenticationFrame (Ieee80211AuthenticationFrame *frame) override
virtual void	handleDeauthenticationFrame (Ieee80211DeauthenticationFrame *frame) override
virtual void	handleAssociationRequestFrame (Ieee80211AssociationRequestFrame *frame) override
virtual void	handleAssociationResponseFrame (Ieee80211AssociationResponseFrame *frame) override
virtual void	handleReassociationRequestFrame (Ieee80211ReassociationRequestFrame *frame) override
virtual void	handleReassociationResponseFrame (Ieee80211ReassociationResponseFrame *frame) override
virtual void	handleDisassociationFrame (Ieee80211DisassociationFrame *frame) override
virtual void	handleBeaconFrame (Ieee80211BeaconFrame *frame) override
virtual void	handleProbeRequestFrame (Ieee80211ProbeRequestFrame *frame) override
virtual void	handleProbeResponseFrame (Ieee80211ProbeResponseFrame *frame) override
Protected Member Functions inherited from inet::ieee80211::Ieee80211MgmtBase
virtual void	handleMessage (cMessage *msg) override
	Dispatches incoming messages to handleTimer(), handleUpperMessage() or processFrame(). More...
virtual void	sendDown (cPacket *frame)
	Utility method for implementing handleUpperMessage(): send message to MAC. More...
virtual void	dropManagementFrame (Ieee80211ManagementFrame *frame)
	Utility method to dispose of an unhandled frame. More...
virtual void	sendUp (cMessage *msg)
	Utility method: sends the packet to the upper layer. More...
virtual void	processFrame (Ieee80211DataOrMgmtFrame *frame)
	Dispatch to frame processing methods according to frame type. More...
virtual void	start ()
	lifecycle support More...
virtual void	stop ()

Protected Attributes
MACAddress	accessPointAddress
int	receiveSequence
Protected Attributes inherited from inet::ieee80211::Ieee80211MgmtBase
MACAddress	myAddress
bool	isOperational
long	numDataFramesReceived
long	numMgmtFramesReceived
long	numMgmtFramesDropped

Additional Inherited Members
Public Member Functions inherited from inet::ieee80211::Ieee80211MgmtBase
virtual bool	handleOperationStage (LifecycleOperation *operation, int stage, IDoneCallback *doneCallback) override
	Perform one stage of a lifecycle operation. More...
Public Member Functions inherited from inet::ILifecycle
virtual	~ILifecycle ()

Detailed Description

Used in 802.11 infrastructure mode: handles management frames for a station (STA).

See corresponding NED file for a detailed description. This implementation ignores many details.

Author

Andras Varga

Member Function Documentation

cPacket * inet::ieee80211::Ieee80211MgmtSTASimplified::decapsulate ( Ieee80211DataFrame *  frame )

protectedvirtual

Utility method to decapsulate a data frame.

Referenced by handleDataFrame().

{
    cPacket *payload = frame->decapsulate();

    Ieee802Ctrl *ctrl = new Ieee802Ctrl();
    ctrl->setSrc(frame->getAddress3());
    ctrl->setDest(frame->getReceiverAddress());
    if (frame->getType() == ST_DATA_WITH_QOS) {
        int tid = frame->getTid();
        if (tid < 8)
            ctrl->setUserPriority(tid); // TID values 0..7 are UP
    }
    Ieee80211DataFrameWithSNAP *frameWithSNAP = dynamic_cast<Ieee80211DataFrameWithSNAP *>(frame);
    if (frameWithSNAP)
        ctrl->setEtherType(frameWithSNAP->getEtherType());
    payload->setControlInfo(ctrl);

    delete frame;
    return payload;
}

Ieee80211DataFrame * inet::ieee80211::Ieee80211MgmtSTASimplified::encapsulate ( cPacket *  msg )

protectedvirtual

Utility function for handleUpperMessage()

Referenced by handleUpperMessage().

{
    Ieee80211DataFrameWithSNAP *frame = new Ieee80211DataFrameWithSNAP(msg->getName());

    // frame goes to the AP
    frame->setToDS(true);

    // receiver is the AP
    frame->setReceiverAddress(accessPointAddress);

    // destination address is in address3
    Ieee802Ctrl *ctrl = check_and_cast<Ieee802Ctrl *>(msg->removeControlInfo());
    ASSERT(!ctrl->getDest().isUnspecified());
    frame->setAddress3(ctrl->getDest());
    frame->setEtherType(ctrl->getEtherType());
    int up = ctrl->getUserPriority();
    if (up >= 0) {
        // make it a QoS frame, and set TID
        frame->setType(ST_DATA_WITH_QOS);
        frame->addBitLength(QOSCONTROL_BITS);
        frame->setTid(up);
    }
    delete ctrl;

    frame->encapsulate(msg);
    return frame;
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleAssociationRequestFrame ( Ieee80211AssociationRequestFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleAssociationResponseFrame ( Ieee80211AssociationResponseFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleAuthenticationFrame ( Ieee80211AuthenticationFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleBeaconFrame ( Ieee80211BeaconFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleCommand ( int  msgkind, cObject *  ctrl  )

overrideprotectedvirtual

Implements abstract Ieee80211MgmtBase method – throws an error (no commands supported)

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    throw cRuntimeError("handleCommand(): no commands supported");
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleDataFrame ( Ieee80211DataFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    sendUp(decapsulate(frame));
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleDeauthenticationFrame ( Ieee80211DeauthenticationFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleDisassociationFrame ( Ieee80211DisassociationFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleProbeRequestFrame ( Ieee80211ProbeRequestFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleProbeResponseFrame ( Ieee80211ProbeResponseFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleReassociationRequestFrame ( Ieee80211ReassociationRequestFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleReassociationResponseFrame ( Ieee80211ReassociationResponseFrame *  frame )

overrideprotectedvirtual

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    dropManagementFrame(frame);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleTimer ( cMessage *  msg )

overrideprotectedvirtual

Implements abstract Ieee80211MgmtBase method.

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    ASSERT(false);
}

void inet::ieee80211::Ieee80211MgmtSTASimplified::handleUpperMessage ( cPacket *  msg )

overrideprotectedvirtual

Implements abstract Ieee80211MgmtBase method.

Implements inet::ieee80211::Ieee80211MgmtBase.

{
    if (accessPointAddress.isUnspecified()) {
        EV << "STA is not associated with an access point, discarding packet " << msg << "\n";
        delete msg;
        return;
    }
    Ieee80211DataFrame *frame = encapsulate(msg);
    sendDown(frame);
}

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

overrideprotectedvirtual

Reimplemented from inet::ieee80211::Ieee80211MgmtBase.

{
    Ieee80211MgmtBase::initialize(stage);

    if (stage == INITSTAGE_LOCAL) {
        accessPointAddress.setAddress(par("accessPointAddress").stringValue());
        receiveSequence = 0;
    }
}

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

inlineoverrideprotectedvirtual

Reimplemented from inet::ieee80211::Ieee80211MgmtBase.

{ return NUM_INIT_STAGES; }

Member Data Documentation

MACAddress inet::ieee80211::Ieee80211MgmtSTASimplified::accessPointAddress

protected

Referenced by encapsulate(), handleUpperMessage(), and initialize().

int inet::ieee80211::Ieee80211MgmtSTASimplified::receiveSequence

protected

Referenced by initialize().

---

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

• Ieee80211MgmtSTASimplified.h
• Ieee80211MgmtSTASimplified.cc