21 #include "ns3/packet.h" 23 #include "ns3/boolean.h" 24 #include "ns3/double.h" 25 #include "ns3/uinteger.h" 26 #include "ns3/simulator.h" 27 #include "ns3/data-rate.h" 68 .SetGroupName (
"Wifi")
70 .AddAttribute (
"Basic",
71 "If true the RRPAA-BASIC algorithm will be used, otherwise the RRPAA will be used.",
75 .AddAttribute (
"Timeout",
76 "Timeout for the RRPAA-BASIC loss estimation block.",
80 .AddAttribute (
"FrameLength",
81 "The Data frame length (in bytes) used for calculating mode TxTime.",
84 MakeUintegerChecker <uint32_t> ())
85 .AddAttribute (
"AckFrameLength",
86 "The Ack frame length (in bytes) used for calculating mode TxTime.",
89 MakeUintegerChecker <uint32_t> ())
90 .AddAttribute (
"Alpha",
91 "Constant for calculating the MTL threshold.",
94 MakeDoubleChecker<double> (1))
95 .AddAttribute (
"Beta",
96 "Constant for calculating the ORI threshold.",
99 MakeDoubleChecker<double> (1))
100 .AddAttribute (
"Tau",
101 "Constant for calculating the EWND size.",
104 MakeDoubleChecker<double> (0))
105 .AddAttribute (
"Gamma",
106 "Constant for Probabilistic Decision Table decrements.",
109 MakeDoubleChecker<double> (1))
110 .AddAttribute (
"Delta",
111 "Constant for Probabilistic Decision Table increments.",
114 MakeDoubleChecker<double> (1))
115 .AddTraceSource (
"RateChange",
116 "The transmission rate has change.",
118 "ns3::WifiRemoteStationManager::RateChangeTracedCallback")
119 .AddTraceSource (
"PowerChange",
120 "The transmission power has change.",
122 "ns3::WifiRemoteStationManager::PowerChangeTracedCallback")
156 uint8_t nModes =
phy->GetNModes ();
157 for (uint8_t i = 0; i < nModes; i++)
166 NS_LOG_DEBUG (
"Calculating TX times: Mode= " << mode <<
" DataTxTime= " << dataTxTime <<
" AckTxTime= " << ackTxTime);
185 NS_FATAL_ERROR (
"WifiRemoteStationManager selected does not support HT rates");
189 NS_FATAL_ERROR (
"WifiRemoteStationManager selected does not support VHT rates");
193 NS_FATAL_ERROR (
"WifiRemoteStationManager selected does not support HE rates");
203 if (mode == i->second)
224 for (RrpaaThresholdsTable::const_iterator i = station->
m_thresholds.begin (); i != station->
m_thresholds.end (); i++)
226 if (mode == i->second)
231 NS_ABORT_MSG (
"No thresholds for mode " << mode <<
" found");
272 for (uint8_t i = 0; i < station->
m_nRate; i++)
292 double nextCritical = 0;
296 for (uint8_t i = 0; i < station->
m_nRate; i++)
309 nextMtl =
m_alpha * nextCritical;
320 station->
m_thresholds.push_back (std::make_pair (th, mode));
363 double ctsSnr,
WifiMode ctsMode,
double rtsSnr)
370 double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
372 NS_LOG_FUNCTION (
this << st << ackSnr << ackMode << dataSnr << dataChannelWidth << +dataNss);
397 if (channelWidth > 20 && channelWidth != 22)
417 return WifiTxVector (mode, station->
m_powerLevel,
GetPreambleForTransmission (mode.
GetModulationClass (),
GetShortPreambleEnabled (),
UseGreenfieldForDestination (
GetAddress (station))), 800, 1, 1, 0, channelWidth,
GetAggregation (station));
425 if (channelWidth > 20 && channelWidth != 22)
439 rtsTxVector =
WifiTxVector (mode,
GetDefaultTxPowerLevel (),
GetPreambleForTransmission (mode.
GetModulationClass (),
GetShortPreambleEnabled (),
UseGreenfieldForDestination (
GetAddress (station))), 800, 1, 1, 0, channelWidth,
GetAggregation (station));
445 uint32_t size,
bool normally)
474 double bploss = (
static_cast<double> (station->
m_nFailed) / thresholds.
m_ewnd);
478 if (bploss >= thresholds.
m_mtl)
482 NS_LOG_DEBUG (
"bploss >= MTL and power < maxPower => Increase Power");
490 NS_LOG_DEBUG (
"bploss >= MTL and power = maxPower => Decrease Rate");
498 NS_LOG_DEBUG (
"bploss >= MTL but already at maxPower and minRate");
501 else if (wploss <= thresholds.
m_ori)
505 NS_LOG_DEBUG (
"wploss <= ORI and rate < maxRate => Probabilistic Rate Increase");
508 for (uint8_t i = 0; i <= station->
m_rateIndex; i++)
526 NS_LOG_DEBUG (
"wploss <= ORI and rate = maxRate => Probabilistic Power Decrease");
547 else if (bploss > thresholds.
m_ori && wploss < thresholds.
m_mtl)
551 NS_LOG_DEBUG (
"loss between ORI and MTL and power > minPowerLevel => Probabilistic Power Decrease");
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.
Hold per-remote-station state for RRPAA Wifi manager.
Simulation virtual time values and global simulation resolution.
bool GetVhtSupported(void) const
Return whether the device has VHT capability support enabled.
uint8_t m_nPowerLevels
Number of power levels.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
void SetStream(int64_t stream)
Specifies the stream number for the RngStream.
uint8_t GetNSupported(const WifiRemoteStation *station) const
Return the number of modes supported by the given station.
AttributeValue implementation for Boolean.
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
Time m_lastReset
Time of the last reset.
void CheckInit(RrpaaWifiRemoteStation *station)
Check for initializations.
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
double m_ori
The Opportunistic Rate Increase threshold.
uint32_t m_rtsCounter
Counter for RTS transmission attempts.
uint8_t m_prevRateIndex
Rate index of the previous transmission.
virtual void SetupMac(const Ptr< WifiMac > mac)
Set up MAC associated with this device since it is the object that knows the full set of timing param...
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Time m_sifs
Value of SIFS configured in the device.
double GetSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
uint8_t m_minPowerLevel
Differently form rate, power levels do not depend on the remote 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...
WifiRrpaaThresholds GetThresholds(RrpaaWifiRemoteStation *station, WifiMode mode) const
Get the thresholds for the given station and mode.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
void AddCalcTxTime(WifiMode mode, Time t)
Add transmission time for the given mode to an internal list.
Mac48Address m_address
Mac48Address of the remote station.
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
bool m_basic
If using the basic algorithm (without RTS/CTS).
virtual void DoReportRtsFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
WifiPreamble GetPreambleForTransmission(WifiModulationClass modulation, bool useShortPreamble, bool useGreenfield)
Return the preamble to be used for the transmission.
WifiMode GetSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether mode associated with the specified station at the specified index. ...
uint32_t m_counter
Counter for transmission attempts.
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
RrpaaThresholdsTable m_thresholds
RRPAA thresholds for this station.
uint8_t m_rateIndex
Current rate index.
WifiRemoteStationState * m_state
Remote station state.
bool m_lastFrameFail
Flag if the last frame sent has failed.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
virtual void DoReportFinalDataFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
Class for representing data rates.
uint32_t m_ewnd
The Estimation Window size.
bool GetShortPreambleEnabled(void) const
Return whether the device uses short PHY preambles.
void ResetCountersBasic(RrpaaWifiRemoteStation *station)
Reset the counters of the given station.
double m_beta
Beta value for RRPAA (value for calculating ORI threshold).
uint8_t m_powerLevel
Current power level.
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model...
Ptr< UniformRandomVariable > m_uniformRandomVariable
Provides uniform random variables for probabilistic changes.
Time m_timeout
Timeout for the RRAA BASIC loss estimation block.
AttributeValue implementation for Time.
double m_tau
Tau value for RRPAA (value for calculating EWND size).
Time m_difs
Value of DIFS configured in the device.
Hold an unsigned integer type.
bool GetHtSupported(void) const
Return whether the device has HT capability support enabled.
static TypeId GetTypeId(void)
Register this type.
uint32_t m_adaptiveRtsWnd
Window size for the Adaptive RTS mechanism.
virtual void DoReportFinalRtsFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
double m_mtl
The Maximum Tolerable Loss threshold.
virtual void SetupPhy(const Ptr< WifiPhy > phy)
Set up PHY associated with this device since it is the object that knows the full set of transmit rat...
hold a list of per-remote-station state.
WifiModulationClass GetModulationClass() const
double m_delta
Delta value for RRPAA (value for pdTable increments).
double GetPowerDbm(uint8_t power) const
Get the power of the given power level in dBm.
uint32_t m_nFailed
Number of failed transmission attempts.
TracedCallback< double, double, Mac48Address > m_powerChange
The trace source fired when the transmission power change.
TracedCallback< DataRate, DataRate, Mac48Address > m_rateChange
The trace source fired when the transmission rate change.
RrpaaProbabilitiesTable m_pdTable
Probability table for power and rate changes.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void SetPreambleType(WifiPreamble preamble)
Sets the preamble type.
uint8_t m_prevPowerLevel
Power level of the previous transmission.
bool m_adaptiveRtsOn
Check if Adaptive RTS mechanism is on.
Time GetCalcTxTime(WifiMode mode) const
Get the estimated TxTime of a packet with a given mode.
bool UseGreenfieldForDestination(Mac48Address dest) const
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 Time Now(void)
Return the current simulation virtual time.
bool GetAggregation(const WifiRemoteStation *station) const
Return whether the given station supports A-MPDU.
void RunBasicAlgorithm(RrpaaWifiRemoteStation *station)
Find an appropriate rate and power for the given station, using a basic algorithm.
void SetMode(WifiMode mode)
Sets the selected payload transmission mode.
uint32_t m_frameLength
Data frame length used for calculate mode TxTime (in bytes).
Ptr< const AttributeAccessor > MakeDoubleAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
void InitThresholds(RrpaaWifiRemoteStation *station)
Initialize the thresholds internal list for the given station.
uint8_t m_maxPowerLevel
Maximal power level.
virtual void SetupPhy(const Ptr< WifiPhy > phy)
Set up PHY associated with this device since it is the object that knows the full set of transmit rat...
uint32_t m_ackLength
Ack frame length used for calculate mode TxTime (in bytes).
virtual void SetupMac(const Ptr< WifiMac > mac)
Set up MAC associated with this device since it is the object that knows the full set of timing param...
Robust Rate and Power Adaptation Algorithm.
Ptr< WifiPhy > GetPhy(void) const
Return the WifiPhy.
virtual bool DoNeedRts(WifiRemoteStation *st, uint32_t size, bool normally)
virtual WifiRemoteStation * DoCreateStation(void) const
virtual WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station)
bool GetUseNonErpProtection(void) const
Return whether the device supports protection of non-ERP stations.
double m_alpha
Alpha value for RRPAA (value for calculating MTL threshold)
bool m_initialized
For initializing variables.
#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.
Ptr< const AttributeChecker > MakeBooleanChecker(void)
uint8_t GetDefaultTxPowerLevel(void) const
TxTime m_calcTxTime
To hold all the calculated TxTime for all modes.
virtual void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode)
This method is a pure virtual method that must be implemented by the sub-class.
std::vector< std::pair< WifiRrpaaThresholds, WifiMode > > RrpaaThresholdsTable
List of thresholds for each mode.
virtual void DoReportDataFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
virtual WifiTxVector DoGetDataTxVector(WifiRemoteStation *station)
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
uint8_t m_nRate
Number of supported rates.
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...
void RunAdaptiveRtsAlgorithm(RrpaaWifiRemoteStation *station)
Run an enhanced algorithm which activates the use of RTS for the given station if the conditions are ...
a unique identifier for an interface.
virtual 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.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
void(* DataRate)(DataRate oldValue, DataRate newValue)
TracedValue callback signature for DataRate.
virtual ~RrpaaWifiManager()
hold per-remote-station state.
uint64_t GetDataRate(uint16_t channelWidth, uint16_t guardInterval, uint8_t nss) const
void CheckTimeout(RrpaaWifiRemoteStation *station)
Check if the counter should be reset.
double m_gamma
Gamma value for RRPAA (value for pdTable decrements).
void DoInitialize(void)
Initialize() implementation.
uint16_t GetChannelWidth(const WifiRemoteStation *station) const
Return the channel width supported by the station.
std::vector< std::vector< double > > RrpaaProbabilitiesTable
List of probabilities.