A Discrete-Event Network Simulator
API
msdu-aggregator.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2009 MIRKO BANCHI
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: Mirko Banchi <mk.banchi@gmail.com>
18  */
19 
20 #ifndef MSDU_AGGREGATOR_H
21 #define MSDU_AGGREGATOR_H
22 
23 #include "qos-utils.h"
24 #include "wifi-mode.h"
25 #include "wifi-mpdu.h"
26 
27 #include "ns3/nstime.h"
28 #include "ns3/object.h"
29 
30 #include <map>
31 
32 namespace ns3
33 {
34 
35 class Packet;
36 class QosTxop;
37 class WifiTxVector;
38 class WifiMac;
39 class HtFrameExchangeManager;
40 class WifiTxParameters;
41 
46 class MsduAggregator : public Object
47 {
48  public:
50  typedef std::map<AcIndex, Ptr<QosTxop>> EdcaQueues;
51 
56  static TypeId GetTypeId();
57 
58  MsduAggregator() = default;
59  ~MsduAggregator() override = default;
60 
66  void SetLinkId(uint8_t linkId);
67 
78  static uint16_t GetSizeIfAggregated(uint16_t msduSize, uint16_t amsduSize);
79 
111  WifiTxParameters& txParams,
112  Time availableTime) const;
113 
123  uint16_t GetMaxAmsduSize(Mac48Address recipient,
124  uint8_t tid,
125  WifiModulationClass modulation) const;
126 
132  static WifiMpdu::DeaggregatedMsdus Deaggregate(Ptr<Packet> aggregatedPacket);
133 
139  void SetWifiMac(const Ptr<WifiMac> mac);
140 
150  static uint8_t CalculatePadding(uint16_t amsduSize);
151 
152  protected:
153  void DoDispose() override;
154 
155  private:
158  uint8_t m_linkId{0};
159 };
160 
161 } // namespace ns3
162 
163 #endif /* MSDU_AGGREGATOR_H */
an EUI-48 address
Definition: mac48-address.h:46
Aggregator used to construct A-MSDUs.
static TypeId GetTypeId()
Get the type ID.
uint16_t GetMaxAmsduSize(Mac48Address recipient, uint8_t tid, WifiModulationClass modulation) const
Determine the maximum size for an A-MSDU of the given TID that can be sent to the given receiver when...
MsduAggregator()=default
std::map< AcIndex, Ptr< QosTxop > > EdcaQueues
EDCA queues typedef.
void DoDispose() override
Destructor implementation.
Ptr< WifiMac > m_mac
the MAC of this station
uint8_t m_linkId
ID of the link this object is connected to.
static WifiMpdu::DeaggregatedMsdus Deaggregate(Ptr< Packet > aggregatedPacket)
Ptr< HtFrameExchangeManager > m_htFem
the HT Frame Exchange Manager of this station
static uint16_t GetSizeIfAggregated(uint16_t msduSize, uint16_t amsduSize)
Compute the size of the A-MSDU resulting from the aggregation of an MSDU of size msduSize and an A-MS...
Ptr< WifiMpdu > GetNextAmsdu(Ptr< WifiMpdu > peekedItem, WifiTxParameters &txParams, Time availableTime) const
Attempt to aggregate other MSDUs to the given A-MSDU while meeting the following constraints:
void SetWifiMac(const Ptr< WifiMac > mac)
Set the MAC layer to use.
static uint8_t CalculatePadding(uint16_t amsduSize)
Calculate how much padding must be added to the end of an A-MSDU of the given size if a new MSDU is a...
~MsduAggregator() override=default
void SetLinkId(uint8_t linkId)
Set the ID of the link this MSDU aggregator is associated with.
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
std::list< std::pair< Ptr< const Packet >, AmsduSubframeHeader > > DeaggregatedMsdus
DeaggregatedMsdus typedef.
Definition: wifi-mpdu.h:142
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