Ieee80211MgmtSta¶

simple module Ieee80211MgmtSta

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 implements 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 its detailed simulation involved.

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

Usage diagram¶

Inheritance diagram¶

Used in compound modules¶

Name	Type	Description
ExtUpperIeee80211Interface	compound module	Provides an IEEE 802.11 network interface suitable for emulation. The upper part of the network interface is realized in the real world using a real TAP device of the host computer which is running the simulation.
Ieee80211Interface	compound module	Implements an IEEE 802.11 network interface. It implements a large subset of the IEEE 802.11 standard, and may use radio models and wireless signal representations of varying levels of detail. It is also extremely configurable, and its component structure makes it easy to experiment with various details of the protocol.

Extends¶

Name	Type	Description
SimpleModule	simple module	Base module for all INET simple modules.

Parameters¶

Name	Type	Default value	Description
displayStringTextFormat	string	“”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
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
class	Ieee80211MgmtSta
display	i=block/cogwheel

Gates¶

Name	Direction	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	Description
l2Associated	inet::NetworkInterface
l2BeaconLost	inet::NetworkInterface

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 implements 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 its detailed simulation
// involved.
//
// Relies on the MAC layer (~Ieee80211Mac) for reception and transmission of frames.
//
simple Ieee80211MgmtSta extends SimpleModule like IIeee80211Mgmt
{
    parameters:
        @class(Ieee80211MgmtSta);
        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