A Discrete-Event Network Simulator
API
aparf-wifi-manager.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014 Universidad de la República - Uruguay
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Matias Richart <mrichart@fing.edu.uy>
19  */
20 
21 #ifndef APARF_WIFI_MANAGER_H
22 #define APARF_WIFI_MANAGER_H
23 
24 #include "ns3/wifi-remote-station-manager.h"
25 
26 namespace ns3 {
27 
28 struct AparfWifiRemoteStation;
29 
46 {
47 public:
52  static TypeId GetTypeId (void);
54  virtual ~AparfWifiManager ();
55 
56  void SetupPhy (const Ptr<WifiPhy> phy) override;
57 
61  enum State
62  {
64  Low,
65  Spread
66  };
67 
68 
69 private:
70  void DoInitialize (void) override;
71  WifiRemoteStation * DoCreateStation (void) const override;
72  void DoReportRxOk (WifiRemoteStation *station,
73  double rxSnr, WifiMode txMode) override;
74  void DoReportRtsFailed (WifiRemoteStation *station) override;
75  void DoReportDataFailed (WifiRemoteStation *station) override;
76  void DoReportRtsOk (WifiRemoteStation *station,
77  double ctsSnr, WifiMode ctsMode, double rtsSnr) override;
78  void DoReportDataOk (WifiRemoteStation *station, double ackSnr, WifiMode ackMode,
79  double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss) override;
80  void DoReportFinalRtsFailed (WifiRemoteStation *station) override;
81  void DoReportFinalDataFailed (WifiRemoteStation *station) override;
84 
89  void CheckInit (AparfWifiRemoteStation *station);
90 
91  uint32_t m_succesMax1;
92  uint32_t m_succesMax2;
93  uint32_t m_failMax;
94  uint32_t m_powerMax;
95  uint8_t m_powerInc;
96  uint8_t m_powerDec;
97  uint8_t m_rateInc;
98  uint8_t m_rateDec;
99 
105  uint8_t m_minPower;
106 
110  uint8_t m_maxPower;
111 
120 };
121 
122 } //namespace ns3
123 
124 #endif /* APARF_WIFI_MANAGER_H */
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 DoInitialize(void) override
Initialize() implementation.
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 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.
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station) override
uint8_t m_maxPower
Maximal power level.
WifiRemoteStation * DoCreateStation(void) const override
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.
uint8_t m_powerInc
Step size for increment the power.
uint32_t m_succesMax2
The minimum number of successful transmissions in "Low" state to try a new power or rate.
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 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.
TracedCallback< double, double, Mac48Address > m_powerChange
The trace source fired when the transmission power changes.
uint32_t m_succesMax1
The minimum number of successful transmissions in "High" state to try a new power or rate.
static TypeId GetTypeId(void)
Register this type.
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.
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station) override
TracedCallback< DataRate, DataRate, Mac48Address > m_rateChange
The trace source fired when the transmission rate changes.
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:48
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.
phy
Definition: third.py:93
Hold per-remote-station state for APARF Wifi manager.
hold per-remote-station state.