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

This module accepts commands such as Scan, Authenticate, Deauthenticate, Associate, Reassociate, Deassociate from a connected agent module, and carries out the requested action by sending/receiving management frames, switching channels, etc.

It implementes both active and passive scanning (where active means sending Probe frames). The authentication process is simulated by exchanging dummy messages, i.e. there is no actual cryptography or not its detailed simulation involved.

Relies on the MAC layer (Ieee80211Mac) for reception and transmission of frames.

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Parameters

Name	Type	Default value	Description
interfaceTableModule	string		The path to the InterfaceTable module
numChannels	int	1	number of channels to scan
mibModule	string
macModule	string		The path to the MAC module

Properties

Name	Value	Description
display	i=block/cogwheel

Gates

Name	Direction	Size	Description
macIn	input
macOut	output
agentIn	input		used for attaching an agent algorithm
agentOut	output		used for attaching an agent algorithm

Signals

Name	Type	Unit
l2Associated	inet::NetworkInterface
l2BeaconLost	inet::NetworkInterface

Scheduled messages (observed)

msg	kind	ctrl	tags	msgname	context
omnetpp::cMessage	3			sendProbe
omnetpp::cMessage	4			minChannelTime
omnetpp::cMessage	5			maxChannelTime
omnetpp::cMessage	6			beaconTimeout

Direct method calls (observed)

call to	function	info
DhcpClient	inet::DhcpClient::receiveSignal	l2Associated
Ieee80211AgentSta	inet::ieee80211::Ieee80211AgentSta::receiveSignal	l2BeaconLost

Called methods (observed)

function	info	call from
inet::ieee80211::Ieee80211MgmtSta::receiveSignal	receptionStateChanged	Ieee80211ScalarRadio

Incoming messages (observed)

gate	msg	kind	ctrl	srcModule	tags
agentIn	omnetpp::cMessage	0	Ieee80211Prim_AssociateRequest	Ieee80211AgentSta
agentIn	omnetpp::cMessage	0	Ieee80211Prim_AuthenticateRequest	Ieee80211AgentSta
agentIn	omnetpp::cMessage	0	Ieee80211Prim_ScanRequest	Ieee80211AgentSta
macIn	Packet	0		Ieee80211Mac	ErrorRateInd, InterfaceInd, MacAddressInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd

Outgoing messages (observed)

gate	msg	kind	ctrl	destModule	tags
agentOut	omnetpp::cMessage	0	Ieee80211Prim_AssociateConfirm	Ieee80211AgentSta
agentOut	omnetpp::cMessage	0	Ieee80211Prim_AuthenticateConfirm	Ieee80211AgentSta
agentOut	omnetpp::cMessage	0	Ieee80211Prim_ScanConfirm	Ieee80211AgentSta
macOut	Packet	0		Ieee80211Mac	Ieee80211SubtypeReq, MacAddressReq, PacketProtocolTag
macOut	Request	1	Ieee80211ConfigureRadioCommand	Ieee80211Mac

Packet operations (observed)

chunkType	packetAction
Ieee80211AssociationRequestFrame	insertAtBack
Ieee80211AssociationResponseFrame	peekData
Ieee80211AuthenticationFrame	insertAtBack, peekData
Ieee80211BeaconFrame	peekData
Ieee80211DataOrMgmtHeader	peekAt
Ieee80211ProbeRequestFrame	insertAtBack
Ieee80211ProbeResponseFrame	peekData

Shared Tagging operations (observed)

tagType	tagAction
Ieee80211SubtypeReq	addTag
MacAddressReq	addTag
PacketProtocolTag	addTagIfAbsent
SignalPowerInd	getTag

Source code

//
// Used in 802.11 infrastructure mode: handles management frames for a station (STA).
//
// This module accepts commands such as Scan, Authenticate, Deauthenticate,
// Associate, Reassociate, Deassociate from a connected agent module, and carries
// out the requested action by sending/receiving management frames, switching
// channels, etc.
//
// It implementes both active and passive scanning (where active means sending
// Probe frames). The authentication process is simulated by exchanging dummy
// messages, i.e. there is no actual cryptography or not its detailed simulation
// involved.
//
// Relies on the MAC layer (~Ieee80211Mac) for reception and transmission of frames.
//
simple Ieee80211MgmtSta like IIeee80211Mgmt
{
    parameters:
        string interfaceTableModule;   // The path to the InterfaceTable module
        int numChannels = default(1);  // number of channels to scan
        string mibModule;
        string macModule;               // The path to the MAC module
        @display("i=block/cogwheel");
        @signal[l2Associated](type=inet::NetworkInterface);
        @signal[l2BeaconLost](type=inet::NetworkInterface);
    gates:
        input macIn @labels(Ieee80211MacHeader);
        output macOut @labels(Ieee80211MacHeader);
        input agentIn;   // used for attaching an agent algorithm
        output agentOut; // used for attaching an agent algorithm
}

File: src/inet/linklayer/ieee80211/mgmt/Ieee80211MgmtSta.ned

---

This documentation is released under the Creative Commons license