Implementation of the 802.11b MAC protocol. This module is intended to be used in combination with the Ieee80211Radio module as the physical layer.

Encapsulation/decapsulation must be done in the upper layers. (It is typically in the 802.11 management module, see in Ieee80211Interface). The base class for 802.11 frame messages is Ieee80211MacHeader, but this module expects Ieee80211DataOrMgmtHeader (a subclass) from upper layers (the management module). This module will assign the transmitter address (address 2) and the frame sequence number/fragment number fields in the frames; all other fields must already be filled when this module gets the frame for transmission.

Limitations

Power management and polling (PCF) are not supported.

Physical layer algorithms such as frequency hopping and direct sequence spread spectrum are not modelled directly.

Fields related to the above unsupported features are omitted from management frame formats as well (for example, FH/DS/CF parameter sets, beacon/probe timestamp which is related to physical layer synchronization, listen interval which is related to power management, capability information which is related to PCF and other non-modelled features).

Usage diagram

The following diagram shows usage relationships between types. Unresolved types are missing from the diagram.

Inheritance diagram

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

Extends

Name	Type	Description
MacProtocolBase	simple module	Module base for different MAC protocols.

Parameters

Name	Type	Default value	Description
interfaceTableModule	string
mibModule	string
modeSet	string	"g(mixed)"
fcsMode	string	"declared"
initialRadioMode	string	"receiver"
mtu	int	2304B
qosStation	bool	false

Properties

Name	Value	Description
display	i=block/layer
class	Ieee80211Mac

Gates

Name	Direction	Size	Description
upperLayerIn	input
upperLayerOut	output
lowerLayerIn	input
lowerLayerOut	output
mgmtIn	input
mgmtOut	output

Signals

Name	Type	Unit
modesetChanged	inet::physicallayer::Ieee80211ModeSet
linkBroken	inet::Packet

Statistics

Name	Title	Source	Record	Unit	Interpolation Mode
packetDropOther	packet drops: other	packetDropReasonIsOther(packetDropped)	count, sum(packetBytes), vector(packetBytes)		none
packetDropNotAddressedToUs	packet drops: not addressed to us	packetDropReasonIsNotAddressedToUs(packetDropped)	count, sum(packetBytes), vector(packetBytes)		none
packetDropDuplicateDetected	packet drops: duplicate detected	packetDropReasonIsDuplicateDetected(packetDropped)	count, sum(packetBytes), vector(packetBytes)		none
packetReceivedFromUpper	packets received from upper layer		count, sum(packetBytes), vector(packetBytes)		none
packetReceivedFromLower	packets received from lower layer		count, sum(packetBytes), vector(packetBytes)		none
packetDropQueueOverflow	packet drops: queue overflow	packetDropReasonIsQueueOverflow(packetDropped)	count, sum(packetBytes), vector(packetBytes)		none
packetDropRetryLimitReached	packet drops: retry limit reached	packetDropReasonIsRetryLimitReached(packetDropped)	count, sum(packetBytes), vector(packetBytes)		none
packetSentToLower	packets sent to lower layer		count, sum(packetBytes), vector(packetBytes)		none
packetSentToUpper	packets sent to upper layer		count, sum(packetBytes), vector(packetBytes)		none
linkBroken	link breaks		count, vector?		none
packetDrop	packet drops	packetDropped	count, sum(packetBytes), vector(packetBytes)		none
packetDropIncorrectlyReceived	packet drops: incorrectly received	packetDropReasonIsIncorrectlyReceived(packetDropped)	count, sum(packetBytes), vector(packetBytes)		none

Direct method calls (observed)

