Probe¶

compound module Probe

A minimal wireless network node that consists only of an antenna and mobility model. Designed for monitoring wireless signals without actively participating in network communication.

Unlike full-featured wireless nodes, the Probe does not have protocol stacks, applications, or network interfaces. It simply provides the basic infrastructure needed to detect and measure wireless signals in the simulation environment.

The Probe can be used for various measurement and analysis purposes in wireless simulations, such as signal strength mapping, interference analysis, and coverage testing. When the simulation runs in Qtenv, the module can be dragged (shift + mouse) around. Visualizers should be configured to monitor the transmission medium.

Usage diagram¶

Inheritance diagram¶

Properties¶

Name	Value	Description
display	i=device/antennatower
networkNode

Unassigned submodule parameters¶

Name	Type	Default value	Description
mobility.displayStringTextFormat	string	“p: {position}\nv: {velocity}”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobility.subjectModule	string	“^”	The module path that determines the subject module, the motion of which this mobility model describes. The default value is the parent module
mobility.coordinateSystemModule	string	“”	The module path of the geographic coordinate system module; optional, empty disables geographic conversion (and the {geo_position} directive)
mobility.updateDisplayString	bool	true	Enables continuous update of the subject module’s position by modifying its display string
mobility.constraintAreaMinX	double	-inf m	The minimum x position of the constraint area. It is unconstrained by default (negative infinity)
mobility.constraintAreaMinY	double	-inf m	The minimum y position of the constraint area. It is unconstrained by default (negative infinity)
mobility.constraintAreaMinZ	double	-inf m	The minimum z position of the constraint area. It is unconstrained by default (negative infinity)
mobility.constraintAreaMaxX	double	inf m	The maximum x position of the constraint area. It is unconstrained by default (positive infinity)
mobility.constraintAreaMaxY	double	inf m	The maximum y position of the constraint area. It is unconstrained by default (positive infinity)
mobility.constraintAreaMaxZ	double	inf m	The maximum z position of the constraint area. It is unconstrained by default (positive infinity)
mobility.initialX	double	uniform(this.constraintAreaMinX, this.constraintAreaMaxX)
mobility.initialY	double	uniform(this.constraintAreaMinY, this.constraintAreaMaxY)
mobility.initialZ	double	nanToZero(uniform(this.constraintAreaMinZ, this.constraintAreaMaxZ))
mobility.initialLatitude	double	nan deg
mobility.initialLongitude	double	nan deg
mobility.initialAltitude	double	0m
mobility.initialHeading	double	0deg
mobility.initialElevation	double	0deg
mobility.initialBank	double	0deg
mobility.initFromDisplayString	bool	true	Enables one-time initialization from the subject module’s display string
mobility.updateFromDisplayString	bool	true	Enables continuous update from the subject module’s display string for dragging and rotating it

Source code¶

//
// A minimal wireless network node that consists only of an antenna
// and mobility model. Designed for monitoring wireless signals without actively
// participating in network communication.
//
// Unlike full-featured wireless nodes, the Probe does not have protocol stacks,
// applications, or network interfaces. It simply provides the basic infrastructure
// needed to detect and measure wireless signals in the simulation environment.
//
// The Probe can be used for various measurement and analysis purposes in wireless
// simulations, such as signal strength mapping, interference analysis, and coverage
// testing. When the simulation runs in Qtenv, the module can be dragged (shift + mouse)
// around. Visualizers should be configured to monitor the transmission medium.
//
// @see ~AccessPoint, ~WirelessHost, ~MediumCanvasVisualizer
//
module Probe like INetworkNode
{
    parameters:
        @networkNode;
        @display("i=device/antennatower");
    submodules:
        mobility: <default("StationaryMobility")> like IMobility {
            parameters:
                subjectModule = default("^");
                @display("p=100,100");
        }
        antenna: <default("IsotropicAntenna")> like IAntenna {
            parameters:
                mobilityModule = default("^.mobility");
                @display("p=100,200");
        }
}

File: src/inet/node/wireless/Probe.ned