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...
Public Member Functions |
void | SetSlot (Time slotTime) |
void | SetSifs (Time sifs) |
void | SetEifsNoDifs (Time eifsNoDifs) |
void | SetPifs (Time pifs) |
void | SetCtsTimeout (Time ctsTimeout) |
void | SetAckTimeout (Time ackTimeout) |
Time | GetPifs (void) const |
Time | GetSifs (void) const |
Time | GetSlot (void) const |
Time | GetEifsNoDifs (void) const |
Time | GetCtsTimeout (void) const |
Time | GetAckTimeout (void) const |
virtual Mac48Address | GetAddress (void) const |
virtual Ssid | GetSsid (void) const |
virtual void | SetAddress (Mac48Address address) |
virtual void | SetSsid (Ssid ssid) |
virtual void | SetBssid (Mac48Address bssid) |
virtual Mac48Address | GetBssid (void) const |
virtual void | SetPromisc (void) |
| Sets the interface in promiscuous mode.
|
virtual void | Enqueue (Ptr< const Packet > packet, Mac48Address to, Mac48Address from) |
virtual bool | SupportsSendFrom (void) const |
virtual void | Enqueue (Ptr< const Packet > packet, Mac48Address to)=0 |
virtual void | SetWifiPhy (Ptr< WifiPhy > phy) |
virtual Ptr< WifiPhy > | GetWifiPhy () const |
virtual void | SetWifiRemoteStationManager (Ptr< WifiRemoteStationManager > stationManager) |
virtual Ptr
< WifiRemoteStationManager > | GetWifiRemoteStationManager () const |
virtual void | SetForwardUpCallback (ForwardUpCallback upCallback) |
virtual void | SetLinkUpCallback (Callback< void > linkUp) |
virtual void | SetLinkDownCallback (Callback< void > linkDown) |
virtual void | SetBasicBlockAckTimeout (Time blockAckTimeout) |
virtual Time | GetBasicBlockAckTimeout (void) const |
virtual void | SetCompressedBlockAckTimeout (Time blockAckTimeout) |
virtual Time | GetCompressedBlockAckTimeout (void) const |
void | SetMaxPropagationDelay (Time delay) |
Time | GetMsduLifetime (void) const |
Time | GetMaxPropagationDelay (void) const |
virtual void | SetForwardUpCallback (Callback< void, Ptr< Packet >, Mac48Address, Mac48Address > upCallback)=0 |
void | NotifyTx (Ptr< const Packet > packet) |
void | NotifyTxDrop (Ptr< const Packet > packet) |
void | NotifyRx (Ptr< const Packet > packet) |
void | NotifyPromiscRx (Ptr< const Packet > packet) |
void | NotifyRxDrop (Ptr< const Packet > packet) |
void | ConfigureStandard (enum WifiPhyStandard standard) |
virtual TypeId | GetInstanceTypeId (void) const |
template<typename T > |
Ptr< T > | GetObject (void) const |
template<typename T > |
Ptr< T > | GetObject (TypeId tid) const |
void | Dispose (void) |
void | AggregateObject (Ptr< Object > other) |
AggregateIterator | GetAggregateIterator (void) const |
void | Start (void) |
| SimpleRefCount (const SimpleRefCount &o) |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
void | Ref (void) const |
void | Unref (void) const |
uint32_t | GetReferenceCount (void) const |
void | SetAttribute (std::string name, const AttributeValue &value) |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
void | GetAttribute (std::string name, AttributeValue &value) const |
bool | GetAttributeFailSafe (std::string name, AttributeValue &attribute) const |
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) |
Protected Member Functions |
virtual void | DoStart () |
virtual void | DoDispose () |
virtual void | FinishConfigureStandard (enum WifiPhyStandard standard) |
void | SetTypeOfStation (TypeOfStation type) |
virtual void | Receive (Ptr< Packet > packet, const WifiMacHeader *hdr) |
virtual void | TxOk (const WifiMacHeader &hdr) |
virtual void | TxFailed (const WifiMacHeader &hdr) |
void | ForwardUp (Ptr< Packet > packet, Mac48Address from, Mac48Address to) |
virtual void | DeaggregateAmsduAndForward (Ptr< Packet > aggregatedPacket, const WifiMacHeader *hdr) |
virtual void | SendAddBaResponse (const MgtAddBaRequestHeader *reqHdr, Mac48Address originator) |
void | SetQosSupported (bool enable) |
bool | GetQosSupported () const |
void | ConfigureDcf (Ptr< Dcf > dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac) |
void | ConfigureCCHDcf (Ptr< Dcf > dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac) |
virtual void | NotifyNewAggregate (void) |
| Object (const Object &o) |
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).
void ns3::RegularWifiMac::DoDispose |
( |
void |
| ) |
|
|
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.
References ns3::Object::Dispose(), m_dca, m_edca, and NS_LOG_FUNCTION.
void ns3::RegularWifiMac::DoStart |
( |
void |
| ) |
|
|
protectedvirtual |
This method is called only once by Object::Start. If the user calls Object::Start multiple times, DoStart 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.
References m_dca, m_edca, NS_LOG_FUNCTION, and ns3::Object::Start().
- Parameters:
-
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.
References GetAddress(), and NS_FATAL_ERROR.
void ns3::RegularWifiMac::FinishConfigureStandard |
( |
enum WifiPhyStandard |
standard | ) |
|
|
protectedvirtual |
- Parameters:
-
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.
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.
TypeId ns3::RegularWifiMac::GetTypeId |
( |
void |
| ) |
|
|
static |
This method returns the TypeId associated to ns3::RegularWifiMac.
This object is accessible through the following paths with Config::Set and Config::Connect:
-
/NodeList/[i]/DeviceList/[i]/$ns3::WifiNetDevice/Mac/$ns3::RegularWifiMac
Attributes defined for this type:
-
QosSupported: This Boolean attribute is set to enable 802.11e/WMM-style QoS support at this STA
-
Set with class: BooleanValue
-
Underlying type: bool
-
Initial value: false
-
Flags: construct write read
-
DcaTxop: The DcaTxop object
-
VO_EdcaTxopN: Queue that manages packets belonging to AC_VO access class
-
VI_EdcaTxopN: Queue that manages packets belonging to AC_VI access class
-
BE_EdcaTxopN: Queue that manages packets belonging to AC_BE access class
-
BK_EdcaTxopN: Queue that manages packets belonging to AC_BK access class
Attributes defined in parent class ns3::WifiMac:
-
CtsTimeout: When this timeout expires, the RTS/CTS handshake has failed.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +75000.0ns
-
Flags: construct write read
-
AckTimeout: When this timeout expires, the DATA/ACK handshake has failed.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +75000.0ns
-
Flags: construct write read
-
BasicBlockAckTimeout: When this timeout expires, the BASIC_BLOCK_ACK_REQ/BASIC_BLOCK_ACK handshake has failed.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +281000.0ns
-
Flags: construct write read
-
CompressedBlockAckTimeout: When this timeout expires, the COMPRESSED_BLOCK_ACK_REQ/COMPRESSED_BLOCK_ACK handshake has failed.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +99000.0ns
-
Flags: construct write read
-
Sifs: The value of the SIFS constant.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +16000.0ns
-
Flags: construct write read
-
EifsNoDifs: The value of EIFS-DIFS
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +60000.0ns
-
Flags: construct write read
-
Slot: The duration of a Slot.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +9000.0ns
-
Flags: construct write read
-
Pifs: The value of the PIFS constant.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +25000.0ns
-
Flags: construct write read
-
MaxPropagationDelay: The maximum propagation delay. Unused for now.
-
Set with class: TimeValue
-
Underlying type: Time
-
Initial value: +3333.0ns
-
Flags: construct write read
-
Ssid: The ssid we want to belong to.
-
Set with class: SsidValue
-
Underlying type: Ssid
-
Initial value: default
-
Flags: construct write read
TraceSources defined for this type:
-
TxOkHeader: The header of successfully transmitted packet
-
TxErrHeader: The header of unsuccessfully transmitted packet
TraceSources defined in parent class ns3::WifiMac:
-
MacTx: A packet has been received from higher layers and is being processed in preparation for queueing for transmission.
-
MacTxDrop: A packet has been dropped in the MAC layer before being queued for transmission.
-
MacPromiscRx: A packet has been received by this device, has been passed up from the physical layer and is being forwarded up the local protocol stack. This is a promiscuous trace,
-
MacRx: A packet has been received by this device, has been passed up from the physical layer and is being forwarded up the local protocol stack. This is a non-promiscuous trace,
-
MacRxDrop: A packet has been dropped in the MAC layer after it has been passed up from the physical layer.
Reimplemented from ns3::WifiMac.
Reimplemented in ns3::MeshWifiInterfaceMac, ns3::StaWifiMac, ns3::ApWifiMac, and ns3::AdhocWifiMac.
References GetQosSupported(), ns3::MakeTraceSourceAccessor(), ns3::TypeId::SetParent(), and SetQosSupported().
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.
- Parameters:
-
packet | the packet that has been received. |
hdr | a pointer to the MAC header of the received frame. |
References ns3::MacLow::DestroyBlockAckAgreement(), GetAddress(), m_edca, m_qosSupported, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_FUNCTION, ns3::QosUtilsMapTidToAc(), ns3::Packet::RemoveHeader(), and SendAddBaResponse().
bool ns3::RegularWifiMac::m_qosSupported |
|
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.
Referenced by ns3::StaWifiMac::Enqueue(), ns3::AdhocWifiMac::Enqueue(), GetQosSupported(), Receive(), and SetQosSupported().