A Discrete-Event Network Simulator
API
rr-multi-user-scheduler.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020 Universita' degli Studi di Napoli Federico II
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: Stefano Avallone <stavallo@unina.it>
18  */
19 
20 #ifndef RR_MULTI_USER_SCHEDULER_H
21 #define RR_MULTI_USER_SCHEDULER_H
22 
23 #include "multi-user-scheduler.h"
24 
25 #include <list>
26 
27 namespace ns3
28 {
29 
45 {
46  public:
51  static TypeId GetTypeId();
53  ~RrMultiUserScheduler() override;
54 
55  protected:
56  void DoDispose() override;
57  void DoInitialize() override;
58 
59  private:
60  TxFormat SelectTxFormat() override;
61  DlMuInfo ComputeDlMuInfo() override;
62  UlMuInfo ComputeUlMuInfo() override;
63 
70  virtual TxFormat TrySendingBsrpTf();
71 
79  virtual TxFormat TrySendingBasicTf();
80 
89  virtual TxFormat TrySendingDlMuPpdu();
90 
101  template <class Func>
102  WifiTxVector GetTxVectorForUlMu(Func canBeSolicited);
103 
110  void NotifyStationAssociated(uint16_t aid, Mac48Address address);
117  void NotifyStationDeassociated(uint16_t aid, Mac48Address address);
118 
122  struct MasterInfo
123  {
124  uint16_t aid;
126  double credits;
127  };
128 
140  void FinalizeTxVector(WifiTxVector& txVector);
149  void UpdateCredits(std::list<MasterInfo>& staList,
150  Time txDuration,
151  const WifiTxVector& txVector);
152 
156  typedef std::pair<std::list<MasterInfo>::iterator, Ptr<WifiMpdu>> CandidateInfo;
157 
158  uint8_t m_nStations;
164  uint32_t m_ulPsduSize;
165  std::map<AcIndex, std::list<MasterInfo>>
167  std::list<MasterInfo> m_staListUl;
168  std::list<CandidateInfo> m_candidates;
173 };
174 
175 } // namespace ns3
176 
177 #endif /* RR_MULTI_USER_SCHEDULER_H */
Headers for Trigger frames.
Definition: ctrl-headers.h:942
an EUI-48 address
Definition: mac48-address.h:46
MultiUserScheduler is an abstract base class defining the API that APs supporting at least VHT can us...
TxFormat
Enumeration of the possible transmission formats.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:77
RrMultiUserScheduler is a simple OFDMA scheduler that indicates to perform a DL OFDMA transmission if...
TxFormat SelectTxFormat() override
Select the format of the next transmission.
bool m_enableBsrp
send a BSRP before an UL MU transmission
void NotifyStationAssociated(uint16_t aid, Mac48Address address)
Notify the scheduler that a station associated with the AP.
static TypeId GetTypeId()
Get the type ID.
uint32_t m_ulPsduSize
the size in byte of the solicited PSDU
std::list< CandidateInfo > m_candidates
Candidate stations for MU TX.
bool m_useCentral26TonesRus
whether to allocate central 26-tone RUs
bool m_forceDlOfdma
return DL_OFDMA even if no DL MU PPDU was built
bool m_enableUlOfdma
enable the scheduler to also return UL_OFDMA
std::pair< std::list< MasterInfo >::iterator, Ptr< WifiMpdu > > CandidateInfo
Information stored for candidate stations.
void DoInitialize() override
Initialize() implementation.
UlMuInfo ComputeUlMuInfo() override
Prepare the information required to solicit an UL MU transmission.
DlMuInfo ComputeDlMuInfo() override
Compute the information required to perform a DL MU transmission.
void DoDispose() override
Destructor implementation.
void UpdateCredits(std::list< MasterInfo > &staList, Time txDuration, const WifiTxVector &txVector)
Update credits of the stations in the given list considering that a PPDU having the given duration is...
WifiMacHeader m_triggerMacHdr
MAC header for Trigger Frame.
uint8_t m_nStations
Number of stations/slots to fill.
WifiTxParameters m_txParams
TX parameters.
virtual TxFormat TrySendingDlMuPpdu()
Check if it is possible to send a DL MU PPDU given the current time limits.
void NotifyStationDeassociated(uint16_t aid, Mac48Address address)
Notify the scheduler that a station deassociated with the AP.
Time m_maxCredits
Max amount of credits a station can have.
bool m_enableTxopSharing
allow A-MPDUs of different TIDs in a DL MU PPDU
CtrlTriggerHeader m_trigger
Trigger Frame to send.
std::map< AcIndex, std::list< MasterInfo > > m_staListDl
Per-AC list of stations (next to serve for DL first)
virtual TxFormat TrySendingBsrpTf()
Check if it is possible to send a BSRP Trigger Frame given the current time limits.
WifiTxVector GetTxVectorForUlMu(Func canBeSolicited)
Compute a TXVECTOR that can be used to construct a Trigger Frame to solicit transmissions from suitab...
virtual TxFormat TrySendingBasicTf()
Check if it is possible to send a Basic Trigger Frame given the current time limits.
void FinalizeTxVector(WifiTxVector &txVector)
Finalize the given TXVECTOR by only including the largest subset of the current set of candidate stat...
std::list< MasterInfo > m_staListUl
List of stations to serve for UL.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
a unique identifier for an interface.
Definition: type-id.h:59
Implements the IEEE 802.11 MAC header.
This class stores the TX parameters (TX vector, protection mechanism, acknowledgment mechanism,...
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
address
Definition: first.py:47
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Information to be provided in case of DL MU transmission.
Information to be provided in case of UL MU transmission.
Information used to sort stations.
Mac48Address address
station's MAC Address
double credits
credits accumulated by the station