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 <array>
25 #include "ns3/traced-callback.h"
26 #include "ns3/object.h"
27 #include "ns3/data-rate.h"
28 #include "ns3/mac48-address.h"
29 #include "wifi-mode.h"
30 #include "wifi-utils.h"
31 #include "qos-utils.h"
33 #include "ns3/ht-capabilities.h"
34 #include "ns3/vht-capabilities.h"
35 #include "ns3/he-capabilities.h"
36 
37 namespace ns3 {
38 
39 class WifiPhy;
40 class WifiMac;
41 class WifiMacHeader;
42 class Packet;
43 class WifiMacQueueItem;
44 class WifiTxVector;
45 
46 struct WifiRemoteStationState;
47 struct RxSignalInfo;
48 
61 {
62  virtual ~WifiRemoteStation () {};
64  std::pair<double, Time> m_rssiAndUpdateTimePair;
65 };
66 
71 {
75  enum
76  {
81  } m_state;
82 
99 
100  uint16_t m_channelWidth;
101  uint16_t m_guardInterval;
102  uint8_t m_ness;
107 };
108 
116 {
117 public:
122  static TypeId GetTypeId (void);
123 
125  virtual ~WifiRemoteStationManager ();
126 
129  {
132  };
133 
137  typedef std::vector <WifiRemoteStation *> Stations;
141  typedef std::vector <WifiRemoteStationState *> StationStates;
142 
149  virtual void SetupPhy (const Ptr<WifiPhy> phy);
156  virtual void SetupMac (const Ptr<WifiMac> mac);
157 
166  virtual int64_t AssignStreams (int64_t stream);
167 
173  void SetMaxSsrc (uint32_t maxSsrc);
179  void SetMaxSlrc (uint32_t maxSlrc);
185  void SetRtsCtsThreshold (uint32_t threshold);
186 
192  uint32_t GetFragmentationThreshold (void) const;
199  void SetFragmentationThreshold (uint32_t threshold);
200 
207  void SetQosSupport (Mac48Address from, bool qosSupported);
214  void AddStationHtCapabilities (Mac48Address from, HtCapabilities htCapabilities);
221  void AddStationVhtCapabilities (Mac48Address from, VhtCapabilities vhtCapabilities);
228  void AddStationHeCapabilities (Mac48Address from, HeCapabilities heCapabilities);
255  bool GetHtSupported (void) const;
261  bool GetVhtSupported (void) const;
267  bool GetHeSupported (void) const;
273  bool GetLdpcSupported (void) const;
279  bool GetShortGuardIntervalSupported (void) const;
285  uint16_t GetGuardInterval (void) const;
291  void SetUseNonErpProtection (bool enable);
298  bool GetUseNonErpProtection (void) const;
304  void SetUseNonHtProtection (bool enable);
311  bool GetUseNonHtProtection (void) const;
317  void SetShortPreambleEnabled (bool enable);
324  bool GetShortPreambleEnabled (void) const;
330  void SetShortSlotTimeEnabled (bool enable);
337  bool GetShortSlotTimeEnabled (void) const;
338 
342  void Reset (void);
343 
351  void AddBasicMode (WifiMode mode);
357  WifiMode GetDefaultMode (void) const;
363  uint8_t GetNBasicModes (void) const;
371  WifiMode GetBasicMode (uint8_t i) const;
377  uint32_t GetNNonErpBasicModes (void) const;
385  WifiMode GetNonErpBasicMode (uint8_t i) const;
421  bool GetQosSupported (Mac48Address address) const;
428  void AddBasicMcs (WifiMode mcs);
434  WifiMode GetDefaultMcs (void) const;
440  uint8_t GetNBasicMcs (void) const;
448  WifiMode GetBasicMcs (uint8_t i) const;
488  uint8_t GetNMcsSupported (Mac48Address address) const;
497  bool GetHtSupported (Mac48Address address) const;
506  bool GetVhtSupported (Mac48Address address) const;
515  bool GetHeSupported (Mac48Address address) const;
516 
522  WifiMode GetNonUnicastMode (void) const;
523 
562  void AddSupportedPhyPreamble (Mac48Address address, bool isShortPreambleSupported);
569  void AddSupportedErpSlotTime (Mac48Address address, bool isShortSlotTimeSupported);
578  bool IsBrandNew (Mac48Address address) const;
587  bool IsAssociated (Mac48Address address) const;
597  bool IsWaitAssocTxOk (Mac48Address address) const;
625 
647  WifiTxVector GetCtsTxVector (Mac48Address to, WifiMode rtsTxMode) const;
664  WifiTxVector GetAckTxVector (Mac48Address to, const WifiTxVector& dataTxVector) const;
673  WifiTxVector GetBlockAckTxVector (Mac48Address to, const WifiTxVector& dataTxVector) const;
680  WifiMode GetControlAnswerMode (WifiMode reqMode) const;
681 
688  void ReportRtsFailed (const WifiMacHeader& header);
706  void ReportRtsOk (const WifiMacHeader& header,
707  double ctsSnr, WifiMode ctsMode, double rtsSnr);
718  void ReportDataOk (Ptr<const WifiMacQueueItem> mpdu, double ackSnr,
719  WifiMode ackMode, double dataSnr, WifiTxVector dataTxVector);
726  void ReportFinalRtsFailed (const WifiMacHeader& header);
746  void ReportAmpduTxStatus (Mac48Address address, uint16_t nSuccessfulMpdus, uint16_t nFailedMpdus,
747  double rxSnr, double dataSnr, WifiTxVector dataTxVector);
748 
756  void ReportRxOk (Mac48Address address, RxSignalInfo rxSignalInfo, WifiTxVector txVector);
757 
765  bool NeedRts (const WifiMacHeader &header, uint32_t size);
774  bool NeedCtsToSelf (WifiTxVector txVector);
775 
796  uint32_t GetFragmentSize (Ptr<const WifiMacQueueItem> mpdu, uint32_t fragmentNumber);
803  uint32_t GetFragmentOffset (Ptr<const WifiMacQueueItem> mpdu, uint32_t fragmentNumber);
810  bool IsLastFragment (Ptr<const WifiMacQueueItem> mpdu, uint32_t fragmentNumber);
811 
815  uint8_t GetDefaultTxPowerLevel (void) const;
831  double GetMostRecentRssi (Mac48Address address) const;
837  void SetDefaultTxPowerLevel (uint8_t txPower);
841  uint8_t GetNumberOfAntennas (void) const;
845  uint8_t GetMaxNumberOfTransmitStreams (void) const;
853  bool UseLdpcForDestination (Mac48Address dest) const;
854 
862  typedef void (*PowerChangeTracedCallback)(double oldPower, double newPower, Mac48Address remoteAddress);
863 
871  typedef void (*RateChangeTracedCallback)(DataRate oldRate, DataRate newRate, Mac48Address remoteAddress);
872 
878  Ptr<WifiPhy> GetPhy (void) const;
884  Ptr<WifiMac> GetMac (void) const;
885 
886 
887 protected:
888  virtual void DoDispose (void);
897  WifiMode GetSupported (const WifiRemoteStation *station, uint8_t i) const;
905  uint8_t GetNSupported (const WifiRemoteStation *station) const;
914  bool GetQosSupported (const WifiRemoteStation *station) const;
923  bool GetHtSupported (const WifiRemoteStation *station) const;
932  bool GetVhtSupported (const WifiRemoteStation *station) const;
941  bool GetHeSupported (const WifiRemoteStation *station) const;
951  WifiMode GetMcsSupported (const WifiRemoteStation *station, uint8_t i) const;
959  uint8_t GetNMcsSupported (const WifiRemoteStation *station) const;
968  WifiMode GetNonErpSupported (const WifiRemoteStation *station, uint8_t i) const;
976  uint32_t GetNNonErpSupported (const WifiRemoteStation *station) const;
984  Mac48Address GetAddress (const WifiRemoteStation *station) const;
992  uint16_t GetChannelWidth (const WifiRemoteStation *station) const;
1001  bool GetShortGuardIntervalSupported (const WifiRemoteStation *station) const;
1009  uint16_t GetGuardInterval (const WifiRemoteStation *station) const;
1018  bool GetAggregation (const WifiRemoteStation *station) const;
1019 
1027  uint8_t GetNumberOfSupportedStreams (const WifiRemoteStation *station) const;
1035  uint8_t GetNess (const WifiRemoteStation *station) const;
1036 
1037 
1038 private:
1044  uint16_t GetStaId (Mac48Address address, const WifiTxVector& txVector) const;
1045 
1057  virtual bool DoNeedRts (WifiRemoteStation *station,
1058  uint32_t size, bool normally);
1070  virtual bool DoNeedRetransmission (WifiRemoteStation *station,
1071  Ptr<const Packet> packet, bool normally);
1083  virtual bool DoNeedFragmentation (WifiRemoteStation *station,
1084  Ptr<const Packet> packet, bool normally);
1088  virtual WifiRemoteStation* DoCreateStation (void) const = 0;
1097  virtual WifiTxVector DoGetDataTxVector (WifiRemoteStation *station) = 0;
1106  virtual WifiTxVector DoGetRtsTxVector (WifiRemoteStation *station) = 0;
1107 
1114  virtual void DoReportRtsFailed (WifiRemoteStation *station) = 0;
1121  virtual void DoReportDataFailed (WifiRemoteStation *station) = 0;
1131  virtual void DoReportRtsOk (WifiRemoteStation *station,
1132  double ctsSnr, WifiMode ctsMode, double rtsSnr) = 0;
1144  virtual void DoReportDataOk (WifiRemoteStation *station, double ackSnr, WifiMode ackMode,
1145  double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss) = 0;
1152  virtual void DoReportFinalRtsFailed (WifiRemoteStation *station) = 0;
1159  virtual void DoReportFinalDataFailed (WifiRemoteStation *station) = 0;
1168  virtual void DoReportRxOk (WifiRemoteStation *station,
1169  double rxSnr, WifiMode txMode) = 0;
1185  virtual void DoReportAmpduTxStatus (WifiRemoteStation *station, uint16_t nSuccessfulMpdus, uint16_t nFailedMpdus,
1186  double rxSnr, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss);
1187 
1203 
1210  void DoSetFragmentationThreshold (uint32_t threshold);
1216  uint32_t DoGetFragmentationThreshold (void) const;
1225 
1243 
1254 
1257 
1260 
1261  uint32_t m_maxSsrc;
1262  uint32_t m_maxSlrc;
1273 
1274  std::array<uint32_t, AC_BE_NQOS> m_ssrc;
1275  std::array<uint32_t, AC_BE_NQOS> m_slrc;
1276 
1295 };
1296 
1297 } //namespace ns3
1298 
1299 #endif /* WIFI_REMOTE_STATION_MANAGER_H */
std::array< uint32_t, AC_BE_NQOS > m_ssrc
short retry count per AC
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
bool m_shortPreamble
Flag if short PHY preamble is supported by the remote station.
void AddSupportedMcs(Mac48Address address, WifiMode mcs)
Record the MCS index supported by the station.
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 PHY preamble or not.
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...
std::array< uint32_t, AC_BE_NQOS > m_slrc
long retry count per AC
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.
WifiMode m_nonUnicastMode
Transmission mode for non-unicast Data frames.
Forward calls to a chain of Callback.
void AddStationVhtCapabilities(Mac48Address from, VhtCapabilities vhtCapabilities)
Records VHT capabilities of the remote station.
void ReportFinalDataFailed(Ptr< const WifiMacQueueItem > mpdu)
Should be invoked after calling ReportDataFailed if NeedRetransmission returns false.
bool GetHeSupported(void) const
Return whether the device has HE capability support enabled.
void ReportAmpduTxStatus(Mac48Address address, uint16_t nSuccessfulMpdus, uint16_t nFailedMpdus, double rxSnr, double dataSnr, WifiTxVector dataTxVector)
Typically called per A-MPDU, either when a Block ACK was successfully received or when a BlockAckTime...
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 transmission power level.
void ReportDataFailed(Ptr< const WifiMacQueueItem > mpdu)
Should be invoked whenever the AckTimeout associated to a transmission attempt expires.
void AddSupportedPhyPreamble(Mac48Address address, bool isShortPreambleSupported)
Record whether the short PHY preamble is supported by the station.
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 GetUseNonHtProtection(void) const
Return whether the device supports protection of non-HT stations.
uint32_t GetNFragments(Ptr< const WifiMacQueueItem > mpdu)
Return the number of fragments needed for the given packet.
TracedCallback< Mac48Address > m_macTxFinalRtsFailed
The trace source fired when the transmission of a RTS has exceeded the maximum number of attempts...
uint32_t GetFragmentationThreshold(void) const
Return the fragmentation threshold.
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.
void ReportRtsFailed(const WifiMacHeader &header)
Should be invoked whenever the RtsTimeout associated to a transmission attempt expires.
virtual int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model...
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:47
bool m_shortPreambleEnabled
flag if short PHY preamble is enabled
bool NeedFragmentation(Ptr< const WifiMacQueueItem > mpdu)
TID independent remote station statistics.
bool NeedRetransmission(Ptr< const WifiMacQueueItem > mpdu)
void ReportRtsOk(const WifiMacHeader &header, double ctsSnr, WifiMode ctsMode, double rtsSnr)
Should be invoked whenever we receive the CTS associated to an RTS we just sent.
WifiRemoteStationState * m_state
Remote station state.
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...
WifiMode GetControlAnswerMode(WifiMode reqMode) const
Get control answer mode function.
Class for representing data rates.
Definition: data-rate.h:88
void SetShortSlotTimeEnabled(bool enable)
Enable or disable short slot time.
WifiTxVector GetDataTxVector(const WifiMacHeader &header)
std::pair< double, Time > m_rssiAndUpdateTimePair
RSSI (in dBm) of the most recent packet received from the remote station along with update 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 PHY preambles.
ProtectionMode
ProtectionMode enumeration.
RxSignalInfo structure containing info on the received signal.
Definition: phy-entity.h:66
ProtectionMode m_htProtectionMode
Protection mode for HT stations when non-HT stations are detected.
void SetRtsCtsThreshold(uint32_t threshold)
Sets the RTS threshold.
bool GetLdpcSupported(void) const
Return whether the device has LDPC support enabled.
bool m_qosSupported
Flag if QoS 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.
bool GetShortSlotTimeSupported(Mac48Address address) const
Return whether the station supports short ERP slot time or not.
The IEEE 802.11ac VHT Capabilities.
void AddStationHtCapabilities(Mac48Address from, HtCapabilities htCapabilities)
Records HT capabilities of the remote station.
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.
mac
Definition: third.py:99
WifiRemoteStationInfo GetInfo(Mac48Address address)
void SetMaxSsrc(uint32_t maxSsrc)
Sets the maximum STA short retry count (SSRC).
virtual void DoReportAmpduTxStatus(WifiRemoteStation *station, uint16_t nSuccessfulMpdus, uint16_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...
void AddStationHeCapabilities(Mac48Address from, HeCapabilities heCapabilities)
Records HE capabilities of the remote station.
uint32_t m_maxSlrc
Maximum STA long retry count (SLRC)
Ptr< const HeCapabilities > GetStationHeCapabilities(Mac48Address from)
Return the HE capabilities sent by the remote station.
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
void ReportDataOk(Ptr< const WifiMacQueueItem > mpdu, double ackSnr, WifiMode ackMode, double dataSnr, WifiTxVector dataTxVector)
Should be invoked whenever we receive the ACK associated to a data packet we just sent...
uint32_t GetNNonErpBasicModes(void) const
Return the number of non-ERP basic modes we support.
WifiTxVector GetCtsTxVector(Mac48Address to, WifiMode rtsTxMode) const
Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS used by the sender...
WifiTxVector GetCtsToSelfTxVector(void)
Since CTS-to-self parameters are not dependent on the station, it is implemented in wifi remote stati...
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.
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.
bool NeedRts(const WifiMacHeader &header, uint32_t size)
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.
bool GetShortSlotTimeEnabled(void) const
Return whether the device uses short slot time.
uint16_t GetStaId(Mac48Address address, const WifiTxVector &txVector) const
If the given TXVECTOR is used for a MU transmission, return the STAID of the station with the given a...
Every class exported by the ns3 library is enclosed in the ns3 namespace.
bool IsLastFragment(Ptr< const WifiMacQueueItem > mpdu, uint32_t fragmentNumber)
address
Definition: first.py:44
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...
void DoSetFragmentationThreshold(uint32_t threshold)
Actually sets the fragmentation threshold, it also checks the validity of the given threshold...
double GetMostRecentRssi(Mac48Address address) const
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.
uint32_t GetFragmentOffset(Ptr< const WifiMacQueueItem > mpdu, uint32_t fragmentNumber)
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 void DoReportDataOk(WifiRemoteStation *station, double ackSnr, WifiMode ackMode, double dataSnr, uint16_t dataChannelWidth, uint8_t dataNss)=0
This method is a pure virtual method that must be implemented by the sub-class.
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:254
bool GetShortGuardIntervalSupported(void) const
Return whether the device has SGI support enabled.
Stations m_stations
Information for each known stations.
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 ReportFinalRtsFailed(const WifiMacHeader &header)
Should be invoked after calling ReportRtsFailed if NeedRetransmission returns false.
void AddBasicMcs(WifiMode mcs)
Add a given Modulation and Coding Scheme (MCS) index to the set of basic MCS.
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.
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.
WifiTxVector GetRtsTxVector(Mac48Address address)
uint8_t m_ness
Number of extended spatial streams of the remote station.
WifiTxVector GetBlockAckTxVector(Mac48Address to, const WifiTxVector &dataTxVector) const
Return a TXVECTOR for the BlockAck frame given the destination and the mode of the Data used by the s...
bool UseLdpcForDestination(Mac48Address dest) const
bool m_shortSlotTime
Flag if short ERP slot time is supported by the remote station.
A base class which provides memory management and object aggregation.
Definition: object.h:87
WifiTxVector GetAckTxVector(Mac48Address to, const WifiTxVector &dataTxVector) const
Return a TXVECTOR for the Ack frame given the destination and the mode of the Data used by the sender...
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 PHY preambles.
virtual bool DoNeedRts(WifiRemoteStation *station, uint32_t size, bool normally)
void ReportRxOk(Mac48Address address, RxSignalInfo rxSignalInfo, WifiTxVector txVector)
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.
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.
uint32_t GetFragmentSize(Ptr< const WifiMacQueueItem > mpdu, uint32_t fragmentNumber)
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
WifiRemoteStation * Lookup(Mac48Address address) const
Return the station associated with the given address.
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.
virtual WifiRemoteStation * DoCreateStation(void) const =0
void RecordGotAssocTxOk(Mac48Address address)
Records that we got an ACK for the association response we sent.
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.
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.