Helper to create IEEE 802.11s mesh networks. More...

#include <mesh-helper.h>

Collaboration diagram for ns3::MeshHelper:

Public Types
enum	ChannelPolicy { SPREAD_CHANNELS, ZERO_CHANNEL }
	Spread/not spread frequency channels of MP interfaces. More...

Public Member Functions
	MeshHelper ()
	Construct a MeshHelper used to make life easier when creating 802.11s networks. More...

	~MeshHelper ()
	Destroy a MeshHelper. More...

int64_t	AssignStreams (NetDeviceContainer c, int64_t stream)
	Assign a fixed random variable stream number to the random variables used by this model. More...

NetDeviceContainer	Install (const WifiPhyHelper &phyHelper, NodeContainer c) const
	Install 802.11s mesh device & protocols on given node list. More...

void	Report (const ns3::Ptr< ns3::NetDevice > &, std::ostream &)
	Print statistics. More...

void	ResetStats (const ns3::Ptr< ns3::NetDevice > &)
	Reset statistics. More...

void	SetMacType (std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())

void	SetNumberOfInterfaces (uint32_t nInterfaces)
	Set a number of interfaces in a mesh network. More...

void	SetRemoteStationManager (std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())

void	SetSpreadInterfaceChannels (ChannelPolicy)
	set the channel policy More...

void	SetStackInstaller (std::string type, std::string n0="", const AttributeValue &v0=EmptyAttributeValue(), std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue())

void	SetStandard (enum WifiPhyStandard standard)
	Set PHY standard. More...

Static Public Member Functions
static MeshHelper	Default ()
	Set the helper to the default values for the MAC type, remote station manager and channel policy. More...

Private Member Functions
Ptr< WifiNetDevice >	CreateInterface (const WifiPhyHelper &phyHelper, Ptr< Node > node, uint16_t channelId) const

Private Attributes
uint32_t	m_nInterfaces

ChannelPolicy	m_spreadChannelPolicy

Ptr< MeshStack >	m_stack

ObjectFactory	m_stackFactory

Interface factory
ObjectFactory	m_mac

ObjectFactory	m_stationManager

enum WifiPhyStandard	m_standard

Detailed Description

Helper to create IEEE 802.11s mesh networks.

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

Member Enumeration 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.

Constructor & Destructor Documentation

ns3::MeshHelper::MeshHelper ( )

Construct a MeshHelper used to make life easier when creating 802.11s networks.

Definition at line 29 of file mesh-helper.cc.

ns3::MeshHelper::~MeshHelper ( )

Destroy a MeshHelper.

Definition at line 36 of file mesh-helper.cc.

References m_stack.

Member Function Documentation

int64_t ns3::MeshHelper::AssignStreams	(	NetDeviceContainer	c,
		int64_t	stream
	)

Assign a fixed random variable stream number to the random variables used by this model.

Return the number of streams (possibly zero) that have been assigned. The Install() method of this helper should have previously been called by the user.

Parameters

stream	first stream index to use
c	NetDeviceContainer of the set of devices for which the mesh devices should be modified to use a fixed stream

Returns: the number of stream indices assigned by this helper

Definition at line 212 of file mesh-helper.cc.

References ns3::NetDeviceContainer::Begin(), and ns3::NetDeviceContainer::End().

Referenced by PeerManagementProtocolRegressionTest::CreateDevices(), HwmpProactiveRegressionTest::CreateDevices(), FlameRegressionTest::CreateDevices(), HwmpDoRfRegressionTest::CreateDevices(), HwmpSimplestRegressionTest::CreateDevices(), and HwmpReactiveRegressionTest::CreateDevices().

Here is the call graph for this function:

Here is the caller graph for this function:

Ptr< WifiNetDevice > ns3::MeshHelper::CreateInterface	(	const WifiPhyHelper &	phyHelper,
		Ptr< Node >	node,
		uint16_t	channelId
	)		const

private

Internal:

Returns: a WifiNetDevice with ready-to-use interface

Definition at line 171 of file mesh-helper.cc.

References ns3::Node::AddDevice(), ns3::Mac48Address::Allocate(), ns3::WifiPhy::ConfigureStandard(), ns3::WifiPhyHelper::Create(), ns3::ObjectFactory::Create(), m_mac, m_standard, m_stationManager, and NS_ASSERT.

Referenced by Install().

