This is plugin to Mesh WiFi MAC, which implements the 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...

#include "peer-management-protocol-mac.h"

Inheritance diagram for ns3::dot11s::PeerManagementProtocolMac:

Collaboration diagram for ns3::dot11s::PeerManagementProtocolMac:

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

struct	Statistics
	Statistics structure. More...

Public Member Functions
	PeerManagementProtocolMac (uint32_t interface, Ptr< PeerManagementProtocol > protocol)
	Constructor. More...

	~PeerManagementProtocolMac ()

int64_t	AssignStreams (int64_t stream)
	Assign the streams. More...

bool	Receive (Ptr< Packet > packet, const WifiMacHeader &header)
	Receive and process a packet. More...

void	SetParent (Ptr< MeshWifiInterfaceMac > parent)
	Set pointer to parent. More...

void	UpdateBeacon (MeshWifiBeacon &beacon) const
	Add beacon timing and mesh ID information elements, and notify beacon sent. More...

bool	UpdateOutcomingFrame (Ptr< Packet > packet, WifiMacHeader &header, Mac48Address from, Mac48Address to)
	This method appears to test a few conditions. More...

Statistics
void	Report (std::ostream &) const
	Report statistics. More...

void	ResetStats ()
	Reset stats. More...

uint32_t	GetLinkMetric (Mac48Address peerAddress)
	Get the link metric. More...

Public Member Functions inherited from ns3::MeshWifiInterfaceMacPlugin
virtual	~MeshWifiInterfaceMacPlugin ()
	This is for subclasses. More...

Public Member Functions inherited from ns3::SimpleRefCount< MeshWifiInterfaceMacPlugin >
	SimpleRefCount ()
	Default constructor. More...

	SimpleRefCount (const SimpleRefCount &o)
	Copy constructor. More...

uint32_t	GetReferenceCount (void) const
	Get the reference count of the object. More...

SimpleRefCount &	operator= (const SimpleRefCount &o)
	Assignment operator. More...

void	Ref (void) const
	Increment the reference count. More...

void	Unref (void) const
	Decrement the reference count. More...

Private Member Functions
	PeerManagementProtocolMac (const PeerManagementProtocolMac &)
	type conversion operator More...

Mac48Address	GetAddress () const
	debug only, used to print established links More...

PeerManagementProtocolMac &	operator= (const PeerManagementProtocolMac &peer)
	assignment operator More...

void	SendPeerLinkManagementFrame (Mac48Address peerAddress, Mac48Address peerMpAddress, uint16_t aid, IePeerManagement peerElement, IeConfiguration meshConfig)
	Send peer link management frame function. More...

void	SetBeaconShift (Time shift)
	Set beacon shift function. More...

void	SetPeerManagerProtcol (Ptr< PeerManagementProtocol > protocol)
	Set peer manager protocol function. More...

void	TxError (WifiMacDropReason reason, Ptr< const WifiMacQueueItem > mpdu)
	Closes link when a proper number of successive transmissions have failed. More...

void	TxOk (Ptr< const WifiMacQueueItem > mpdu)
	Transmit OK function. More...

Create peer link management frames
Ptr< Packet >	CreatePeerLinkOpenFrame ()
	Create peer link open frame function. More...

Ptr< Packet >	CreatePeerLinkConfirmFrame ()
	Create peer link confirm frame function. More...

Ptr< Packet >	CreatePeerLinkCloseFrame ()
	Create peer link clode frame function. More...

PlinkFrameStart	ParsePlinkFrame (Ptr< const Packet > packet)
	Parses the start of the frame, where no WifiInformationElements exist. More...

Private Attributes
struct Statistics	m_stats
	statistics More...

Information about MAC and protocol:
Ptr< MeshWifiInterfaceMac >	m_parent
	parent More...

uint32_t	m_ifIndex
	IF index. More...

Ptr< PeerManagementProtocol >	m_protocol
	protocol More...

Friends
class	PeerLink
	allow PeerLink class access friend access More...

class	PeerManagementProtocol
	allow PeerManagementProtocol class access friend access More...

Detailed Description

This is plugin to Mesh WiFi MAC, which implements the 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.

Definition at line 44 of file peer-management-protocol-mac.h.

