Package: inet.physicallayer.wireless.ieee80211.packetlevel

Ieee80211ScalarRadio

compound module

This radio model uses scalar transmission power in the analog representation. It must be used in conjunction with the Ieee80211ScalarRadioMedium model.

Inheritance diagram

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

Extends

Name	Type	Description
Ieee80211Radio	compound module	This radio model is part of the IEEE 802.11 physical layer model. It supports multiple channels, different operation modes, and preamble modes. It must be used in conjunction with the Ieee80211RadioMedium model or other derived models.

Parameters

Name	Type	Default value	Description
radioMediumModule	string	"radioMedium"	module path of the medium module where this radio communicates
energySourceModule	string	""	module path of the energy source module which provides energy to the radio
initialRadioMode	string	"off"
switchingTimes	string	"ms 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0"	time parameters to switch between radio modes
sendRawBytes	bool	false	when true packets are serialized into a sequence of bytes before sending out
separateTransmissionParts	bool	false	when enabled the transmission of preamble, header and data part are simulated separately
separateReceptionParts	bool	false	when enabled the reception of preamble, header and data part are simulated separately
displayCommunicationRange	bool	false	if true communication range is displayed as a blue circle around the node
displayInterferenceRange	bool	false	if true interference range is displayed as a gray circle around the node
centerFrequency	double	2.412GHz	center frequency of the band where the radio transmits and receives signals on the medium
bandwidth	double	nan MHz	bandwidth of the band where the radio transmits and receives signals on the medium
signalAnalogRepresentation	string	"scalar"
opMode	string	"g(mixed)"	operation mode
bandName	string	"2.4 GHz"	band name
channelNumber	int	0	initial channel number within the band (TODO this is offset by 1)
crcMode	string	"declared"

Properties

Name	Value	Description
display	i=block/wrxtx
class	Ieee80211Radio

Gates

Name	Direction	Size	Description
upperLayerIn	input
upperLayerOut	output
radioIn	input

Signals

Name	Type	Unit
radioChannelChanged	long

Statistics

Name	Title	Source	Record	Unit	Interpolation Mode
radioChannel	Radio channel	radioChannelChanged	histogram, vector		sample-hold

Scheduled messages (observed)

msg	kind	ctrl	msgname	context
omnetpp::cMessage	0		transmissionTimer	filled
omnetpp::cMessage	0	WirelessSignal	receptionTimer
omnetpp::cMessage	1		transmissionTimer	filled
omnetpp::cMessage	1	WirelessSignal	receptionTimer
omnetpp::cMessage	2		transmissionTimer	filled
omnetpp::cMessage	2	WirelessSignal	receptionTimer
omnetpp::cMessage	3		transmissionTimer	filled
omnetpp::cMessage	3	WirelessSignal	receptionTimer

Direct method calls (observed)

