Robust Rate Adaptation AlgorithmThis is an implementation of RRAA as described in "Robust rate adaptation for 802.11 wireless networks" by "Starsky H. Y. Wong", "Hao Yang", "Songwu Lu", and, "Vaduvur Bharghavan" published in Mobicom 06. More...

#include <rraa-wifi-manager.h>

Inheritance diagram for ns3::RraaWifiManager:

Collaboration diagram for ns3::RraaWifiManager:

Classes
struct	ThresholdsItem

Public Member Functions
	RraaWifiManager ()
virtual	~RraaWifiManager ()
Public Member Functions inherited from ns3::WifiRemoteStationManager
	WifiRemoteStationManager ()
virtual	~WifiRemoteStationManager ()
void	AddBasicMode (WifiMode mode)
void	AddSupportedMode (Mac48Address address, WifiMode mode)
WifiMode	GetAckMode (Mac48Address address, WifiMode dataMode)
WifiMode	GetBasicMode (uint32_t i) const
WifiMode	GetCtsMode (Mac48Address address, WifiMode rtsMode)
WifiMode	GetDataMode (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fullPacketSize)
WifiMode	GetDefaultMode (void) const
uint32_t	GetFragmentationThreshold (void) const
uint32_t	GetFragmentOffset (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber)
uint32_t	GetFragmentSize (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber)
WifiRemoteStationInfo	GetInfo (Mac48Address address)
uint32_t	GetMaxSlrc (void) const
uint32_t	GetMaxSsrc (void) const
uint32_t	GetNBasicModes (void) const
WifiMode	GetNonUnicastMode (void) const
uint32_t	GetRtsCtsThreshold (void) const
WifiMode	GetRtsMode (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
bool	IsAssociated (Mac48Address address) const
bool	IsBrandNew (Mac48Address address) const
bool	IsLastFragment (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber)
bool	IsWaitAssocTxOk (Mac48Address address) const
bool	NeedDataRetransmission (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
bool	NeedFragmentation (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
bool	NeedRts (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
bool	NeedRtsRetransmission (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
void	PrepareForQueue (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fullPacketSize)
void	RecordDisassociated (Mac48Address address)
void	RecordGotAssocTxFailed (Mac48Address address)
void	RecordGotAssocTxOk (Mac48Address address)
void	RecordWaitAssocTxOk (Mac48Address address)
void	ReportDataFailed (Mac48Address address, const WifiMacHeader *header)
void	ReportDataOk (Mac48Address address, const WifiMacHeader *header, double ackSnr, WifiMode ackMode, double dataSnr)
void	ReportFinalDataFailed (Mac48Address address, const WifiMacHeader *header)
void	ReportFinalRtsFailed (Mac48Address address, const WifiMacHeader *header)
void	ReportRtsFailed (Mac48Address address, const WifiMacHeader *header)
void	ReportRtsOk (Mac48Address address, const WifiMacHeader *header, double ctsSnr, WifiMode ctsMode, double rtsSnr)
void	ReportRxOk (Mac48Address address, const WifiMacHeader *header, double rxSnr, WifiMode txMode)
void	Reset (void)
void	Reset (Mac48Address address)
void	SetFragmentationThreshold (uint32_t threshold)
void	SetMaxSlrc (uint32_t maxSlrc)
void	SetMaxSsrc (uint32_t maxSsrc)
void	SetRtsCtsThreshold (uint32_t threshold)
virtual void	SetupPhy (Ptr< WifiPhy > phy)
Public Member Functions inherited from ns3::Object
	Object ()
virtual	~Object ()
void	AggregateObject (Ptr< Object > other)
void	Dispose (void)
AggregateIterator	GetAggregateIterator (void) const
virtual TypeId	GetInstanceTypeId (void) const
template<typename T >
Ptr< T >	GetObject (void) const
template<typename T >
Ptr< T >	GetObject (TypeId tid) const
void	Start (void)
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	SimpleRefCount ()
	SimpleRefCount (const SimpleRefCount &o)
uint32_t	GetReferenceCount (void) const
SimpleRefCount &	operator= (const SimpleRefCount &o)
void	Ref (void) const
void	Unref (void) const
Public Member Functions inherited from ns3::ObjectBase
virtual	~ObjectBase ()
void	GetAttribute (std::string name, AttributeValue &value) const
bool	GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
void	SetAttribute (std::string name, const AttributeValue &value)
bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)
bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)
bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)

Static Public Member Functions
static TypeId	GetTypeId (void)
	This method returns the TypeId associated to ns3::RraaWifiManager.

Private Member Functions
void	ARts (RraaWifiRemoteStation *station)
void	CheckTimeout (RraaWifiRemoteStation *station)
virtual WifiRemoteStation *	DoCreateStation (void) const
virtual WifiMode	DoGetDataMode (WifiRemoteStation *station, uint32_t size)
virtual WifiMode	DoGetRtsMode (WifiRemoteStation *station)
virtual bool	DoNeedRts (WifiRemoteStation *st, Ptr< const Packet > packet, bool normally)
virtual void	DoReportDataFailed (WifiRemoteStation *station)
virtual void	DoReportDataOk (WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr)
virtual void	DoReportFinalDataFailed (WifiRemoteStation *station)
virtual void	DoReportFinalRtsFailed (WifiRemoteStation *station)
virtual void	DoReportRtsFailed (WifiRemoteStation *station)
virtual void	DoReportRtsOk (WifiRemoteStation *station, double ctsSnr, WifiMode ctsMode, double rtsSnr)
virtual void	DoReportRxOk (WifiRemoteStation *station, double rxSnr, WifiMode txMode)
uint32_t	GetMaxRate (RraaWifiRemoteStation *station)
uint32_t	GetMinRate (RraaWifiRemoteStation *station)
struct ThresholdsItem	GetThresholds (WifiMode mode) const
struct ThresholdsItem	GetThresholds (RraaWifiRemoteStation *station, uint32_t rate) const
virtual bool	IsLowLatency (void) const
void	ResetCountersBasic (RraaWifiRemoteStation *station)
void	RunBasicAlgorithm (RraaWifiRemoteStation *station)

Private Attributes
bool	m_basic
uint32_t	m_ewndfor12
uint32_t	m_ewndfor18
uint32_t	m_ewndfor24
uint32_t	m_ewndfor36
uint32_t	m_ewndfor48
uint32_t	m_ewndfor54
uint32_t	m_ewndfor6
uint32_t	m_ewndfor9
double	m_pmtlfor12
double	m_pmtlfor18
double	m_pmtlfor24
double	m_pmtlfor36
double	m_pmtlfor48
double	m_pmtlfor54
double	m_pmtlfor9
double	m_porifor12
double	m_porifor18
double	m_porifor24
double	m_porifor36
double	m_porifor48
double	m_porifor6
double	m_porifor9
Time	m_timeout

Additional Inherited Members
Protected Member Functions inherited from ns3::WifiRemoteStationManager
virtual void	DoDispose (void)
uint32_t	GetNSupported (const WifiRemoteStation *station) const
WifiMode	GetSupported (const WifiRemoteStation *station, uint32_t i) const

Detailed Description

Robust Rate Adaptation Algorithm

This is an implementation of RRAA as described in "Robust rate adaptation for 802.11 wireless networks" by "Starsky H. Y. Wong", "Hao Yang", "Songwu Lu", and, "Vaduvur Bharghavan" published in Mobicom 06.

Definition at line 39 of file rraa-wifi-manager.h.

Constructor & Destructor Documentation

ns3::RraaWifiManager::RraaWifiManager ( )

Definition at line 180 of file rraa-wifi-manager.cc.

ns3::RraaWifiManager::~RraaWifiManager ( )

virtual

Definition at line 183 of file rraa-wifi-manager.cc.

Member Function Documentation

void ns3::RraaWifiManager::ARts ( RraaWifiRemoteStation * station )

private

Definition at line 333 of file rraa-wifi-manager.cc.

References ns3::RraaWifiRemoteStation::m_lastFrameFail, ns3::RraaWifiRemoteStation::m_rtsCounter, ns3::RraaWifiRemoteStation::m_rtsOn, and ns3::RraaWifiRemoteStation::m_rtsWnd.

Referenced by DoNeedRts().

Here is the caller graph for this function:

void ns3::RraaWifiManager::CheckTimeout ( RraaWifiRemoteStation * station )

private

Definition at line 301 of file rraa-wifi-manager.cc.

References ns3::RraaWifiRemoteStation::m_counter, ns3::RraaWifiRemoteStation::m_lastReset, m_timeout, ns3::Now(), and ResetCountersBasic().

Referenced by DoReportDataFailed(), and DoReportDataOk().

Here is the call graph for this function:

Here is the caller graph for this function:

WifiRemoteStation * ns3::RraaWifiManager::DoCreateStation ( void ) const

privatevirtual

Definition at line 189 of file rraa-wifi-manager.cc.

References ns3::RraaWifiRemoteStation::m_initialized, ns3::RraaWifiRemoteStation::m_lastFrameFail, ns3::RraaWifiRemoteStation::m_rtsCounter, ns3::RraaWifiRemoteStation::m_rtsOn, and ns3::RraaWifiRemoteStation::m_rtsWnd.

WifiMode ns3::RraaWifiManager::DoGetDataMode	(	WifiRemoteStation *	station,
		uint32_t	size
	)

privatevirtual

Definition at line 271 of file rraa-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetSupported(), ns3::RraaWifiRemoteStation::m_initialized, ns3::RraaWifiRemoteStation::m_rate, and ResetCountersBasic().

Here is the call graph for this function:

WifiMode ns3::RraaWifiManager::DoGetRtsMode ( WifiRemoteStation * station )

privatevirtual

Definition at line 282 of file rraa-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetSupported().

Here is the call graph for this function:

bool ns3::RraaWifiManager::DoNeedRts	(	WifiRemoteStation *	st,
		Ptr< const Packet >	packet,
		bool	normally
	)

privatevirtual

Definition at line 288 of file rraa-wifi-manager.cc.

References ARts(), m_basic, and ns3::RraaWifiRemoteStation::m_rtsOn.

Here is the call graph for this function:

void ns3::RraaWifiManager::DoReportDataFailed ( WifiRemoteStation * station )

privatevirtual

Definition at line 231 of file rraa-wifi-manager.cc.

References CheckTimeout(), ns3::RraaWifiRemoteStation::m_counter, ns3::RraaWifiRemoteStation::m_failed, ns3::RraaWifiRemoteStation::m_lastFrameFail, and RunBasicAlgorithm().

Here is the call graph for this function:

void ns3::RraaWifiManager::DoReportDataOk	(	WifiRemoteStation *	station,
		double	ackSnr,
		WifiMode	ackMode,
		double	dataSnr
	)

privatevirtual

Definition at line 252 of file rraa-wifi-manager.cc.

References CheckTimeout(), ns3::RraaWifiRemoteStation::m_counter, ns3::RraaWifiRemoteStation::m_lastFrameFail, and RunBasicAlgorithm().

Here is the call graph for this function:

void ns3::RraaWifiManager::DoReportFinalDataFailed ( WifiRemoteStation * station )

privatevirtual

Definition at line 266 of file rraa-wifi-manager.cc.

void ns3::RraaWifiManager::DoReportFinalRtsFailed ( WifiRemoteStation * station )

privatevirtual

Definition at line 262 of file rraa-wifi-manager.cc.

void ns3::RraaWifiManager::DoReportRtsFailed ( WifiRemoteStation * station )

privatevirtual

Definition at line 226 of file rraa-wifi-manager.cc.

void ns3::RraaWifiManager::DoReportRtsOk	(	WifiRemoteStation *	station,
		double	ctsSnr,
		WifiMode	ctsMode,
		double	rtsSnr
	)

privatevirtual

Definition at line 246 of file rraa-wifi-manager.cc.

References NS_LOG_DEBUG.

void ns3::RraaWifiManager::DoReportRxOk	(	WifiRemoteStation *	station,
		double	rxSnr,
		WifiMode	txMode
	)

privatevirtual

Definition at line 241 of file rraa-wifi-manager.cc.

uint32_t ns3::RraaWifiManager::GetMaxRate ( RraaWifiRemoteStation * station )

private

Definition at line 214 of file rraa-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetNSupported().

Referenced by ResetCountersBasic(), and RunBasicAlgorithm().

Here is the call graph for this function:

Here is the caller graph for this function:

uint32_t ns3::RraaWifiManager::GetMinRate ( RraaWifiRemoteStation * station )

private

Definition at line 219 of file rraa-wifi-manager.cc.

Referenced by RunBasicAlgorithm().

Here is the caller graph for this function:

struct RraaWifiManager::ThresholdsItem ns3::RraaWifiManager::GetThresholds ( WifiMode mode ) const

readprivate

Definition at line 367 of file rraa-wifi-manager.cc.

References m_ewndfor12, m_ewndfor18, m_ewndfor24, m_ewndfor36, m_ewndfor48, m_ewndfor54, m_ewndfor6, m_ewndfor9, m_pmtlfor12, m_pmtlfor18, m_pmtlfor24, m_pmtlfor36, m_pmtlfor48, m_pmtlfor54, m_pmtlfor9, m_porifor12, m_porifor18, m_porifor24, m_porifor36, m_porifor48, m_porifor6, m_porifor9, and NS_ASSERT_MSG.

Referenced by GetThresholds(), ResetCountersBasic(), and RunBasicAlgorithm().

Here is the caller graph for this function:

struct RraaWifiManager::ThresholdsItem ns3::RraaWifiManager::GetThresholds	(	RraaWifiRemoteStation *	station,
		uint32_t	rate
	)		const

readprivate

Definition at line 359 of file rraa-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetSupported(), and GetThresholds().

Here is the call graph for this function:

TypeId ns3::RraaWifiManager::GetTypeId ( void )

static

This method returns the TypeId associated to ns3::RraaWifiManager.

This object is accessible through the following paths with Config::Set and Config::Connect:

/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/RemoteStationManager/$ns3::RraaWifiManager

Attributes defined for this type:

Basic: If true the RRAA-BASIC algorithm will be used, otherwise the RRAA wil be used
- Set with class: BooleanValue
- Underlying type: bool
- Initial value: false
- Flags: construct write read
Timeout: Timeout for the RRAA BASIC loss estimaton block (s)
- Set with class: TimeValue
- Underlying type: Time
- Initial value: +50000000.0ns
- Flags: construct write read
ewndFor54mbps: ewnd parameter for 54 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 40
- Flags: construct write read
ewndFor48mbps: ewnd parameter for 48 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 40
- Flags: construct write read
ewndFor36mbps: ewnd parameter for 36 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 40
- Flags: construct write read
ewndFor24mbps: ewnd parameter for 24 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 40
- Flags: construct write read
ewndFor18mbps: ewnd parameter for 18 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 20
- Flags: construct write read
ewndFor12mbps: ewnd parameter for 12 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 20
- Flags: construct write read
ewndFor9mbps: ewnd parameter for 9 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 10
- Flags: construct write read
ewndFor6mbps: ewnd parameter for 6 Mbs data mode
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 6
- Flags: construct write read
poriFor48mbps: Pori parameter for 48 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.047
- Flags: construct write read
poriFor36mbps: Pori parameter for 36 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.115
- Flags: construct write read
poriFor24mbps: Pori parameter for 24 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.1681
- Flags: construct write read
poriFor18mbps: Pori parameter for 18 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.1325
- Flags: construct write read
poriFor12mbps: Pori parameter for 12 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.1861
- Flags: construct write read
poriFor9mbps: Pori parameter for 9 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.1434
- Flags: construct write read
poriFor6mbps: Pori parameter for 6 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.5
- Flags: construct write read
pmtlFor54mbps: Pmtl parameter for 54 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.094
- Flags: construct write read
pmtlFor48mbps: Pmtl parameter for 48 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.23
- Flags: construct write read
pmtlFor36mbps: Pmtl parameter for 36 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.3363
- Flags: construct write read
pmtlFor24mbps: Pmtl parameter for 24 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.265
- Flags: construct write read
pmtlFor18mbps: Pmtl parameter for 18 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.3722
- Flags: construct write read
pmtlFor12mbps: Pmtl parameter for 12 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.2868
- Flags: construct write read
pmtlFor9mbps: Pmtl parameter for 9 Mbs data mode
- Set with class: ns3::DoubleValue
- Underlying type: double -1.79769e+308:1.79769e+308
- Initial value: 0.3932
- Flags: construct write read

Attributes defined in parent class ns3::WifiRemoteStationManager:

IsLowLatency: If true, we attempt to modelize a so-called low-latency device: a device where decisions about tx parameters can be made on a per-packet basis and feedback about the transmission of each packet is obtained before sending the next. Otherwise, we modelize a high-latency device, that is a device where we cannot update our decision about tx parameters after every packet transmission.
- Set with class: BooleanValue
- Underlying type: bool
- Flags: read
MaxSsrc: The maximum number of retransmission attempts for an RTS. This value will not have any effect on some rate control algorithms.
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 7
- Flags: construct write read
MaxSlrc: The maximum number of retransmission attempts for a DATA packet. This value will not have any effect on some rate control algorithms.
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 7
- Flags: construct write read
RtsCtsThreshold: If the size of the data packet + LLC header + MAC header + FCS trailer is bigger than this value, we use an RTS/CTS handshake before sending the data, as per IEEE Std. 802.11-2007, Section 9.2.6. This value will not have any effect on some rate control algorithms.
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 2346
- Flags: construct write read
FragmentationThreshold: If the size of the data packet + LLC header + MAC header + FCS trailer is biggerthan this value, we fragment it such that the size of the fragments are equal or smaller than this value, as per IEEE Std. 802.11-2007, Section 9.4. This value will not have any effect on some rate control algorithms.
- Set with class: ns3::UintegerValue
- Underlying type: uint32_t 0:4294967295
- Initial value: 2346
- Flags: construct write read
NonUnicastMode: Wifi mode used for non-unicast transmissions.
- Set with class: WifiModeValue
- Underlying type: WifiMode
- Initial value: Invalid-WifiMode
- Flags: construct write read

No TraceSources defined for this type.
TraceSources defined in parent class ns3::WifiRemoteStationManager:

MacTxRtsFailed: The transmission of a RTS by the MAC layer has failed
MacTxDataFailed: The transmission of a data packet by the MAC layer has failed
MacTxFinalRtsFailed: The transmission of a RTS has exceeded the maximum number of attempts
MacTxFinalDataFailed: The transmission of a data packet has exceeded the maximum number of attempts

Reimplemented from ns3::WifiRemoteStationManager.

Definition at line 50 of file rraa-wifi-manager.cc.

References m_basic, m_ewndfor12, m_ewndfor18, m_ewndfor24, m_ewndfor36, m_ewndfor48, m_ewndfor54, m_ewndfor6, m_ewndfor9, m_pmtlfor12, m_pmtlfor18, m_pmtlfor24, m_pmtlfor36, m_pmtlfor48, m_pmtlfor54, m_pmtlfor9, m_porifor12, m_porifor18, m_porifor24, m_porifor36, m_porifor48, m_porifor6, m_porifor9, m_timeout, ns3::Seconds(), and ns3::TypeId::SetParent().