Aggregator used to construct A-MPDUs. More...
#include "mpdu-aggregator.h"
Public Types | |
typedef std::map< AcIndex, Ptr< QosTxop > > | EdcaQueues |
EDCA queues typedef. More... | |
Public Member Functions | |
MpduAggregator () | |
virtual | ~MpduAggregator () |
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 using the given modulation class. More... | |
std::vector< Ptr< WifiMacQueueItem > > | GetNextAmpdu (Ptr< WifiMacQueueItem > mpdu, WifiTxParameters &txParams, Time availableTime) const |
Attempt to aggregate other MPDUs to the given MPDU, while meeting the following constraints: More... | |
void | SetWifiMac (const Ptr< WifiMac > mac) |
Set the MAC layer to use. More... | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. More... | |
virtual | ~Object () |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose (void) |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator (void) const |
Get an iterator to the Objects aggregated to this one. More... | |
virtual TypeId | GetInstanceTypeId (void) const |
Get the most derived TypeId for this Object. More... | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. More... | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (void) const |
Get a pointer to the requested aggregated Object. More... | |
void | Initialize (void) |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized (void) const |
Check if the object has been initialized. More... | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. More... | |
SimpleRefCount (const SimpleRefCount &o[[maybe_unused]]) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount (void) const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= ([[maybe_unused]] const SimpleRefCount &o) |
Assignment operator. More... | |
void | Ref (void) const |
Increment the reference count. More... | |
void | Unref (void) const |
Decrement the reference count. More... | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. More... | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising erros. More... | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. More... | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. More... | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. More... | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. More... | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. More... | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
static void | Aggregate (Ptr< const WifiMacQueueItem > mpdu, Ptr< Packet > ampdu, bool isSingle) |
Aggregate an MPDU to an A-MPDU. More... | |
static uint8_t | CalculatePadding (uint32_t ampduSize) |
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. More... | |
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-MPDU of size ampduSize. More... | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId (void) |
Register this type. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Protected Member Functions | |
void | DoDispose () override |
Destructor implementation. More... | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | DoInitialize (void) |
Initialize() implementation. More... | |
virtual void | NotifyNewAggregate (void) |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted (void) |
Notifier called once the ObjectBase is fully constructed. More... | |
Private Attributes | |
Ptr< WifiMac > | m_mac |
the MAC of this station More... | |
Additional Inherited Members | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid (void) |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
Aggregator used to construct A-MPDUs.
Introspection did not find any typical Config paths.
No Attributes are defined for this type.
No TraceSources are defined for this type.
Size of this type is 40 bytes (on a 64-bit architecture).
Definition at line 43 of file mpdu-aggregator.h.
typedef std::map<AcIndex, Ptr<QosTxop> > ns3::MpduAggregator::EdcaQueues |
EDCA queues typedef.
Definition at line 49 of file mpdu-aggregator.h.
ns3::MpduAggregator::MpduAggregator | ( | ) |
Definition at line 59 of file mpdu-aggregator.cc.
|
virtual |
Definition at line 63 of file mpdu-aggregator.cc.
|
static |
Aggregate an MPDU to an A-MPDU.
mpdu | the MPDU. |
ampdu | the A-MPDU. |
isSingle | whether it is a single MPDU. |
Definition at line 82 of file mpdu-aggregator.cc.
References ns3::Packet::AddAtEnd(), ns3::Packet::AddHeader(), ns3::AddWifiMacTrailer(), CalculatePadding(), GetAmpduSubframeHeader(), ns3::Packet::GetSize(), NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by ns3::WifiPsdu::GetPacket().
|
static |
ampduSize | the size of the A-MPDU that needs to be padded in bytes |
Calculates how much padding must be added to the end of an A-MPDU of the given size (once another MPDU is aggregated). Each A-MPDU subframe is padded so that its length is multiple of 4 octets.
Definition at line 177 of file mpdu-aggregator.cc.
Referenced by Aggregate(), ns3::WifiPsdu::GetAmpduSubframeSize(), and GetSizeIfAggregated().
|
overrideprotectedvirtual |
Destructor implementation.
This method is called by Dispose() or by the Object's destructor, whichever comes first.
Subclasses are expected to implement their real destruction code in an overridden version of this method and chain up to their parent's implementation once they are done. i.e, for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose() method.
It is safe to call GetObject() from within this method.
Reimplemented from ns3::Object.
Definition at line 68 of file mpdu-aggregator.cc.
References ns3::Object::DoDispose(), and m_mac.
|
static |
Get the A-MPDU subframe header corresponding to the MPDU size and whether the MPDU is a single MPDU.
mpduSize | size of the MPDU in bytes. |
isSingle | true if S-MPDU. |
Definition at line 183 of file mpdu-aggregator.cc.
References ns3::AmpduSubframeHeader::SetEof(), and ns3::AmpduSubframeHeader::SetLength().
Referenced by Aggregate(), and ns3::WifiPsdu::GetAmpduSubframe().
uint32_t ns3::MpduAggregator::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 using the given modulation class.
recipient | the receiver station address. |
tid | the TID. |
modulation | the modulation class. |
Definition at line 122 of file mpdu-aggregator.cc.
References ns3::WifiRemoteStationManager::GetStationHeCapabilities(), ns3::WifiRemoteStationManager::GetStationHtCapabilities(), ns3::WifiRemoteStationManager::GetStationVhtCapabilities(), m_mac, min, NS_ABORT_MSG_IF, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::QosUtilsMapTidToAc(), ns3::WIFI_MOD_CLASS_HE, ns3::WIFI_MOD_CLASS_HT, and ns3::WIFI_MOD_CLASS_VHT.
Referenced by GetNextAmpdu().
std::vector< Ptr< WifiMacQueueItem > > ns3::MpduAggregator::GetNextAmpdu | ( | Ptr< WifiMacQueueItem > | mpdu, |
WifiTxParameters & | txParams, | ||
Time | availableTime | ||
) | const |
Attempt to aggregate other MPDUs to the given MPDU, while meeting the following constraints:
For now, only non-broadcast QoS Data frames can be aggregated (do not pass other types of frames to this method). MPDUs to aggregate are looked for among those with the same TID and receiver as the given MPDU.
The resulting A-MPDU is returned as a vector of the constituent MPDUs (including the given MPDU), which are not actually aggregated (call the Aggregate method afterwards to get the actual A-MPDU). If aggregation was not possible (aggregation is disabled, there is no Block Ack agreement established with the receiver, or another MPDU to aggregate was not found), the returned vector is empty.
mpdu | the given MPDU. |
txParams | the TX parameters used to transmit the frame |
availableTime | the time available for the frame exchange |
Definition at line 195 of file mpdu-aggregator.cc.
References ns3::QosTxop::GetBaAgreementEstablished(), ns3::QosTxop::GetBaBufferSize(), ns3::QosTxop::GetBaStartingSequence(), GetMaxAmpduSize(), ns3::WifiTxVector::GetModulationClass(), ns3::QosTxop::GetNextMpdu(), ns3::WifiTxParameters::GetSize(), ns3::Mac48Address::IsBroadcast(), ns3::IsInWindow(), m_mac, ns3::WifiTxParameters::m_txVector, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::QosTxop::PeekNextMpdu().
|
static |
Compute the size of the A-MPDU resulting from the aggregation of an MPDU of size mpduSize and an A-MPDU of size ampduSize.
mpduSize | the MPDU size in bytes. |
ampduSize | the A-MPDU size in bytes. |
Definition at line 114 of file mpdu-aggregator.cc.
References CalculatePadding(), and NS_LOG_FUNCTION.
Referenced by ns3::WifiPsdu::WifiPsdu(), ns3::WifiTxParameters::AddMpdu(), ns3::MultiUserScheduler::DoInitialize(), ns3::VhtFrameExchangeManager::GetPsduSize(), ns3::WifiTxParameters::GetSize(), ns3::WifiTxParameters::GetSizeIfAddMpdu(), and ns3::WifiTxParameters::GetSizeIfAggregateMsdu().
|
static |
Get the type ID.
Definition at line 49 of file mpdu-aggregator.cc.
References ns3::TypeId::SetParent().
Set the MAC layer to use.
mac | the MAC layer to use |
Definition at line 75 of file mpdu-aggregator.cc.
References m_mac, third::mac, and NS_LOG_FUNCTION.
the MAC of this station
Definition at line 158 of file mpdu-aggregator.h.
Referenced by DoDispose(), GetMaxAmpduSize(), GetNextAmpdu(), and SetWifiMac().