call to	function	info
PcapRecorder	inet::PcapRecorder::receiveSignal	packetReceivedFromLower
PcapRecorder	inet::PcapRecorder::receiveSignal	packetSentToLower
Ds	inet::ieee80211::Ds::processDataFrame	processDataFrame
Ieee80211Mac	inet::ieee80211::Ieee80211Mac::processLowerFrame	processLowerFrame("%s")
Ieee80211Mac	inet::ieee80211::Ieee80211Mac::processUpperFrame	processUpperFrame("%s")
Rx	inet::ieee80211::Rx::lowerFrameReceived	lowerFrameReceived("%s")
Rx	inet::ieee80211::Rx::receivedSignalPartChanged	receivedSignalPartChanged
Rx	inet::ieee80211::Rx::receptionStateChanged	receptionStateChanged
Rx	inet::ieee80211::Rx::transmissionStateChanged	transmissionStateChanged
Tx	inet::ieee80211::Tx::radioTransmissionFinished	radioTransmissionFinished
OriginatorBlockAckAgreementPolicy	inet::ieee80211::OriginatorBlockAckAgreementPolicy::receiveSignal	modesetChanged
Dcaf	inet::ieee80211::Dcaf::receiveSignal	modesetChanged
Edcaf	inet::ieee80211::Edcaf::receiveSignal	modesetChanged
Dcf	inet::ieee80211::Dcf::corruptedFrameReceived	corruptedFrameReceived
Dcf	inet::ieee80211::Dcf::processLowerFrame	processLowerFrame(%s)
Dcf	inet::ieee80211::Dcf::processUpperFrame	processUpperFrame(%s)
Dcf	inet::ieee80211::Dcf::receiveSignal	modesetChanged
Hcf	inet::ieee80211::Hcf::corruptedFrameReceived	corruptedFrameReceived
Hcf	inet::ieee80211::Hcf::processLowerFrame	processLowerFrame(%s)
Hcf	inet::ieee80211::Hcf::processUpperFrame	processUpperFrame(%s)
Hcf	inet::ieee80211::Hcf::receiveSignal	modesetChanged
OriginatorAckPolicy	inet::ieee80211::OriginatorAckPolicy::receiveSignal	modesetChanged
OriginatorQosAckPolicy	inet::ieee80211::OriginatorQosAckPolicy::receiveSignal	modesetChanged
QosRtsPolicy	inet::ieee80211::QosRtsPolicy::receiveSignal	modesetChanged
RtsPolicy	inet::ieee80211::RtsPolicy::receiveSignal	modesetChanged
TxopProcedure	inet::ieee80211::TxopProcedure::receiveSignal	modesetChanged
OriginatorProtectionMechanism	inet::ieee80211::OriginatorProtectionMechanism::receiveSignal	modesetChanged
SingleProtectionMechanism	inet::ieee80211::SingleProtectionMechanism::receiveSignal	modesetChanged
AarfRateControl	inet::ieee80211::AarfRateControl::receiveSignal	modesetChanged
QosRateSelection	inet::ieee80211::QosRateSelection::receiveSignal	modesetChanged
RateSelection	inet::ieee80211::RateSelection::receiveSignal	modesetChanged
CtsPolicy	inet::ieee80211::CtsPolicy::receiveSignal	modesetChanged
QosCtsPolicy	inet::ieee80211::QosCtsPolicy::receiveSignal	modesetChanged
RecipientAckPolicy	inet::ieee80211::RecipientAckPolicy::receiveSignal	modesetChanged
RecipientQosAckPolicy	inet::ieee80211::RecipientQosAckPolicy::receiveSignal	modesetChanged
InterfaceTable	inet::InterfaceTable::interfaceChanged	interfaceChanged
ApskScalarRadio	inet::physicallayer::ApskRadio::setRadioMode	setRadioMode
Ieee80211OfdmRadio	inet::physicallayer::Ieee80211OfdmRadio::setRadioMode	setRadioMode
Ieee80211DimensionalRadio	inet::physicallayer::Ieee80211Radio::setRadioMode	setRadioMode
Ieee80211Radio	inet::physicallayer::Ieee80211Radio::setRadioMode	setRadioMode
Ieee80211ScalarRadio	inet::physicallayer::Ieee80211Radio::setRadioMode	setRadioMode
Ieee80211UnitDiskRadio	inet::physicallayer::Radio::setRadioMode	setRadioMode
UnitDiskRadio	inet::physicallayer::UnitDiskRadio::setRadioMode	setRadioMode

Called methods (observed)