call to	function	info
PcapRecorder	inet::PcapRecorder::receiveSignal	packetReceivedFromLower
Ieee80211Mac	inet::ieee80211::Ieee80211Mac::receiveSignal	radioModeChanged
Ieee80211Mac	inet::ieee80211::Ieee80211Mac::receiveSignal	receivedSignalPartChanged
Ieee80211Mac	inet::ieee80211::Ieee80211Mac::receiveSignal	receptionStateChanged
Ieee80211Mac	inet::ieee80211::Ieee80211Mac::receiveSignal	transmissionStateChanged
Ieee80211MgmtAp	inet::ieee80211::Ieee80211MgmtAp::receiveSignal	radioChannelChanged
Ieee80211MgmtSta	inet::ieee80211::Ieee80211MgmtSta::receiveSignal	receptionStateChanged
ApskScalarRadioMedium	inet::physicallayer::RadioMedium::addRadio	addRadio
ApskScalarRadioMedium	inet::physicallayer::RadioMedium::listenOnMedium	listenOnMedium
ApskScalarRadioMedium	inet::physicallayer::RadioMedium::receivePacket	receivePacket
ApskScalarRadioMedium	inet::physicallayer::RadioMedium::transmitPacket	transmitPacket
StateBasedEpEnergyConsumer	inet::physicallayer::StateBasedEpEnergyConsumer::receiveSignal	radioModeChanged
StateBasedEpEnergyConsumer	inet::physicallayer::StateBasedEpEnergyConsumer::receiveSignal	receivedSignalPartChanged
StateBasedEpEnergyConsumer	inet::physicallayer::StateBasedEpEnergyConsumer::receiveSignal	receptionStateChanged
StateBasedEpEnergyConsumer	inet::physicallayer::StateBasedEpEnergyConsumer::receiveSignal	transmissionStateChanged
StateBasedEpEnergyConsumer	inet::physicallayer::StateBasedEpEnergyConsumer::receiveSignal	transmittedSignalPartChanged
Ieee80211ScalarRadio	inet::physicallayer::Ieee80211Radio::setRadioMode	setRadioMode
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::addRadio	addRadio
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::listenOnMedium	listenOnMedium
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::receivePacket	receivePacket
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::receiveSignal	listeningChanged
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::receiveSignal	radioModeChanged
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::removeRadio	removeRadio
Ieee80211ScalarRadioMedium	inet::physicallayer::RadioMedium::transmitPacket	transmitPacket
Ieee80211NistErrorModel	inet::physicallayer::Ieee80211NistErrorModel::computePacketErrorRate	computePacketErrorRate

Called methods (observed)

function	info	call from
inet::physicallayer::Ieee80211Radio::handleOperationStage	handleOperationStage	ScenarioManager, SimpleEpEnergyManagement, SimpleEpEnergyStorage
inet::physicallayer::Ieee80211Radio::setRadioMode	setRadioMode	Ieee80211Mac, Ieee80211ScalarRadio

Incoming messages (observed)

gate	msg	kind	ctrl	srcModule	tags
radioIn	WirelessSignal	0		Ieee80211ScalarRadio
upperLayerIn	Packet	0		Ieee80211Mac	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?
upperLayerIn	Request	1	ConfigureRadioCommand	Ieee80211Mac
upperLayerIn	Request	1	Ieee80211ConfigureRadioCommand	Ieee80211Mac

Outgoing messages (observed)

gate	msg	kind	ctrl	destModule	tags
upperLayerOut	Packet	0		Ieee80211Mac	ErrorRateInd, PacketProtocolTag, SignalPowerInd, SignalTimeInd, SnirInd, Ieee80211ChannelInd, Ieee80211ModeInd

Packet operations (observed)

chunkType	packetAction
BitCountChunk	insertAtBack
Chunk	popAtBack
Ieee80211DsssPhyHeader	insertAtFront, popAtFront
Ieee80211HrDsssPhyHeader	insertAtFront
Ieee80211HtPhyHeader	insertAtFront, popAtFront
Ieee80211OfdmPhyHeader	insertAtFront, popAtFront

Shared Tagging operations (observed)

tagType	tagAction
	clearTags
ErrorRateInd	findTag
PacketProtocolTag	addTag, addTagIfAbsent, getTag
SignalBitrateReq	findTag
SnirInd	findTag
Ieee80211ModeInd	getTag
Ieee80211ModeReq	findTag

Source code

//
// This radio model uses scalar transmission power in the analog representation.
// It must be used in conjunction with the ~Ieee80211ScalarRadioMedium model.
// @see ~Ieee80211ScalarRadioMedium, ~Ieee80211ScalarTransmitter,
// ~Ieee80211ScalarReceiver, ~ScalarAnalogModel.
//
module Ieee80211ScalarRadio extends Ieee80211Radio
{
    parameters:
        transmitter.typename = default("Ieee80211ScalarTransmitter");
        receiver.typename = default("Ieee80211ScalarReceiver");
}

File: src/inet/physicallayer/wireless/ieee80211/packetlevel/Ieee80211ScalarRadio.ned