12#include "ns3/wifi-tx-vector.h"
14#define Min(a, b) ((a < b) ? a : b)
41 TypeId(
"ns3::CaraWifiManager")
47 "The number of consecutive transmissions failure to activate the RTS probe.",
51 .AddAttribute(
"FailureThreshold",
52 "The number of consecutive transmissions failure to decrease the rate.",
56 .AddAttribute(
"SuccessThreshold",
57 "The minimum number of successful transmissions to try a new rate.",
61 .AddAttribute(
"Timeout",
62 "The 'timer' in the CARA algorithm",
66 .AddTraceSource(
"Rate",
67 "Traced value for rate changes (b/s)",
69 "ns3::TracedValueCallback::Uint64");
91 NS_FATAL_ERROR(
"WifiRemoteStationManager selected does not support HT rates");
95 NS_FATAL_ERROR(
"WifiRemoteStationManager selected does not support VHT rates");
99 NS_FATAL_ERROR(
"WifiRemoteStationManager selected does not support HE rates");
109 station->m_success = 0;
110 station->m_failed = 0;
111 station->m_timer = 0;
128 station->m_success = 0;
132 if (station->m_rate != 0)
136 station->m_failed = 0;
137 station->m_timer = 0;
161 MHz_u dataChannelWidth,
164 NS_LOG_FUNCTION(
this << st << ackSnr << ackMode << dataSnr << dataChannelWidth << +dataNss);
167 station->m_success++;
168 station->m_failed = 0;
169 NS_LOG_DEBUG(
"self=" << station <<
" data ok success=" << station->m_success
170 <<
", timer=" << station->m_timer);
177 NS_LOG_DEBUG(
"self=" << station <<
" inc rate=" << +station->m_rate);
178 station->m_timer = 0;
179 station->m_success = 0;
201 if (channelWidth > 20 && channelWidth != 22)
232 if (channelWidth > 20 && channelWidth != 22)
implement the CARA rate control algorithm
void DoInitialize() override
Initialize() implementation.
~CaraWifiManager() override
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.
void DoReportFinalDataFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
static TypeId GetTypeId()
Get the type ID.
uint32_t m_failureThreshold
failure threshold
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station, MHz_u allowedWidth) override
void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode) override
This method is a pure virtual method that must be implemented by the sub-class.
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station) override
bool DoNeedRts(WifiRemoteStation *station, uint32_t size, bool normally) override
uint32_t m_timerTimeout
timer threshold
void DoReportRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
void DoReportDataFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
WifiRemoteStation * DoCreateStation() const override
uint32_t m_successThreshold
success threshold
void DoReportFinalRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
TracedValue< uint64_t > m_currentRate
Trace rate changes.
uint32_t m_probeThreshold
probe threshold
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.
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
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.
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.
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 CARA Wifi manager.
uint32_t m_success
success count
uint32_t m_failed
failed count
uint32_t m_timer
timer count
uint8_t m_rate
rate in bps
hold per-remote-station state.