A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Member Functions | Static Public Member Functions | Private Member Functions | Private Attributes | List of all members
ns3::AarfWifiManager Class Reference
Wifi Models

AARF Rate control algorithmThis class implements the AARF rate control algorithm which was initially described in IEEE 802.11 Rate Adaptation: A Practical Approach, by M. Lacage, M.H. Manshaei, and T. Turletti. More...

#include <aarf-wifi-manager.h>

+ Inheritance diagram for ns3::AarfWifiManager:
+ Collaboration diagram for ns3::AarfWifiManager:

Public Member Functions

 AarfWifiManager ()
virtual ~AarfWifiManager ()
- 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::AarfWifiManager.

Private Member Functions

virtual WifiRemoteStation * DoCreateStation (void) const
virtual WifiMode DoGetDataMode (WifiRemoteStation *station, uint32_t size)
virtual WifiMode DoGetRtsMode (WifiRemoteStation *station)
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)
virtual bool IsLowLatency (void) const

Private Attributes

uint32_t m_maxSuccessThreshold
uint32_t m_minSuccessThreshold
uint32_t m_minTimerThreshold
double m_successK
double m_timerK

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

AARF Rate control algorithm

This class implements the AARF rate control algorithm which was initially described in IEEE 802.11 Rate Adaptation: A Practical Approach, by M. Lacage, M.H. Manshaei, and T. Turletti.

Definition at line 36 of file aarf-wifi-manager.h.

Constructor & Destructor Documentation

ns3::AarfWifiManager::AarfWifiManager ( )

Definition at line 85 of file aarf-wifi-manager.cc.

ns3::AarfWifiManager::~AarfWifiManager ( )
virtual

Definition at line 88 of file aarf-wifi-manager.cc.

Member Function Documentation

WifiRemoteStation * ns3::AarfWifiManager::DoCreateStation ( void  ) const
privatevirtual

Definition at line 93 of file aarf-wifi-manager.cc.

References ns3::AarfWifiRemoteStation::m_failed, m_minSuccessThreshold, m_minTimerThreshold, ns3::AarfWifiRemoteStation::m_rate, ns3::AarfWifiRemoteStation::m_recovery, ns3::AarfWifiRemoteStation::m_retry, ns3::AarfWifiRemoteStation::m_success, ns3::AarfWifiRemoteStation::m_successThreshold, ns3::AarfWifiRemoteStation::m_timer, and ns3::AarfWifiRemoteStation::m_timerTimeout.

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

Definition at line 210 of file aarf-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetSupported(), and ns3::AarfWifiRemoteStation::m_rate.

+ Here is the call graph for this function:

WifiMode ns3::AarfWifiManager::DoGetRtsMode ( WifiRemoteStation *  station)
privatevirtual

Definition at line 216 of file aarf-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetSupported().

+ Here is the call graph for this function:

void ns3::AarfWifiManager::DoReportDataFailed ( WifiRemoteStation *  st)
privatevirtual

It is important to realize that "recovery" mode starts after failure of the first transmission after a rate increase and ends at the first successful transmission. Specifically, recovery mode transcends retransmissions boundaries. Fundamentally, ARF handles each data transmission independently, whether it is the initial transmission of a packet or the retransmission of a packet. The fundamental reason for this is that there is a backoff between each data transmission, be it an initial transmission or a retransmission.

Definition at line 123 of file aarf-wifi-manager.cc.

References ns3::AarfWifiRemoteStation::m_failed, m_maxSuccessThreshold, m_minSuccessThreshold, m_minTimerThreshold, ns3::AarfWifiRemoteStation::m_rate, ns3::AarfWifiRemoteStation::m_recovery, ns3::AarfWifiRemoteStation::m_retry, ns3::AarfWifiRemoteStation::m_success, m_successK, ns3::AarfWifiRemoteStation::m_successThreshold, ns3::AarfWifiRemoteStation::m_timer, m_timerK, ns3::AarfWifiRemoteStation::m_timerTimeout, ns3::Max(), ns3::Min(), and NS_ASSERT.

