IEEE 802.11s (mesh) draft standard implementation. More...

Collaboration diagram for IEEE 802.11s draft:

Classes
class	ns3::dot11s::AirtimeLinkMetricCalculator
	Airtime link metric calculator. More...

struct	ns3::dot11s::PeerManagementProtocol::BeaconInfo
	Keeps information about beacon of peer station: beacon interval, association ID, last time we have received a beacon. More...

class	ns3::dot11s::DestinationAddressUnit
	Describes an address unit in PREQ information element See 7.3.2.96 for more details. More...

class	ns3::dot11s::Dot11sMeshCapability
	See 7.3.2.86.7 in 802.11s draft 3.0. More...

struct	ns3::dot11s::HwmpProtocol::FailedDestination
	structure of unreachable destination - address and sequence number More...

class	HwmpDoRfRegressionTest
	This is a test for intermediate reply and saving routing information about neighbour. More...

class	HwmpProactiveRegressionTest
	There are 5 stations set into a column, the center station is root. More...

class	ns3::dot11s::HwmpProtocol
	Hybrid wireless mesh protocol – a routing protocol of IEEE 802.11s draft. More...

class	ns3::dot11s::HwmpProtocolMac
	Interface MAC plugin for HWMP – 802.11s routing protocol. More...

class	HwmpReactiveRegressionTest
	test for multihop path establishing and path error procedures Initiate scenario with 6 stations. More...

class	ns3::dot11s::HwmpRtable
	Routing table for HWMP – 802.11s routing protocol. More...

class	HwmpSimplestRegressionTest
	Peering Management & HWM Protocol regression test Initiate scenario with 2 stations. More...

class	ns3::dot11s::HwmpTag
	Hwmp tag implements interaction between HWMP protocol and MeshWifiMac. More...

class	ns3::dot11s::IeBeaconTiming
	See 7.3.2.89 of 802.11s draft 2.07. More...

class	ns3::dot11s::IeBeaconTimingUnit
	Describes one unit of beacon timing element. More...

class	ns3::dot11s::IeConfiguration
	Describes Mesh Configuration Element see 7.3.2.86 of 802.11s draft 3.0. More...

class	ns3::dot11s::IePerr
	See 7.3.2.98 of 802.11s draft 2.07. More...

class	ns3::dot11s::IePrep
	See 7.3.2.97 of 802.11s draft 2.07. More...

class	ns3::dot11s::IePreq
	See 7.3.2.96 of 802.11s draft 2.07. More...

class	ns3::dot11s::IeRann
	See 7.3.2.95 of 802.11s draft 2.07. More...

struct	ns3::dot11s::HwmpRtable::LookupResult
	Route lookup result, return type of LookupXXX methods. More...

class	ns3::dot11s::MeshHeader
	Mesh Control field, see IEEE 802.11s draft 3.0 section 7.1.3.5b. More...

class	ns3::MeshHelper
	Helper to create IEEE 802.11s mesh networks. More...

struct	ns3::dot11s::HwmpProtocolMac::MyPerr

struct	ns3::dot11s::HwmpProtocol::PathError
	Structure of path error: IePerr and list of receivers: interfaces and MAC address. More...

class	ns3::dot11s::PeerLink
	Peer link model for 802.11s Peer Management protocol. More...

class	ns3::dot11s::PeerLinkFrameStart
	802.11s Peer link management frame More...

class	ns3::dot11s::PeerManagementProtocol
	802.11s Peer Management Protocol model More...

class	ns3::dot11s::PeerManagementProtocolMac
	This is plugin to Mesh WiFi MAC, which implements interface to dot11s peer management protocol: it takes proper frames from MAC-layer, extracts peer link management information element and mesh configuration element and passes it to main part of protocol. More...

class	PeerManagementProtocolRegressionTest
	Peering Management Protocol regression test. More...

struct	ns3::dot11s::PeerManagementProtocolMac::PlinkFrameStart
	This structure keeps all fields in peer link management frame, which are not subclasses of WifiInformationElement. More...

struct	ns3::dot11s::PeerLinkFrameStart::PlinkFrameStartFields
	fields: More...