function	info	call from
inet::ieee80211::Ieee80211Mac::handleOperationStage	handleOperationStage	ScenarioManager, SimpleEpEnergyManagement, SimpleEpEnergyStorage
inet::ieee80211::Ieee80211Mac::processLowerFrame	processLowerFrame("%s")	Ieee80211Mac
inet::ieee80211::Ieee80211Mac::processUpperFrame	processUpperFrame("%s")	Ds, Ieee80211Mac
inet::ieee80211::Ieee80211Mac::receiveSignal	radioModeChanged	ApskScalarRadio, Ieee80211OfdmRadio, Ieee80211DimensionalRadio, Ieee80211Radio, Ieee80211ScalarRadio, Ieee80211UnitDiskRadio, UnitDiskRadio
inet::ieee80211::Ieee80211Mac::receiveSignal	receivedSignalPartChanged	ApskScalarRadio, Ieee80211OfdmRadio, Ieee80211DimensionalRadio, Ieee80211Radio, Ieee80211ScalarRadio, Ieee80211UnitDiskRadio, UnitDiskRadio
inet::ieee80211::Ieee80211Mac::receiveSignal	receptionStateChanged	ApskScalarRadio, Ieee80211OfdmRadio, Ieee80211DimensionalRadio, Ieee80211Radio, Ieee80211ScalarRadio, Ieee80211UnitDiskRadio, UnitDiskRadio
inet::ieee80211::Ieee80211Mac::receiveSignal	transmissionStateChanged	ApskScalarRadio, Ieee80211OfdmRadio, Ieee80211DimensionalRadio, Ieee80211Radio, Ieee80211ScalarRadio, Ieee80211UnitDiskRadio, UnitDiskRadio
inet::ieee80211::Ieee80211Mac::sendDownFrame	sendDownFrame("%s")	Tx
inet::ieee80211::Ieee80211Mac::sendUp	sendUp("%s")	Ds
inet::ieee80211::Ieee80211Mac::sendUpFrame	sendUpFrame("%s")	Dcf, Hcf

Incoming messages (observed)

gate	msg	kind	ctrl	srcModule	tags
lowerLayerIn	Packet	0		ApskScalarRadio	ErrorRateInd, MacAddressInd, PacketProtocolTag, SnirInd, Ieee80211ModeReq, DispatchProtocolInd?, DispatchProtocolReq?, InterfaceReq?, MacAddressReq?, NetworkProtocolInd?, SocketReq?, LlcProtocolTag?
lowerLayerIn	Packet	0		Ieee80211OfdmRadio	ErrorRateInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd, PacketProtocolTag?
lowerLayerIn	Packet	0		Ieee80211DimensionalRadio	ErrorRateInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
lowerLayerIn	Packet	0		Ieee80211Radio	ErrorRateInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
lowerLayerIn	Packet	0		Ieee80211ScalarRadio	ErrorRateInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
lowerLayerIn	Packet	0		Ieee80211UnitDiskRadio	ErrorRateInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
lowerLayerIn	Packet	0		UnitDiskRadio	ErrorRateInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd
mgmtIn	Packet	0		Ieee80211MgmtAp	Ieee80211SubtypeReq, MacAddressReq, PacketProtocolTag
mgmtIn	Packet	0		Ieee80211MgmtSta	Ieee80211SubtypeReq, MacAddressReq, PacketProtocolTag
mgmtIn	Request	1	Ieee80211ConfigureRadioCommand	Ieee80211MgmtSta
upperLayerIn	Packet	0		Ieee80211LlcEpd	InterfaceReq, MacAddressReq, PacketProtocolTag, LlcProtocolTag, DispatchProtocolInd?, NetworkProtocolInd?, SocketReq?
upperLayerIn	Packet	0		Ieee80211LlcLpd	DispatchProtocolReq, InterfaceReq, MacAddressReq, PacketProtocolTag, LlcProtocolTag, DirectionTag?, DispatchProtocolInd?, EcnInd?, ErrorRateInd?, Ieee802SapInd?, Ieee802SapReq?, InterfaceInd?, MacAddressInd?, MulticastReq?, NetworkProtocolInd?, NextHopAddressReq?, SignalPowerInd?, SignalTimeInd?, SnirInd?, SocketReq?, TransportProtocolInd?, UserPriorityReq?, Ieee80211ChannelInd?, Ieee80211ModeInd?
upperLayerIn	Packet	0		Ieee80211Portal	DirectionTag, InterfaceReq, MacAddressReq, PacketProtocolTag

Outgoing messages (observed)