+ Here is the call graph for this function:

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

Definition at line 179 of file aarf-wifi-manager.cc.

References ns3::WifiRemoteStationManager::GetNSupported(), ns3::AarfWifiRemoteStation::m_failed, ns3::AarfWifiRemoteStation::m_rate, ns3::AarfWifiRemoteStation::m_recovery, ns3::AarfWifiRemoteStation::m_retry, ns3::AarfWifiRemoteStation::m_success, ns3::AarfWifiRemoteStation::m_successThreshold, ns3::AarfWifiRemoteStation::m_timer, ns3::AarfWifiRemoteStation::m_timerTimeout, and NS_LOG_DEBUG.

+ Here is the call graph for this function:

void ns3::AarfWifiManager::DoReportFinalDataFailed ( WifiRemoteStation *  station)
privatevirtual

Definition at line 205 of file aarf-wifi-manager.cc.

void ns3::AarfWifiManager::DoReportFinalRtsFailed ( WifiRemoteStation *  station)
privatevirtual

Definition at line 201 of file aarf-wifi-manager.cc.

void ns3::AarfWifiManager::DoReportRtsFailed ( WifiRemoteStation *  station)
privatevirtual

Definition at line 110 of file aarf-wifi-manager.cc.

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

Definition at line 173 of file aarf-wifi-manager.cc.

References NS_LOG_DEBUG.

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

Definition at line 168 of file aarf-wifi-manager.cc.

TypeId ns3::AarfWifiManager::GetTypeId ( void  )
static

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

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

  • /NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/RemoteStationManager/$ns3::AarfWifiManager

Attributes defined for this type:

  • SuccessK: Multiplication factor for the success threshold in the AARF algorithm.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 2
    • Flags: construct write read
  • TimerK: Multiplication factor for the timer threshold in the AARF algorithm.
    • Set with class: ns3::DoubleValue
    • Underlying type: double -1.79769e+308:1.79769e+308
    • Initial value: 2
    • Flags: construct write read
  • MaxSuccessThreshold: Maximum value of the success threshold in the AARF algorithm.
  • MinTimerThreshold: The minimum value for the 'timer' threshold in the AARF algorithm.
  • MinSuccessThreshold: The minimum value for the success threshold in the AARF algorithm.

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.
  • MaxSsrc: The maximum number of retransmission attempts for an RTS. This value will not have any effect on some rate control algorithms.
  • MaxSlrc: The maximum number of retransmission attempts for a DATA packet. This value will not have any effect on some rate control algorithms.
  • 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.
  • 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.
  • 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 52 of file aarf-wifi-manager.cc.

References m_maxSuccessThreshold, m_minSuccessThreshold, m_minTimerThreshold, m_successK, m_timerK, and ns3::TypeId::SetParent().

+ Here is the call graph for this function:

bool ns3::AarfWifiManager::IsLowLatency ( void  ) const
privatevirtual

Definition at line 225 of file aarf-wifi-manager.cc.

Member Data Documentation

uint32_t ns3::AarfWifiManager::m_maxSuccessThreshold
private

Definition at line 62 of file aarf-wifi-manager.h.

Referenced by DoReportDataFailed(), and GetTypeId().

uint32_t ns3::AarfWifiManager::m_minSuccessThreshold
private

Definition at line 60 of file aarf-wifi-manager.h.

Referenced by DoCreateStation(), DoReportDataFailed(), and GetTypeId().

uint32_t ns3::AarfWifiManager::m_minTimerThreshold
private

Definition at line 59 of file aarf-wifi-manager.h.

Referenced by DoCreateStation(), DoReportDataFailed(), and GetTypeId().

double ns3::AarfWifiManager::m_successK
private

Definition at line 61 of file aarf-wifi-manager.h.

Referenced by DoReportDataFailed(), and GetTypeId().

double ns3::AarfWifiManager::m_timerK
private

Definition at line 63 of file aarf-wifi-manager.h.

Referenced by DoReportDataFailed(), and GetTypeId().

The documentation for this class was generated from the following files: