MultiRadio

Package: inet.examples.manetrouting.multiradio

MultiRadio

network

Models a network with several hosts. Each host may contain one or more radios. Nodes are using adhoc routing to pass information.

radioMedium : Ieee80211ScalarRadioMedium This radio medium model uses scalar transmission power in the analog representation. Source: radioMedium: Ieee80211ScalarRadioMedium { @display("p=100,200;is=s"); } configurator : Ipv4NetworkConfigurator Assigns IPv4 addresses and sets up static routing for an IPv4 network. Source: configurator: Ipv4NetworkConfigurator { config = xml("<config><interface hosts='*' address='10.0.0.x' netmask='255.255.255.0'/></config>"); addStaticRoutes = false; addDefaultRoutes = false; addSubnetRoutes = false; @display("p=100,100;is=s"); } mobileHost[numHosts] : DymoRouter A mobile node with the Dynamic MANET On-demand (DYMO) routing protocol. Source: mobileHost[numHosts]: DymoRouter { @display("p=250,150;r=,,#000040"); }

Usage diagram

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

Parameters

Name Type Default value Description
numHosts int

Properties

Name Value Description
isNetwork

Unassigned submodule parameters

Name Type Default value Description
radioMedium.neighborCache.refillPeriod double
configurator.displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
configurator.minLinkWeight double 1E-3
configurator.configureIsolatedNetworksSeparatly bool false
configurator.assignAddresses bool true

Assign IP addresses to all interfaces in the network
configurator.assignUniqueAddresses bool true

Avoid using the same address and raise an error if not possible
configurator.assignDisjunctSubnetAddresses bool true

Avoid using the same address prefix and netmask on different links when assigning IP addresses to interfaces
configurator.addDirectRoutes bool true

Add direct routes towards local network members (i.e. directly connected interfaces) to the routing table (used only if addStaticRoutes is true)
configurator.optimizeRoutes bool true

Optimize routing tables by merging routes, the resulting routing table might route more packets than the original (used only if addStaticRoutes is true)
configurator.updateRoutes bool false

Recalculate static routes if an interface goes down/up or a carrier is lost/back
configurator.dumpTopology bool false

Print extracted network topology to the module output
configurator.dumpLinks bool false

Print recognized network links to the module output
configurator.dumpAddresses bool false

Print assigned IP addresses for all interfaces to the module output
configurator.dumpRoutes bool false

Print configured and optimized routing tables for all nodes to the module output
configurator.dumpConfig string ""

Write configuration into the given config file that can be fed back to speed up subsequent runs (network configurations)
mobileHost.status.displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.status.initialStatus string "UP"

TODO @signal, @statistic
mobileHost.environment.displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.environment.initStage int 0

Initialization stage for the setup command
mobileHost.environment.globalNamespace bool false

Create new network namespaces under /var/run/netns/ (Linux only)
mobileHost.environment.namespace string ""

Name of the host OS network namespace (optional) (Linux only)
mobileHost.environment.setupCommand string ""

A host OS system command
mobileHost.environment.teardownCommand string ""

A host OS system command
mobileHost.pcapRecorder.displayStringTextFormat string "rec: %n pks"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.pcapRecorder.verbose bool true

Whether to log packets on the module output
mobileHost.pcapRecorder.recordEmptyPackets bool true

Specifies if zero length packets are recorded or not
mobileHost.pcapRecorder.enableConvertingPackets bool true

Specifies if converting packets to link type is allowed or not
mobileHost.pcapRecorder.pcapFile string ""

The PCAP file to be written, suggested value: pcapFile = "${resultdir}/${configname}-#${runnumber}" + fullpath() + ".pcap"
mobileHost.pcapRecorder.fileFormat string "pcapng"
mobileHost.pcapRecorder.snaplen int 65535

Maximum number of bytes to record per packet
mobileHost.pcapRecorder.timePrecision int 6

Time precision in recorded file. pcap supports only 6 (usec) or 9 (nanosec), pcapng supports more values (see 'if_tsresol' option in pcapng file format).
mobileHost.pcapRecorder.dumpBadFrames bool true

Enable dump of frames with hasBitError
mobileHost.pcapRecorder.moduleNamePatterns string "wlan[*] eth[*] ppp[*]"

Space-separated list of sibling module names to listen on
mobileHost.pcapRecorder.sendingSignalNames string "transmissionEnded"

Space-separated list of outbound packet signals to subscribe to
mobileHost.pcapRecorder.receivingSignalNames string "receptionEnded"