Constructor & Destructor Documentation

◆ PeerManagementProtocolMac() [1/2]

ns3::dot11s::PeerManagementProtocolMac::PeerManagementProtocolMac	(	uint32_t	interface,
		Ptr< PeerManagementProtocol >	protocol
	)

Constructor.

Parameters

interface	interface index
protocol	peer management protocol

Definition at line 37 of file peer-management-protocol-mac.cc.

References m_ifIndex, and m_protocol.

◆ ~PeerManagementProtocolMac()

ns3::dot11s::PeerManagementProtocolMac::~PeerManagementProtocolMac ( )

Definition at line 44 of file peer-management-protocol-mac.cc.

◆ PeerManagementProtocolMac() [2/2]

ns3::dot11s::PeerManagementProtocolMac::PeerManagementProtocolMac ( const PeerManagementProtocolMac & )

private

type conversion operator

Member Function Documentation

◆ AssignStreams()

int64_t ns3::dot11s::PeerManagementProtocolMac::AssignStreams ( int64_t stream )

virtual

Assign the streams.

Parameters

stream the stream to assign

Returns: the assigned stream

Implements ns3::MeshWifiInterfaceMacPlugin.

Definition at line 389 of file peer-management-protocol-mac.cc.

References m_protocol.

◆ CreatePeerLinkCloseFrame()

Ptr<Packet> ns3::dot11s::PeerManagementProtocolMac::CreatePeerLinkCloseFrame ( )

private

Create peer link clode frame function.

Returns: the packet

◆ CreatePeerLinkConfirmFrame()

Ptr<Packet> ns3::dot11s::PeerManagementProtocolMac::CreatePeerLinkConfirmFrame ( )

private

Create peer link confirm frame function.

Returns: the packet

◆ CreatePeerLinkOpenFrame()

Ptr<Packet> ns3::dot11s::PeerManagementProtocolMac::CreatePeerLinkOpenFrame ( )

private

Create peer link open frame function.

Returns: the packet

◆ GetAddress()

Mac48Address ns3::dot11s::PeerManagementProtocolMac::GetAddress ( void ) const

private

debug only, used to print established links

Returns: the MAC address

Definition at line 327 of file peer-management-protocol-mac.cc.

References m_parent.

Referenced by ns3::dot11s::PeerLink::Report().

Here is the caller graph for this function:

◆ GetLinkMetric()

uint32_t ns3::dot11s::PeerManagementProtocolMac::GetLinkMetric ( Mac48Address peerAddress )

Get the link metric.

Parameters

peerAddress the peer address

Returns: The metric

Definition at line 384 of file peer-management-protocol-mac.cc.

References m_parent.

Referenced by ns3::dot11s::PeerLink::Report().

Here is the caller graph for this function:

◆ operator=()

PeerManagementProtocolMac& ns3::dot11s::PeerManagementProtocolMac::operator= ( const PeerManagementProtocolMac & peer )

private

assignment operator

Parameters

peer	the object to assign

Returns: the assigned value

◆ ParsePlinkFrame()

PlinkFrameStart ns3::dot11s::PeerManagementProtocolMac::ParsePlinkFrame ( Ptr< const Packet > packet )

private

Parses the start of the frame, where no WifiInformationElements exist.

Parameters

packet the packet

Returns: PlinkFrameStart

◆ Receive()

bool ns3::dot11s::PeerManagementProtocolMac::Receive	(	Ptr< Packet >	packet,
		const WifiMacHeader &	header
	)

virtual

Receive and process a packet.

Parameters

packet	the packet received
header	the header

Returns: true if received

Implements ns3::MeshWifiInterfaceMacPlugin.

Definition at line 66 of file peer-management-protocol-mac.cc.

Here is the call graph for this function:

◆ Report()

void ns3::dot11s::PeerManagementProtocolMac::Report ( std::ostream & os ) const

Report statistics.

Parameters

os	the output stream

Definition at line 371 of file peer-management-protocol-mac.cc.

References m_parent, m_stats, and ns3::dot11s::PeerManagementProtocolMac::Statistics::Print().

Here is the call graph for this function:

◆ ResetStats()