gate	msg	kind	ctrl	destModule	tags
lowerLayerOut	Packet	0		ApskScalarRadio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DispatchProtocolInd?, DispatchProtocolReq?, InterfaceReq?, MacAddressReq?, NetworkProtocolInd?, SocketReq?, LlcProtocolTag?
lowerLayerOut	Packet	0		Ieee80211OfdmRadio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DirectionTag?, DispatchProtocolInd?, DispatchProtocolReq?, InterfaceReq?, MacAddressReq?, MulticastReq?, NetworkProtocolInd?, SocketReq?, TransportProtocolInd?, LlcProtocolTag?
lowerLayerOut	Packet	0		Ieee80211DimensionalRadio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DispatchProtocolInd?, DispatchProtocolReq?, InterfaceReq?, MacAddressReq?, MulticastReq?, NetworkProtocolInd?, SocketReq?, TransportProtocolInd?, LlcProtocolTag?
lowerLayerOut	Packet	0		Ieee80211Radio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DirectionTag?, DispatchProtocolInd?, DispatchProtocolReq?, InterfaceReq?, MacAddressReq?, MulticastReq?, NetworkProtocolInd?, TransportProtocolInd?, LlcProtocolTag?
lowerLayerOut	Packet	0		Ieee80211ScalarRadio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DirectionTag?, DispatchProtocolInd?, DispatchProtocolReq?, EcnInd?, ErrorRateInd?, Ieee80211SubtypeReq?, Ieee802SapInd?, Ieee802SapReq?, InterfaceInd?, InterfaceReq?, MacAddressReq?, MulticastReq?, NetworkProtocolInd?, NextHopAddressReq?, SignalPowerInd?, SignalTimeInd?, SnirInd?, SocketReq?, TransportProtocolInd?, UserPriorityReq?, LlcProtocolTag?, Ieee80211ChannelInd?, Ieee80211ModeInd?
lowerLayerOut	Packet	0		Ieee80211UnitDiskRadio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DispatchProtocolInd?, DispatchProtocolReq?, ErrorRateInd?, Ieee802SapInd?, InterfaceInd?, InterfaceReq?, MacAddressReq?, MulticastReq?, NetworkProtocolInd?, SignalPowerInd?, SignalTimeInd?, SnirInd?, SocketReq?, TransportProtocolInd?, LlcProtocolTag?, Ieee80211ChannelInd?, Ieee80211ModeInd?
lowerLayerOut	Packet	0		UnitDiskRadio	MacAddressInd, PacketProtocolTag, Ieee80211ModeReq, DispatchProtocolInd?, DispatchProtocolReq?, InterfaceReq?, MacAddressReq?, NetworkProtocolInd?, SocketReq?, LlcProtocolTag?
lowerLayerOut	Request	1	ConfigureRadioCommand	ApskScalarRadio
lowerLayerOut	Request	1	ConfigureRadioCommand	Ieee80211OfdmRadio
lowerLayerOut	Request	1	ConfigureRadioCommand	Ieee80211DimensionalRadio
lowerLayerOut	Request	1	ConfigureRadioCommand	Ieee80211Radio
lowerLayerOut	Request	1	ConfigureRadioCommand	Ieee80211ScalarRadio
lowerLayerOut	Request	1	ConfigureRadioCommand	Ieee80211UnitDiskRadio
lowerLayerOut	Request	1	ConfigureRadioCommand	UnitDiskRadio
lowerLayerOut	Request	1	Ieee80211ConfigureRadioCommand	Ieee80211ScalarRadio
mgmtOut	Packet	0		Ieee80211MgmtAp	ErrorRateInd, InterfaceInd, MacAddressInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
mgmtOut	Packet	0		Ieee80211MgmtSta	ErrorRateInd, InterfaceInd, MacAddressInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
upperLayerOut	Packet	0		Ieee80211LlcEpd	ErrorRateInd, InterfaceInd, MacAddressInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd
upperLayerOut	Packet	0		Ieee80211LlcLpd	InterfaceInd, MacAddressInd, PacketProtocolTag, DispatchProtocolInd?, DispatchProtocolReq?, ErrorRateInd?, InterfaceReq?, MacAddressReq?, NetworkProtocolInd?, SignalPowerInd?, SignalTimeInd?, SnirInd?, SocketReq?, UserPriorityInd?, LlcProtocolTag?, Ieee80211ChannelInd?, Ieee80211ModeInd?, Ieee80211ModeReq?
upperLayerOut	Packet	0		Ieee80211Portal	ErrorRateInd, InterfaceInd, MacAddressInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd, UserPriorityInd?

Packet operations (observed)

chunkType	packetAction
Ieee80211DataHeader	insertAtFront
Ieee80211DataOrMgmtHeader	peekAtFront, popAtFront
Ieee80211MacHeader	peekAtFront
Ieee80211MacTrailer	insertAtBack, popAtBack
Ieee80211MgmtHeader	insertAtFront

Shared Tagging operations (observed)