struct	ns3::dot11s::HwmpRtable::Precursor
	Route found in reactive mode. More...

struct	ns3::dot11s::HwmpProtocol::PreqEvent

struct	ns3::dot11s::HwmpRtable::ProactiveRoute
	Route fond in proactive mode. More...

struct	ns3::dot11s::HwmpProtocol::QueuedPacket
	Packet waiting its routing information. More...

struct	ns3::dot11s::HwmpRtable::ReactiveRoute

struct	ns3::dot11s::PeerManagementProtocol::Statistics

struct	ns3::dot11s::PeerManagementProtocolMac::Statistics

struct	ns3::dot11s::HwmpProtocol::Statistics

struct	ns3::dot11s::HwmpProtocolMac::Statistics

Typedefs
typedef std::vector< Ptr< IeBeaconTimingUnit > >	ns3::dot11s::IeBeaconTiming::NeighboursTimingUnitsList
	This type is a list of timing elements obtained from neighbours with their beacons: More...

Enumerations
enum	ns3::MeshHelper::ChannelPolicy { ns3::MeshHelper::SPREAD_CHANNELS, ns3::MeshHelper::ZERO_CHANNEL }
	Spread/not spread frequency channels of MP interfaces. More...

enum	ns3::dot11s::PeerLink::PeerEvent { ns3::dot11s::PeerLink::CNCL, ns3::dot11s::PeerLink::ACTOPN, ns3::dot11s::PeerLink::CLS_ACPT, ns3::dot11s::PeerLink::OPN_ACPT, ns3::dot11s::PeerLink::OPN_RJCT, ns3::dot11s::PeerLink::REQ_RJCT, ns3::dot11s::PeerLink::CNF_ACPT, ns3::dot11s::PeerLink::CNF_RJCT, ns3::dot11s::PeerLink::TOR1, ns3::dot11s::PeerLink::TOR2, ns3::dot11s::PeerLink::TOC, ns3::dot11s::PeerLink::TOH }
	Peer link events, see 802.11s draft 11B.3.3.2. More...

enum	ns3::dot11s::PeerLink::PeerState { ns3::dot11s::PeerLink::IDLE, ns3::dot11s::PeerLink::OPN_SNT, ns3::dot11s::PeerLink::CNF_RCVD, ns3::dot11s::PeerLink::OPN_RCVD, ns3::dot11s::PeerLink::ESTAB, ns3::dot11s::PeerLink::HOLDING }
	Peer Link state: More...

enum	ns3::dot11s::PmpReasonCode { ns3::dot11s::REASON11S_PEERING_CANCELLED = 52, ns3::dot11s::REASON11S_MESH_MAX_PEERS = 53, ns3::dot11s::REASON11S_MESH_CAPABILITY_POLICY_VIOLATION = 54, ns3::dot11s::REASON11S_MESH_CLOSE_RCVD = 55, ns3::dot11s::REASON11S_MESH_MAX_RETRIES = 56, ns3::dot11s::REASON11S_MESH_CONFIRM_TIMEOUT = 57, ns3::dot11s::REASON11S_MESH_INVALID_GTK = 58, ns3::dot11s::REASON11S_MESH_INCONSISTENT_PARAMETERS = 59, ns3::dot11s::REASON11S_MESH_INVALID_SECURITY_CAPABILITY =60, ns3::dot11s::REASON11S_RESERVED = 67 }
	Codes used by 802.11s Peer Management Protocol. More...

Detailed Description

IEEE 802.11s (mesh) draft standard implementation.

Current model conforms IEEE 802.11s D3.0 draft version and includes Peer Management Protocol and HWMP (routing) Protocol implementations.

The multi-interface mesh points are supported as an extension of IEEE draft version 3.0. Note that corresponding helper creates single interface station by default.

Overview of IEEE 802.11s

Implementation of 802.11s draft standard consists of two main parts: Peer management protocol and HWMP - Hybrid Wireless Mesh Protocol.

The task of peer management protocol is the following: -open links detecting beacons and starting peer link finite state machine. -close peer links due to transmission failures or beacon loss.

