A Discrete-Event Network Simulator
QKDNetSim v2.0 (NS-3 v3.41) @ (+)
API
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
rrpaa-wifi-manager.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2017 Universidad de la República - Uruguay
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Matías Richart <mrichart@fing.edu.uy>
18  */
19 
20 #ifndef RRPAA_WIFI_MANAGER_H
21 #define RRPAA_WIFI_MANAGER_H
22 
23 #include "ns3/nstime.h"
24 #include "ns3/random-variable-stream.h"
25 #include "ns3/wifi-remote-station-manager.h"
26 
27 namespace ns3
28 {
29 
30 struct RrpaaWifiRemoteStation;
31 
58 {
59  double m_ori;
60  double m_mtl;
61  uint32_t m_ewnd;
62 };
63 
67 typedef std::vector<std::pair<WifiRrpaaThresholds, WifiMode>> RrpaaThresholdsTable;
68 
72 typedef std::vector<std::vector<double>> RrpaaProbabilitiesTable;
73 
75 {
76  public:
81  static TypeId GetTypeId();
83  ~RrpaaWifiManager() override;
84 
85  void SetupPhy(const Ptr<WifiPhy> phy) override;
86  void SetupMac(const Ptr<WifiMac> mac) override;
87 
97  int64_t AssignStreams(int64_t stream) override;
98 
99  private:
100  void DoInitialize() override;
101  WifiRemoteStation* DoCreateStation() const override;
102  void DoReportRxOk(WifiRemoteStation* station, double rxSnr, WifiMode txMode) override;
103  void DoReportRtsFailed(WifiRemoteStation* station) override;
104  void DoReportDataFailed(WifiRemoteStation* station) override;
105  void DoReportRtsOk(WifiRemoteStation* station,
106  double ctsSnr,
107  WifiMode ctsMode,
108  double rtsSnr) override;
109  void DoReportDataOk(WifiRemoteStation* station,
110  double ackSnr,
111  WifiMode ackMode,
112  double dataSnr,
113  uint16_t dataChannelWidth,
114  uint8_t dataNss) override;
115  void DoReportFinalRtsFailed(WifiRemoteStation* station) override;
116  void DoReportFinalDataFailed(WifiRemoteStation* station) override;
117  WifiTxVector DoGetDataTxVector(WifiRemoteStation* station, uint16_t allowedWidth) override;
119  bool DoNeedRts(WifiRemoteStation* st, uint32_t size, bool normally) override;
120 
125  void CheckInit(RrpaaWifiRemoteStation* station);
126 
132  void CheckTimeout(RrpaaWifiRemoteStation* station);
153 
159  void InitThresholds(RrpaaWifiRemoteStation* station);
160 
170 
179  WifiRrpaaThresholds GetThresholds(RrpaaWifiRemoteStation* station, uint8_t index) const;
180 
188  Time GetCalcTxTime(WifiMode mode) const;
195  void AddCalcTxTime(WifiMode mode, Time t);
196 
202  typedef std::vector<std::pair<Time, WifiMode>> TxTime;
203 
207 
208  uint32_t m_frameLength;
209  uint32_t m_ackLength;
210 
211  bool m_basic;
213  double m_alpha;
214  double m_beta;
215  double m_tau;
216  double m_gamma;
217  double m_delta;
218 
223  uint8_t m_minPowerLevel;
224  uint8_t m_maxPowerLevel;
225  uint8_t m_nPowerLevels;
226 
235 
238 };
239 
240 } // namespace ns3
241 
242 #endif /* RRPAA__WIFI_MANAGER_H */
Time m_sifs
Value of SIFS configured in the device.
Ptr< UniformRandomVariable > m_uniformRandomVariable
Provides uniform random variables for probabilistic changes.
uint8_t m_maxPowerLevel
Maximal power level.
void ResetCountersBasic(RrpaaWifiRemoteStation *station)
Reset the counters of the given station.
double m_beta
Beta value for RRPAA (value for calculating ORI threshold).
int64_t AssignStreams(int64_t stream) override
Assign a fixed random variable stream number to the random variables used by this model.
Time m_difs
Value of DIFS configured in the device.
WifiRemoteStation * DoCreateStation() const override
bool m_basic
If using the basic algorithm (without RTS/CTS).
void DoInitialize() override
Initialize() implementation.
void DoReportRtsFailed(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...
TxTime m_calcTxTime
To hold all the calculated TxTime for all modes.
void CheckInit(RrpaaWifiRemoteStation *station)
Check for initializations.
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station, uint16_t allowedWidth) override
std::vector< std::pair< Time, WifiMode > > TxTime
typedef for a vector of a pair of Time, WifiMode.
TracedCallback< double, double, Mac48Address > m_powerChange
The trace source fired when the transmission power change.
uint8_t m_minPowerLevel
Differently form rate, power levels do not depend on the remote station.
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 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...
void RunAdaptiveRtsAlgorithm(RrpaaWifiRemoteStation *station)
Run an enhanced algorithm which activates the use of RTS for the given station if the conditions are ...
TracedCallback< DataRate, DataRate, Mac48Address > m_rateChange
The trace source fired when the transmission rate change.
Time m_timeout
Timeout for the RRAA BASIC loss estimation block.
uint32_t m_ackLength
Ack frame length used to calculate mode TxTime (in bytes).
uint8_t m_nPowerLevels
Number of power levels.
WifiRrpaaThresholds GetThresholds(RrpaaWifiRemoteStation *station, WifiMode mode) const
Get the thresholds for the given station and mode.
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.
double m_tau
Tau value for RRPAA (value for calculating EWND size).
void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode) override
This method is a pure virtual method that must be implemented by the sub-class.
double m_gamma
Gamma value for RRPAA (value for pdTable decrements).
Time GetCalcTxTime(WifiMode mode) const
Get the estimated TxTime of a packet with a given mode.
double m_delta
Delta value for RRPAA (value for pdTable increments).
void CheckTimeout(RrpaaWifiRemoteStation *station)
Check if the counter should be reset.
double m_alpha
Alpha value for RRPAA (value for calculating MTL threshold)
bool DoNeedRts(WifiRemoteStation *st, uint32_t size, bool normally) override
void DoReportFinalDataFailed(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.
void DoReportFinalRtsFailed(WifiRemoteStation *station) override
This method is a pure virtual method that must be implemented by the sub-class.
uint32_t m_frameLength
Data frame length used to calculate mode TxTime (in bytes).
void AddCalcTxTime(WifiMode mode, Time t)
Add transmission time for the given mode to an internal list.
void InitThresholds(RrpaaWifiRemoteStation *station)
Initialize the thresholds internal list for the given station.
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station) override
static TypeId GetTypeId()
Register this type.
void RunBasicAlgorithm(RrpaaWifiRemoteStation *station)
Find an appropriate rate and power for the given station, using a basic algorithm.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
Forward calls to a chain of Callback.
a unique identifier for an interface.
Definition: type-id.h:59
represent a single transmission mode
Definition: wifi-mode.h:51
hold a list of per-remote-station state.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
Every class exported by the ns3 library is enclosed in the ns3 namespace.
std::vector< std::vector< double > > RrpaaProbabilitiesTable
List of probabilities.
std::vector< std::pair< WifiRrpaaThresholds, WifiMode > > RrpaaThresholdsTable
List of thresholds for each mode.
mac
Definition: third.py:92
phy
Definition: third.py:89
Hold per-remote-station state for RRPAA Wifi manager.
hold per-remote-station state.
Robust Rate and Power Adaptation Algorithm.
double m_ori
The Opportunistic Rate Increase threshold.
uint32_t m_ewnd
The Estimation Window size.
double m_mtl
The Maximum Tolerable Loss threshold.