base class for all MAC-level wifi objects.This class encapsulates all the low-level MAC functionality DCA, EDCA, etc) and all the high-level MAC functionality (association/disassociation state machines). More...
#include <regular-wifi-mac.h>
Public Types | |
typedef Callback< void, Ptr < Packet >, Mac48Address, Mac48Address > | ForwardUpCallback |
Public Member Functions | |
virtual void | Enqueue (Ptr< const Packet > packet, Mac48Address to, Mac48Address from) |
virtual void | Enqueue (Ptr< const Packet > packet, Mac48Address to)=0 |
Time | GetAckTimeout (void) const |
virtual Mac48Address | GetAddress (void) const |
virtual Time | GetBasicBlockAckTimeout (void) const |
virtual Mac48Address | GetBssid (void) const |
virtual Time | GetCompressedBlockAckTimeout (void) const |
Time | GetCtsTimeout (void) const |
Time | GetEifsNoDifs (void) const |
Time | GetPifs (void) const |
Time | GetSifs (void) const |
Time | GetSlot (void) const |
virtual Ssid | GetSsid (void) const |
virtual Ptr< WifiPhy > | GetWifiPhy () const |
virtual Ptr < WifiRemoteStationManager > | GetWifiRemoteStationManager () const |
void | RestartAccess (void) |
void | SetAckTimeout (Time ackTimeout) |
virtual void | SetAddress (Mac48Address address) |
virtual void | SetBasicBlockAckTimeout (Time blockAckTimeout) |
virtual void | SetBssid (Mac48Address bssid) |
virtual void | SetCompressedBlockAckTimeout (Time blockAckTimeout) |
void | SetCtsTimeout (Time ctsTimeout) |
void | SetEifsNoDifs (Time eifsNoDifs) |
virtual void | SetForwardUpCallback (ForwardUpCallback upCallback) |
virtual void | SetLinkDownCallback (Callback< void > linkDown) |
virtual void | SetLinkUpCallback (Callback< void > linkUp) |
void | SetPifs (Time pifs) |
virtual void | SetPromisc (void) |
Sets the interface in promiscuous mode. More... | |
void | SetSifs (Time sifs) |
void | SetSlot (Time slotTime) |
virtual void | SetSsid (Ssid ssid) |
virtual void | SetWifiPhy (Ptr< WifiPhy > phy) |
virtual void | SetWifiRemoteStationManager (Ptr< WifiRemoteStationManager > stationManager) |
virtual bool | SupportsSendFrom (void) const |
Public Member Functions inherited from ns3::WifiMac | |
void | ConfigureStandard (enum WifiPhyStandard standard) |
Time | GetMaxPropagationDelay (void) const |
Time | GetMsduLifetime (void) const |
void | NotifyPromiscRx (Ptr< const Packet > packet) |
void | NotifyRx (Ptr< const Packet > packet) |
void | NotifyRxDrop (Ptr< const Packet > packet) |
void | NotifyTx (Ptr< const Packet > packet) |
void | NotifyTxDrop (Ptr< const Packet > packet) |
virtual void | SetForwardUpCallback (Callback< void, Ptr< Packet >, Mac48Address, Mac48Address > upCallback)=0 |
void | SetMaxPropagationDelay (Time delay) |
Public Member Functions inherited from ns3::Object | |
void | AggregateObject (Ptr< Object > other) |
void | Dispose (void) |
AggregateIterator | GetAggregateIterator (void) const |
virtual TypeId | GetInstanceTypeId (void) const |
template<typename T > | |
Ptr< T > | GetObject (void) const |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
void | Initialize (void) |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount (const SimpleRefCount &o) | |
uint32_t | GetReferenceCount (void) const |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
void | Ref (void) const |
void | Unref (void) const |
Public Member Functions inherited from ns3::ObjectBase | |
void | GetAttribute (std::string name, AttributeValue &value) const |
bool | GetAttributeFailSafe (std::string name, AttributeValue &attribute) const |
void | SetAttribute (std::string name, const AttributeValue &value) |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Static Public Member Functions | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::WifiMac | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId (void) |
Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
static void | Cleanup (void) |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Protected Types | |
typedef std::map< AcIndex, Ptr < EdcaTxopN > > | EdcaQueues |
Protected Member Functions | |
virtual void | DeaggregateAmsduAndForward (Ptr< Packet > aggregatedPacket, const WifiMacHeader *hdr) |
virtual void | DoDispose () |
virtual void | DoInitialize () |
virtual void | FinishConfigureStandard (enum WifiPhyStandard standard) |
void | ForwardUp (Ptr< Packet > packet, Mac48Address from, Mac48Address to) |
bool | GetQosSupported () const |
bool | IsRxRadio (void) |
bool | IsTxRadio (void) |
virtual void | Receive (Ptr< Packet > packet, const WifiMacHeader *hdr) |
virtual void | SendAddBaResponse (const MgtAddBaRequestHeader *reqHdr, Mac48Address originator) |
void | SetQosSupported (bool enable) |
void | SetRxRadio (bool isRx, Ptr< Node > node, Ptr< Repository > repo, Ptr< PUModel > puModel, Ptr< WifiPhy > phy) |
void | SetTxRadio (bool isTx) |
void | SetTypeOfStation (TypeOfStation type) |
virtual void | TxFailed (const WifiMacHeader &hdr) |
virtual void | TxOk (const WifiMacHeader &hdr) |
Protected Member Functions inherited from ns3::WifiMac | |
void | ConfigureCCHDcf (Ptr< Dcf > dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac) |
void | ConfigureDcf (Ptr< Dcf > dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac) |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
virtual void | NotifyNewAggregate (void) |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
virtual void | NotifyConstructionCompleted (void) |
Protected Attributes | |
Ptr< DcaTxop > | m_dca |
DcfManager * | m_dcfManager |
EdcaQueues | m_edca |
ForwardUpCallback | m_forwardUp |
Callback< void > | m_linkDown |
Callback< void > | m_linkUp |
Ptr< MacLow > | m_low |
Ptr< WifiPhy > | m_phy |
bool | m_qosSupported |
MacRxMiddle * | m_rxMiddle |
Ssid | m_ssid |
Ptr< WifiRemoteStationManager > | m_stationManager |
MacTxMiddle * | m_txMiddle |
Private Member Functions | |
RegularWifiMac (const RegularWifiMac &) | |
Ptr< EdcaTxopN > | GetBEQueue (void) const |
Ptr< EdcaTxopN > | GetBKQueue (void) const |
Ptr< DcaTxop > | GetDcaTxop (void) const |
Ptr< EdcaTxopN > | GetVIQueue (void) const |
Ptr< EdcaTxopN > | GetVOQueue (void) const |
RegularWifiMac & | operator= (const RegularWifiMac &) |
void | SetupEdcaQueue (enum AcIndex ac) |
Private Attributes | |
Ptr< Node > | m_node |
double | m_probMisdetect |
Time | m_snsInterval |
SpectrumManager * | m_spectrumManager |
TracedCallback< const WifiMacHeader & > | m_txErrCallback |
Time | m_txInterval |
TracedCallback< const WifiMacHeader & > | m_txOkCallback |
base class for all MAC-level wifi objects.
This class encapsulates all the low-level MAC functionality DCA, EDCA, etc) and all the high-level MAC functionality (association/disassociation state machines).
ns3::RegularWifiMac is accessible through the following paths with Config::Set and Config::Connect:
Definition at line 51 of file regular-wifi-mac.h.
|
protected |
This type defines a mapping between an Access Category index, and a pointer to the corresponding channel access function
Definition at line 242 of file regular-wifi-mac.h.
typedef Callback<void, Ptr<Packet>, Mac48Address, Mac48Address> ns3::RegularWifiMac::ForwardUpCallback |
This type defines the callback of a higher layer that a WifiMac(-derived) object invokes to pass a packet up the stack.
packet | the packet that has been received. |
from | the MAC address of the device that sent the packet. |
to | the MAC address ot the device that the packet is destined for. |
Definition at line 192 of file regular-wifi-mac.h.
|
protectedvirtual |
This method can be called to de-aggregate an A-MSDU and forward the constituent packets up the stack.
aggregatedPacket | the Packet containing the A-MSDU. |
hdr | a pointer to the MAC header for aggregatedPacket . |
Reimplemented in ns3::ApWifiMac.
Definition at line 539 of file regular-wifi-mac.cc.
Referenced by ns3::AdhocWifiMac::Receive(), and ns3::StaWifiMac::Receive().
|
protectedvirtual |
This method is called by Object::Dispose or by the object's destructor, whichever comes first.
Subclasses are expected to implement their real destruction code in an overriden 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.
Reimplemented in ns3::MeshWifiInterfaceMac, and ns3::ApWifiMac.
Definition at line 92 of file regular-wifi-mac.cc.
References m_dca, m_edca, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::DoDispose(), and ns3::MeshWifiInterfaceMac::DoDispose().
|
protectedvirtual |
This method is called only once by Object::Initialize. If the user calls Object::Initialize multiple times, DoInitialize is called only the first time.
Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject and AggregateObject from within this method.
Reimplemented from ns3::Object.
Reimplemented in ns3::MeshWifiInterfaceMac, and ns3::ApWifiMac.
Definition at line 79 of file regular-wifi-mac.cc.
References m_dca, m_edca, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::DoInitialize().
|
virtual |
packet | the packet to send. |
to | the address to which the packet should be sent. |
from | the address from which the packet should be sent. |
The packet should be enqueued in a tx queue, and should be dequeued as soon as the channel access function determines that access is granted to this MAC. The extra parameter "from" allows this device to operate in a bridged mode, forwarding received frames without altering the source address.
Implements ns3::WifiMac.
Reimplemented in ns3::ApWifiMac, and ns3::MeshWifiInterfaceMac.
Definition at line 407 of file regular-wifi-mac.cc.
References GetAddress(), and NS_FATAL_ERROR.
|
pure virtual |
packet | the packet to send. |
to | the address to which the packet should be sent. |
The packet should be enqueued in a tx queue, and should be dequeued as soon as the channel access function determines that access is granted to this MAC.
Implements ns3::WifiMac.
Implemented in ns3::MeshWifiInterfaceMac, ns3::ApWifiMac, ns3::AdhocWifiMac, and ns3::StaWifiMac.
|
protectedvirtual |
standard | the phy standard to be used |
This method is called by ns3::WifiMac::ConfigureStandard to complete the configuration process for a requested phy standard.
This method may be overriden by a derived class (e.g., in order to apply DCF or EDCA parameters specific to the usage model it is dealing with), in which case the reimplementation may choose to deal with certain values in the WifiPhyStandard enumeration, and chain up to this implementation to deal with the remainder.
Implements ns3::WifiMac.
Reimplemented in ns3::MeshWifiInterfaceMac.
Definition at line 674 of file regular-wifi-mac.cc.
References ns3::AC_BE_NQOS, m_dca, m_edca, NS_FATAL_ERROR, ns3::WIFI_PHY_STANDARD_80211_10MHZ, ns3::WIFI_PHY_STANDARD_80211_5MHZ, ns3::WIFI_PHY_STANDARD_80211a, ns3::WIFI_PHY_STANDARD_80211b, ns3::WIFI_PHY_STANDARD_80211g, ns3::WIFI_PHY_STANDARD_80211p_CCH, ns3::WIFI_PHY_STANDARD_80211p_SCH, and ns3::WIFI_PHY_STANDARD_holland.
Referenced by ns3::MeshWifiInterfaceMac::FinishConfigureStandard().
|
virtual |
Implements ns3::WifiMac.
Definition at line 317 of file regular-wifi-mac.cc.
|
virtual |
Implements ns3::WifiMac.
Definition at line 369 of file regular-wifi-mac.cc.
Referenced by ns3::ApWifiMac::DeaggregateAmsduAndForward(), Enqueue(), ns3::MeshWifiInterfaceMac::ForwardDown(), ns3::StaWifiMac::Receive(), ns3::ApWifiMac::Receive(), ns3::MeshWifiInterfaceMac::Receive(), Receive(), ns3::MeshWifiInterfaceMac::Report(), SendAddBaResponse(), and ns3::MeshWifiInterfaceMac::SendBeacon().
Accessor for the AC_BE channel access function
Definition at line 195 of file regular-wifi-mac.cc.
References ns3::AC_BE, and m_edca.
Accessor for the AC_BK channel access function
Definition at line 201 of file regular-wifi-mac.cc.
References ns3::AC_BK, and m_edca.
|
virtual |
Implements ns3::WifiMac.
Definition at line 395 of file regular-wifi-mac.cc.
Referenced by ns3::StaWifiMac::Enqueue(), ns3::AdhocWifiMac::Enqueue(), and ns3::StaWifiMac::Receive().
|
virtual |
Implements ns3::WifiMac.
Definition at line 330 of file regular-wifi-mac.cc.
|
virtual |
Implements ns3::WifiMac.
Definition at line 291 of file regular-wifi-mac.cc.
References ns3::DcfManager::GetEifsNoDifs().
|
virtual |
Implements ns3::WifiMac.
Definition at line 304 of file regular-wifi-mac.cc.
|
protected |
Get accessor for the m_qosSupported
member
Definition at line 250 of file regular-wifi-mac.cc.
References m_qosSupported.
|
virtual |
Implements ns3::WifiMac.
Definition at line 278 of file regular-wifi-mac.cc.
|
virtual |
Implements ns3::WifiMac.
Definition at line 264 of file regular-wifi-mac.cc.
|
virtual |
Implements ns3::WifiMac.
Definition at line 382 of file regular-wifi-mac.cc.
Referenced by ns3::StaWifiMac::Receive(), ns3::MeshWifiInterfaceMac::Receive(), and ns3::MeshWifiInterfaceMac::SendBeacon().
Accessor for the AC_VI channel access function
Definition at line 189 of file regular-wifi-mac.cc.
References ns3::AC_VI, and m_edca.
Accessor for the AC_VO channel access function
Definition at line 183 of file regular-wifi-mac.cc.
References ns3::AC_VO, and m_edca.
Definition at line 216 of file regular-wifi-mac.cc.
|
virtual |
Definition at line 141 of file regular-wifi-mac.cc.
|
protectedvirtual |
This method acts as the MacRxMiddle receive callback and is invoked to notify us that a frame has been received. The implementation is intended to capture logic that is going to be common to all (or most) derived classes. Specifically, handling of Block Ack managment frames is dealt with here.
This method will need, however, to be overriden by derived classes so that they can perform their data handling before invoking the base version.
packet | the packet that has been received. |
hdr | a pointer to the MAC header of the received frame. |
Reimplemented in ns3::MeshWifiInterfaceMac, ns3::ApWifiMac, ns3::StaWifiMac, and ns3::AdhocWifiMac.
Definition at line 432 of file regular-wifi-mac.cc.
References GetAddress(), m_edca, m_qosSupported, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_FUNCTION, ns3::QosUtilsMapTidToAc(), ns3::Packet::RemoveHeader(), and SendAddBaResponse().
Referenced by ns3::AdhocWifiMac::Receive(), ns3::StaWifiMac::Receive(), and ns3::ApWifiMac::Receive().
void ns3::RegularWifiMac::RestartAccess | ( | void | ) |
Restart backoff access at mac layer
Definition at line 532 of file regular-wifi-mac.cc.
References m_dca, and NS_LOG_FUNCTION.
|
protectedvirtual |
This method can be called to accept a received ADDBA Request. An ADDBA Response will be constructed and queued for transmission.
reqHdr | a pointer to the received ADDBA Request header. |
originator | the MAC address of the originator. |
Definition at line 554 of file regular-wifi-mac.cc.
References ns3::Packet::AddHeader(), GetAddress(), m_edca, NS_LOG_FUNCTION, and ns3::QosUtilsMapTidToAc().
Referenced by Receive().
|
virtual |
ackTimeout | the duration of an ACK timeout. |
Implements ns3::WifiMac.
Definition at line 310 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
virtual |
address | the current address of this MAC layer. |
Implements ns3::WifiMac.
Reimplemented in ns3::ApWifiMac, and ns3::AdhocWifiMac.
Definition at line 362 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
Referenced by ns3::AdhocWifiMac::SetAddress(), and ns3::ApWifiMac::SetAddress().
|
virtual |
bssid | the BSSID of the network that this device belongs to. |
Definition at line 388 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
Referenced by ns3::StaWifiMac::Receive(), ns3::AdhocWifiMac::SetAddress(), and ns3::ApWifiMac::SetAddress().
|
virtual |
ctsTimeout | the duration of a CTS timeout. |
Implements ns3::WifiMac.
Definition at line 323 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
virtual |
eifsNoDifs | the duration of an EIFS minus DIFS. |
This value is used to calculate the EIFS depending on AIFSN.
Implements ns3::WifiMac.
Definition at line 284 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION, and ns3::DcfManager::SetEifsNoDifs().
|
virtual |
upCallback | the callback to invoke when a packet must be forwarded up the stack. |
Definition at line 222 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
virtual |
linkDown | the callback to invoke when the link becomes down. |
Implements ns3::WifiMac.
Definition at line 236 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
virtual |
linkUp | the callback to invoke when the link becomes up. |
Implements ns3::WifiMac.
Reimplemented in ns3::MeshWifiInterfaceMac, ns3::ApWifiMac, and ns3::AdhocWifiMac.
Definition at line 229 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
Referenced by ns3::AdhocWifiMac::SetLinkUpCallback(), ns3::ApWifiMac::SetLinkUpCallback(), and ns3::MeshWifiInterfaceMac::SetLinkUpCallback().
|
virtual |
pifs | the pifs duration. |
Implements ns3::WifiMac.
Definition at line 297 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
virtual |
Sets the interface in promiscuous mode.
Enables promiscuous mode on the interface. Note that any further filtering on the incoming frame path may affect the overall behavior.
Implements ns3::WifiMac.
Definition at line 401 of file regular-wifi-mac.cc.
|
protected |
Set accessor for the m_qosSupported
member
Definition at line 243 of file regular-wifi-mac.cc.
References m_qosSupported, and NS_LOG_FUNCTION.
|
virtual |
sifs | the sifs duration |
Implements ns3::WifiMac.
Definition at line 270 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION, and ns3::DcfManager::SetSifs().
|
virtual |
slotTime | the slot duration |
Implements ns3::WifiMac.
Definition at line 256 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION, and ns3::DcfManager::SetSlot().
|
virtual |
ssid | the current ssid of this MAC layer. |
Implements ns3::WifiMac.
Definition at line 375 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
protected |
This method is invoked by a subclass to specify what type of station it is implementing. This is something that the channel access functions (instantiated within this class as EdcaTxopN's) need to know.
type | the type of station. |
Definition at line 167 of file regular-wifi-mac.cc.
References m_edca, and NS_LOG_FUNCTION.
Referenced by ns3::MeshWifiInterfaceMac::MeshWifiInterfaceMac().
|
private |
This method is a private utility invoked to configure the channel access function for the specified Access Category.
ac | the Access Category index of the queue to initialise. |
Definition at line 147 of file regular-wifi-mac.cc.
References m_edca, ns3::MakeCallback(), NS_ASSERT, and NS_LOG_FUNCTION.
phy | the physical layer attached to this MAC. |
Implements ns3::WifiMac.
Definition at line 207 of file regular-wifi-mac.cc.
References NS_LOG_FUNCTION.
|
virtual |
stationManager | the station manager attached to this MAC. |
Implements ns3::WifiMac.
Reimplemented in ns3::ApWifiMac.
Definition at line 126 of file regular-wifi-mac.cc.
References m_dca, m_edca, and NS_LOG_FUNCTION.
Referenced by ns3::ApWifiMac::SetWifiRemoteStationManager().
This holds a pointer to the DCF instance for this WifiMac - used for transmission of frames to non-QoS peers.
Definition at line 238 of file regular-wifi-mac.h.
Referenced by DoDispose(), DoInitialize(), ns3::StaWifiMac::Enqueue(), ns3::AdhocWifiMac::Enqueue(), ns3::MeshWifiInterfaceMac::FinishConfigureStandard(), FinishConfigureStandard(), GetDcaTxop(), RestartAccess(), ns3::MeshWifiInterfaceMac::SendBeacon(), and SetWifiRemoteStationManager().
|
protected |
This is a map from Access Category index to the corresponding channel access function
Definition at line 245 of file regular-wifi-mac.h.
Referenced by DoDispose(), DoInitialize(), ns3::StaWifiMac::Enqueue(), ns3::AdhocWifiMac::Enqueue(), FinishConfigureStandard(), ns3::MeshWifiInterfaceMac::ForwardDown(), GetBEQueue(), GetBKQueue(), GetVIQueue(), GetVOQueue(), Receive(), SendAddBaResponse(), ns3::MeshWifiInterfaceMac::SendManagementFrame(), SetTypeOfStation(), SetupEdcaQueue(), and SetWifiRemoteStationManager().
|
protected |
This Boolean is set true
iff this WifiMac is to model 802.11e/WMM style Quality of Service. It is exposed through the attribute system.
At the moment, this flag is the sole selection between QoS and non-QoS operation for the STA (whether IBSS, AP, or non-AP). Ultimately, we will want a QoS-enabled STA to be able to fall back to non-QoS operation with a non-QoS peer. This'll require further intelligence - i.e., per-association QoS state. Having a big switch seems like a good intermediate stage, however.
Definition at line 324 of file regular-wifi-mac.h.
Referenced by ns3::StaWifiMac::Enqueue(), ns3::AdhocWifiMac::Enqueue(), GetQosSupported(), Receive(), and SetQosSupported().