void ns3::dot11s::PeerManagementProtocolMac::ResetStats ( )

Reset stats.

Definition at line 379 of file peer-management-protocol-mac.cc.

References m_stats.

◆ SendPeerLinkManagementFrame()

void ns3::dot11s::PeerManagementProtocolMac::SendPeerLinkManagementFrame	(	Mac48Address	peerAddress,
		Mac48Address	peerMpAddress,
		uint16_t	aid,
		IePeerManagement	peerElement,
		IeConfiguration	meshConfig
	)

private

Send peer link management frame function.

Parameters

peerAddress	the peer MAC address
peerMpAddress	the peer MP address
aid	the AID
peerElement	IePeerManagement
meshConfig	IeConfiguration

Definition at line 252 of file peer-management-protocol-mac.cc.

Referenced by ns3::dot11s::PeerLink::SendPeerLinkClose(), ns3::dot11s::PeerLink::SendPeerLinkConfirm(), and ns3::dot11s::PeerLink::SendPeerLinkOpen().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetBeaconShift()

void ns3::dot11s::PeerManagementProtocolMac::SetBeaconShift ( Time shift )

private

Set beacon shift function.

Parameters

shift the beacon time shift

Definition at line 339 of file peer-management-protocol-mac.cc.

References ns3::dot11s::PeerManagementProtocolMac::Statistics::beaconShift, m_parent, m_stats, and ns3::Seconds().

Here is the call graph for this function:

◆ SetParent()

void ns3::dot11s::PeerManagementProtocolMac::SetParent ( Ptr< MeshWifiInterfaceMac > parent )

virtual

Set pointer to parent.

Parameters

parent Ptr<MeshWifiInterfaceMac>

Implements ns3::MeshWifiInterfaceMacPlugin.

Definition at line 49 of file peer-management-protocol-mac.cc.

References m_parent, ns3::MakeCallback(), TxError(), and TxOk().

Here is the call graph for this function:

◆ SetPeerManagerProtcol()

void ns3::dot11s::PeerManagementProtocolMac::SetPeerManagerProtcol ( Ptr< PeerManagementProtocol > protocol )

private

Set peer manager protocol function.

Parameters

protocol the peer manager protocol

◆ TxError()

void ns3::dot11s::PeerManagementProtocolMac::TxError	(	WifiMacDropReason	reason,
		Ptr< const WifiMacQueueItem >	mpdu
	)

private

Closes link when a proper number of successive transmissions have failed.

Parameters

reason	the reason why the MPDU was dropped
mpdu	the dropped MPDU

Definition at line 56 of file peer-management-protocol-mac.cc.

References m_ifIndex, and m_protocol.

Referenced by SetParent().

Here is the caller graph for this function:

◆ TxOk()

void ns3::dot11s::PeerManagementProtocolMac::TxOk ( Ptr< const WifiMacQueueItem > mpdu )

private

Transmit OK function.

Parameters

mpdu the MPDU

Definition at line 61 of file peer-management-protocol-mac.cc.

References m_ifIndex, and m_protocol.

Referenced by SetParent().

Here is the caller graph for this function:

◆ UpdateBeacon()

void ns3::dot11s::PeerManagementProtocolMac::UpdateBeacon ( MeshWifiBeacon & beacon ) const

virtual

Add beacon timing and mesh ID information elements, and notify beacon sent.

Parameters

beacon the beacon

Implements ns3::MeshWifiInterfaceMacPlugin.

Definition at line 240 of file peer-management-protocol-mac.cc.

References ns3::MeshWifiBeacon::AddInformationElement(), ns3::MeshWifiBeacon::GetBeaconInterval(), m_ifIndex, and m_protocol.

Here is the call graph for this function:

◆ UpdateOutcomingFrame()

bool ns3::dot11s::PeerManagementProtocolMac::UpdateOutcomingFrame	(	Ptr< Packet >	packet,
		WifiMacHeader &	header,
		Mac48Address	from,
		Mac48Address	to
	)

virtual

This method appears to test a few conditions.

If an action frame, it returns true if SELF_PROTECTED. It then checks if it is either a broadcast or sent on an active link, and returns true if so. Otherwise, it returns false (indicating it is to be dropped)

Parameters