Throughput

Package: inet.showcases.wireless.throughput

Throughput

network

(no description)

WirelessHost WirelessHost Ipv4NetworkConfigurator Ieee80211ScalarRadioMedium

Usage diagram

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

Properties

Name Value Description
isNetwork
display bgb=6,4

Statistics

Name Title Source Record Unit Interpolation Mode
numRcvdPk count(destinationHost.app[0].packetReceived) figure
throughput liveThroughput(destinationHost.app[0].packetReceived)/1000000 figure

Unassigned submodule parameters

Name Type Default value Description
sourceHost.status.initialStatus string "UP"

TODO @signal, @statistic
sourceHost.pcapRecorder.verbose bool true

whether to log packets on the module output
sourceHost.pcapRecorder.pcapFile string ""

the PCAP file to be written
sourceHost.pcapRecorder.fileFormat string "pcapng"
sourceHost.pcapRecorder.snaplen int 65535

maximum number of bytes to record per packet
sourceHost.pcapRecorder.dumpBadFrames bool true

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

space-separated list of sibling module names to listen on
sourceHost.pcapRecorder.sendingSignalNames string "packetSentToLower"

space-separated list of outbound packet signals to subscribe to
sourceHost.pcapRecorder.receivingSignalNames string "packetReceivedFromLower"

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

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

which packets are considered, matches all packets by default
sourceHost.pcapRecorder.helpers string ""

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

flush the pcapFile after each write to ensure that all packets are captured in case of a crash
sourceHost.pcapRecorder.displayStringTextFormat string "rec: %n pks"
sourceHost.interfaceTable.displayAddresses bool false

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

determines the text that is written on top of the submodule
sourceHost.cb.forwardServiceRegistration bool true
sourceHost.cb.forwardProtocolRegistration bool true
sourceHost.bl.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
sourceHost.bl.forwardServiceRegistration bool true
sourceHost.bl.forwardProtocolRegistration bool true
sourceHost.li.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
sourceHost.li.forwardServiceRegistration bool true
sourceHost.li.forwardProtocolRegistration bool true
sourceHost.eth.bitrate double
sourceHost.nl.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
sourceHost.nl.forwardServiceRegistration bool true
sourceHost.nl.forwardProtocolRegistration bool true
sourceHost.tn.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
sourceHost.tn.forwardServiceRegistration bool true
sourceHost.tn.forwardProtocolRegistration bool true
sourceHost.at.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
sourceHost.at.forwardServiceRegistration bool true
sourceHost.at.forwardProtocolRegistration bool true
destinationHost.status.initialStatus string "UP"

TODO @signal, @statistic
destinationHost.pcapRecorder.verbose bool true

whether to log packets on the module output
destinationHost.pcapRecorder.pcapFile string ""

the PCAP file to be written
destinationHost.pcapRecorder.fileFormat string "pcapng"
destinationHost.pcapRecorder.snaplen int 65535

maximum number of bytes to record per packet
destinationHost.pcapRecorder.dumpBadFrames bool true

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

space-separated list of sibling module names to listen on
destinationHost.pcapRecorder.sendingSignalNames string "packetSentToLower"

space-separated list of outbound packet signals to subscribe to
destinationHost.pcapRecorder.receivingSignalNames string "packetReceivedFromLower"

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

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

which packets are considered, matches all packets by default
destinationHost.pcapRecorder.helpers string ""

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

flush the pcapFile after each write to ensure that all packets are captured in case of a crash
destinationHost.pcapRecorder.displayStringTextFormat string "rec: %n pks"
destinationHost.interfaceTable.displayAddresses bool false

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

determines the text that is written on top of the submodule
destinationHost.cb.forwardServiceRegistration bool true
destinationHost.cb.forwardProtocolRegistration bool true
destinationHost.bl.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
destinationHost.bl.forwardServiceRegistration bool true
destinationHost.bl.forwardProtocolRegistration bool true
destinationHost.li.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
destinationHost.li.forwardServiceRegistration bool true
destinationHost.li.forwardProtocolRegistration bool true
destinationHost.eth.bitrate double
destinationHost.nl.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
destinationHost.nl.forwardServiceRegistration bool true
destinationHost.nl.forwardProtocolRegistration bool true
destinationHost.tn.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
destinationHost.tn.forwardServiceRegistration bool true
destinationHost.tn.forwardProtocolRegistration bool true
destinationHost.at.displayStringTextFormat string "processed %p pk (%l)"

determines the text that is written on top of the submodule
destinationHost.at.forwardServiceRegistration bool true
destinationHost.at.forwardProtocolRegistration bool true
configurator.minLinkWeight double 1E-3
configurator.configureIsolatedNetworksSeparatly bool false
configurator.config xml xml("")

XML configuration parameters for IP address assignment and adding manual routes
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.addStaticRoutes bool true

add static routes to the routing tables of all nodes to route to all destination interfaces (only where applicable; turn off when config file contains manual routes)
configurator.addDefaultRoutes bool true

add default routes if all routes from a source node go through the same gateway (used only if addStaticRoutes is true)
configurator.addSubnetRoutes bool true

add subnet routes instead of destination interface routes (only where applicable; used only if addStaticRoutes is true)
configurator.addDirectRoutes bool true

add direct routes (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.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)
radioMedium.neighborCache.refillPeriod double

Source code

network Throughput
{
    @display("bgb=6,4");
    @statistic[throughput](source=liveThroughput(destinationHost.app[0].packetReceived)/1000000; record=figure; targetFigure=panel.throughput; checkSignals=false);
    @statistic[numRcvdPk](source=count(destinationHost.app[0].packetReceived); record=figure; targetFigure=panel.numRcvdPkCounter; checkSignals=false);
    @figure[panel](type=panel; pos=1.5,0.1);
    //    @figure[panel.throughput](type=gauge; pos=0,0; size=100,100; minValue=0; maxValue=40; tickSize=5; label="App level throughput [Mbps]");
    @figure[panel.throughput](type=linearGauge; pos=250,50; size=250,30; minValue=0; maxValue=54; tickSize=6; label="Application level throughput [Mbps]");
    @figure[panel.numRcvdPkCounter](type=counter; pos=50,50; label="Packets received"; decimalPlaces=6);
    submodules:
        sourceHost: WirelessHost {
            @display("p=3,2");
        }
        destinationHost: WirelessHost {
            @display("p=4,2");
        }
        configurator: Ipv4NetworkConfigurator {
            @display("p=0.5,0.5");
        }
        radioMedium: Ieee80211ScalarRadioMedium {
            @display("p=0.5,1");
        }
}
File: showcases/wireless/throughput/Throughput.ned

This documentation is released under the Creative Commons license