Space-separated list of inbound packet signals to subscribe to
mobileHost.pcapRecorder.dumpProtocols string "ethernetmac ppp ieee80211mac"

Space-separated list of protocol names as defined in the Protocol class
mobileHost.pcapRecorder.packetFilter object "*"

Which packets are considered, matches all packets by default
mobileHost.pcapRecorder.helpers string ""

Usable PcapRecorder::IHelper helpers for accept packettype and store/convert packet as specified linktype currently available: "inet::AckingMacToEthernetPcapRecorderHelper"
mobileHost.pcapRecorder.alwaysFlush bool false

Flush the pcapFile after each write to ensure that all packets are captured in case of a crash
mobileHost.interfaceTable.displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.interfaceTable.displayAddresses bool false

Whether to display IP addresses on links
mobileHost.cb.displayStringTextFormat string "processed %p pk (%l)"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.cb.interfaceTableModule string

Module path to the ~InterfaceTable module
mobileHost.cb.forwardServiceRegistration bool true
mobileHost.cb.forwardProtocolRegistration bool true
mobileHost.cb.interfaceMapping object {}

Maps network interface names to connected submodule names (e.g. {"eth0": "bridging"}), overrides automatically learned dispatching; * overrides all learned network interfaces, ? overrides default
mobileHost.cb.serviceMapping object {}

Maps protocols to connected submodule names (e.g. {"ethernetmac": "bridging"}), overrides automatically learned dispatching; * overrides all learned services, ? overrides default
mobileHost.cb.protocolMapping object {}

Maps protocols to connected submodule names (e.g. {"ipv4": "bridging"}), overrides automatically learned dispatching; * overrides all learned protocols, ? overrides default
mobileHost.bl.displayStringTextFormat string "processed %p pk (%l)"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.bl.interfaceTableModule string

Module path to the ~InterfaceTable module
mobileHost.bl.forwardServiceRegistration bool true
mobileHost.bl.forwardProtocolRegistration bool true
mobileHost.bl.interfaceMapping object {}

Maps network interface names to connected submodule names (e.g. {"eth0": "bridging"}), overrides automatically learned dispatching; * overrides all learned network interfaces, ? overrides default
mobileHost.bl.serviceMapping object {}

Maps protocols to connected submodule names (e.g. {"ethernetmac": "bridging"}), overrides automatically learned dispatching; * overrides all learned services, ? overrides default
mobileHost.bl.protocolMapping object {}

Maps protocols to connected submodule names (e.g. {"ipv4": "bridging"}), overrides automatically learned dispatching; * overrides all learned protocols, ? overrides default
mobileHost.li.displayStringTextFormat string "processed %p pk (%l)"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.li.interfaceTableModule string

Module path to the ~InterfaceTable module
mobileHost.li.forwardServiceRegistration bool true
mobileHost.li.forwardProtocolRegistration bool true
mobileHost.li.interfaceMapping object {}

Maps network interface names to connected submodule names (e.g. {"eth0": "bridging"}), overrides automatically learned dispatching; * overrides all learned network interfaces, ? overrides default
mobileHost.li.serviceMapping object {}

Maps protocols to connected submodule names (e.g. {"ethernetmac": "bridging"}), overrides automatically learned dispatching; * overrides all learned services, ? overrides default
mobileHost.li.protocolMapping object {}

Maps protocols to connected submodule names (e.g. {"ipv4": "bridging"}), overrides automatically learned dispatching; * overrides all learned protocols, ? overrides default
mobileHost.eth.bitrate double
mobileHost.nl.displayStringTextFormat string "processed %p pk (%l)"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.nl.interfaceTableModule string

Module path to the ~InterfaceTable module
mobileHost.nl.forwardServiceRegistration bool true
mobileHost.nl.forwardProtocolRegistration bool true
mobileHost.nl.interfaceMapping object {}

Maps network interface names to connected submodule names (e.g. {"eth0": "bridging"}), overrides automatically learned dispatching; * overrides all learned network interfaces, ? overrides default
mobileHost.nl.serviceMapping object {}

Maps protocols to connected submodule names (e.g. {"ethernetmac": "bridging"}), overrides automatically learned dispatching; * overrides all learned services, ? overrides default
mobileHost.nl.protocolMapping object {}

Maps protocols to connected submodule names (e.g. {"ipv4": "bridging"}), overrides automatically learned dispatching; * overrides all learned protocols, ? overrides default
mobileHost.tn.displayStringTextFormat string "processed %p pk (%l)"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.tn.interfaceTableModule string

