A Discrete-Event Network Simulator
API
ideal-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) 2006 INRIA
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: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  */
20 
21 #ifndef IDEAL_WIFI_MANAGER_H
22 #define IDEAL_WIFI_MANAGER_H
23 
24 #include "ns3/traced-value.h"
26 
27 namespace ns3 {
28 
29 struct IdealWifiRemoteStation;
30 
47 {
48 public:
53  static TypeId GetTypeId (void);
55  virtual ~IdealWifiManager ();
56 
57  void SetupPhy (const Ptr<WifiPhy> phy);
58 
59 
60 private:
61  //overridden from base class
62  void DoInitialize (void);
63  WifiRemoteStation* DoCreateStation (void) const;
64  void DoReportRxOk (WifiRemoteStation *station,
65  double rxSnr, WifiMode txMode);
66  void DoReportRtsFailed (WifiRemoteStation *station);
67  void DoReportDataFailed (WifiRemoteStation *station);
68  void DoReportRtsOk (WifiRemoteStation *station,
69  double ctsSnr, WifiMode ctsMode, double rtsSnr);
70  void DoReportDataOk (WifiRemoteStation *station, double ackSnr, WifiMode ackMode,
71  double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss);
72  void DoReportAmpduTxStatus (WifiRemoteStation *station, uint8_t nSuccessfulMpdus, uint8_t nFailedMpdus,
73  double rxSnr, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss);
78 
82  void Reset (WifiRemoteStation *station) const;
83 
89  void BuildSnrThresholds (void);
90 
99  double GetSnrThreshold (WifiTxVector txVector);
107  void AddSnrThreshold (WifiTxVector txVector, double snr);
108 
114  uint16_t GetChannelWidthForNonHtMode (WifiMode mode) const;
115 
126  double GetLastObservedSnr (IdealWifiRemoteStation *station, uint16_t channelWidth, uint8_t nss) const;
127 
132  typedef std::vector<std::pair<double, WifiTxVector> > Thresholds;
133 
134  double m_ber;
136 
138 };
139 
140 } //namespace ns3
141 
142 #endif /* IDEAL_WIFI_MANAGER_H */
void DoReportFinalDataFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
void DoReportFinalRtsFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
void DoReportAmpduTxStatus(WifiRemoteStation *station, uint8_t nSuccessfulMpdus, uint8_t nFailedMpdus, double rxSnr, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
Typically called per A-MPDU, either when a Block ACK was successfully received or when a BlockAckTime...
std::vector< std::pair< double, WifiTxVector > > Thresholds
A vector of <snr, WifiTxVector> pair holding the minimum SNR for the WifiTxVector.
void DoReportRtsOk(WifiRemoteStation *station, double ctsSnr, WifiMode ctsMode, double rtsSnr)
This method is a pure virtual method that must be implemented by the sub-class.
WifiTxVector DoGetDataTxVector(WifiRemoteStation *station)
hold per-remote-station state for Ideal Wifi manager.
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
Definition: wifi-mode.h:97
void DoInitialize(void)
Initialize() implementation.
phy
Definition: third.py:93
void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode)
This method is a pure virtual method that must be implemented by the sub-class.
double GetLastObservedSnr(IdealWifiRemoteStation *station, uint16_t channelWidth, uint8_t nss) const
Convenience function to get the last observed SNR from a given station for a given channel width and ...
static TypeId GetTypeId(void)
Get the type ID.
uint16_t GetChannelWidthForNonHtMode(WifiMode mode) const
Convenience function for selecting a channel width for non-HT mode.
double m_ber
The maximum Bit Error Rate acceptable at any transmission mode.
double GetSnrThreshold(WifiTxVector txVector)
Return the minimum SNR needed to successfully transmit data with this WifiTxVector at the specified B...
void BuildSnrThresholds(void)
Construct the vector of minimum SNRs needed to successfully transmit for all possible combinations (r...
void DoReportDataOk(WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)
This method is a pure virtual method that must be implemented by the sub-class.
Thresholds m_thresholds
List of WifiTxVector and the minimum SNR pair.
hold a list of per-remote-station state.
TracedValue< uint64_t > m_currentRate
Trace rate changes.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
WifiRemoteStation * DoCreateStation(void) const
WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station)
void Reset(void)
Reset the station, invoked in a STA upon dis-association or in an AP upon reboot. ...
Ideal rate control algorithmThis class implements an &#39;ideal&#39; rate control algorithm similar to RBAR i...
void DoReportDataFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
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...
a unique identifier for an interface.
Definition: type-id.h:58
void DoReportRtsFailed(WifiRemoteStation *station)
This method is a pure virtual method that must be implemented by the sub-class.
hold per-remote-station state.
void AddSnrThreshold(WifiTxVector txVector, double snr)
Adds a pair of WifiTxVector and the minimum SNR for that given vector to the list.