ARF Rate control algorithm. More...
#include <arf-wifi-manager.h>
Inheritance diagram for ns3::ArfWifiManager:
Collaboration diagram for ns3::ArfWifiManager:Public Member Functions | |
| ArfWifiManager () | |
| virtual | ~ArfWifiManager () |
Public Member Functions inherited from ns3::WifiRemoteStationManager | |
| WifiRemoteStationManager () | |
| virtual | ~WifiRemoteStationManager () |
| void | AddAllSupportedModes (Mac48Address address) |
| Invoked in a STA or AP to store all of the modes supported by a destination which is also supported locally. More... | |
| void | AddBasicMcs (uint8_t mcs) |
| Add a given Modulation and Coding Scheme (MCS) index to the set of basic MCS. More... | |
| void | AddBasicMode (WifiMode mode) |
| Invoked in a STA upon association to store the set of rates which belong to the BSSBasicRateSet of the associated AP and which are supported locally. More... | |
| void | AddStationHtCapabilities (Mac48Address from, HtCapabilities htcapabilities) |
| Records HT capabilities of the remote station. More... | |
| void | AddSupportedMcs (Mac48Address address, uint8_t mcs) |
| Record the MCS index supported by the station. More... | |
| void | AddSupportedMode (Mac48Address address, WifiMode mode) |
| Invoked in a STA or AP to store the set of modes supported by a destination which is also supported locally. More... | |
| WifiTxVector | DoGetCtsToSelfTxVector (void) |
| Since CTS-to-self parameters are not dependent on the station, it is implemented in wifiremote station manager. More... | |
| WifiTxVector | GetAckTxVector (Mac48Address address, WifiMode dataMode) |
| uint8_t | GetBasicMcs (uint32_t i) const |
| Return the MCS at the given list index. More... | |
| WifiMode | GetBasicMode (uint32_t i) const |
| Return a basic mode from the set of basic modes. More... | |
| 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 |
| Return the default Modulation and Coding Scheme (MCS) index. More... | |
| WifiMode | GetDefaultMode (void) const |
| Return the default transmission mode. More... | |
| uint8_t | GetDefaultTxPowerLevel (void) const |
| uint32_t | GetFragmentationThreshold (void) const |
| Return the fragmentation threshold. More... | |
| 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 |
| Return whether the station supports Greenfield or not. More... | |
| WifiRemoteStationInfo | GetInfo (Mac48Address address) |
| uint32_t | GetMaxSlrc (void) const |
| Return the maximum STA long retry count (SLRC). More... | |
| uint32_t | GetMaxSsrc (void) const |
| Return the maximum STA short retry count (SSRC). More... | |
| uint32_t | GetNBasicMcs (void) const |
| Return the number of basic MCS index. More... | |
| uint32_t | GetNBasicModes (void) const |
| Return the number of basic modes we support. More... | |
| WifiMode | GetNonUnicastMode (void) const |
| Return a mode for non-unicast packets. More... | |
| uint32_t | GetNumberOfTransmitAntennas (void) |
| uint32_t | GetRtsCtsThreshold (void) const |
| Return the RTS threshold. More... | |
| WifiTxVector | GetRtsTxVector (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet) |
| bool | HasHtSupported (void) const |
| Return whether the device has HT capability support enabled. More... | |
| bool | IsAssociated (Mac48Address address) const |
| Return whether the station associated. More... | |
| bool | IsBrandNew (Mac48Address address) const |
| Return whether the station state is brand new. More... | |
| bool | IsLastFragment (Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber) |
| bool | IsWaitAssocTxOk (Mac48Address address) const |
| Return whether we are waiting for an ACK for the association response we sent. More... | |
| bool | NeedCtsToSelf (WifiTxVector txVector) |
| Return if we need to do Cts-to-self before sending a DATA. More... | |
| 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) |
| Records that the STA was disassociated. More... | |
| void | RecordGotAssocTxFailed (Mac48Address address) |
| Records that we missed an ACK for the association response we sent. More... | |
| void | RecordGotAssocTxOk (Mac48Address address) |
| Records that we got an ACK for the association response we sent. More... | |
| void | RecordWaitAssocTxOk (Mac48Address address) |
| Records that we are waiting for an ACK for the association response we sent. More... | |
| void | ReportDataFailed (Mac48Address address, const WifiMacHeader *header) |
| Should be invoked whenever the AckTimeout associated to a transmission attempt expires. More... | |
| void | ReportDataOk (Mac48Address address, const WifiMacHeader *header, double ackSnr, WifiMode ackMode, double dataSnr) |
| Should be invoked whenever we receive the Ack associated to a data packet we just sent. More... | |
| void | ReportFinalDataFailed (Mac48Address address, const WifiMacHeader *header) |
| Should be invoked after calling ReportDataFailed if NeedDataRetransmission returns false. More... | |
| void | ReportFinalRtsFailed (Mac48Address address, const WifiMacHeader *header) |
| Should be invoked after calling ReportRtsFailed if NeedRtsRetransmission returns false. More... | |
| void | ReportRtsFailed (Mac48Address address, const WifiMacHeader *header) |
| Should be invoked whenever the RtsTimeout associated to a transmission attempt expires. More... | |
| void | ReportRtsOk (Mac48Address address, const WifiMacHeader *header, double ctsSnr, WifiMode ctsMode, double rtsSnr) |
| Should be invoked whenever we receive the Cts associated to an RTS we just sent. More... | |
| void | ReportRxOk (Mac48Address address, const WifiMacHeader *header, double rxSnr, WifiMode txMode) |
| void | Reset (void) |
| Reset the station, invoked in a STA upon dis-association or in an AP upon reboot. More... | |
| void | Reset (Mac48Address address) |
| Invoked in an AP upon disassociation of a specific STA. More... | |
| void | SetDefaultTxPowerLevel (uint8_t txPower) |
| Set the default transmission power level. More... | |
| void | SetFragmentationThreshold (uint32_t threshold) |
| Sets a fragmentation threshold. More... | |
| void | SetHtSupported (bool enable) |
| Enable or disable HT capability support. More... | |
| void | SetMaxSlrc (uint32_t maxSlrc) |
| Sets the maximum STA long retry count (SLRC). More... | |
| void | SetMaxSsrc (uint32_t maxSsrc) |
| Sets the maximum STA short retry count (SSRC). More... | |
| void | SetRtsCtsThreshold (uint32_t threshold) |
| Sets the RTS threshold. More... | |
| virtual void | SetupMac (Ptr< WifiMac > mac) |
| Set up MAC associated with this device since it is the object that knows the full set of timing parameters (e.g. More... | |
| virtual void | SetupPhy (Ptr< WifiPhy > phy) |
| Set up PHY associated with this device since it is the object that knows the full set of transmit rates that are supported. More... | |
Public Member Functions inherited from ns3::Object | |
| Object () | |
| Constructor. More... | |
| virtual | ~Object () |
| Destructor. More... | |
| void | AggregateObject (Ptr< Object > other) |
| Aggregate two Objects together. More... | |
| void | Dispose (void) |
| Dispose of this Object. More... | |
| AggregateIterator | GetAggregateIterator (void) const |
| Get an iterator to the Objects aggregated to this one. More... | |
| virtual TypeId | GetInstanceTypeId (void) const |
| Implement the GetInstanceTypeId method defined in ObjectBase. More... | |
| template<typename T > | |
| Ptr< T > | GetObject (void) const |
| Get a pointer to the requested aggregated Object. More... | |
| template<typename T > | |
| Ptr< T > | GetObject (TypeId tid) const |
| Get a pointer to the requested aggregated Object. More... | |
| void | Initialize (void) |
| Invoke DoInitialize on all Objects aggregated to this one. More... | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
| SimpleRefCount () | |
| 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. More... | |
| void | Ref (void) const |
| Increment the reference count. More... | |
| void | Unref (void) const |
| Decrement the reference count. More... | |
Public Member Functions inherited from ns3::ObjectBase | |
| virtual | ~ObjectBase () |
| Virtual destructor. More... | |
| void | GetAttribute (std::string name, AttributeValue &value) const |
| Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
| bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
| Get the value of an attribute without raising erros. More... | |
| void | SetAttribute (std::string name, const AttributeValue &value) |
| Set a single attribute, raising fatal errors if unsuccessful. More... | |
| bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
| Set a single attribute without raising errors. More... | |
| bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
| Connect a TraceSource to a Callback with a context. More... | |
| bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
| Connect a TraceSource to a Callback without a context. More... | |
| bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
| Disconnect from a TraceSource a Callback previously connected with a context. More... | |
| bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
| Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
| static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::WifiRemoteStationManager | |
| static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::Object | |
| static TypeId | GetTypeId (void) |
| Register this type. More... | |
Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
| static void | Cleanup (void) |
| Noop. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
| static TypeId | GetTypeId (void) |
| Get the type ID. More... | |
Private Member Functions | |
| virtual WifiRemoteStation * | DoCreateStation (void) const |
| virtual WifiTxVector | DoGetDataTxVector (WifiRemoteStation *station, uint32_t size) |
| virtual WifiTxVector | DoGetRtsTxVector (WifiRemoteStation *station) |
| virtual void | DoReportDataFailed (WifiRemoteStation *station) |
| 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. More... | |
| virtual void | DoReportDataOk (WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr) |
| This method is a pure virtual method that must be implemented by the sub-class. More... | |
| virtual void | DoReportFinalDataFailed (WifiRemoteStation *station) |
| This method is a pure virtual method that must be implemented by the sub-class. More... | |
| virtual void | DoReportFinalRtsFailed (WifiRemoteStation *station) |
| This method is a pure virtual method that must be implemented by the sub-class. More... | |
| virtual void | DoReportRtsFailed (WifiRemoteStation *station) |
| This method is a pure virtual method that must be implemented by the sub-class. More... | |
| virtual void | DoReportRtsOk (WifiRemoteStation *station, double ctsSnr, WifiMode ctsMode, double rtsSnr) |
| This method is a pure virtual method that must be implemented by the sub-class. More... | |
| virtual void | DoReportRxOk (WifiRemoteStation *station, double rxSnr, WifiMode txMode) |
| This method is a pure virtual method that must be implemented by the sub-class. More... | |
| virtual bool | IsLowLatency (void) const |
Private Attributes | |
| uint32_t | m_successThreshold |
| uint32_t | m_timerThreshold |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::WifiRemoteStationManager | |
| virtual void | DoDispose (void) |
| Destructor implementation. More... | |
| bool | GetGreenfield (const WifiRemoteStation *station) const |
| Return whether the station supports Greenfield or not. More... | |
| uint32_t | GetLongRetryCount (const WifiRemoteStation *station) const |
| Return the long retry limit of the given station. More... | |
| Ptr< WifiMac > | GetMac (void) const |
| Return the WifiMac. More... | |
| uint8_t | GetMcsSupported (const WifiRemoteStation *station, uint32_t i) const |
| Return the MCS index supported by the specified station at the specified index. More... | |
| uint32_t | GetNess (const WifiRemoteStation *station) const |
| uint32_t | GetNMcsSupported (const WifiRemoteStation *station) const |
| Return the number of MCS supported by the given station. More... | |
| uint32_t | GetNSupported (const WifiRemoteStation *station) const |
| Return the number of modes supported by the given station. More... | |
| uint32_t | GetNumberOfReceiveAntennas (const WifiRemoteStation *station) const |
| Return the number of receive antenna the station has. More... | |
| uint32_t | GetNumberOfTransmitAntennas (const WifiRemoteStation *station) const |
| Return the number of transmit antenna the station has. More... | |
| Ptr< WifiPhy > | GetPhy (void) const |
| Return the WifiPhy. More... | |
| bool | GetShortGuardInterval (const WifiRemoteStation *station) const |
| Return whether the given station supports short guard interval. More... | |
| uint32_t | GetShortRetryCount (const WifiRemoteStation *station) const |
| Return the short retry limit of the given station. More... | |
| bool | GetStbc (const WifiRemoteStation *station) const |
| Return whether the given station supports space-time block coding (STBC). More... | |
| WifiMode | GetSupported (const WifiRemoteStation *station, uint32_t i) const |
| Return whether mode associated with the specified station at the specified index. More... | |
Protected Member Functions inherited from ns3::Object | |
| Object (const Object &o) | |
| Copy an Object. More... | |
| virtual void | DoInitialize (void) |
| Initialize() implementation. More... | |
| virtual void | NotifyNewAggregate (void) |
| Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
Protected Member Functions inherited from ns3::ObjectBase | |
| void | ConstructSelf (const AttributeConstructionList &attributes) |
| Complete construction of ObjectBase; invoked by derived classes. More... | |
| virtual void | NotifyConstructionCompleted (void) |
| Notifier called once the ObjectBase is fully constructed. More... | |
Related Functions inherited from ns3::ObjectBase | |
| static TypeId | GetObjectIid (void) |
| Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
ARF Rate control algorithm.
This class implements the so-called ARF algorithm which was initially described in WaveLAN-II: A High-performance wireless LAN for the unlicensed band, by A. Kamerman and L. Monteban. in Bell Lab Technical Journal, pages 118-133, Summer 1997.
This implementation differs from the initial description in that it uses a packet-based timer rather than a time-based timer as described in XXX (I cannot find back the original paper which described how the time-based timer could be easily replaced with a packet-based timer.)
ns3::ArfWifiManager is accessible through the following paths with Config::Set and Config::Connect:
No TraceSources are defined for this type.
Size of this type is 256 bytes (on a 64-bit architecture).
Definition at line 42 of file arf-wifi-manager.h.
| ns3::ArfWifiManager::ArfWifiManager | ( | ) |
Definition at line 74 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
virtual |
Definition at line 78 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
privatevirtual |
Implements ns3::WifiRemoteStationManager.
Definition at line 83 of file arf-wifi-manager.cc.
References ns3::ArfWifiRemoteStation::m_failed, ns3::ArfWifiRemoteStation::m_rate, ns3::ArfWifiRemoteStation::m_recovery, ns3::ArfWifiRemoteStation::m_retry, ns3::ArfWifiRemoteStation::m_success, ns3::ArfWifiRemoteStation::m_successThreshold, m_successThreshold, ns3::ArfWifiRemoteStation::m_timer, m_timerThreshold, ns3::ArfWifiRemoteStation::m_timerTimeout, and NS_LOG_FUNCTION.
|
privatevirtual |
| station | the station that we need to communicate |
| size | size of the packet or fragment we want to send |
Note: This method is called before sending a unicast packet or a fragment of a unicast packet to decide which transmission mode to use.
Implements ns3::WifiRemoteStationManager.
Definition at line 202 of file arf-wifi-manager.cc.
References ns3::WifiRemoteStationManager::GetDefaultTxPowerLevel(), ns3::WifiRemoteStationManager::GetLongRetryCount(), ns3::WifiRemoteStationManager::GetNess(), ns3::WifiRemoteStationManager::GetNumberOfReceiveAntennas(), ns3::WifiRemoteStationManager::GetNumberOfTransmitAntennas(), ns3::WifiRemoteStationManager::GetShortGuardInterval(), ns3::WifiRemoteStationManager::GetStbc(), ns3::WifiRemoteStationManager::GetSupported(), ns3::ArfWifiRemoteStation::m_rate, ns3::Min(), and NS_LOG_FUNCTION.
Here is the call graph for this function:
|
privatevirtual |
| station | the station that we need to communicate |
Note: This method is called before sending an rts to a station to decide which transmission mode to use for the rts.
Implements ns3::WifiRemoteStationManager.
Definition at line 209 of file arf-wifi-manager.cc.
References ns3::WifiRemoteStationManager::GetDefaultTxPowerLevel(), ns3::WifiRemoteStationManager::GetLongRetryCount(), ns3::WifiRemoteStationManager::GetNess(), ns3::WifiRemoteStationManager::GetNumberOfReceiveAntennas(), ns3::WifiRemoteStationManager::GetNumberOfTransmitAntennas(), ns3::WifiRemoteStationManager::GetShortGuardInterval(), ns3::WifiRemoteStationManager::GetStbc(), ns3::WifiRemoteStationManager::GetSupported(), ns3::Min(), and NS_LOG_FUNCTION.
Here is the call graph for this function:
|
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.
| st | the station that we failed to send DATA |
Implements ns3::WifiRemoteStationManager.
Definition at line 117 of file arf-wifi-manager.cc.
References ns3::ArfWifiRemoteStation::m_failed, ns3::ArfWifiRemoteStation::m_rate, ns3::ArfWifiRemoteStation::m_recovery, ns3::ArfWifiRemoteStation::m_retry, ns3::ArfWifiRemoteStation::m_success, ns3::ArfWifiRemoteStation::m_timer, NS_ASSERT, and NS_LOG_FUNCTION.
|
privatevirtual |
This method is a pure virtual method that must be implemented by the sub-class.
This allows different types of WifiRemoteStationManager to respond differently,
| station | the station that we successfully sent RTS |
| ackSnr | the SNR of the ACK we received |
| ackMode | the WifiMode the receiver used to send the ACK |
| dataSnr | the SNR of the DATA we sent |
Implements ns3::WifiRemoteStationManager.
Definition at line 168 of file arf-wifi-manager.cc.
References ns3::ArfWifiRemoteStation::m_failed, ns3::WifiRemoteStationState::m_operationalRateSet, ns3::ArfWifiRemoteStation::m_rate, ns3::ArfWifiRemoteStation::m_recovery, ns3::ArfWifiRemoteStation::m_retry, ns3::WifiRemoteStation::m_state, ns3::ArfWifiRemoteStation::m_success, m_successThreshold, ns3::ArfWifiRemoteStation::m_timer, m_timerThreshold, NS_LOG_DEBUG, and NS_LOG_FUNCTION.
|
privatevirtual |
This method is a pure virtual method that must be implemented by the sub-class.
This allows different types of WifiRemoteStationManager to respond differently,
| station | the station that we failed to send DATA |
Implements ns3::WifiRemoteStationManager.
Definition at line 196 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
privatevirtual |
This method is a pure virtual method that must be implemented by the sub-class.
This allows different types of WifiRemoteStationManager to respond differently,
| station | the station that we failed to send RTS |
Implements ns3::WifiRemoteStationManager.
Definition at line 191 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
privatevirtual |
This method is a pure virtual method that must be implemented by the sub-class.
This allows different types of WifiRemoteStationManager to respond differently,
| station | the station that we failed to send RTS |
Implements ns3::WifiRemoteStationManager.
Definition at line 101 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
privatevirtual |
This method is a pure virtual method that must be implemented by the sub-class.
This allows different types of WifiRemoteStationManager to respond differently,
| station | the station that we successfully sent RTS |
| ctsSnr | the SNR of the CTS we received |
| ctsMode | the WifiMode the receiver used to send the CTS |
| rtsSnr | the SNR of the RTS we sent |
Implements ns3::WifiRemoteStationManager.
Definition at line 162 of file arf-wifi-manager.cc.
References NS_LOG_DEBUG, and NS_LOG_FUNCTION.
|
privatevirtual |
This method is a pure virtual method that must be implemented by the sub-class.
This allows different types of WifiRemoteStationManager to respond differently,
| station | the station that sent the DATA to us |
| rxSnr | the SNR of the DATA we received |
| txMode | the WifiMode the sender used to send the DATA |
Implements ns3::WifiRemoteStationManager.
Definition at line 157 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
static |
Definition at line 55 of file arf-wifi-manager.cc.
References m_successThreshold, m_timerThreshold, ns3::MakeUintegerAccessor(), and ns3::TypeId::SetParent().
Here is the call graph for this function:
|
privatevirtual |
Note: In this context, low vs high latency is defined in IEEE 802.11 Rate Adaptation: A Practical Approach, by M. Lacage, M.H. Manshaei, and T. Turletti.
Implements ns3::WifiRemoteStationManager.
Definition at line 219 of file arf-wifi-manager.cc.
References NS_LOG_FUNCTION.
|
private |
Definition at line 67 of file arf-wifi-manager.h.
Referenced by DoCreateStation(), DoReportDataOk(), and GetTypeId().
|
private |
Definition at line 66 of file arf-wifi-manager.h.
Referenced by DoCreateStation(), DoReportDataOk(), and GetTypeId().