A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::AarfWifiManager Class Reference

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 AddBasicMcs (uint8_t mcs)
void AddBasicMode (WifiMode mode)
void AddStationHtCapabilities (Mac48Address from, HtCapabilities htcapabilities)
void AddSupportedMcs (Mac48Address address, uint8_t mcs)
void AddSupportedMode (Mac48Address address, WifiMode mode)
WifiTxVector DoGetCtsToSelfTxVector (void)
WifiTxVector GetAckTxVector (Mac48Address address, WifiMode dataMode)
uint8_t GetBasicMcs (uint32_t i) const
WifiMode GetBasicMode (uint32_t i) const
WifiTxVector GetBlockAckTxVector (Mac48Address address, WifiMode dataMode)
WifiTxVector GetCtsToSelfTxVector (const WifiMacHeader *header, Ptr< const Packet > packet)
WifiTxVector GetCtsTxVector (Mac48Address address, WifiMode rtsMode)
WifiTxVector GetDataTxVector (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fullPacketSize)
uint8_t GetDefaultMcs (void) const
WifiMode GetDefaultMode (void) const
uint8_t GetDefaultTxPowerLevel (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)
bool GetGreenfieldSupported (Mac48Address address) const
WifiRemoteStationInfo GetInfo (Mac48Address address)
uint32_t GetMaxSlrc (void) const
uint32_t GetMaxSsrc (void) const
uint32_t GetNBasicMcs (void) const
uint32_t GetNBasicModes (void) const
WifiMode GetNonUnicastMode (void) const
uint32_t GetNumberOfTransmitAntennas (void)
uint32_t GetRtsCtsThreshold (void) const
WifiTxVector GetRtsTxVector (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
bool HasHtSupported (void) const
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 NeedCtsToSelf (WifiTxVector txVector)
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 SetDefaultTxPowerLevel (uint8_t txPower)
void SetFragmentationThreshold (uint32_t threshold)
void SetHtSupported (bool enable)
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 Initialize (void)
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 SimpleRefCount (const SimpleRefCount &o)
uint32_t GetReferenceCount (void) const
SimpleRefCountoperator= (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)

Private Member Functions

virtual WifiRemoteStationDoCreateStation (void) const
virtual WifiTxVector DoGetDataTxVector (WifiRemoteStation *station, uint32_t size)
virtual WifiTxVector DoGetRtsTxVector (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)
bool GetGreenfield (const WifiRemoteStation *station) const
uint32_t GetLongRetryCount (const WifiRemoteStation *station) const
uint8_t GetMcsSupported (const WifiRemoteStation *station, uint32_t i) const
uint32_t GetNMcsSupported (const WifiRemoteStation *station) const
uint32_t GetNSupported (const WifiRemoteStation *station) const
uint32_t GetNumberOfReceiveAntennas (const WifiRemoteStation *station) const
uint32_t GetNumberOfTransmitAntennas (const WifiRemoteStation *station) const
bool GetShortGuardInterval (const WifiRemoteStation *station) const
uint32_t GetShortRetryCount (const WifiRemoteStation *station) const
bool GetStbc (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.

Config Paths

ns3::AarfWifiManager is accessible through the following paths with Config::Set and Config::Connect:

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

Attributes

  • 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
  • DefaultTxPowerLevel: Default power level to be used for transmissions. This is the power level that is used by all those WifiManagers that do notimplement TX power control.

No TraceSources are 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

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.

References NS_LOG_FUNCTION.

ns3::AarfWifiManager::~AarfWifiManager ( )
virtual

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

References NS_LOG_FUNCTION.

Member Function Documentation

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 127 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(), NS_ASSERT, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

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

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

References NS_LOG_FUNCTION.

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

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

References NS_LOG_FUNCTION.

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

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

References NS_LOG_FUNCTION.

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

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

References NS_LOG_DEBUG, and NS_LOG_FUNCTION.

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

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

References NS_LOG_FUNCTION.

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

Get the type ID.

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 237 of file aarf-wifi-manager.cc.

References NS_LOG_FUNCTION.

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: