NED File src/inet/networklayer/probabilistic/ProbabilisticBroadcast.ned¶

//
// Copyright:   (C) 2008-2010 CSEM SA, Neuchâtel, Switzerland.
//
//***************************************************************************
// file:        ProbabilisticBroadcast.ned
//
// author:      Damien Piguet
//
// description: Multi-hop ad-hoc data dissemination protocol based on
//              probabilistic broadcast: depending on application
//              parameters and network status, each packet will
//              go through a number of transmission attempts, each
//              with a certain probability. How the number of transmissions
//              attempts and probability of forwarding are computed will
//              be derived from the simulations of this protocol.
//**************************************************************************
package inet.networklayer.probabilistic;

import inet.networklayer.base.NetworkProtocolBase;
import inet.networklayer.contract.INetworkProtocol;

//
// Multi-hop ad-hoc data dissemination protocol based on probabilistic broadcast.
//
// This method reduces the number of packets sent on the channel (reducing the
// broadcast storm problem) at the risk of some nodes not receiving the data.
// It is particularly interesting for mobile networks.
// The parameter `maxNbBcast` sets the maximum number of broadcast transmissions of a packet,
// the parameter beta gives the transmission probability for each attempt,
// the parameter bcperiod sets the time between two transmission attempts.
// The parameter `maxFirstBcastBackoff` sets a backoff window before the first transmission attempt,
// and the parameter `timeInQueueAfterDeath` sets the time during which a node remembers
// a packet whose time to live (TTL) expired, avoiding retransmitting it in case it comes back
// in the network because of some problem.
//
simple ProbabilisticBroadcast extends NetworkProtocolBase like INetworkProtocol
{
    parameters:
        @class(ProbabilisticBroadcast);
        int headerLength @unit(b) = default(96b); // Length of the network packet header (in bits)
        // period between two probabilistic broadcast attempts
        double bcperiod @unit(s) = default(2 s);
        // probability of broadcast for each attempt
        double beta = default(0.8);
        // maximal number of broadcast attempts for each packet.
        int maxNbBcast = default(1);
        // maximal back-off before the first broadcast attempt [seconds].
        // If you don't want to use this parameter, simply set it
        // to a value that is greater than bcperiod.
        double maxFirstBcastBackoff @unit(s) = default(1 s);

        double timeToLive @unit(s) = default(10 s);
        // How many seconds the message should be kept in the queue after it dies.
        // That way the message is known if the node receives one of its
        // copies that isn't dead because of TTL de-synchronization due to
        // MAC backoff, propagation delay, and clock drift.
        double timeInQueueAfterDeath @unit(s) = default(60 s);
}