11#include "ns3/data-rate.h"
13#include "ns3/uinteger.h"
14#include "ns3/wifi-phy.h"
16#define Min(a, b) ((a < b) ? a : b)
54 TypeId(
"ns3::AparfWifiManager")
58 .AddAttribute(
"SuccessThreshold1",
59 "The minimum number of successful transmissions in \"High\" state to try "
60 "a new power or rate.",
64 .AddAttribute(
"SuccessThreshold2",
65 "The minimum number of successful transmissions in \"Low\" state to try "
66 "a new power or rate.",
70 .AddAttribute(
"FailThreshold",
71 "The minimum number of failed transmissions to try a new power or rate.",
75 .AddAttribute(
"PowerThreshold",
76 "The maximum number of power changes.",
80 .AddAttribute(
"PowerDecrementStep",
81 "Step size for decrement the power.",
85 .AddAttribute(
"PowerIncrementStep",
86 "Step size for increment the power.",
90 .AddAttribute(
"RateDecrementStep",
91 "Step size for decrement the rate.",
95 .AddAttribute(
"RateIncrementStep",
96 "Step size for increment the rate.",
100 .AddTraceSource(
"PowerChange",
101 "The transmission power has change",
103 "ns3::WifiRemoteStationManager::PowerChangeTracedCallback")
104 .AddTraceSource(
"RateChange",
105 "The transmission rate has change",
107 "ns3::WifiRemoteStationManager::RateChangeTracedCallback");
136 NS_FATAL_ERROR(
"WifiRemoteStationManager selected does not support HT rates");
140 NS_FATAL_ERROR(
"WifiRemoteStationManager selected does not support VHT rates");
144 NS_FATAL_ERROR(
"WifiRemoteStationManager selected does not support HE rates");
156 station->m_nSuccess = 0;
157 station->m_nFailed = 0;
158 station->m_pCount = 0;
160 station->m_initialized =
false;
162 NS_LOG_DEBUG(
"create station=" << station <<
", rate=" << +station->m_rateIndex
163 <<
", power=" << +station->m_powerLevel);
201 station->m_nFailed++;
202 station->m_nSuccess = 0;
203 NS_LOG_DEBUG(
"station=" << station <<
", rate=" << station->m_rateIndex
204 <<
", power=" << (
int)station->m_powerLevel);
217 if (station->m_nFailed == station->m_failThreshold)
219 station->m_nFailed = 0;
220 station->m_nSuccess = 0;
221 station->m_pCount = 0;
224 station->m_critRateIndex = station->m_rateIndex;
225 if (station->m_rateIndex != 0)
259 MHz_u dataChannelWidth,
262 NS_LOG_FUNCTION(
this << st << ackSnr << ackMode << dataSnr << dataChannelWidth << +dataNss);
265 station->m_nSuccess++;
266 station->m_nFailed = 0;
267 NS_LOG_DEBUG(
"station=" << station <<
" data ok success=" << station->m_nSuccess <<
", rate="
268 << +station->m_rateIndex <<
", power=" << +station->m_powerLevel);
272 station->m_nSuccess >= station->m_successThreshold)
283 if (station->m_nSuccess == station->m_successThreshold)
285 station->m_nSuccess = 0;
286 station->m_nFailed = 0;
287 if (station->m_rateIndex == (station->m_state->m_operationalRateSet.size() - 1))
297 if (station->m_critRateIndex == 0)
299 if (station->m_rateIndex != (station->m_state->m_operationalRateSet.size() - 1))
310 station->m_rateIndex = station->m_critRateIndex;
311 station->m_pCount = 0;
312 station->m_critRateIndex = 0;
345 if (channelWidth > 20 && channelWidth != 22)
354 const auto prevPower =
GetPhy()->
GetPower(station->m_prevPowerLevel);
355 if (station->m_prevPowerLevel != station->m_powerLevel)
357 m_powerChange(prevPower, power, station->m_state->m_address);
358 station->m_prevPowerLevel = station->m_powerLevel;
360 if (station->m_prevRateIndex != station->m_rateIndex)
362 m_rateChange(prevRate, rate, station->m_state->m_address);
363 station->m_prevRateIndex = station->m_rateIndex;
367 station->m_powerLevel,
385 if (channelWidth > 20 && channelWidth != 22)
APARF Power and rate control algorithm.
void DoReportFinalDataFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
void DoReportRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
uint32_t m_failMax
The minimum number of failed transmissions to try a new power or rate.
uint8_t m_minPower
Minimal power level.
void DoInitialize() override
Initialize() implementation.
WifiRemoteStation * DoCreateStation() const override
~AparfWifiManager() override
uint32_t m_successMax2
The minimum number of successful transmissions in "Low" state to try a new power or rate.
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station) override
uint8_t m_maxPower
Maximal power level.
uint32_t m_powerMax
The maximum number of power changes.
uint8_t m_powerDec
Step size for decrement the power.
State
Enumeration of the possible states of the channel.
void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode) override
This method is a pure virtual method that must be implemented by the sub-class.
uint8_t m_rateDec
Step size for decrement the rate.
uint32_t m_successMax1
The minimum number of successful transmissions in "High" state to try a new power or rate.
uint8_t m_powerInc
Step size for increment the power.
void DoReportRtsOk(WifiRemoteStation *station, double ctsSnr, WifiMode ctsMode, double rtsSnr) override
This method is a pure virtual method that must be implemented by the sub-class.
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station, MHz_u allowedWidth) override
void DoReportFinalRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
void CheckInit(AparfWifiRemoteStation *station)
Check for initializations.
void DoReportDataOk(WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr, MHz_u dataChannelWidth, uint8_t dataNss) override
This method is a pure virtual method that must be implemented by the sub-class.
TracedCallback< double, double, Mac48Address > m_powerChange
The trace source fired when the transmission power changes.
void DoReportDataFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
void SetupPhy(const Ptr< WifiPhy > phy) override
Set up PHY associated with this device since it is the object that knows the full set of transmit rat...
uint8_t m_rateInc
Step size for increment the rate.
TracedCallback< DataRate, DataRate, Mac48Address > m_rateChange
The trace source fired when the transmission rate changes.
static TypeId GetTypeId()
Register this type.
Class for representing data rates.
Smart pointer class similar to boost::intrusive_ptr.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
represent a single transmission mode
WifiModulationClass GetModulationClass() const
uint64_t GetDataRate(MHz_u channelWidth, Time guardInterval, uint8_t nss) const
dBm_u GetPower(uint8_t powerLevel) const
Get the power of the given power level.
hold a list of per-remote-station state.
uint8_t GetDefaultTxPowerLevel() const
uint8_t GetNSupported(const WifiRemoteStation *station) const
Return the number of modes supported by the given station.
Ptr< WifiPhy > GetPhy() const
Return the WifiPhy.
MHz_u GetChannelWidth(const WifiRemoteStation *station) const
Return the channel width supported by the station.
bool GetAggregation(const WifiRemoteStation *station) const
Return whether the given station supports A-MPDU.
bool GetHtSupported() const
Return whether the device has HT capability support enabled on the link this manager is associated wi...
WifiMode GetNonErpSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether non-ERP mode associated with the specified station at the specified index.
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...
bool GetUseNonErpProtection() const
Return whether the device supports protection of non-ERP stations.
bool GetVhtSupported() const
Return whether the device has VHT capability support enabled on the link this manager is associated w...
bool GetShortPreambleEnabled() const
Return whether the device uses short PHY preambles.
WifiMode GetSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether mode associated with the specified station at the specified index.
bool GetHeSupported() const
Return whether the device has HE capability support enabled.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Ptr< const TraceSourceAccessor > MakeTraceSourceAccessor(T a)
Create a TraceSourceAccessor which will control access to the underlying trace source.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Ptr< const AttributeChecker > MakeUintegerChecker()
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
WifiPreamble GetPreambleForTransmission(WifiModulationClass modulation, bool useShortPreamble)
Return the preamble to be used for the transmission.
Hold per-remote-station state for APARF Wifi manager.
uint8_t m_prevRateIndex
Rate index of the previous transmission.
uint8_t m_nSupported
Number of supported rates by the remote station.
uint32_t m_successThreshold
The minimum number of successful transmissions to try a new power or rate.
uint32_t m_nSuccess
Number of successful transmission attempts.
uint32_t m_failThreshold
The minimum number of failed transmissions to try a new power or rate.
uint8_t m_rateIndex
Current rate index.
uint32_t m_pCount
Number of power changes.
uint8_t m_critRateIndex
Critical rate.
bool m_initialized
For initializing variables.
AparfWifiManager::State m_aparfState
The estimated state of the channel.
uint8_t m_powerLevel
Current power level.
uint8_t m_prevPowerLevel
Power level of the previous transmission.
uint32_t m_nFailed
Number of failed transmission attempts.
hold per-remote-station state.
WifiRemoteStationState * m_state
Remote station state.
Mac48Address m_address
Mac48Address of the remote station.