Module path to the ~InterfaceTable module
mobileHost.tn.forwardServiceRegistration bool true
mobileHost.tn.forwardProtocolRegistration bool true
mobileHost.tn.interfaceMapping object {}

Maps network interface names to connected submodule names (e.g. {"eth0": "bridging"}), overrides automatically learned dispatching; * overrides all learned network interfaces, ? overrides default
mobileHost.tn.serviceMapping object {}

Maps protocols to connected submodule names (e.g. {"ethernetmac": "bridging"}), overrides automatically learned dispatching; * overrides all learned services, ? overrides default
mobileHost.tn.protocolMapping object {}

Maps protocols to connected submodule names (e.g. {"ipv4": "bridging"}), overrides automatically learned dispatching; * overrides all learned protocols, ? overrides default
mobileHost.at.displayStringTextFormat string "processed %p pk (%l)"

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.at.interfaceTableModule string

Module path to the ~InterfaceTable module
mobileHost.at.forwardServiceRegistration bool true
mobileHost.at.forwardProtocolRegistration bool true
mobileHost.at.interfaceMapping object {}

Maps network interface names to connected submodule names (e.g. {"eth0": "bridging"}), overrides automatically learned dispatching; * overrides all learned network interfaces, ? overrides default
mobileHost.at.serviceMapping object {}

Maps protocols to connected submodule names (e.g. {"ethernetmac": "bridging"}), overrides automatically learned dispatching; * overrides all learned services, ? overrides default
mobileHost.at.protocolMapping object {}

Maps protocols to connected submodule names (e.g. {"ipv4": "bridging"}), overrides automatically learned dispatching; * overrides all learned protocols, ? overrides default
mobileHost.dymo.displayStringTextFormat string ""

Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
mobileHost.dymo.interfaceTableModule string

context parameters
mobileHost.dymo.routingTableModule string absPath("^.ipv4.routingTable")
mobileHost.dymo.networkProtocolModule string absPath("^.ipv4.ip")
mobileHost.dymo.clientAddresses string "10.10.0.0/24 10.20.0.0"

1. Dymo parameter group
mobileHost.dymo.useMulticastRREP bool false

USE_MULTICAST_RREP
mobileHost.dymo.interfaces string "*"

string DEFAULT_METRIC_TYPE = default("HOP_COUNT");
mobileHost.dymo.activeInterval double 5s

2. Dymo parameter group
mobileHost.dymo.maxIdleTime double 200s

MAX_IDLETIME
mobileHost.dymo.maxSequenceNumberLifetime double 300s

MAX_SEQNUM_LIFETIME
mobileHost.dymo.routeRREQWaitTime double 2s

ROUTE_RREQ_WAIT_TIME
mobileHost.dymo.rreqHolddownTime double 10s

double UNICAST_MESSAGE_SENT_TIMEOUT @unit(s) = default(1s);
mobileHost.dymo.maxHopCount int 20

3. Dymo parameter group
mobileHost.dymo.discoveryAttemptsMax int 3

string MAX_METRIC = default(""); double MAXTIME;
mobileHost.dymo.appendInformation bool true

4. Dymo parameter group
mobileHost.dymo.bufferSizePackets int -1

BUFFER_SIZE_PACKETS
mobileHost.dymo.bufferSizeBytes int -1B

BUFFER_SIZE_BYTES double CONTROL_TRAFFIC_LIMIT
mobileHost.dymo.maxJitter double 10ms

Dymo extension parameters
mobileHost.dymo.sendIntermediateRREP bool true
mobileHost.dymo.minHopLimit int 5
mobileHost.dymo.maxHopLimit int 10

Source code

//
// Models a network with several hosts. Each host may contain one or
// more radios. Nodes are using adhoc routing to pass information.
//
network MultiRadio
{
    parameters:
        int numHosts;
    submodules:
        radioMedium: Ieee80211ScalarRadioMedium {
            @display("p=100,200;is=s");
        }
        configurator: Ipv4NetworkConfigurator {
            config = xml("<config><interface hosts='*' address='10.0.0.x' netmask='255.255.255.0'/></config>");
            addStaticRoutes = false;
            addDefaultRoutes = false;
            addSubnetRoutes = false;
            @display("p=100,100;is=s");
        }
        mobileHost[numHosts]: DymoRouter {
            @display("p=250,150;r=,,#000040");
        }
    connections allowunconnected:
}
File: examples/manetrouting/multiradio/MultiRadio.ned

This documentation is released under the Creative Commons license