A Discrete-Event Network Simulator
API
msdu-aggregator.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2009 MIRKO BANCHI
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: Mirko Banchi <mk.banchi@gmail.com>
19  */
20 
21 #include "ns3/log.h"
22 #include "ns3/uinteger.h"
23 #include "msdu-aggregator.h"
24 
25 namespace ns3 {
26 
27 NS_LOG_COMPONENT_DEFINE ("MsduAggregator");
28 
29 NS_OBJECT_ENSURE_REGISTERED (MsduAggregator);
30 
31 TypeId
33 {
34  static TypeId tid = TypeId ("ns3::MsduAggregator")
35  .SetParent<Object> ()
36  .SetGroupName ("Wifi")
37  .AddConstructor<MsduAggregator> ()
38  ;
39  return tid;
40 }
41 
43 {
44 }
45 
47 {
48 }
49 
50 void
52 {
53  m_maxAmsduLength = maxSize;
54 }
55 
56 uint16_t
58 {
59  return m_maxAmsduLength;
60 }
61 
62 bool
64  Mac48Address src, Mac48Address dest) const
65 {
66  NS_LOG_FUNCTION (this);
67  Ptr<Packet> currentPacket;
68  AmsduSubframeHeader currentHdr;
69 
70  uint8_t padding = CalculatePadding (aggregatedPacket);
71  uint32_t actualSize = aggregatedPacket->GetSize ();
72 
73  if ((14 + packet->GetSize () + actualSize + padding) <= m_maxAmsduLength)
74  {
75  if (padding)
76  {
77  Ptr<Packet> pad = Create<Packet> (padding);
78  aggregatedPacket->AddAtEnd (pad);
79  }
80  currentHdr.SetDestinationAddr (dest);
81  currentHdr.SetSourceAddr (src);
82  currentHdr.SetLength (packet->GetSize ());
83  currentPacket = packet->Copy ();
84 
85  currentPacket->AddHeader (currentHdr);
86  aggregatedPacket->AddAtEnd (currentPacket);
87  return true;
88  }
89  return false;
90 }
91 
92 uint8_t
94 {
95  return (4 - (packet->GetSize () % 4 )) % 4;
96 }
97 
100 {
102  DeaggregatedMsdus set;
103 
105  Ptr<Packet> extractedMsdu = Create<Packet> ();
106  uint32_t maxSize = aggregatedPacket->GetSize ();
107  uint16_t extractedLength;
108  uint8_t padding;
109  uint32_t deserialized = 0;
110 
111  while (deserialized < maxSize)
112  {
113  deserialized += aggregatedPacket->RemoveHeader (hdr);
114  extractedLength = hdr.GetLength ();
115  extractedMsdu = aggregatedPacket->CreateFragment (0, static_cast<uint32_t> (extractedLength));
116  aggregatedPacket->RemoveAtStart (extractedLength);
117  deserialized += extractedLength;
118 
119  padding = (4 - ((extractedLength + 14) % 4 )) % 4;
120 
121  if (padding > 0 && deserialized < maxSize)
122  {
123  aggregatedPacket->RemoveAtStart (padding);
124  deserialized += padding;
125  }
126 
127  std::pair<Ptr<Packet>, AmsduSubframeHeader> packetHdr (extractedMsdu, hdr);
128  set.push_back (packetHdr);
129  }
130  NS_LOG_INFO ("Deaggreated A-MSDU: extracted " << set.size () << " MSDUs");
131  return set;
132 }
133 
134 } //namespace ns3
uint32_t RemoveHeader(Header &header)
Deserialize and remove the header from the internal buffer.
Definition: packet.cc:280
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:45
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:821
static DeaggregatedMsdus Deaggregate(Ptr< Packet > aggregatedPacket)
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:277
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
void SetSourceAddr(Mac48Address to)
Set source address function.
Ptr< Packet > CreateFragment(uint32_t start, uint32_t length) const
Create a new packet which contains a fragment of the original packet.
Definition: packet.cc:227
void AddAtEnd(Ptr< const Packet > packet)
Concatenate the input packet at the end of the current packet.
Definition: packet.cc:335
void RemoveAtStart(uint32_t size)
Remove size bytes from the start of the current packet.
Definition: packet.cc:362
uint8_t CalculatePadding(Ptr< const Packet > packet) const
Calculates how much padding must be added to the end of aggregated packet, after that a new packet is...
uint16_t GetMaxAmsduSize(void) const
Returns the maximum A-MSDU size in bytes.
static TypeId GetTypeId(void)
Get the type ID.
void SetLength(uint16_t length)
Set length function.
Ptr< Packet > Copy(void) const
performs a COW copy of the packet.
Definition: packet.cc:121
std::list< std::pair< Ptr< Packet >, AmsduSubframeHeader > > DeaggregatedMsdus
DeaggregatedMsdus typedef.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
an EUI-48 address
Definition: mac48-address.h:43
Introspection did not find any typical Config paths.
void SetDestinationAddr(Mac48Address to)
Set destination address function.
bool Aggregate(Ptr< const Packet > packet, Ptr< Packet > aggregatedPacket, Mac48Address src, Mac48Address dest) const
Adds packet to aggregatedPacket.
Aggregator used to construct A-MSDUs.
A base class which provides memory management and object aggregation.
Definition: object.h:87
a unique identifier for an interface.
Definition: type-id.h:58
uint16_t m_maxAmsduLength
maximum AMSDU length
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:914
void AddHeader(const Header &header)
Add header to this packet.
Definition: packet.cc:256
void SetMaxAmsduSize(uint16_t maxSize)
Sets the maximum A-MSDU size in bytes.
uint16_t GetLength(void) const
Get length function.