Here is the call graph for this function:

Here is the caller graph for this function:

MeshHelper ns3::MeshHelper::Default ( void )

static

Set the helper to the default values for the MAC type, remote station manager and channel policy.

Definition at line 113 of file mesh-helper.cc.

References SetMacType(), SetRemoteStationManager(), SetSpreadInterfaceChannels(), and SPREAD_CHANNELS.

Here is the call graph for this function:

NetDeviceContainer ns3::MeshHelper::Install	(	const WifiPhyHelper &	phyHelper,
		NodeContainer	c
	)		const

Install 802.11s mesh device & protocols on given node list.

Parameters

phyHelper	Wifi PHY helper
c	List of nodes to install

Returns: list of created mesh point devices, see MeshPointDevice

Definition at line 79 of file mesh-helper.cc.

References ns3::NetDeviceContainer::Add(), ns3::Node::AddDevice(), ns3::NodeContainer::Begin(), CreateInterface(), first::devices, ns3::NodeContainer::End(), m_nInterfaces, m_spreadChannelPolicy, m_stack, NS_ASSERT, NS_FATAL_ERROR, SPREAD_CHANNELS, and ZERO_CHANNEL.

Referenced by PeerManagementProtocolRegressionTest::CreateDevices(), FlameRegressionTest::CreateDevices(), HwmpProactiveRegressionTest::CreateDevices(), HwmpDoRfRegressionTest::CreateDevices(), HwmpSimplestRegressionTest::CreateDevices(), HwmpReactiveRegressionTest::CreateDevices(), and MeshTest::CreateNodes().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MeshHelper::Report	(	const ns3::Ptr< ns3::NetDevice > &	device,
		std::ostream &	os
	)

Print statistics.

Definition at line 192 of file mesh-helper.cc.

References ns3::Mac48Address::ConvertFrom(), ns3::Object::GetObject(), ns3::Time::GetSeconds(), m_stack, ns3::Simulator::Now(), and NS_ASSERT.

Referenced by MeshTest::Report().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MeshHelper::ResetStats ( const ns3::Ptr< ns3::NetDevice > & device )

Reset statistics.

Definition at line 204 of file mesh-helper.cc.

References ns3::Object::GetObject(), m_stack, and NS_ASSERT.

Here is the call graph for this function:

void ns3::MeshHelper::SetMacType	(	std::string	n0 = `""`,
		const AttributeValue &	v0 = `EmptyAttributeValue ()`,
		std::string	n1 = `""`,
		const AttributeValue &	v1 = `EmptyAttributeValue ()`,
		std::string	n2 = `""`,
		const AttributeValue &	v2 = `EmptyAttributeValue ()`,
		std::string	n3 = `""`,
		const AttributeValue &	v3 = `EmptyAttributeValue ()`,
		std::string	n4 = `""`,
		const AttributeValue &	v4 = `EmptyAttributeValue ()`,
		std::string	n5 = `""`,
		const AttributeValue &	v5 = `EmptyAttributeValue ()`,
		std::string	n6 = `""`,
		const AttributeValue &	v6 = `EmptyAttributeValue ()`,
		std::string	n7 = `""`,
		const AttributeValue &	v7 = `EmptyAttributeValue ()`
	)

Parameters

n0	the name of the attribute to set
v0	the value of the attribute to set
n1	the name of the attribute to set
v1	the value of the attribute to set
n2	the name of the attribute to set
v2	the value of the attribute to set
n3	the name of the attribute to set
v3	the value of the attribute to set
n4	the name of the attribute to set
v4	the value of the attribute to set
n5	the name of the attribute to set
v5	the value of the attribute to set
n6	the name of the attribute to set
v6	the value of the attribute to set
n7	the name of the attribute to set
v7	the value of the attribute to set

All the attributes specified in this method should exist in the requested mac.

Definition at line 123 of file mesh-helper.cc.

References m_mac, ns3::ObjectFactory::Set(), and ns3::ObjectFactory::SetTypeId().

Referenced by PeerManagementProtocolRegressionTest::CreateDevices(), FlameRegressionTest::CreateDevices(), HwmpProactiveRegressionTest::CreateDevices(), HwmpDoRfRegressionTest::CreateDevices(), HwmpSimplestRegressionTest::CreateDevices(), HwmpReactiveRegressionTest::CreateDevices(), MeshTest::CreateNodes(), and Default().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MeshHelper::SetNumberOfInterfaces ( uint32_t nInterfaces )

