A Discrete-Event Network Simulator
API
mpdu-aggregator.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2013
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: Ghada Badawy <gbadawy@gmail.com>
18  */
19 
20 #ifndef MPDU_AGGREGATOR_H
21 #define MPDU_AGGREGATOR_H
22 
23 #include "qos-utils.h"
24 #include "wifi-mode.h"
25 
26 #include "ns3/nstime.h"
27 #include "ns3/object.h"
28 
29 #include <vector>
30 
31 namespace ns3
32 {
33 
34 class AmpduSubframeHeader;
35 class WifiTxVector;
36 class QosTxop;
37 class Packet;
38 class WifiMac;
39 class WifiMpdu;
40 class WifiTxParameters;
41 class HtFrameExchangeManager;
42 
47 class MpduAggregator : public Object
48 {
49  public:
53  typedef std::map<AcIndex, Ptr<QosTxop>> EdcaQueues;
54 
59  static TypeId GetTypeId();
60 
61  MpduAggregator() = default;
62  ~MpduAggregator() override = default;
63 
71  static void Aggregate(Ptr<const WifiMpdu> mpdu, Ptr<Packet> ampdu, bool isSingle);
72 
78  void SetLinkId(uint8_t linkId);
79 
88  static uint32_t GetSizeIfAggregated(uint32_t mpduSize, uint32_t ampduSize);
89 
99  uint32_t GetMaxAmpduSize(Mac48Address recipient,
100  uint8_t tid,
101  WifiModulationClass modulation) const;
102 
134  std::vector<Ptr<WifiMpdu>> GetNextAmpdu(Ptr<WifiMpdu> mpdu,
135  WifiTxParameters& txParams,
136  Time availableTime) const;
137 
143  void SetWifiMac(const Ptr<WifiMac> mac);
144 
153  static uint8_t CalculatePadding(uint32_t ampduSize);
154 
163  static AmpduSubframeHeader GetAmpduSubframeHeader(uint16_t mpduSize, bool isSingle);
164 
165  protected:
166  void DoDispose() override;
167 
168  private:
171  uint8_t m_linkId{0};
172 };
173 
174 } // namespace ns3
175 
176 #endif /* MPDU_AGGREGATOR_H */
Headers for A-MPDU subframes.
an EUI-48 address
Definition: mac48-address.h:46
Aggregator used to construct A-MPDUs.
static uint8_t CalculatePadding(uint32_t ampduSize)
~MpduAggregator() override=default
MpduAggregator()=default
void DoDispose() override
Destructor implementation.
static void Aggregate(Ptr< const WifiMpdu > mpdu, Ptr< Packet > ampdu, bool isSingle)
Aggregate an MPDU to an A-MPDU.
Ptr< WifiMac > m_mac
the MAC of this station
Ptr< HtFrameExchangeManager > m_htFem
the HT Frame Exchange Manager of this station
std::map< AcIndex, Ptr< QosTxop > > EdcaQueues
EDCA queues typedef.
uint32_t GetMaxAmpduSize(Mac48Address recipient, uint8_t tid, WifiModulationClass modulation) const
Determine the maximum size for an A-MPDU of the given TID that can be sent to the given receiver when...
static AmpduSubframeHeader GetAmpduSubframeHeader(uint16_t mpduSize, bool isSingle)
Get the A-MPDU subframe header corresponding to the MPDU size and whether the MPDU is a single MPDU.
static TypeId GetTypeId()
Get the type ID.
void SetWifiMac(const Ptr< WifiMac > mac)
Set the MAC layer to use.
static uint32_t GetSizeIfAggregated(uint32_t mpduSize, uint32_t ampduSize)
Compute the size of the A-MPDU resulting from the aggregation of an MPDU of size mpduSize and an A-MP...
std::vector< Ptr< WifiMpdu > > GetNextAmpdu(Ptr< WifiMpdu > mpdu, WifiTxParameters &txParams, Time availableTime) const
Attempt to aggregate other MPDUs to the given MPDU, while meeting the following constraints:
void SetLinkId(uint8_t linkId)
Set the ID of the link this MPDU aggregator is associated with.
uint8_t m_linkId
ID of the link this object is connected to.
A base class which provides memory management and object aggregation.
Definition: object.h:89
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:77
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
a unique identifier for an interface.
Definition: type-id.h:59
This class stores the TX parameters (TX vector, protection mechanism, acknowledgment mechanism,...
WifiModulationClass
This enumeration defines the modulation classes per (Table 10-6 "Modulation classes"; IEEE 802....
Every class exported by the ns3 library is enclosed in the ns3 namespace.
mac
Definition: third.py:92