22 #include "ns3/simulator.h" 26 #define Min(a,b) ((a < b) ? a : b) 59 .SetGroupName (
"Wifi")
61 .AddAttribute (
"UpdatePeriod",
62 "The interval between decisions about rate control changes",
66 .AddAttribute (
"FailureRatio",
67 "Ratio of minimum erroneous transmissions needed to switch to a lower rate",
70 MakeDoubleChecker<double> (0.0, 1.0))
71 .AddAttribute (
"SuccessRatio",
72 "Ratio of maximum erroneous transmissions needed to switch to a higher rate",
75 MakeDoubleChecker<double> (0.0, 1.0))
76 .AddAttribute (
"MaxSuccessThreshold",
77 "Maximum number of consecutive success periods needed to switch to a higher rate",
80 MakeUintegerChecker<uint32_t> ())
81 .AddAttribute (
"MinSuccessThreshold",
82 "Minimum number of consecutive success periods needed to switch to a higher rate",
85 MakeUintegerChecker<uint32_t> ())
86 .AddTraceSource (
"Rate",
87 "Traced value for rate changes (b/s)",
89 "ns3::TracedValueCallback::Uint64")
112 NS_FATAL_ERROR (
"WifiRemoteStationManager selected does not support HT rates");
116 NS_FATAL_ERROR (
"WifiRemoteStationManager selected does not support VHT rates");
120 NS_FATAL_ERROR (
"WifiRemoteStationManager selected does not support HE rates");
165 double ctsSnr,
WifiMode ctsMode,
double rtsSnr)
172 double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
174 NS_LOG_FUNCTION (
this << st << ackSnr << ackMode << dataSnr << dataChannelWidth << +dataNss);
266 bool needChange =
false;
314 if (
IsEnough (station) || needChange)
367 if (channelWidth > 20 && channelWidth != 22)
377 return WifiTxVector (mode,
GetDefaultTxPowerLevel (),
GetPreambleForTransmission (mode.
GetModulationClass (),
GetShortPreambleEnabled (),
UseGreenfieldForDestination (
GetAddress (station))), 800, 1, 1, 0, channelWidth,
GetAggregation (station));
386 if (channelWidth > 20 && channelWidth != 22)
401 rtsTxVector =
WifiTxVector (mode,
GetDefaultTxPowerLevel (),
GetPreambleForTransmission (mode.
GetModulationClass (),
GetShortPreambleEnabled (),
UseGreenfieldForDestination (
GetAddress (station))), 800, 1, 1, 0, channelWidth,
GetAggregation (station));
uint32_t m_minSuccessThreshold
minimum success threshold
Simulation virtual time values and global simulation resolution.
bool GetVhtSupported(void) const
Return whether the device has VHT capability support enabled.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
AMRR Rate control algorithmThis class implements the AMRR rate control algorithm which was initially ...
uint8_t GetNSupported(const WifiRemoteStation *station) const
Return the number of modes supported by the given station.
uint32_t m_successThreshold
success threshold
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
Time m_nextModeUpdate
next mode update time
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
void DoReportFinalRtsFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
void ResetCnt(AmrrWifiRemoteStation *station)
Reset transmission statistics of the given station.
hold per-remote-station state for AMRR Wifi manager.
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station)
bool GetHeSupported(void) const
Return whether the device has HE capability support enabled.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
void DoInitialize(void)
Initialize() implementation.
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
bool IsMinRate(AmrrWifiRemoteStation *station) const
Check if the current rate for the given station is the minimum rate.
uint32_t m_tx_err
transmit error
WifiPreamble GetPreambleForTransmission(WifiModulationClass modulation, bool useShortPreamble, bool useGreenfield)
Return the preamble to be used for the transmission.
Time m_updatePeriod
update period
WifiMode GetSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether mode associated with the specified station at the specified index. ...
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
void DoReportRtsFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station)
bool GetShortPreambleEnabled(void) const
Return whether the device uses short PHY preambles.
TracedValue< uint64_t > m_currentRate
Trace rate changes.
AttributeValue implementation for Time.
Hold an unsigned integer type.
uint8_t m_txrate
transmit rate
bool GetHtSupported(void) const
Return whether the device has HT capability support enabled.
void DoReportDataFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
void DecreaseRate(AmrrWifiRemoteStation *station)
Decrease the transmission rate to the given station.
hold a list of per-remote-station state.
WifiModulationClass GetModulationClass() const
uint32_t m_tx_ok
transmit OK
virtual ~AmrrWifiManager()
void IncreaseRate(AmrrWifiRemoteStation *station)
Increase the transmission rate to the given station.
WifiRemoteStation * DoCreateStation(void) const
bool IsEnough(AmrrWifiRemoteStation *station) const
Check if the number of retransmission, transmission error, and successful transmission are greater th...
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.
void DoReportDataOk(WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
This method is a pure virtual method that must be implemented by the sub-class.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint32_t m_success
success
bool UseGreenfieldForDestination(Mac48Address dest) const
double m_successRatio
success ratio
void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode)
This method is a pure virtual method that must be implemented by the sub-class.
Mac48Address GetAddress(const WifiRemoteStation *station) const
Return the address of the station.
WifiMode GetNonErpSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether non-ERP mode associated with the specified station at the specified index...
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
static TypeId GetTypeId(void)
Get the type ID.
static Time Now(void)
Return the current simulation virtual time.
bool GetAggregation(const WifiRemoteStation *station) const
Return whether the given station supports A-MPDU.
uint32_t m_tx_retr
transmit retry
bool IsMaxRate(AmrrWifiRemoteStation *station) const
Check if the current rate for the given station is the maximum rate.
Ptr< const AttributeAccessor > MakeDoubleAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
bool IsSuccess(AmrrWifiRemoteStation *station) const
Check if the number of retransmission and transmission error is less than the number of successful tr...
double m_failureRatio
failure ratio
bool GetUseNonErpProtection(void) const
Return whether the device supports protection of non-ERP stations.
uint32_t m_maxSuccessThreshold
maximum success threshold
void DoReportFinalDataFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Time Seconds(double value)
Construct a Time in the indicated unit.
void UpdateMode(AmrrWifiRemoteStation *station)
Update the mode used to send to the given station.
uint8_t GetDefaultTxPowerLevel(void) const
bool IsFailure(AmrrWifiRemoteStation *station) const
Check if the number of retransmission and transmission error is greater than the number of successful...
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
This class can be used to hold variables of floating point type such as 'double' or 'float'...
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
hold per-remote-station state.
uint64_t GetDataRate(uint16_t channelWidth, uint16_t guardInterval, uint8_t nss) const
uint16_t GetChannelWidth(const WifiRemoteStation *station) const
Return the channel width supported by the station.