Airtime link metric calculator. More...
#include "airtime-metric.h"
Public Member Functions | |
AirtimeLinkMetricCalculator () | |
uint32_t | CalculateMetric (Mac48Address peerAddress, Ptr< MeshWifiInterfaceMac > mac) |
Airtime link metric is defined in Section 13.9 of IEEE 802.11-2012 as: 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 TypeId | GetTypeId () |
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... | |
Private Member Functions | |
void | SetHeaderTid (uint8_t tid) |
Set header TID from the Dot11MetricTid attribute. More... | |
void | SetTestLength (uint16_t testLength) |
Set number of bytes in test frame (a constant 1024 in the standard) More... | |
Private Attributes | |
Ptr< Packet > | m_testFrame |
test frame More... | |
WifiMacHeader | m_testHeader |
test header More... | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | DoDispose (void) |
Destructor implementation. 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... | |
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... | |
Airtime link metric calculator.
Introspection did not find any typical Config paths.
Airtime link metric is defined in 11B.10 of 802.11s Draft D3.0 as:
airtime = (O + Bt/r)* (1 + average retry counter), where:
Final result is expressed in units of 0.01 Time Unit = 10.24 us (as required by 802.11s draft)
No TraceSources are defined for this type.
Size of this type is 96 bytes (on a 64-bit architecture).
Definition at line 44 of file airtime-metric.h.
ns3::dot11s::AirtimeLinkMetricCalculator::AirtimeLinkMetricCalculator | ( | ) |
Definition at line 52 of file airtime-metric.cc.
uint32_t ns3::dot11s::AirtimeLinkMetricCalculator::CalculateMetric | ( | Mac48Address | peerAddress, |
Ptr< MeshWifiInterfaceMac > | mac | ||
) |
Airtime link metric is defined in Section 13.9 of IEEE 802.11-2012 as:
airtime = (O + Bt/r) / (1 - frame error rate), where o – the PHY dependent channel access which includes frame headers, training sequences, access protocol frames, etc. bt – the test packet length in bits (8192 by default), r – the current bitrate of the packet,
Final result is expressed encoded as an unsigned integer in units of 0.01 TU = 10.24 us
peerAddress | The peer MAC address |
mac | The MAC layer |
Definition at line 69 of file airtime-metric.cc.
References ns3::Packet::GetSize(), ns3::Mac48Address::IsGroup(), m_testFrame, m_testHeader, third::mac, NS_ASSERT, ns3::WifiTxVector::SetMode(), ns3::WifiTxVector::SetPreambleType(), and ns3::WIFI_PREAMBLE_LONG.
Referenced by ns3::dot11s::HwmpProtocol::Install().
|
static |
Get the type ID.
Definition at line 29 of file airtime-metric.cc.
References ns3::MakeUintegerAccessor(), SetHeaderTid(), ns3::TypeId::SetParent(), and SetTestLength().
|
private |
Set header TID from the Dot11MetricTid attribute.
tid | the header TID to use to calculate data rate |
Definition at line 56 of file airtime-metric.cc.
References m_testHeader, ns3::WifiMacHeader::SetDsFrom(), ns3::WifiMacHeader::SetDsTo(), ns3::WifiMacHeader::SetQosTid(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_DATA.
Referenced by GetTypeId().
|
private |
Set number of bytes in test frame (a constant 1024 in the standard)
testLength | the test length in bits |
Definition at line 64 of file airtime-metric.cc.
References m_testFrame.
Referenced by GetTypeId().
test frame
Definition at line 82 of file airtime-metric.h.
Referenced by CalculateMetric(), and SetTestLength().
|
private |
test header
Definition at line 83 of file airtime-metric.h.
Referenced by CalculateMetric(), and SetHeaderTid().