Set a number of interfaces in a mesh network.

Parameters

nInterfaces is the number of interfaces

Definition at line 74 of file mesh-helper.cc.

References m_nInterfaces.

Referenced by PeerManagementProtocolRegressionTest::CreateDevices(), FlameRegressionTest::CreateDevices(), HwmpProactiveRegressionTest::CreateDevices(), HwmpDoRfRegressionTest::CreateDevices(), HwmpSimplestRegressionTest::CreateDevices(), HwmpReactiveRegressionTest::CreateDevices(), and MeshTest::CreateNodes().

Here is the caller graph for this function:

void ns3::MeshHelper::SetRemoteStationManager	(	std::string	type,
		std::string	n0 = `""`,
		const AttributeValue &	v0 = `EmptyAttributeValue ()`,
		std::string	n1 = `""`,
		const AttributeValue &	v1 = `EmptyAttributeValue ()`,
		std::string	n2 = `""`,
		const AttributeValue &	v2 = `EmptyAttributeValue ()`,
		std::string	n3 = `""`,
		const AttributeValue &	v3 = `EmptyAttributeValue ()`,
		std::string	n4 = `""`,
		const AttributeValue &	v4 = `EmptyAttributeValue ()`,
		std::string	n5 = `""`,
		const AttributeValue &	v5 = `EmptyAttributeValue ()`,
		std::string	n6 = `""`,
		const AttributeValue &	v6 = `EmptyAttributeValue ()`,
		std::string	n7 = `""`,
		const AttributeValue &	v7 = `EmptyAttributeValue ()`
	)

Parameters

type	the type of ns3::WifiRemoteStationManager to create.
n0	the name of the attribute to set
v0	the value of the attribute to set
n1	the name of the attribute to set
v1	the value of the attribute to set
n2	the name of the attribute to set
v2	the value of the attribute to set
n3	the name of the attribute to set
v3	the value of the attribute to set
n4	the name of the attribute to set
v4	the value of the attribute to set
n5	the name of the attribute to set
v5	the value of the attribute to set
n6	the name of the attribute to set
v6	the value of the attribute to set
n7	the name of the attribute to set
v7	the value of the attribute to set

All the attributes specified in this method should exist in the requested station manager.

Definition at line 143 of file mesh-helper.cc.

References m_stationManager, ns3::ObjectFactory::Set(), and ns3::ObjectFactory::SetTypeId().

Referenced by Default().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::MeshHelper::SetSpreadInterfaceChannels ( ChannelPolicy policy )

set the channel policy

Definition at line 41 of file mesh-helper.cc.

References m_spreadChannelPolicy.

Referenced by MeshTest::CreateNodes(), and Default().

Here is the caller graph for this function:

void ns3::MeshHelper::SetStackInstaller	(	std::string	type,
		std::string	n0 = `""`,
		const AttributeValue &	v0 = `EmptyAttributeValue ()`,
		std::string	n1 = `""`,
		const AttributeValue &	v1 = `EmptyAttributeValue ()`,
		std::string	n2 = `""`,
		const AttributeValue &	v2 = `EmptyAttributeValue ()`,
		std::string	n3 = `""`,
		const AttributeValue &	v3 = `EmptyAttributeValue ()`,
		std::string	n4 = `""`,
		const AttributeValue &	v4 = `EmptyAttributeValue ()`,
		std::string	n5 = `""`,
		const AttributeValue &	v5 = `EmptyAttributeValue ()`,
		std::string	n6 = `""`,
		const AttributeValue &	v6 = `EmptyAttributeValue ()`,
		std::string	n7 = `""`,
		const AttributeValue &	v7 = `EmptyAttributeValue ()`
	)

Parameters

type	the type of ns3::MeshStack.
n0	the name of the attribute to set
v0	the value of the attribute to set
n1	the name of the attribute to set
v1	the value of the attribute to set
n2	the name of the attribute to set
v2	the value of the attribute to set
n3	the name of the attribute to set
v3	the value of the attribute to set
n4	the name of the attribute to set
v4	the value of the attribute to set
n5	the name of the attribute to set
v5	the value of the attribute to set
n6	the name of the attribute to set
v6	the value of the attribute to set
n7	the name of the attribute to set
v7	the value of the attribute to set