26 #ifndef MINSTREL_HT_WIFI_MANAGER_H 27 #define MINSTREL_HT_WIFI_MANAGER_H 29 #include "ns3/wifi-remote-station-manager.h" 31 #include "ns3/wifi-mpdu-type.h" 38 typedef std::map<WifiMode, Time>
TxTime;
69 return (os <<
"INVALID");
250 double rxSnr,
WifiMode txMode)
override;
254 double ctsSnr,
WifiMode ctsMode,
double rtsSnr)
override;
256 double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
override;
262 double rxSnr,
double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
override;
454 double CalculateEwmsd (
double oldEwmsd,
double currentProb,
double ewmaProb,
double weight);
535 uint16_t
GetIndex (uint8_t groupId, uint8_t rateId);
545 uint8_t
GetHtGroupId (uint8_t txstreams, uint16_t gi, uint16_t chWidth);
555 uint8_t
GetVhtGroupId (uint8_t txstreams, uint16_t gi, uint16_t chWidth);
565 uint8_t
GetHeGroupId (uint8_t txstreams, uint16_t gi, uint16_t chWidth);
uint16_t m_maxProbRate
The highest success probability rate of this group in bps.
void DoReportAmpduTxStatus(WifiRemoteStation *station, uint16_t nSuccessfulMpdus, uint16_t nFailedMpdus, double rxSnr, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss) override
Typically called per A-MPDU, either when a Block ACK was successfully received or when a BlockAckTime...
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 GetHeGroupId(uint8_t txstreams, uint16_t gi, uint16_t chWidth)
Returns the groupId of an HE MCS with the given number of streams, GI and channel width used...
uint8_t m_nSampleCol
Number of sample columns.
uint8_t GetVhtGroupId(uint8_t txstreams, uint16_t gi, uint16_t chWidth)
Returns the groupId of a VHT MCS with the given number of streams, GI and channel width used...
void DoReportRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
Simulation virtual time values and global simulation resolution.
bool m_supported
If the rates of this group are supported by the station.
Time GetMpduTxTime(uint8_t groupId, WifiMode mode) const
Obtain the TxTime saved in the group information.
A struct to contain information of a group.
WifiModeList GetVhtDeviceMcsList(void) const
Returns a list of only the VHT MCS supported by the device.
bool DoNeedRetransmission(WifiRemoteStation *st, Ptr< const Packet > packet, bool normally) override
double prob
Current probability within last time interval.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
double ewmsdProb
Exponential weighted moving standard deviation of probability.
TracedValue< uint64_t > m_currentRate
Trace rate changes.
void PrintTable(MinstrelHtWifiRemoteStation *station)
Printing Minstrel Table.
static const uint8_t MAX_HE_STREAM_GROUPS
Maximal number of groups per stream in HE (4 possible channel widths and 3 possible GI configurations...
uint16_t GetLowestIndex(MinstrelHtWifiRemoteStation *station)
Returns the lowest global index of the rates supported by the station.
uint8_t m_col
MCS rates are divided into groups based on the number of streams and flags that they use...
WifiModeList GetHeDeviceMcsList() const
Returns a list of only the HE MCS supported by the device.
void SetBestProbabilityRate(MinstrelHtWifiRemoteStation *station, uint16_t index)
Set index rate as maxProbRate if it is better than current value.
uint8_t GetHtGroupId(uint8_t txstreams, uint16_t gi, uint16_t chWidth)
Returns the groupId of an HT MCS with the given number of streams, GI and channel width used...
MinstrelHtWifiRemoteStation structure.
void DoReportFinalDataFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
void CalculateRetransmits(MinstrelHtWifiRemoteStation *station, uint16_t index)
Calculate the number of retransmissions to set for the index rate.
void DoInitialize(void) override
Initialize() implementation.
static const uint8_t MAX_VHT_STREAM_GROUPS
Maximal number of groups per stream in VHT (4 possible channel widths and 2 possible GI configuration...
bool isSupported
flag whether group is supported
Time m_legacyUpdateStats
How frequent do we calculate the stats for legacy MinstrelWifiManager.
uint16_t FindRate(MinstrelHtWifiRemoteStation *station)
Find a rate to use from Minstrel Table.
A struct to contain all statistics information related to a data rate.
uint32_t m_frameLength
Frame length used for calculate modes TxTime in bytes.
MinstrelMcsGroups m_minstrelGroups
Global array for groups information.
Time CalculateTimeUnicastPacket(Time dataTransmissionTime, uint32_t shortRetries, uint32_t longRetries)
Estimate the time to transmit the given packet with the given number of retries.
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
uint8_t mcsIndex
The index in the operationalMcsSet of the WifiRemoteStationManager.
bool supported
If the rate is supported.
TxTime ratesFirstMpduTxTimeTable
rates MPDU transmit time table
WifiRemoteStation * DoCreateStation(void) const override
uint16_t gi
guard interval duration (nanoseconds)
uint8_t GetRateId(uint16_t index)
Return the rateId inside a group, from the global index.
bool m_printStats
If statistics table should be printed.
MpduType
The type of an MPDU.
bool retryUpdated
If number of retries was updated already.
uint16_t GetIndex(uint8_t groupId, uint8_t rateId)
Returns the global index corresponding to the groupId and rateId.
uint32_t numRateSuccess
Number of successful frames transmitted so far.
uint8_t m_index
Sample table index.
uint8_t m_lookAroundRate
The % to try other rates than our current rate.
uint8_t m_ewmaLevel
Exponential weighted moving average level (or coefficient).
void SetBestStationThRates(MinstrelHtWifiRemoteStation *station, uint16_t index)
Set index rate as maxTpRate or maxTp2Rate if is better than current values.
std::ostream & operator<<(std::ostream &os, const Angles &a)
void SetupMac(const Ptr< WifiMac > mac) override
Set up MAC associated with this device since it is the object that knows the full set of timing param...
Time GetFirstMpduTxTime(uint8_t groupId, WifiMode mode) const
Obtain the TxTime saved in the group information.
TxTime ratesTxTimeTable
rates transmit time table
std::vector< MinstrelHtRateInfo > MinstrelHtRate
Data structure for a Minstrel Rate table.
McsGroupType type
identifies the group,
uint16_t chWidth
channel width (MHz)
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station) override
uint64_t successHist
Aggregate of all transmission successes.
Time perfectTxTime
Perfect transmission time calculation, or frame calculation.
double ewmaProb
Exponential weighted moving average of probability.
static const uint8_t MAX_HE_SUPPORTED_STREAMS
Maximal number of streams supported by the HE PHY layer.
static const uint8_t MAX_VHT_GROUP_RATES
Number of rates (or MCS) per VHT group.
static const uint8_t MAX_HT_WIDTH
Maximal channel width in MHz.
virtual ~MinstrelHtWifiManager()
uint8_t streams
number of spatial streams
static const uint8_t MAX_HT_STREAM_GROUPS
Maximal number of groups per stream in HT (2 possible channel widths and 2 possible GI configurations...
bool m_useLatestAmendmentOnly
Flag if only the latest supported amendment by both peers should be used.
Ptr< UniformRandomVariable > m_uniformRandomVariable
Provides uniform random variables.
hold a list of per-remote-station state.
double throughput
Throughput of this rate (in packets per second).
std::vector< struct GroupInfo > McsGroupData
Data structure for a table of groups.
static TypeId GetTypeId(void)
Get the type ID.
static const uint8_t MAX_VHT_WIDTH
Maximal channel width in MHz.
uint16_t GetNextSample(MinstrelHtWifiRemoteStation *station)
Getting the next sample from Sample Table.
uint64_t attemptHist
Aggregate of all transmission attempts.
uint16_t m_maxTpRate2
The second max throughput rate of this group in bps.
bool IsValidMcs(Ptr< WifiPhy > phy, uint8_t streams, uint16_t chWidth, WifiMode mode)
Check the validity of a combination of number of streams, chWidth and mode.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint8_t m_numRates
Number of rates per group Minstrel should consider.
void InitSampleTable(MinstrelHtWifiRemoteStation *station)
Initialize Sample Table.
double CalculateThroughput(MinstrelHtWifiRemoteStation *station, uint8_t groupId, uint8_t rateId, double ewmaProb)
Return the average throughput of the MCS defined by groupId and rateId.
void UpdateRetry(MinstrelHtWifiRemoteStation *station)
Update the number of retries and reset accordingly.
uint8_t m_numGroups
Number of groups Minstrel should consider.
uint32_t numSamplesSkipped
Number of times this rate statistics were not updated because no attempts have been made...
Time m_updateStats
How frequent do we calculate the stats.
void DoReportFinalRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
static const uint8_t MAX_HT_GROUP_RATES
Number of rates (or MCS) per HT group.
uint32_t adjustedRetryCount
Adjust the retry limit for this rate.
uint32_t numRateAttempt
Number of transmission attempts so far.
void UpdateStats(MinstrelHtWifiRemoteStation *station)
Update the Minstrel Table.
std::vector< WifiMode > WifiModeList
In various parts of the code, folk are interested in maintaining a list of transmission modes...
static const uint8_t MAX_VHT_SUPPORTED_STREAMS
Maximal number of streams supported by the VHT PHY layer.
uint16_t m_maxTpRate
The max throughput rate of this group in bps.
void RateInit(MinstrelHtWifiRemoteStation *station)
Initialize Minstrel Table.
Implementation of Minstrel-HT Rate Control AlgorithmMinstrel-HT is a rate adaptation mechanism for th...
int64_t AssignStreams(int64_t stream) override
Assign a fixed random variable stream number to the random variables used by this model...
Data structure to contain the information that defines a group.
void DoReportDataFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
McsGroupType
Available MCS group types.
void StatsDump(MinstrelHtWifiRemoteStation *station, uint8_t groupId, std::ofstream &of)
Print group statistics.
void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode) override
This method is a pure virtual method that must be implemented by the sub-class.
void UpdatePacketCounters(MinstrelHtWifiRemoteStation *station, uint16_t nSuccessfulMpdus, uint16_t nFailedMpdus)
Update the number of sample count variables.
std::map< WifiMode, Time > TxTime
Data structure to save transmission time calculations per rate.
double CalculateEwmsd(double oldEwmsd, double currentProb, double ewmaProb, double weight)
Perform EWMSD (Exponentially Weighted Moving Standard Deviation) calculation.
void(* RateChangeTracedCallback)(const uint64_t rate, const Mac48Address remoteAddress)
TracedCallback signature for rate change events.
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.
std::vector< McsGroup > MinstrelMcsGroups
Data structure for a table of group definitions.
uint32_t prevNumRateAttempt
Number of transmission attempts with previous rate.
void AddMpduTxTime(uint8_t groupId, WifiMode mode, Time t)
Save a TxTime to the vector of groups.
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station) override
void SetNextSample(MinstrelHtWifiRemoteStation *station)
Set the next sample from Sample Table.
void PrintSampleTable(MinstrelHtWifiRemoteStation *station)
Printing Sample Table.
WifiModeList GetHtDeviceMcsList(void) const
Returns a list of only the HT MCS supported by the device.
MinstrelHtRate m_ratesTable
Information about rates of this group.
Ptr< MinstrelWifiManager > m_legacyManager
Pointer to an instance of MinstrelWifiManager.
uint8_t GetGroupId(uint16_t index)
Return the groupId from the global index.
Time CalculateMpduTxDuration(Ptr< WifiPhy > phy, uint8_t streams, uint16_t gi, uint16_t chWidth, WifiMode mode, MpduType mpduType)
Estimates the TxTime of a frame with a given mode and group (stream, guard interval and channel width...
static const uint8_t MAX_HE_WIDTH
Maximal channel width in MHz.
static const uint8_t MAX_HT_SUPPORTED_STREAMS
Constants for maximum values.
uint32_t CountRetries(MinstrelHtWifiRemoteStation *station)
Count retries.
void DoReportDataOk(WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss) override
This method is a pure virtual method that must be implemented by the sub-class.
void UpdateRate(MinstrelHtWifiRemoteStation *station)
Update rate.
void AddFirstMpduTxTime(uint8_t groupId, WifiMode mode, Time t)
Save a TxTime to the vector of groups.
a unique identifier for an interface.
void CheckInit(MinstrelHtWifiRemoteStation *station)
Check for initializations.
hold per-remote-station state.
uint32_t prevNumRateSuccess
Number of successful frames transmitted with previous rate.
static const uint8_t MAX_HE_GROUP_RATES
Number of rates (or MCS) per HE group.
uint32_t retryCount
Retry limit.