tagType	tagAction
ErrorRateInd	findTag
Ieee80211SubtypeReq	getTag
InterfaceInd	addTagIfAbsent
MacAddressInd	addTagIfAbsent
MacAddressReq	getTag
PacketProtocolTag	addTagIfAbsent
UserPriorityInd	addTagIfAbsent
UserPriorityReq	findTag

Source code

//
// Implementation of the 802.11b MAC protocol. This module is intended
// to be used in combination with the ~Ieee80211Radio module as the physical
// layer.
//
// Encapsulation/decapsulation must be done in the upper layers. (It is
// typically in the 802.11 management module, see in ~Ieee80211Interface).
// The base class for 802.11 frame messages is ~Ieee80211MacHeader, but this
// module expects ~Ieee80211DataOrMgmtHeader (a subclass) from upper layers
// (the management module). This module will assign the transmitter address
// (address 2) and the frame sequence number/fragment number fields in the
// frames; all other fields must already be filled when this module gets
// the frame for transmission.
//
// <b>Limitations</b>
//
// Power management and polling (PCF) are not supported.
//
// Physical layer algorithms such as frequency hopping and
// direct sequence spread spectrum are not modelled directly.
//
// Fields related to the above unsupported features are omitted from
// management frame formats as well (for example, FH/DS/CF parameter sets,
// beacon/probe timestamp which is related to physical layer synchronization,
// listen interval which is related to power management, capability information
// which is related to PCF and other non-modelled features).
//
module Ieee80211Mac extends MacProtocolBase like IIeee80211Mac
{
    parameters:
        string mibModule;
        string modeSet @enum("a","b","g(erp)","g(mixed)","n(mixed-2.4Ghz)","p","ac") = default("g(mixed)");
        string fcsMode @enum("declared","computed") = default("declared");
        string initialRadioMode @enum("off","sleep","receiver","transmitter","transceiver") = default("receiver");

        int mtu @unit(B) = default(2304B);
        bool qosStation = default(false);

        *.mibModule = default(absPath(this.mibModule));
        *.rxModule = "^.rx";
        *.txModule = "^.tx";

        @display("i=block/layer");
        @class(Ieee80211Mac);
        @signal[linkBroken](type=inet::Packet); // TODO this signal is only present for the statistic to pass the signal check, to be removed
        @signal[modesetChanged](type=inet::physicallayer::Ieee80211ModeSet);
        @statistic[packetSentToUpper](title="packets sent to upper layer"; record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetSentToLower](title="packets sent to lower layer"; record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetReceivedFromUpper](title="packets received from upper layer"; record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetReceivedFromLower](title="packets received from lower layer"; record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[linkBroken](title="link breaks"; record=count,vector?; interpolationmode=none);
        @statistic[packetDrop](title="packet drops"; source=packetDropped; record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetDropIncorrectlyReceived](title="packet drops: incorrectly received"; source=packetDropReasonIsIncorrectlyReceived(packetDropped); record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetDropNotAddressedToUs](title="packet drops: not addressed to us"; source=packetDropReasonIsNotAddressedToUs(packetDropped); record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetDropQueueOverflow](title="packet drops: queue overflow"; source=packetDropReasonIsQueueOverflow(packetDropped); record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetDropRetryLimitReached](title="packet drops: retry limit reached"; source=packetDropReasonIsRetryLimitReached(packetDropped); record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetDropDuplicateDetected](title="packet drops: duplicate detected"; source=packetDropReasonIsDuplicateDetected(packetDropped); record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
        @statistic[packetDropOther](title="packet drops: other"; source=packetDropReasonIsOther(packetDropped); record=count,sum(packetBytes),vector(packetBytes); interpolationmode=none);
    gates:
        input mgmtIn;
        output mgmtOut;
    submodules:
        dcf: <default("Dcf")> like IDcf {
            parameters:
                @display("p=100,100");
        }
        hcf: <default("Hcf")> like IHcf if qosStation {
            parameters:
                @display("p=250,100");
        }
        ds: <default("Ds")> like IDs {
            parameters:
                @display("p=400,100");
        }
        rx: <default("Rx")> like IRx {
            parameters:
                @display("p=100,200");
        }
        tx: <default("Tx")> like ITx {
            parameters:
                @display("p=250,200");
        }
}

File: src/inet/linklayer/ieee80211/mac/Ieee80211Mac.ned

---

This documentation is released under the Creative Commons license