If peer link between sender and receiver does not exist, the packet will be dropped. So, the plug-in to peer management protocol is the first in the list of ns3::MeshWifiInterfaceMacPlugin

Peer management protocol

Peer management protocol consists of three main parts:

Protocol itself ns3::dot11s::PeerManagementProtocol, which keeps all active peer links on interfaces, handles all changes of their states and notifies a routing protocol about link failures.
MAC plug-in ns3::dot11s::PeerManagementProtocolMac which drops packet, if there is no peer link, and peek all needed information from management frames and information elements from beacons.
Peer link ns3::dot11s::PeerLink which keeps finite state machine of each peer link, keeps beacon loss counter and counter of successive transmission failures.

Procedure of closing peer link is not described detailed in 802.11s draft standard, so in our model the link may be closed by:

beacon loss (see an appropriate attribute of ns3::dot11s::PeerLink class)
transmission failure – when a predefined number of successive packets have failed to transmit, the link will be closed.

Also Peer management protocol is responsible for beacon collision avoidance, because it keeps beacon timing elements from all neighbours. Note, that PeerManagementProtocol is not attached to MeshPointDevice as a routing protocol, but the structure is similar: the upper tier of protocol ns3::dot11s::PeerManagementProtocol and its plug-in is ns3::dot11s::PeerManagementProtocolMac.

Hybrid Wireless Mesh Protocol

HWMP is implemented in both modes – reactive and proactive. Also we have implemented an ability to transmit broadcast data and management frames as unicasts (see appropriate attributes). This feature turns off at a station when the number of neighbours of the station is more than a threshold.

Typedef Documentation

typedef std::vector< Ptr<IeBeaconTimingUnit> > ns3::dot11s::IeBeaconTiming::NeighboursTimingUnitsList

This type is a list of timing elements obtained from neighbours with their beacons:

Definition at line 67 of file ie-dot11s-beacon-timing.h.

Enumeration Type Documentation

enum ns3::MeshHelper::ChannelPolicy

Spread/not spread frequency channels of MP interfaces.

Todo:: SetMeshId

If set to true different non-overlapping 20MHz frequency channels will be assigned to different mesh point interfaces.

Enumerator
SPREAD_CHANNELS
ZERO_CHANNEL

Definition at line 130 of file mesh-helper.h.

enum ns3::dot11s::PeerLink::PeerEvent

private

Peer link events, see 802.11s draft 11B.3.3.2.

Enumerator
CNCL	Cancel peer link.
ACTOPN	Active peer link open.
CLS_ACPT	PeerLinkClose_Accept.
OPN_ACPT	PeerLinkOpen_Accept.
OPN_RJCT	PeerLinkOpen_Reject.
REQ_RJCT	PeerLinkOpenReject by internal reason.
CNF_ACPT	PeerLinkConfirm_Accept.
CNF_RJCT	PeerLinkConfirm_Reject.
TOR1	Timeout of retry timer.
TOR2	also timeout of retry timer
TOC	Timeout of confirm timer.
TOH	Timeout of holding (graceful closing) timer.

Definition at line 112 of file peer-link.h.

enum ns3::dot11s::PeerLink::PeerState

Peer Link state:

Enumerator
IDLE
OPN_SNT
CNF_RCVD
OPN_RCVD
ESTAB
HOLDING

Definition at line 54 of file peer-link.h.

enum ns3::dot11s::PmpReasonCode

Codes used by 802.11s Peer Management Protocol.

Enumerator
REASON11S_PEERING_CANCELLED
REASON11S_MESH_MAX_PEERS
REASON11S_MESH_CAPABILITY_POLICY_VIOLATION
REASON11S_MESH_CLOSE_RCVD
REASON11S_MESH_MAX_RETRIES
REASON11S_MESH_CONFIRM_TIMEOUT
REASON11S_MESH_INVALID_GTK
REASON11S_MESH_INCONSISTENT_PARAMETERS
REASON11S_MESH_INVALID_SECURITY_CAPABILITY
REASON11S_RESERVED

Definition at line 34 of file ie-dot11s-peer-management.h.

Classes