A Discrete-Event Network Simulator
API
wifi-remote-station-manager.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2005,2006,2007 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 WIFI_REMOTE_STATION_MANAGER_H
22 #define WIFI_REMOTE_STATION_MANAGER_H
23 
24 #include "ns3/traced-callback.h"
25 #include "ns3/object.h"
26 #include "ns3/data-rate.h"
27 #include "ns3/mac48-address.h"
28 #include "wifi-mode.h"
29 #include "wifi-utils.h"
31 #include "ht-capabilities.h"
32 #include "vht-capabilities.h"
33 #include "he-capabilities.h"
34 
35 namespace ns3 {
36 
37 class WifiPhy;
38 class WifiMac;
39 class WifiMacHeader;
40 class Packet;
41 class WifiTxVector;
42 
43 struct WifiRemoteStationState;
44 
57 {
58  virtual ~WifiRemoteStation () {};
60  uint32_t m_ssrc;
61  uint32_t m_slrc;
62  uint8_t m_tid;
63 };
64 
69 {
73  enum
74  {
79  } m_state;
80 
97 
98  uint16_t m_channelWidth;
99  uint16_t m_guardInterval;
100  uint8_t m_ness;
105 };
106 
114 {
115 public:
120  static TypeId GetTypeId (void);
121 
123  virtual ~WifiRemoteStationManager ();
124 
127  {
130  };
131 
135  typedef std::vector <WifiRemoteStation *> Stations;
139  typedef std::vector <WifiRemoteStationState *> StationStates;
140 
147  virtual void SetupPhy (const Ptr<WifiPhy> phy);
154  virtual void SetupMac (const Ptr<WifiMac> mac);
155 
161  void SetMaxSsrc (uint32_t maxSsrc);
167  void SetMaxSlrc (uint32_t maxSlrc);
173  void SetRtsCtsThreshold (uint32_t threshold);
174 
180  uint32_t GetFragmentationThreshold (void) const;
187  void SetFragmentationThreshold (uint32_t threshold);
192  void UpdateFragmentationThreshold (void);
193 
200  void SetQosSupport (Mac48Address from, bool qosSupported);
207  void AddStationHtCapabilities (Mac48Address from, HtCapabilities htcapabilities);
214  void AddStationVhtCapabilities (Mac48Address from, VhtCapabilities vhtcapabilities);
221  void AddStationHeCapabilities (Mac48Address from, HeCapabilities hecapabilities);
248  bool GetHtSupported (void) const;
254  bool GetVhtSupported (void) const;
260  bool GetHeSupported (void) const;
266  void SetPcfSupported (bool enable);
272  bool GetPcfSupported (void) const;
278  bool GetGreenfieldSupported (void) const;
284  bool GetShortGuardIntervalSupported (void) const;
290  uint16_t GetGuardInterval (void) const;
296  void SetUseNonErpProtection (bool enable);
303  bool GetUseNonErpProtection (void) const;
309  void SetUseNonHtProtection (bool enable);
316  bool GetUseNonHtProtection (void) const;
322  void SetUseGreenfieldProtection (bool enable);
329  bool GetUseGreenfieldProtection (void) const;
335  void SetShortPreambleEnabled (bool enable);
342  bool GetShortPreambleEnabled (void) const;
348  void SetShortSlotTimeEnabled (bool enable);
355  bool GetShortSlotTimeEnabled (void) const;
361  void SetRifsPermitted (bool allow);
368  bool GetRifsPermitted (void) const;
369 
373  void Reset (void);
374 
382  void AddBasicMode (WifiMode mode);
388  WifiMode GetDefaultMode (void) const;
394  uint8_t GetNBasicModes (void) const;
402  WifiMode GetBasicMode (uint8_t i) const;
408  uint32_t GetNNonErpBasicModes (void) const;
416  WifiMode GetNonErpBasicMode (uint8_t i) const;
452  bool GetQosSupported (Mac48Address address) const;
459  void AddBasicMcs (WifiMode mcs);
465  WifiMode GetDefaultMcs (void) const;
471  uint8_t GetNBasicMcs (void) const;
479  WifiMode GetBasicMcs (uint8_t i) const;
519  uint8_t GetNMcsSupported (Mac48Address address) const;
528  bool GetHtSupported (Mac48Address address) const;
537  bool GetVhtSupported (Mac48Address address) const;
546  bool GetHeSupported (Mac48Address address) const;
547 
553  WifiMode GetNonUnicastMode (void) const;
554 
593  void AddSupportedPlcpPreamble (Mac48Address address, bool isShortPreambleSupported);
600  void AddSupportedErpSlotTime (Mac48Address address, bool isShortSlotTimeSupported);
609  bool IsBrandNew (Mac48Address address) const;
618  bool IsAssociated (Mac48Address address) const;
628  bool IsWaitAssocTxOk (Mac48Address address) const;
656 
667  void PrepareForQueue (Mac48Address address, const WifiMacHeader *header,
668  Ptr<const Packet> packet);
669 
678  Ptr<const Packet> packet);
688  Ptr<const Packet> packet);
697  Ptr<const Packet> packet);
706 
714  void ReportRtsFailed (Mac48Address address, const WifiMacHeader *header);
723  void ReportDataFailed (Mac48Address address, const WifiMacHeader *header,
724  uint32_t packetSize);
736  void ReportRtsOk (Mac48Address address, const WifiMacHeader *header,
737  double ctsSnr, WifiMode ctsMode, double rtsSnr);
749  void ReportDataOk (Mac48Address address, const WifiMacHeader *header,
750  double ackSnr, WifiMode ackMode, double dataSnr,
751  uint32_t packetSize);
769  uint32_t packetSize);
782  void ReportAmpduTxStatus (Mac48Address address, uint8_t tid, uint8_t nSuccessfulMpdus, uint8_t nFailedMpdus, double rxSnr, double dataSnr);
783 
792  void ReportRxOk (Mac48Address address, const WifiMacHeader *header,
793  double rxSnr, WifiMode txMode);
794 
804  bool NeedRts (Mac48Address address, const WifiMacHeader *header,
805  Ptr<const Packet> packet, WifiTxVector txVector);
814  bool NeedCtsToSelf (WifiTxVector txVector);
815 
825  Ptr<const Packet> packet);
835  Ptr<const Packet> packet);
844  uint32_t GetFragmentSize (Mac48Address address, const WifiMacHeader *header,
845  Ptr<const Packet> packet, uint32_t fragmentNumber);
854  uint32_t GetFragmentOffset (Mac48Address address, const WifiMacHeader *header,
855  Ptr<const Packet> packet, uint32_t fragmentNumber);
864  bool IsLastFragment (Mac48Address address, const WifiMacHeader *header,
865  Ptr<const Packet> packet, uint32_t fragmentNumber);
866 
870  uint8_t GetDefaultTxPowerLevel (void) const;
882  void SetDefaultTxPowerLevel (uint8_t txPower);
886  uint8_t GetNumberOfAntennas (void) const;
890  uint8_t GetMaxNumberOfTransmitStreams (void) const;
898  bool UseGreenfieldForDestination (Mac48Address dest) const;
899 
907  typedef void (*PowerChangeTracedCallback)(double oldPower, double newPower, Mac48Address remoteAddress);
908 
916  typedef void (*RateChangeTracedCallback)(DataRate oldRate, DataRate newRate, Mac48Address remoteAddress);
917 
918 
919 protected:
920  virtual void DoDispose (void);
929  WifiMode GetSupported (const WifiRemoteStation *station, uint8_t i) const;
937  uint8_t GetNSupported (const WifiRemoteStation *station) const;
946  bool GetQosSupported (const WifiRemoteStation *station) const;
955  bool GetHtSupported (const WifiRemoteStation *station) const;
964  bool GetVhtSupported (const WifiRemoteStation *station) const;
973  bool GetHeSupported (const WifiRemoteStation *station) const;
983  WifiMode GetMcsSupported (const WifiRemoteStation *station, uint8_t i) const;
991  uint8_t GetNMcsSupported (const WifiRemoteStation *station) const;
1000  WifiMode GetNonErpSupported (const WifiRemoteStation *station, uint8_t i) const;
1008  uint32_t GetNNonErpSupported (const WifiRemoteStation *station) const;
1016  Mac48Address GetAddress (const WifiRemoteStation *station) const;
1024  uint16_t GetChannelWidth (const WifiRemoteStation *station) const;
1033  bool GetShortGuardIntervalSupported (const WifiRemoteStation *station) const;
1041  uint16_t GetGuardInterval (const WifiRemoteStation *station) const;
1050  bool GetAggregation (const WifiRemoteStation *station) const;
1059  bool GetGreenfield (const WifiRemoteStation *station) const;
1060 
1068  uint8_t GetNumberOfSupportedStreams (const WifiRemoteStation *station) const;
1076  uint8_t GetNess (const WifiRemoteStation *station) const;
1077 
1083  Ptr<WifiPhy> GetPhy (void) const;
1089  Ptr<WifiMac> GetMac (void) const;
1090 
1091 
1092 private:
1104  virtual bool DoNeedRts (WifiRemoteStation *station,
1105  Ptr<const Packet> packet, bool normally);
1117  virtual bool DoNeedRetransmission (WifiRemoteStation *station,
1118  Ptr<const Packet> packet, bool normally);
1130  virtual bool DoNeedFragmentation (WifiRemoteStation *station,
1131  Ptr<const Packet> packet, bool normally);
1138  virtual bool IsLowLatency (void) const = 0;
1142  virtual WifiRemoteStation* DoCreateStation (void) const = 0;
1151  virtual WifiTxVector DoGetDataTxVector (WifiRemoteStation *station) = 0;
1160  virtual WifiTxVector DoGetRtsTxVector (WifiRemoteStation *station) = 0;
1161 
1168  virtual void DoReportRtsFailed (WifiRemoteStation *station) = 0;
1175  virtual void DoReportDataFailed (WifiRemoteStation *station) = 0;
1185  virtual void DoReportRtsOk (WifiRemoteStation *station,
1186  double ctsSnr, WifiMode ctsMode, double rtsSnr) = 0;
1196  virtual void DoReportDataOk (WifiRemoteStation *station,
1197  double ackSnr, WifiMode ackMode, double dataSnr) = 0;
1204  virtual void DoReportFinalRtsFailed (WifiRemoteStation *station) = 0;
1211  virtual void DoReportFinalDataFailed (WifiRemoteStation *station) = 0;
1220  virtual void DoReportRxOk (WifiRemoteStation *station,
1221  double rxSnr, WifiMode txMode) = 0;
1235  virtual void DoReportAmpduTxStatus (WifiRemoteStation *station, uint8_t nSuccessfulMpdus, uint8_t nFailedMpdus, double rxSnr, double dataSnr);
1236 
1252  WifiRemoteStation* Lookup (Mac48Address address, uint8_t tid) const;
1254 
1263  WifiRemoteStation* Lookup (Mac48Address address, const WifiMacHeader *header) const;
1264 
1271  void DoSetFragmentationThreshold (uint32_t threshold);
1277  uint32_t DoGetFragmentationThreshold (void) const;
1286  uint32_t GetNFragments (const WifiMacHeader *header, Ptr<const Packet> packet);
1287 
1305 
1316 
1319 
1322 
1324  uint32_t m_maxSsrc;
1325  uint32_t m_maxSlrc;
1339 
1358 };
1359 
1360 } //namespace ns3
1361 
1362 #endif /* WIFI_REMOTE_STATION_MANAGER_H */
uint8_t GetNMcsSupported(Mac48Address address) const
Return the number of MCS supported by the station.
bool m_useNonHtProtection
flag if protection for non-HT stations against HT transmissions is enabled
uint32_t m_ssrc
STA short retry count.
bool GetRifsPermitted(void) const
Return whether the device can use RIFS.
bool m_shortPreamble
Flag if short PLCP preamble is supported by the remote station.
void AddSupportedMcs(Mac48Address address, WifiMode mcs)
Record the MCS index supported by the station.
uint32_t GetNFragments(const WifiMacHeader *header, Ptr< const Packet > packet)
Return the number of fragments needed for the given packet.
Ptr< WifiMac > GetMac(void) const
Return the WifiMac.
void SetDefaultTxPowerLevel(uint8_t txPower)
Set the default transmission power level.
bool GetVhtSupported(void) const
Return whether the device has VHT capability support enabled.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
uint8_t GetNSupported(const WifiRemoteStation *station) const
Return the number of modes supported by the given station.
std::vector< WifiRemoteStationState * > StationStates
A vector of WifiRemoteStationStates.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
void(* PowerChangeTracedCallback)(double oldPower, double newPower, Mac48Address remoteAddress)
TracedCallback signature for power change events.
uint32_t m_rtsCtsThreshold
Threshold for RTS/CTS.
bool m_shortSlotTimeEnabled
flag if short slot time is enabled
enum ns3::WifiRemoteStationState::@77 m_state
State of the station.
bool GetShortPreambleSupported(Mac48Address address) const
Return whether the station supports short PLCP preamble or not.
void ReportFinalDataFailed(Mac48Address address, const WifiMacHeader *header, uint32_t packetSize)
Should be invoked after calling ReportDataFailed if NeedRetransmission returns false.
void AddAllSupportedMcs(Mac48Address address)
Invoked in a STA or AP to store all of the MCS supported by a destination which is also supported loc...
void RecordWaitAssocTxOk(Mac48Address address)
Records that we are waiting for an ACK for the association response we sent.
virtual void DoReportRtsFailed(WifiRemoteStation *station)=0
This method is a pure virtual method that must be implemented by the sub-class.
static const uint32_t packetSize
WifiMode m_nonUnicastMode
Transmission mode for non-unicast DATA frames.
uint32_t m_nextFragmentationThreshold
Threshold for fragmentation that will be used for the next transmission.
Forward calls to a chain of Callback.
void ReportDataOk(Mac48Address address, const WifiMacHeader *header, double ackSnr, WifiMode ackMode, double dataSnr, uint32_t packetSize)
Should be invoked whenever we receive the Ack associated to a data packet we just sent...
bool GetHeSupported(void) const
Return whether the device has HE capability support enabled.
Ptr< const HeCapabilities > m_heCapabilities
remote station HE capabilities
WifiMode GetDefaultMcs(void) const
Return the default Modulation and Coding Scheme (MCS) index.
uint32_t m_fragmentationThreshold
Current threshold for fragmentation.
The HT Capabilities Information ElementThis class knows how to serialise and deserialise the HT Capab...
uint8_t m_defaultTxPowerLevel
Default tranmission power level.
WifiMode GetNonUnicastMode(void) const
Return a mode for non-unicast packets.
WifiMode GetBasicMcs(uint8_t i) const
Return the MCS at the given list index.
Mac48Address m_address
Mac48Address of the remote station.
bool NeedRts(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, WifiTxVector txVector)
void UpdateFragmentationThreshold(void)
Typically called to update the fragmentation threshold at the start of a new transmission.
void SetPcfSupported(bool enable)
Enable or disable PCF capability support.
bool GetUseNonHtProtection(void) const
Return whether the device supports protection of non-HT stations.
bool IsLastFragment(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber)
TracedCallback< Mac48Address > m_macTxFinalRtsFailed
The trace source fired when the transmission of a RTS has exceeded the maximum number of attempts...
void PrepareForQueue(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
uint32_t GetFragmentationThreshold(void) const
Return the fragmentation threshold.
bool GetUseGreenfieldProtection(void) const
Return whether protection for stations that do not support HT greenfield format is enabled...
WifiMode GetSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether mode associated with the specified station at the specified index. ...
uint8_t GetNBasicMcs(void) const
Return the number of basic MCS index.
uint32_t GetNNonErpSupported(const WifiRemoteStation *station) const
Return the number of non-ERP modes supported by the given station.
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
Definition: wifi-mode.h:97
bool m_shortPreambleEnabled
flag if short PLCP preamble is enabled
virtual bool DoNeedRts(WifiRemoteStation *station, Ptr< const Packet > packet, bool normally)
Tid independent remote station statistics.
WifiRemoteStationState * m_state
Remote station state.
WifiTxVector GetCtsToSelfTxVector(const WifiMacHeader *header, Ptr< const Packet > packet)
void RecordDisassociated(Mac48Address address)
Records that the STA was disassociated.
phy
Definition: third.py:93
TracedCallback< Mac48Address > m_macTxFinalDataFailed
The trace source fired when the transmission of a data packet has exceeded the maximum number of atte...
Class for representing data rates.
Definition: data-rate.h:88
void SetShortSlotTimeEnabled(bool enable)
Enable or disable short slot time.
uint8_t GetNumberOfSupportedStreams(Mac48Address address) const
Return the number of spatial streams supported by the station.
bool GetShortPreambleEnabled(void) const
Return whether the device uses short PLCP preambles.
ProtectionMode
ProtectionMode enumeration.
bool GetGreenfield(const WifiRemoteStation *station) const
Return whether the station supports Greenfield or not.
ProtectionMode m_htProtectionMode
Protection mode for HT stations when non-HT stations are detected.
void SetRtsCtsThreshold(uint32_t threshold)
Sets the RTS threshold.
bool m_qosSupported
Flag if HT is supported by the station.
WifiRemoteStationState * LookupState(Mac48Address address) const
Return the state of the station associated with the given address.
WifiMode m_defaultTxMcs
The default transmission modulation-coding scheme (MCS)
virtual void DoReportRtsOk(WifiRemoteStation *station, double ctsSnr, WifiMode ctsMode, double rtsSnr)=0
This method is a pure virtual method that must be implemented by the sub-class.
Ptr< WifiPhy > m_wifiPhy
This is a pointer to the WifiPhy associated with this WifiRemoteStationManager that is set on call to...
virtual void DoReportRxOk(WifiRemoteStation *station, double rxSnr, WifiMode txMode)=0
This method is a pure virtual method that must be implemented by the sub-class.
void ReportRtsFailed(Mac48Address address, const WifiMacHeader *header)
Should be invoked whenever the RtsTimeout associated to a transmission attempt expires.
bool GetPcfSupported(void) const
Return whether the device has PCF capability support enabled.
bool GetShortSlotTimeSupported(Mac48Address address) const
Return whether the station supports short ERP slot time or not.
The IEEE 802.11ac VHT Capabilities.
bool m_useNonErpProtection
flag if protection for non-ERP stations against ERP transmissions is enabled
virtual void DoReportDataFailed(WifiRemoteStation *station)=0
This method is a pure virtual method that must be implemented by the sub-class.
void RecordGotAssocTxFailed(Mac48Address address)
Records that we missed an ACK for the association response we sent.
bool GetHtSupported(void) const
Return whether the device has HT capability support enabled.
void AddStationHtCapabilities(Mac48Address from, HtCapabilities htcapabilities)
Records HT capabilities of the remote station.
mac
Definition: third.py:99
WifiRemoteStationInfo GetInfo(Mac48Address address)
void SetMaxSsrc(uint32_t maxSsrc)
Sets the maximum STA short retry count (SSRC).
uint32_t m_maxSlrc
Maximum STA long retry count (SLRC)
bool m_pcfSupported
Flag if PCF capability is supported.
Ptr< const HeCapabilities > GetStationHeCapabilities(Mac48Address from)
Return the HE capabilities sent by the remote station.
bool NeedRetransmission(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
Ptr< WifiMac > m_wifiMac
This is a pointer to the WifiMac associated with this WifiRemoteStationManager that is set on call to...
Ptr< const VhtCapabilities > m_vhtCapabilities
remote station VHT capabilities
uint32_t GetNNonErpBasicModes(void) const
Return the number of non-ERP basic modes we support.
Ptr< const HtCapabilities > m_htCapabilities
remote station HT capabilities
WifiMode GetNonErpBasicMode(uint8_t i) const
Return a basic mode from the set of basic modes that is not an ERP mode.
void AddStationHeCapabilities(Mac48Address from, HeCapabilities hecapabilities)
Records HE capabilities of the remote station.
bool IsAssociated(Mac48Address address) const
Return whether the station associated.
virtual 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...
hold a list of per-remote-station state.
bool GetQosSupported(Mac48Address address) const
Return whether the given station is QoS capable.
Ptr< const HtCapabilities > GetStationHtCapabilities(Mac48Address from)
Return the HT capabilities sent by the remote station.
WifiMode GetDefaultMode(void) const
Return the default transmission mode.
void SetQosSupport(Mac48Address from, bool qosSupported)
Records QoS support of the remote station.
WifiMode m_defaultTxMode
The default transmission mode.
WifiModeList m_bssBasicRateSet
This member is the list of WifiMode objects that comprise the BSSBasicRateSet parameter.
uint32_t GetFragmentOffset(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber)
bool GetShortSlotTimeEnabled(void) const
Return whether the device uses short slot time.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
address
Definition: first.py:37
WifiTxVector DoGetCtsToSelfTxVector(void)
Since CTS-to-self parameters are not dependent on the station, it is implemented in wifiremote statio...
void AddSupportedMode(Mac48Address address, WifiMode mode)
Invoked in a STA or AP to store the set of modes supported by a destination which is also supported l...
WifiModeList m_operationalRateSet
This member is the list of WifiMode objects that comprise the OperationalRateSet parameter for this r...
uint32_t GetFragmentSize(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet, uint32_t fragmentNumber)
void DoSetFragmentationThreshold(uint32_t threshold)
Actually sets the fragmentation threshold, it also checks the validity of the given threshold...
void AddBasicMode(WifiMode mode)
Invoked in a STA upon association to store the set of rates which belong to the BSSBasicRateSet of th...
void SetUseNonErpProtection(bool enable)
Enable or disable protection for non-ERP stations.
bool UseGreenfieldForDestination(Mac48Address dest) const
bool m_useGreenfieldProtection
flag if protection for stations that do not support HT greenfield format is enabled ...
bool m_aggregation
Flag if MPDU aggregation is used by the remote station.
an EUI-48 address
Definition: mac48-address.h:43
TracedCallback< Mac48Address > m_macTxRtsFailed
The trace source fired when the transmission of a single RTS has failed.
virtual bool IsLowLatency(void) const =0
Mac48Address GetAddress(const WifiRemoteStation *station) const
Return the address of the station.
WifiMode GetNonErpSupported(const WifiRemoteStation *station, uint8_t i) const
Return whether non-ERP mode associated with the specified station at the specified index...
std::vector< WifiMode > WifiModeList
In various parts of the code, folk are interested in maintaining a list of transmission modes...
Definition: wifi-mode.h:252
bool GetShortGuardIntervalSupported(void) const
Return whether the device has SGI support enabled.
Stations m_stations
Information for each known stations.
void ReportRtsOk(Mac48Address address, const WifiMacHeader *header, double ctsSnr, WifiMode ctsMode, double rtsSnr)
Should be invoked whenever we receive the Cts associated to an RTS we just sent.
TracedCallback< Mac48Address > m_macTxDataFailed
The trace source fired when the transmission of a single data packet has failed.
bool GetAggregation(const WifiRemoteStation *station) const
Return whether the given station supports A-MPDU.
uint16_t m_channelWidth
Channel width (in MHz) supported by the remote station.
virtual bool DoNeedRetransmission(WifiRemoteStation *station, Ptr< const Packet > packet, bool normally)
void AddBasicMcs(WifiMode mcs)
Add a given Modulation and Coding Scheme (MCS) index to the set of basic MCS.
void AddSupportedPlcpPreamble(Mac48Address address, bool isShortPreambleSupported)
Record whether the short PLCP preamble is supported by the station.
virtual bool DoNeedFragmentation(WifiRemoteStation *station, Ptr< const Packet > packet, bool normally)
bool NeedCtsToSelf(WifiTxVector txVector)
Return if we need to do Cts-to-self before sending a DATA.
uint8_t GetNBasicModes(void) const
Return the number of basic modes we support.
void SetUseNonHtProtection(bool enable)
Enable or disable protection for non-HT stations.
virtual void SetupMac(const Ptr< WifiMac > mac)
Set up MAC associated with this device since it is the object that knows the full set of timing param...
void SetMaxSlrc(uint32_t maxSlrc)
Sets the maximum STA long retry count (SLRC).
Ptr< WifiPhy > GetPhy(void) const
Return the WifiPhy.
void ReportDataFailed(Mac48Address address, const WifiMacHeader *header, uint32_t packetSize)
Should be invoked whenever the AckTimeout associated to a transmission attempt expires.
WifiTxVector GetDataTxVector(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
uint16_t GetGuardInterval(void) const
Return the supported HE guard interval duration (in nanoseconds).
A struct that holds information about each remote station.
WifiModeList m_operationalMcsSet
operational MCS set
static TypeId GetTypeId(void)
Get the type ID.
void AddSupportedErpSlotTime(Mac48Address address, bool isShortSlotTimeSupported)
Record whether the short ERP slot time is supported by the station.
void SetFragmentationThreshold(uint32_t threshold)
Sets a fragmentation threshold.
void Reset(void)
Reset the station, invoked in a STA upon dis-association or in an AP upon reboot. ...
bool GetUseNonErpProtection(void) const
Return whether the device supports protection of non-ERP stations.
uint32_t m_maxSsrc
Maximum STA short retry count (SSRC)
virtual void DoDispose(void)
Destructor implementation.
Ptr< const VhtCapabilities > GetStationVhtCapabilities(Mac48Address from)
Return the VHT capabilities sent by the remote station.
bool GetGreenfieldSupported(void) const
Return whether the device has HT Greenfield support enabled.
void ReportRxOk(Mac48Address address, const WifiMacHeader *header, double rxSnr, WifiMode txMode)
void SetUseGreenfieldProtection(bool enable)
Enable or disable protection for stations that do not support HT greenfield format.
bool NeedFragmentation(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
WifiRemoteStation * Lookup(Mac48Address address, uint8_t tid) const
Return the station associated with the given address and TID.
uint8_t m_ness
Number of streams in beamforming of the remote station.
bool m_shortSlotTime
Flag if short ERP slot time is supported by the remote station.
void ReportAmpduTxStatus(Mac48Address address, uint8_t tid, uint8_t nSuccessfulMpdus, uint8_t nFailedMpdus, double rxSnr, double dataSnr)
Typically called per A-MPDU, either when a Block ACK was successfully received or when a BlockAckTime...
WifiTxVector GetRtsTxVector(Mac48Address address, const WifiMacHeader *header, Ptr< const Packet > packet)
A base class which provides memory management and object aggregation.
Definition: object.h:87
virtual void DoReportAmpduTxStatus(WifiRemoteStation *station, uint8_t nSuccessfulMpdus, uint8_t nFailedMpdus, double rxSnr, double dataSnr)
Typically called per A-MPDU, either when a Block ACK was successfully received or when a BlockAckTime...
StationStates m_states
States of known stations.
bool IsWaitAssocTxOk(Mac48Address address) const
Return whether we are waiting for an ACK for the association response we sent.
void SetShortPreambleEnabled(bool enable)
Enable or disable short PLCP preambles.
ProtectionMode m_erpProtectionMode
Protection mode for ERP stations when non-ERP stations are detected.
WifiMode GetBasicMode(uint8_t i) const
Return a basic mode from the set of basic modes.
uint32_t m_slrc
STA long retry count.
void AddAllSupportedModes(Mac48Address address)
Invoked in a STA or AP to store all of the modes supported by a destination which is also supported l...
virtual WifiTxVector DoGetDataTxVector(WifiRemoteStation *station)=0
The IEEE 802.11ax HE Capabilities.
virtual void DoReportFinalDataFailed(WifiRemoteStation *station)=0
This method is a pure virtual method that must be implemented by the sub-class.
void(* RateChangeTracedCallback)(DataRate oldRate, DataRate newRate, Mac48Address remoteAddress)
TracedCallback signature for rate change events.
virtual WifiTxVector DoGetRtsTxVector(WifiRemoteStation *station)=0
bool IsBrandNew(Mac48Address address) const
Return whether the station state is brand new.
a unique identifier for an interface.
Definition: type-id.h:58
bool m_rifsPermitted
flag if RIFS is enabled
void ReportFinalRtsFailed(Mac48Address address, const WifiMacHeader *header)
Should be invoked after calling ReportRtsFailed if NeedRetransmission returns false.
void RemoveAllSupportedMcs(Mac48Address address)
Invoked in a STA or AP to delete all of the supported MCS by a destination.
WifiRemoteStationInfo m_info
remote station info
WifiModeList m_bssBasicMcsSet
basic MCS set
virtual void DoReportFinalRtsFailed(WifiRemoteStation *station)=0
This method is a pure virtual method that must be implemented by the sub-class.
hold per-remote-station state.
void SetRifsPermitted(bool allow)
Permit or prohibit RIFS.
virtual WifiRemoteStation * DoCreateStation(void) const =0
void RecordGotAssocTxOk(Mac48Address address)
Records that we got an ACK for the association response we sent.
void AddStationVhtCapabilities(Mac48Address from, VhtCapabilities vhtcapabilities)
Records VHT capabilities of the remote station.
Implements the IEEE 802.11 MAC header.
WifiMode GetMcsSupported(const WifiRemoteStation *station, uint8_t i) const
Return the WifiMode supported by the specified station at the specified index.
uint16_t GetChannelWidthSupported(Mac48Address address) const
Return the channel width supported by the station.
virtual void DoReportDataOk(WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr)=0
This method is a pure virtual method that must be implemented by the sub-class.
uint16_t GetChannelWidth(const WifiRemoteStation *station) const
Return the channel width supported by the station.
uint8_t GetNess(const WifiRemoteStation *station) const
uint16_t m_guardInterval
HE Guard interval duration (in nanoseconds) supported by the remote station.
uint32_t DoGetFragmentationThreshold(void) const
Return the current fragmentation threshold.
std::vector< WifiRemoteStation * > Stations
A vector of WifiRemoteStations.