inet::ieee80211::Ieee80211AgentSTA Class Reference

Used in 802.11 infrastructure mode: in a station (STA), this module controls channel scanning, association and handovers, by sending commands (e.g. More...

#include <Ieee80211AgentSTA.h>

Inheritance diagram for inet::ieee80211::Ieee80211AgentSTA:

Public Member Functions
	Ieee80211AgentSTA ()

Protected Member Functions
virtual int	numInitStages () const override
virtual void	initialize (int) override
virtual void	handleMessage (cMessage *msg) override
	Overridden cSimpleModule method. More...
virtual void	handleTimer (cMessage *msg)
	Handle timers. More...
virtual void	handleResponse (cMessage *msg)
	Handle responses from mgmgt. More...
virtual void	receiveSignal (cComponent *source, simsignal_t signalID, cObject *obj, cObject *details) override
	Redefined from cListener; called by signal handler. More...
virtual void	sendRequest (Ieee80211PrimRequest *req)
virtual int	chooseBSS (Ieee80211Prim_ScanConfirm *resp)
	Choose one AP from the list to associate with. More...
virtual void	dumpAPList (Ieee80211Prim_ScanConfirm *resp)
virtual void	sendScanRequest ()
	Sending of Request primitives. More...
virtual void	sendAuthenticateRequest (const MACAddress &address)
virtual void	sendDeauthenticateRequest (const MACAddress &address, int reasonCode)
virtual void	sendAssociateRequest (const MACAddress &address)
virtual void	sendReassociateRequest (const MACAddress &address)
virtual void	sendDisassociateRequest (const MACAddress &address, int reasonCode)
virtual void	processScanConfirm (Ieee80211Prim_ScanConfirm *resp)
	Processing Confirm primitives. More...
virtual void	processAuthenticateConfirm (Ieee80211Prim_AuthenticateConfirm *resp)
virtual void	processAssociateConfirm (Ieee80211Prim_AssociateConfirm *resp)
virtual void	processReassociateConfirm (Ieee80211Prim_ReassociateConfirm *resp)

Protected Attributes
InterfaceEntry *	myIface = nullptr
MACAddress	prevAP
bool	activeScan = false
std::vector< int >	channelsToScan
simtime_t	probeDelay
simtime_t	minChannelTime
simtime_t	maxChannelTime
simtime_t	authenticationTimeout
simtime_t	associationTimeout
std::string	default_ssid

Static Protected Attributes
static simsignal_t	sentRequestSignal = registerSignal("sentRequest")
static simsignal_t	acceptConfirmSignal = registerSignal("acceptConfirm")
static simsignal_t	dropConfirmSignal = registerSignal("dropConfirm")

Detailed Description

Used in 802.11 infrastructure mode: in a station (STA), this module controls channel scanning, association and handovers, by sending commands (e.g.

Ieee80211Prim_ScanRequest) to the management module (Ieee80211MgmtSTA).

See corresponding NED file for a detailed description.

Author

Andras Varga

Constructor & Destructor Documentation

inet::ieee80211::Ieee80211AgentSTA::Ieee80211AgentSTA ( )

inline

{}

Member Function Documentation

int inet::ieee80211::Ieee80211AgentSTA::chooseBSS ( Ieee80211Prim_ScanConfirm *  resp )

protectedvirtual

Choose one AP from the list to associate with.

Referenced by processScanConfirm().

{
    if (resp->getBssListArraySize() == 0)
        return -1;

    // here, just choose the one with the greatest receive power
    // TODO and which supports a good data rate we support
    int bestIndex = 0;
    for (int i = 0; i < (int)resp->getBssListArraySize(); i++)
        if (resp->getBssList(i).getRxPower() > resp->getBssList(bestIndex).getRxPower())
            bestIndex = i;

    return bestIndex;
}

void inet::ieee80211::Ieee80211AgentSTA::dumpAPList ( Ieee80211Prim_ScanConfirm *  resp )

protectedvirtual

Referenced by processScanConfirm().

{
    EV << "Received AP list:\n";
    for (int i = 0; i < (int)resp->getBssListArraySize(); i++) {
        Ieee80211Prim_BSSDescription& bssDesc = resp->getBssList(i);
        EV << "    " << i << ". "
           << " address=" << bssDesc.getBSSID()
           << " channel=" << bssDesc.getChannelNumber()
           << " SSID=" << bssDesc.getSSID()
           << " beaconIntvl=" << bssDesc.getBeaconInterval()
           << " rxPower=" << bssDesc.getRxPower()
           << endl;
        // later: supportedRates
    }
}

void inet::ieee80211::Ieee80211AgentSTA::handleMessage ( cMessage *  msg )

overrideprotectedvirtual

Overridden cSimpleModule method.

{
    if (msg->isSelfMessage())
        handleTimer(msg);
    else
        handleResponse(msg);
}

void inet::ieee80211::Ieee80211AgentSTA::handleResponse ( cMessage *  msg )

protectedvirtual

Handle responses from mgmgt.

Referenced by handleMessage().

{
    cObject *ctrl = msg->removeControlInfo();
    delete msg;

    EV << "Processing confirmation from mgmt: " << ctrl->getClassName() << "\n";

    if (dynamic_cast<Ieee80211Prim_ScanConfirm *>(ctrl))
        processScanConfirm((Ieee80211Prim_ScanConfirm *)ctrl);
    else if (dynamic_cast<Ieee80211Prim_AuthenticateConfirm *>(ctrl))
        processAuthenticateConfirm((Ieee80211Prim_AuthenticateConfirm *)ctrl);
    else if (dynamic_cast<Ieee80211Prim_AssociateConfirm *>(ctrl))
        processAssociateConfirm((Ieee80211Prim_AssociateConfirm *)ctrl);
    else if (dynamic_cast<Ieee80211Prim_ReassociateConfirm *>(ctrl))
        processReassociateConfirm((Ieee80211Prim_ReassociateConfirm *)ctrl);
    else if (ctrl)
        throw cRuntimeError("handleResponse(): unrecognized control info class `%s'", ctrl->getClassName());
    else
        throw cRuntimeError("handleResponse(): control info is nullptr");
    delete ctrl;
}

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

protectedvirtual

Handle timers.

Referenced by handleMessage().

{
    if (msg->getKind() == MK_STARTUP) {
        EV << "Starting up\n";
        sendScanRequest();
        delete msg;
    }
    else {
        throw cRuntimeError("internal error: unrecognized timer '%s'", msg->getName());
    }
}

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

overrideprotectedvirtual

{
    cSimpleModule::initialize(stage);

    if (stage == INITSTAGE_LOCAL) {
        // read parameters
        activeScan = par("activeScan");
        probeDelay = par("probeDelay");
        minChannelTime = par("minChannelTime");
        maxChannelTime = par("maxChannelTime");
        authenticationTimeout = par("authenticationTimeout");
        associationTimeout = par("associationTimeout");
        cStringTokenizer tokenizer(par("channelsToScan"));
        const char *token;
        while ((token = tokenizer.nextToken()) != nullptr)
            channelsToScan.push_back(atoi(token));

        cModule *host = getContainingNode(this);
        host->subscribe(NF_L2_BEACON_LOST, this);

        // JcM add: get the default ssid, if there is one.
        default_ssid = par("default_ssid").stringValue();

        // start up: send scan request
        simtime_t startingTime = par("startingTime").doubleValue();
        if (startingTime < SIMTIME_ZERO)
            startingTime = uniform(SIMTIME_ZERO, maxChannelTime);
        scheduleAt(simTime() + startingTime, new cMessage("startUp", MK_STARTUP));

        myIface = nullptr;
    }
    else if (stage == INITSTAGE_LINK_LAYER_2) {
        IInterfaceTable *ift = findModuleFromPar<IInterfaceTable>(par("interfaceTableModule"), this);
        if (ift) {
            myIface = ift->getInterfaceByName(utils::stripnonalnum(findModuleUnderContainingNode(this)->getFullName()).c_str());
        }
    }
}

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

inlineoverrideprotectedvirtual

{ return NUM_INIT_STAGES; }

void inet::ieee80211::Ieee80211AgentSTA::processAssociateConfirm ( Ieee80211Prim_AssociateConfirm *  resp )

protectedvirtual

Referenced by handleResponse().

{
    if (resp->getResultCode() != PRC_SUCCESS) {
        EV << "Association error\n";
        emit(dropConfirmSignal, PR_ASSOCIATE_CONFIRM);

        // try scanning again, maybe we'll have better luck next time, possibly with a different AP
        EV << "Going back to scanning\n";
        sendScanRequest();
    }
    else {
        EV << "Association successful\n";
        emit(acceptConfirmSignal, PR_ASSOCIATE_CONFIRM);
        // we are happy!
        getContainingNode(this)->bubble("Associated with AP");
        if (prevAP.isUnspecified() || prevAP != resp->getAddress()) {
            emit(NF_L2_ASSOCIATED_NEWAP, myIface);    //XXX detail: InterfaceEntry?
            prevAP = resp->getAddress();
        }
        else
            emit(NF_L2_ASSOCIATED_OLDAP, myIface);
    }
}

void inet::ieee80211::Ieee80211AgentSTA::processAuthenticateConfirm ( Ieee80211Prim_AuthenticateConfirm *  resp )

protectedvirtual

Referenced by handleResponse().

{
    if (resp->getResultCode() != PRC_SUCCESS) {
        EV << "Authentication error\n";
        emit(dropConfirmSignal, PR_AUTHENTICATE_CONFIRM);

        // try scanning again, maybe we'll have better luck next time, possibly with a different AP
        EV << "Going back to scanning\n";
        sendScanRequest();
    }
    else {
        EV << "Authentication successful, let's try to associate\n";
        emit(acceptConfirmSignal, PR_AUTHENTICATE_CONFIRM);
        sendAssociateRequest(resp->getAddress());
    }
}

void inet::ieee80211::Ieee80211AgentSTA::processReassociateConfirm ( Ieee80211Prim_ReassociateConfirm *  resp )

protectedvirtual

Referenced by handleResponse().

{
    // treat the same way as AssociateConfirm
    if (resp->getResultCode() != PRC_SUCCESS) {
        EV << "Reassociation error\n";
        emit(dropConfirmSignal, PR_REASSOCIATE_CONFIRM);
        EV << "Going back to scanning\n";
        sendScanRequest();
    }
    else {
        EV << "Reassociation successful\n";
        emit(NF_L2_ASSOCIATED_OLDAP, myIface);    //XXX detail: InterfaceEntry?
        emit(acceptConfirmSignal, PR_REASSOCIATE_CONFIRM);
        // we are happy!
    }
}

void inet::ieee80211::Ieee80211AgentSTA::processScanConfirm ( Ieee80211Prim_ScanConfirm *  resp )

protectedvirtual

Processing Confirm primitives.

Referenced by handleResponse().

{
    // choose best AP

    int bssIndex = -1;
    if (this->default_ssid == "") {
        // no default ssid, so pick the best one
        bssIndex = chooseBSS(resp);
    }
    else {
        // search if the default_ssid is in the list, otherwise
        // keep searching.
        for (int i = 0; i < (int)resp->getBssListArraySize(); i++) {
            std::string resp_ssid = resp->getBssList(i).getSSID();
            if (resp_ssid == this->default_ssid) {
                EV << "found default SSID " << resp_ssid << endl;
                bssIndex = i;
                break;
            }
        }
    }

    if (bssIndex == -1) {
        EV << "No (suitable) AP found, continue scanning\n";
        emit(dropConfirmSignal, PR_SCAN_CONFIRM);
        sendScanRequest();
        return;
    }

    dumpAPList(resp);
    emit(acceptConfirmSignal, PR_SCAN_CONFIRM);

    Ieee80211Prim_BSSDescription& bssDesc = resp->getBssList(bssIndex);
    EV << "Chosen AP address=" << bssDesc.getBSSID() << " from list, starting authentication\n";
    sendAuthenticateRequest(bssDesc.getBSSID());
}

void inet::ieee80211::Ieee80211AgentSTA::receiveSignal ( cComponent *  source, simsignal_t  signalID, cObject *  obj, cObject *  details  )

overrideprotectedvirtual

Redefined from cListener; called by signal handler.

{
    Enter_Method_Silent();
    printNotificationBanner(signalID, obj);

    if (signalID == NF_L2_BEACON_LOST) {
        //XXX should check details if it's about this NIC
        EV << "beacon lost, starting scanning again\n";
        getContainingNode(this)->bubble("Beacon lost!");
        //sendDisassociateRequest();
        sendScanRequest();
        emit(NF_L2_DISASSOCIATED, myIface);
    }
}

void inet::ieee80211::Ieee80211AgentSTA::sendAssociateRequest ( const MACAddress &  address )

protectedvirtual

Referenced by processAuthenticateConfirm().

{
    EV << "Sending AssociateRequest primitive to mgmt\n";
    Ieee80211Prim_AssociateRequest *req = new Ieee80211Prim_AssociateRequest();
    req->setAddress(address);
    req->setTimeout(associationTimeout);
    emit(sentRequestSignal, PR_ASSOCIATE_REQUEST);
    sendRequest(req);
}

void inet::ieee80211::Ieee80211AgentSTA::sendAuthenticateRequest ( const MACAddress &  address )

protectedvirtual

Referenced by processScanConfirm().

{
    EV << "Sending AuthenticateRequest primitive to mgmt\n";
    Ieee80211Prim_AuthenticateRequest *req = new Ieee80211Prim_AuthenticateRequest();
    req->setAddress(address);
    req->setTimeout(authenticationTimeout);
    emit(sentRequestSignal, PR_AUTHENTICATE_REQUEST);
    sendRequest(req);
}

void inet::ieee80211::Ieee80211AgentSTA::sendDeauthenticateRequest ( const MACAddress &  address, int  reasonCode  )

protectedvirtual

{
    EV << "Sending DeauthenticateRequest primitive to mgmt\n";
    Ieee80211Prim_DeauthenticateRequest *req = new Ieee80211Prim_DeauthenticateRequest();
    req->setAddress(address);
    req->setReasonCode(reasonCode);
    emit(sentRequestSignal, PR_DEAUTHENTICATE_REQUEST);
    sendRequest(req);
}

void inet::ieee80211::Ieee80211AgentSTA::sendDisassociateRequest ( const MACAddress &  address, int  reasonCode  )

protectedvirtual

{
    EV << "Sending DisassociateRequest primitive to mgmt\n";
    Ieee80211Prim_DisassociateRequest *req = new Ieee80211Prim_DisassociateRequest();
    req->setAddress(address);
    req->setReasonCode(reasonCode);
    emit(sentRequestSignal, PR_DISASSOCIATE_REQUEST);
    sendRequest(req);
}

void inet::ieee80211::Ieee80211AgentSTA::sendReassociateRequest ( const MACAddress &  address )

protectedvirtual

{
    EV << "Sending ReassociateRequest primitive to mgmt\n";
    Ieee80211Prim_ReassociateRequest *req = new Ieee80211Prim_ReassociateRequest();
    req->setAddress(address);
    req->setTimeout(associationTimeout);
    emit(sentRequestSignal, PR_REASSOCIATE_REQUEST);
    sendRequest(req);
}

void inet::ieee80211::Ieee80211AgentSTA::sendRequest ( Ieee80211PrimRequest *  req )

protectedvirtual

Referenced by sendAssociateRequest(), sendAuthenticateRequest(), sendDeauthenticateRequest(), sendDisassociateRequest(), sendReassociateRequest(), and sendScanRequest().

{
    cMessage *msg = new cMessage(req->getClassName());
    msg->setControlInfo(req);
    send(msg, "mgmtOut");
}

void inet::ieee80211::Ieee80211AgentSTA::sendScanRequest ( )

protectedvirtual

Sending of Request primitives.

Referenced by handleTimer(), processAssociateConfirm(), processAuthenticateConfirm(), processReassociateConfirm(), processScanConfirm(), and receiveSignal().

{
    EV << "Sending ScanRequest primitive to mgmt\n";
    Ieee80211Prim_ScanRequest *req = new Ieee80211Prim_ScanRequest();
    req->setBSSType(BSSTYPE_INFRASTRUCTURE);
    req->setActiveScan(activeScan);
    req->setProbeDelay(probeDelay);
    req->setMinChannelTime(minChannelTime);
    req->setMaxChannelTime(maxChannelTime);
    req->setChannelListArraySize(channelsToScan.size());
    for (int i = 0; i < (int)channelsToScan.size(); i++)
        req->setChannelList(i, channelsToScan[i]);
    //XXX BSSID, SSID are left at default ("any")

    emit(sentRequestSignal, PR_SCAN_REQUEST);
    sendRequest(req);
}

Member Data Documentation

simsignal_t inet::ieee80211::Ieee80211AgentSTA::acceptConfirmSignal = registerSignal("acceptConfirm")

staticprotected

Referenced by processAssociateConfirm(), processAuthenticateConfirm(), processReassociateConfirm(), and processScanConfirm().

bool inet::ieee80211::Ieee80211AgentSTA::activeScan = false

protected

Referenced by initialize(), and sendScanRequest().

simtime_t inet::ieee80211::Ieee80211AgentSTA::associationTimeout

protected

Referenced by initialize(), sendAssociateRequest(), and sendReassociateRequest().

simtime_t inet::ieee80211::Ieee80211AgentSTA::authenticationTimeout

protected

Referenced by initialize(), and sendAuthenticateRequest().

std::vector<int> inet::ieee80211::Ieee80211AgentSTA::channelsToScan

protected

Referenced by initialize(), and sendScanRequest().

std::string inet::ieee80211::Ieee80211AgentSTA::default_ssid

protected

Referenced by initialize(), and processScanConfirm().

simsignal_t inet::ieee80211::Ieee80211AgentSTA::dropConfirmSignal = registerSignal("dropConfirm")

staticprotected

Referenced by processAssociateConfirm(), processAuthenticateConfirm(), processReassociateConfirm(), and processScanConfirm().

simtime_t inet::ieee80211::Ieee80211AgentSTA::maxChannelTime

protected

Referenced by initialize(), and sendScanRequest().

simtime_t inet::ieee80211::Ieee80211AgentSTA::minChannelTime

protected

Referenced by initialize(), and sendScanRequest().

InterfaceEntry* inet::ieee80211::Ieee80211AgentSTA::myIface = nullptr

protected

Referenced by initialize(), processAssociateConfirm(), processReassociateConfirm(), and receiveSignal().

MACAddress inet::ieee80211::Ieee80211AgentSTA::prevAP

protected

Referenced by processAssociateConfirm().

simtime_t inet::ieee80211::Ieee80211AgentSTA::probeDelay

protected

Referenced by initialize(), and sendScanRequest().

simsignal_t inet::ieee80211::Ieee80211AgentSTA::sentRequestSignal = registerSignal("sentRequest")

staticprotected

Referenced by sendAssociateRequest(), sendAuthenticateRequest(), sendDeauthenticateRequest(), sendDisassociateRequest(), sendReassociateRequest(), and sendScanRequest().

---

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

• Ieee80211AgentSTA.h
• Ieee80211AgentSTA.cc