Manage a set of ns3::Txop. More...
#include "channel-access-manager.h"
Classes | |
struct | Timespan |
Structure defining start time and end time for a given state. More... | |
Public Member Functions | |
ChannelAccessManager () | |
~ChannelAccessManager () override | |
void | Add (Ptr< Txop > txop) |
void | DisableEdcaFor (Ptr< Txop > qosTxop, Time duration) |
Time | GetAccessGrantStart (bool ignoreNav=false) const |
Access will never be granted to the medium before the time returned by this method. | |
uint16_t | GetLargestIdlePrimaryChannel (Time interval, Time end) |
Return the width of the largest primary channel that has been idle for the given time interval before the given time, if any primary channel has been idle, or zero, otherwise. | |
bool | GetPer20MHzBusy (const std::set< uint8_t > &indices) const |
bool | IsBusy () const |
Check if the device is busy sending or receiving, or NAV or CCA busy. | |
bool | NeedBackoffUponAccess (Ptr< Txop > txop) |
Determine if a new backoff needs to be generated when a packet is queued for transmission. | |
void | NotifyAckTimeoutResetNow () |
Notify that ack timer has reset. | |
void | NotifyAckTimeoutStartNow (Time duration) |
Notify that ack timer has started for the given duration. | |
void | NotifyCcaBusyStartNow (Time duration, WifiChannelListType channelType, const std::vector< Time > &per20MhzDurations) |
void | NotifyCtsTimeoutResetNow () |
Notify that CTS timer has reset. | |
void | NotifyCtsTimeoutStartNow (Time duration) |
Notify that CTS timer has started for the given duration. | |
void | NotifyNavResetNow (Time duration) |
void | NotifyNavStartNow (Time duration) |
void | NotifyOffNow () |
Notify the Txop that the device has been put in off mode. | |
void | NotifyOnNow () |
Notify the Txop that the device has been resumed from off mode. | |
void | NotifyRxEndErrorNow () |
Notify the Txop that a packet reception was just completed unsuccessfuly. | |
void | NotifyRxEndOkNow () |
Notify the Txop that a packet reception was just completed successfully. | |
void | NotifyRxStartNow (Time duration) |
void | NotifySleepNow () |
Notify the Txop that the device has been put in sleep mode. | |
void | NotifySwitchingStartNow (Time duration) |
void | NotifyTxStartNow (Time duration) |
void | NotifyWakeupNow () |
Notify the Txop that the device has been resumed from sleep mode. | |
void | RemovePhyListener (Ptr< WifiPhy > phy) |
Remove current registered listener for PHY events. | |
void | RequestAccess (Ptr< Txop > txop) |
void | SetLinkId (uint8_t linkId) |
Set the ID of the link this Channel Access Manager is associated with. | |
void | SetupFrameExchangeManager (Ptr< FrameExchangeManager > feManager) |
Set up the Frame Exchange Manager. | |
void | SetupPhyListener (Ptr< WifiPhy > phy) |
Set up listener for PHY events. | |
![]() | |
Object () | |
Constructor. | |
~Object () override | |
Destructor. | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. | |
void | Dispose () |
Dispose of this Object. | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. | |
bool | IsInitialized () const |
Check if the object has been initialized. | |
![]() | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
![]() | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. | |
virtual TypeId | GetInstanceTypeId () const =0 |
Get the most derived TypeId for this Object. | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. | |
Protected Member Functions | |
void | DoDispose () override |
Destructor implementation. | |
void | DoInitialize () override |
Initialize() implementation. | |
![]() | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | DoDispose () |
Destructor implementation. | |
virtual void | DoInitialize () |
Initialize() implementation. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
![]() | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
Private Types | |
typedef std::vector< Ptr< Txop > > | Txops |
typedef for a vector of Txops | |
Private Member Functions | |
void | AccessTimeout () |
Called when access timeout should occur (e.g. | |
void | DoGrantDcfAccess () |
Grant access to Txop using DCF/EDCF contention rules. | |
void | DoRestartAccessTimeoutIfNeeded () |
Time | GetBackoffEndFor (Ptr< Txop > txop) |
Return the time when the backoff procedure ended (or will ended) for the given Txop. | |
Time | GetBackoffStartFor (Ptr< Txop > txop) |
Return the time when the backoff procedure started for the given Txop. | |
virtual Time | GetEifsNoDifs () const |
Return the EIFS duration minus a DIFS. | |
virtual Time | GetSifs () const |
Return the Short Interframe Space (SIFS) for this PHY. | |
virtual Time | GetSlot () const |
Return the slot duration for this PHY. | |
void | InitLastBusyStructs () |
Initialize the structures holding busy end times per channel type (primary, secondary, etc.) and per 20 MHz channel. | |
void | UpdateBackoff () |
Update backoff slots for all Txops. | |
void | UpdateLastIdlePeriod () |
This method determines whether the medium has been idle during a period (of non-null duration) immediately preceding the time this method is called. | |
Private Attributes | |
EventId | m_accessTimeout |
the access timeout ID | |
Time | m_eifsNoDifs |
EIFS no DIFS time. | |
Ptr< FrameExchangeManager > | m_feManager |
pointer to the Frame Exchange Manager | |
Time | m_lastAckTimeoutEnd |
the last Ack timeout end time | |
std::map< WifiChannelListType, Time > | m_lastBusyEnd |
the last busy end time for each channel type | |
Time | m_lastCtsTimeoutEnd |
the last CTS timeout end time | |
std::map< WifiChannelListType, Timespan > | m_lastIdle |
the last idle start and end time for each channel type | |
Time | m_lastNavEnd |
the last NAV end time | |
std::vector< Time > | m_lastPer20MHzBusyEnd |
the last busy end time per 20 MHz channel (HE stations and channel width > 20 MHz only) | |
Timespan | m_lastRx |
the last receive start and end time | |
bool | m_lastRxReceivedOk |
the last receive OK | |
Time | m_lastSwitchingEnd |
the last switching end time | |
Time | m_lastTxEnd |
the last transmit end time | |
uint8_t | m_linkId |
the ID of the link this object is associated with | |
bool | m_off |
flag whether it is in off state | |
Ptr< WifiPhy > | m_phy |
pointer to the PHY | |
PhyListener * | m_phyListener |
the PHY listener | |
bool | m_sleeping |
flag whether it is in sleeping state | |
Txops | m_txops |
the vector of managed Txops | |
Additional Inherited Members | |
![]() | |
static TypeId | GetTypeId () |
Register this type. | |
![]() | |
static TypeId | GetTypeId () |
Get the type ID. | |
![]() | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Manage a set of ns3::Txop.
Handle a set of independent ns3::Txop, each of which represents a single DCF within a MAC stack. Each ns3::Txop has a priority implicitly associated with it (the priority is determined when the ns3::Txop is added to the ChannelAccessManager: the first Txop to be added gets the highest priority, the second, the second highest priority, and so on.) which is used to handle "internal" collisions. i.e., when two local Txop are expected to get access to the medium at the same time, the highest priority local Txop wins access to the medium and the other Txop suffers a "internal" collision.
Definition at line 56 of file channel-access-manager.h.
|
private |
typedef for a vector of Txops
Definition at line 349 of file channel-access-manager.h.
ns3::ChannelAccessManager::ChannelAccessManager | ( | ) |
Definition at line 118 of file channel-access-manager.cc.
References ns3::MicroSeconds().
|
override |
Definition at line 135 of file channel-access-manager.cc.
References m_phyListener, and NS_LOG_FUNCTION.
|
private |
Called when access timeout should occur (e.g.
backoff procedure expired).
Definition at line 452 of file channel-access-manager.cc.
References DoGrantDcfAccess(), DoRestartAccessTimeoutIfNeeded(), NS_LOG_FUNCTION, and UpdateBackoff().
Referenced by DoRestartAccessTimeoutIfNeeded().
txop | a new Txop. |
The ChannelAccessManager does not take ownership of this pointer so, the callee must make sure that the Txop pointer will stay valid as long as the ChannelAccessManager is valid. Note that the order in which Txop objects are added to a ChannelAccessManager matters: the first Txop added has the highest priority, the second Txop added, has the second highest priority, etc.
Definition at line 220 of file channel-access-manager.cc.
References m_txops, and NS_LOG_FUNCTION.
Referenced by ns3::MeshWifiInterfaceMac::ConfigureContentionWindow(), and ns3::ApWifiMac::ConfigureStandard().
qosTxop | a QosTxop that needs to be disabled |
duration | the amount of time during which the QosTxop is disabled |
Disable the given EDCA for the given amount of time. This EDCA will not be granted channel access during this period and the backoff timer will be frozen. After this period, the EDCA will start normal operations again by resuming the backoff timer.
Definition at line 662 of file channel-access-manager.cc.
References DoRestartAccessTimeoutIfNeeded(), m_linkId, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, and UpdateBackoff().
Referenced by ns3::QosTxop::StartMuEdcaTimerNow().
|
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 150 of file channel-access-manager.cc.
References m_feManager, m_phy, m_txops, and NS_LOG_FUNCTION.
|
private |
Grant access to Txop using DCF/EDCF contention rules.
This is the first Txop we find with an expired backoff and which needs access to the medium. i.e., it has data to send.
all other Txops with a lower priority whose backoff has expired and which needed access to the medium must be notified that we did get an internal collision.
Now, we notify all of these changes in one go if the EDCAF winning the contention actually transmitted a frame. It is necessary to perform first the calculations of which Txops are colliding and then only apply the changes because applying the changes through notification could change the global state of the manager, and, thus, could change the result of the calculations.
Definition at line 373 of file channel-access-manager.cc.
References GetBackoffEndFor(), ns3::WifiPhy::GetChannelWidth(), GetLargestIdlePrimaryChannel(), ns3::WifiPhy::GetOperatingChannel(), ns3::WifiPhy::GetPhyBand(), ns3::WifiPhy::GetPifs(), GetSifs(), GetSlot(), ns3::WifiPhyOperatingChannel::IsOfdm(), m_feManager, m_linkId, m_phy, m_txops, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Txop::REQUESTED, and ns3::WIFI_PHY_BAND_2_4GHZ.
Referenced by AccessTimeout(), and RequestAccess().
|
overrideprotectedvirtual |
Initialize() implementation.
This method is called only once by Initialize(). If the user calls 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.
Definition at line 143 of file channel-access-manager.cc.
References InitLastBusyStructs(), and NS_LOG_FUNCTION.
|
private |
Is there a Txop which needs to access the medium, and, if there is one, how many slots for AIFS+backoff does it require ?
Definition at line 563 of file channel-access-manager.cc.
References AccessTimeout(), ns3::EventId::Cancel(), GetBackoffEndFor(), ns3::Simulator::GetDelayLeft(), ns3::Simulator::GetMaximumSimulationTime(), ns3::EventId::IsExpired(), ns3::EventId::IsRunning(), m_accessTimeout, m_linkId, m_txops, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Txop::REQUESTED, and ns3::Simulator::Schedule().
Referenced by AccessTimeout(), DisableEdcaFor(), NotifyAckTimeoutResetNow(), NotifyCtsTimeoutResetNow(), NotifyNavResetNow(), and RequestAccess().
Time ns3::ChannelAccessManager::GetAccessGrantStart | ( | bool | ignoreNav = false | ) | const |
Access will never be granted to the medium before the time returned by this method.
ignoreNav | flag whether NAV should be ignored |
Definition at line 461 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, GetEifsNoDifs(), GetSifs(), m_lastAckTimeoutEnd, m_lastBusyEnd, m_lastCtsTimeoutEnd, m_lastNavEnd, m_lastRx, m_lastRxReceivedOk, m_lastSwitchingEnd, m_lastTxEnd, ns3::Simulator::Now(), NS_LOG_FUNCTION, NS_LOG_INFO, and ns3::WIFI_CHANLIST_PRIMARY.
Referenced by GetBackoffStartFor(), ns3::QosFrameExchangeManager::PifsRecovery(), and RequestAccess().
Return the time when the backoff procedure ended (or will ended) for the given Txop.
txop | the Txop |
Definition at line 518 of file channel-access-manager.cc.
References ns3::Time::As(), GetBackoffStartFor(), GetSlot(), m_linkId, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Time::US.
Referenced by DoGrantDcfAccess(), and DoRestartAccessTimeoutIfNeeded().
Return the time when the backoff procedure started for the given Txop.
txop | the Txop |
Definition at line 506 of file channel-access-manager.cc.
References ns3::Time::As(), GetAccessGrantStart(), GetSlot(), m_linkId, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Time::US.
Referenced by GetBackoffEndFor(), and UpdateBackoff().
|
privatevirtual |
Return the EIFS duration minus a DIFS.
Reimplemented in ChannelAccessManagerStub.
Definition at line 214 of file channel-access-manager.cc.
References ns3::WifiPhy::GetAckTxTime(), ns3::WifiPhy::GetSifs(), and m_phy.
Referenced by GetAccessGrantStart().
Return the width of the largest primary channel that has been idle for the given time interval before the given time, if any primary channel has been idle, or zero, otherwise.
interval | the given time interval |
end | the given end time |
Definition at line 604 of file channel-access-manager.cc.
References ns3::Time::As(), m_lastIdle, NS_LOG_FUNCTION, ns3::Time::S, UpdateLastIdlePeriod(), and ns3::Time::US.
Referenced by DoGrantDcfAccess(), and LargestIdlePrimaryChannelTest::RunOne().
bool ns3::ChannelAccessManager::GetPer20MHzBusy | ( | const std::set< uint8_t > & | indices | ) | const |
indices | a set of indices (starting at 0) specifying the 20 MHz channels to test |
Definition at line 638 of file channel-access-manager.cc.
References ns3::WifiPhy::GetChannelWidth(), m_lastBusyEnd, m_lastPer20MHzBusyEnd, m_phy, ns3::Simulator::Now(), NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, and ns3::WIFI_CHANLIST_PRIMARY.
|
privatevirtual |
Return the Short Interframe Space (SIFS) for this PHY.
Reimplemented in ChannelAccessManagerStub.
Definition at line 208 of file channel-access-manager.cc.
References ns3::WifiPhy::GetSifs(), and m_phy.
Referenced by DoGrantDcfAccess(), GetAccessGrantStart(), NeedBackoffUponAccess(), and NotifyTxStartNow().
|
privatevirtual |
Return the slot duration for this PHY.
Reimplemented in ChannelAccessManagerStub.
Definition at line 202 of file channel-access-manager.cc.
References ns3::WifiPhy::GetSlot(), and m_phy.
Referenced by DoGrantDcfAccess(), GetBackoffEndFor(), GetBackoffStartFor(), NeedBackoffUponAccess(), RequestAccess(), and UpdateBackoff().
|
private |
Initialize the structures holding busy end times per channel type (primary, secondary, etc.) and per 20 MHz channel.
Definition at line 227 of file channel-access-manager.cc.
References ns3::WifiPhy::GetChannelWidth(), ns3::WifiPhy::GetOperatingChannel(), ns3::WifiPhy::GetStandard(), ns3::WifiPhyOperatingChannel::IsOfdm(), m_lastBusyEnd, m_lastIdle, m_lastPer20MHzBusyEnd, m_phy, ns3::Simulator::Now(), NS_LOG_FUNCTION, ns3::WIFI_CHANLIST_PRIMARY, ns3::WIFI_CHANLIST_SECONDARY, ns3::WIFI_CHANLIST_SECONDARY40, ns3::WIFI_CHANLIST_SECONDARY80, and ns3::WIFI_STANDARD_80211ax.
Referenced by DoInitialize(), NotifySwitchingStartNow(), and SetupPhyListener().
bool ns3::ChannelAccessManager::IsBusy | ( | ) | const |
Check if the device is busy sending or receiving, or NAV or CCA busy.
Definition at line 268 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, m_lastBusyEnd, m_lastNavEnd, m_lastRx, m_lastTxEnd, ns3::Simulator::Now(), NS_LOG_FUNCTION, and ns3::WIFI_CHANLIST_PRIMARY.
Referenced by NeedBackoffUponAccess().
Determine if a new backoff needs to be generated when a packet is queued for transmission.
txop | the Txop requesting to generate a backoff |
Definition at line 281 of file channel-access-manager.cc.
References GetSifs(), GetSlot(), ns3::Txop::GRANTED, IsBusy(), m_linkId, m_off, m_sleeping, ns3::Simulator::Now(), NS_LOG_FUNCTION, ns3::Seconds(), and UpdateBackoff().
Referenced by ns3::Txop::Queue().
void ns3::ChannelAccessManager::NotifyAckTimeoutResetNow | ( | ) |
Notify that ack timer has reset.
Definition at line 905 of file channel-access-manager.cc.
References DoRestartAccessTimeoutIfNeeded(), m_lastAckTimeoutEnd, ns3::Simulator::Now(), and NS_LOG_FUNCTION.
Referenced by ChannelAccessManagerTest< TxopType >::AddAckTimeoutReset(), ns3::FrameExchangeManager::ReceivedNormalAck(), ns3::HtFrameExchangeManager::ReceiveMpdu(), and ns3::FrameExchangeManager::RxStartIndication().
void ns3::ChannelAccessManager::NotifyAckTimeoutStartNow | ( | Time | duration | ) |
Notify that ack timer has started for the given duration.
duration | the duration of the timer |
Definition at line 897 of file channel-access-manager.cc.
References m_lastAckTimeoutEnd, ns3::Simulator::Now(), NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by ns3::FrameExchangeManager::SendMpdu(), ns3::HtFrameExchangeManager::SendPsdu(), and ns3::HeFrameExchangeManager::SendPsduMap().
void ns3::ChannelAccessManager::NotifyCcaBusyStartNow | ( | Time | duration, |
WifiChannelListType | channelType, | ||
const std::vector< Time > & | per20MhzDurations | ||
) |
duration | expected duration of CCA busy period |
channelType | the channel type for which the CCA busy state is reported. |
per20MhzDurations | vector that indicates for how long each 20 MHz subchannel (corresponding to the index of the element in the vector) is busy and where a zero duration indicates that the subchannel is idle. The vector is non-empty if the PHY supports 802.11ax or later and if the operational channel width is larger than 20 MHz. |
Notify the Txop that a CCA busy period has just started.
Definition at line 729 of file channel-access-manager.cc.
References m_lastBusyEnd, m_lastPer20MHzBusyEnd, ns3::Simulator::Now(), NS_ASSERT, NS_ASSERT_MSG, NS_LOG_FUNCTION, UpdateBackoff(), and UpdateLastIdlePeriod().
Referenced by ChannelAccessManagerTest< TxopType >::AddCcaBusyEvt(), ChannelAccessManagerTest< TxopType >::AddRxErrorEvt(), ns3::PhyListener::NotifyCcaBusyStart(), and LargestIdlePrimaryChannelTest::RunOne().
void ns3::ChannelAccessManager::NotifyCtsTimeoutResetNow | ( | ) |
Notify that CTS timer has reset.
Definition at line 920 of file channel-access-manager.cc.
References DoRestartAccessTimeoutIfNeeded(), m_lastCtsTimeoutEnd, ns3::Simulator::Now(), and NS_LOG_FUNCTION.
Referenced by ns3::FrameExchangeManager::ReceiveMpdu(), and ns3::HtFrameExchangeManager::ReceiveMpdu().
void ns3::ChannelAccessManager::NotifyCtsTimeoutStartNow | ( | Time | duration | ) |
Notify that CTS timer has started for the given duration.
duration | the duration of the timer |
Definition at line 913 of file channel-access-manager.cc.
References m_lastCtsTimeoutEnd, ns3::Simulator::Now(), and NS_LOG_FUNCTION.
Referenced by ns3::HeFrameExchangeManager::SendMuRts(), and ns3::FrameExchangeManager::SendRts().
void ns3::ChannelAccessManager::NotifyNavResetNow | ( | Time | duration | ) |
duration | the value of the received NAV. |
Called at end of RX
If the NAV reset indicates an end-of-NAV which is earlier than the previous end-of-NAV, the expected end of backoff might be later than previously thought so, we might need to restart a new access timeout.
Definition at line 872 of file channel-access-manager.cc.
References DoRestartAccessTimeoutIfNeeded(), m_lastNavEnd, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and UpdateBackoff().
Referenced by ChannelAccessManagerTest< TxopType >::AddNavReset(), ns3::FrameExchangeManager::NavResetTimeout(), and ns3::MeshWifiInterfaceMac::SwitchFrequencyChannel().
void ns3::ChannelAccessManager::NotifyNavStartNow | ( | Time | duration | ) |
duration | the value of the received NAV. |
Called at end of RX
Definition at line 888 of file channel-access-manager.cc.
References m_lastNavEnd, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and UpdateBackoff().
Referenced by ChannelAccessManagerTest< TxopType >::AddNavStart(), and ns3::FrameExchangeManager::UpdateNav().
void ns3::ChannelAccessManager::NotifyOffNow | ( | ) |
Notify the Txop that the device has been put in off mode.
Definition at line 816 of file channel-access-manager.cc.
References ns3::EventId::Cancel(), ns3::EventId::IsRunning(), m_accessTimeout, m_off, m_txops, and NS_LOG_FUNCTION.
Referenced by ns3::PhyListener::NotifyOff().
void ns3::ChannelAccessManager::NotifyOnNow | ( | ) |
Notify the Txop that the device has been resumed from off mode.
Definition at line 853 of file channel-access-manager.cc.
References m_linkId, m_off, m_txops, ns3::Txop::NOT_REQUESTED, ns3::Simulator::Now(), NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by ns3::PhyListener::NotifyOn().
void ns3::ChannelAccessManager::NotifyRxEndErrorNow | ( | ) |
Notify the Txop that a packet reception was just completed unsuccessfuly.
Definition at line 697 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, m_lastRx, m_lastRxReceivedOk, ns3::Simulator::Now(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by ChannelAccessManagerTest< TxopType >::AddRxErrorEvt(), and ns3::PhyListener::NotifyRxEndError().
void ns3::ChannelAccessManager::NotifyRxEndOkNow | ( | ) |
Notify the Txop that a packet reception was just completed successfully.
Definition at line 688 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, m_lastRx, m_lastRxReceivedOk, ns3::Simulator::Now(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by ChannelAccessManagerTest< TxopType >::AddRxOkEvt(), and ns3::PhyListener::NotifyRxEndOk().
void ns3::ChannelAccessManager::NotifyRxStartNow | ( | Time | duration | ) |
duration | expected duration of reception |
Notify the Txop that a packet reception started for the expected duration.
Definition at line 676 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, m_lastRx, m_lastRxReceivedOk, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::ChannelAccessManager::Timespan::start, UpdateBackoff(), and UpdateLastIdlePeriod().
Referenced by ChannelAccessManagerTest< TxopType >::AddRxErrorEvt(), ChannelAccessManagerTest< TxopType >::AddRxInsideSifsEvt(), ChannelAccessManagerTest< TxopType >::AddRxOkEvt(), ChannelAccessManagerTest< TxopType >::AddRxStartEvt(), ns3::PhyListener::NotifyRxStart(), and LargestIdlePrimaryChannelTest::RunOne().
void ns3::ChannelAccessManager::NotifySleepNow | ( | ) |
Notify the Txop that the device has been put in sleep mode.
Definition at line 798 of file channel-access-manager.cc.
References ns3::EventId::Cancel(), ns3::EventId::IsRunning(), m_accessTimeout, m_linkId, m_sleeping, m_txops, and NS_LOG_FUNCTION.
Referenced by ns3::PhyListener::NotifySleep().
void ns3::ChannelAccessManager::NotifySwitchingStartNow | ( | Time | duration | ) |
duration | expected duration of channel switching period |
Notify the Txop that a channel switching period has just started. During switching state, new packets can be enqueued in Txop/QosTxop but they won't access to the medium until the end of the channel switching.
Definition at line 754 of file channel-access-manager.cc.
References ns3::EventId::Cancel(), ns3::ChannelAccessManager::Timespan::end, InitLastBusyStructs(), ns3::EventId::IsRunning(), m_accessTimeout, m_feManager, m_lastAckTimeoutEnd, m_lastCtsTimeoutEnd, m_lastNavEnd, m_lastRx, m_lastRxReceivedOk, m_lastSwitchingEnd, m_lastTxEnd, m_linkId, m_txops, ns3::Txop::NOT_REQUESTED, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, and UpdateLastIdlePeriod().
Referenced by ChannelAccessManagerTest< TxopType >::AddSwitchingEvt(), and ns3::PhyListener::NotifySwitchingStart().
void ns3::ChannelAccessManager::NotifyTxStartNow | ( | Time | duration | ) |
duration | expected duration of transmission |
Notify the Txop that a packet transmission was just started and is expected to last for the specified duration.
Definition at line 707 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, GetSifs(), m_lastRx, m_lastRxReceivedOk, m_lastTxEnd, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::ChannelAccessManager::Timespan::start, UpdateBackoff(), and UpdateLastIdlePeriod().
Referenced by ChannelAccessManagerTest< TxopType >::AddTxEvt(), and ns3::PhyListener::NotifyTxStart().
void ns3::ChannelAccessManager::NotifyWakeupNow | ( | ) |
Notify the Txop that the device has been resumed from sleep mode.
Definition at line 834 of file channel-access-manager.cc.
References m_linkId, m_sleeping, m_txops, ns3::Txop::NOT_REQUESTED, ns3::Simulator::Now(), NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by ns3::PhyListener::NotifyWakeup().
Remove current registered listener for PHY events.
phy | the WifiPhy to listen to |
Definition at line 174 of file channel-access-manager.cc.
References m_phy, m_phyListener, and NS_LOG_FUNCTION.
Referenced by LargestIdlePrimaryChannelTest::DoRun().
txop | a Txop |
Notify the ChannelAccessManager that a specific Txop needs access to the medium. The ChannelAccessManager is then responsible for starting an access timer and, invoking FrameExchangeManager::StartTransmission when the access is granted if it ever gets granted.
Definition at line 338 of file channel-access-manager.cc.
References DoGrantDcfAccess(), DoRestartAccessTimeoutIfNeeded(), GetAccessGrantStart(), GetSlot(), m_linkId, m_off, m_phy, m_sleeping, ns3::WifiPhy::NotifyChannelAccessRequested(), NS_ASSERT, NS_LOG_FUNCTION, ns3::Txop::REQUESTED, and UpdateBackoff().
Referenced by ns3::MultiUserScheduler::AccessReqTimeout(), ns3::Txop::RequestAccess(), and ns3::Txop::StartAccessIfNeeded().
void ns3::ChannelAccessManager::SetLinkId | ( | uint8_t | linkId | ) |
Set the ID of the link this Channel Access Manager is associated with.
linkId | the ID of the link this Channel Access Manager is associated with |
Definition at line 187 of file channel-access-manager.cc.
References m_linkId, and NS_LOG_FUNCTION.
void ns3::ChannelAccessManager::SetupFrameExchangeManager | ( | Ptr< FrameExchangeManager > | feManager | ) |
Set up the Frame Exchange Manager.
feManager | the Frame Exchange Manager |
Definition at line 194 of file channel-access-manager.cc.
References m_feManager, and NS_LOG_FUNCTION.
Set up listener for PHY events.
phy | the WifiPhy to listen to |
Definition at line 163 of file channel-access-manager.cc.
References InitLastBusyStructs(), m_phy, m_phyListener, NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by LargestIdlePrimaryChannelTest::DoRun().
|
private |
Update backoff slots for all Txops.
Definition at line 528 of file channel-access-manager.cc.
References GetBackoffStartFor(), GetSlot(), m_linkId, m_txops, ns3::Simulator::Now(), NS_LOG_DEBUG, and NS_LOG_FUNCTION.
Referenced by AccessTimeout(), DisableEdcaFor(), NeedBackoffUponAccess(), NotifyCcaBusyStartNow(), NotifyNavResetNow(), NotifyNavStartNow(), NotifyRxStartNow(), NotifyTxStartNow(), and RequestAccess().
|
private |
This method determines whether the medium has been idle during a period (of non-null duration) immediately preceding the time this method is called.
If so, the last idle start time and end time for each channel type are updated. Otherwise, no change is made by this method. This method is normally called when we are notified of the start of a transmission, reception, CCA Busy or switching to correctly maintain the information about the last idle period.
Definition at line 928 of file channel-access-manager.cc.
References ns3::ChannelAccessManager::Timespan::end, m_lastBusyEnd, m_lastIdle, m_lastRx, m_lastSwitchingEnd, m_lastTxEnd, ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Time::S.
Referenced by GetLargestIdlePrimaryChannel(), NotifyCcaBusyStartNow(), NotifyRxStartNow(), NotifySwitchingStartNow(), and NotifyTxStartNow().
|
private |
the access timeout ID
Definition at line 368 of file channel-access-manager.h.
Referenced by DoRestartAccessTimeoutIfNeeded(), NotifyOffNow(), NotifySleepNow(), and NotifySwitchingStartNow().
|
private |
EIFS no DIFS time.
Definition at line 367 of file channel-access-manager.h.
|
private |
pointer to the Frame Exchange Manager
Definition at line 371 of file channel-access-manager.h.
Referenced by DoDispose(), DoGrantDcfAccess(), NotifySwitchingStartNow(), and SetupFrameExchangeManager().
|
private |
the last Ack timeout end time
Definition at line 352 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), NotifyAckTimeoutResetNow(), NotifyAckTimeoutStartNow(), and NotifySwitchingStartNow().
|
private |
the last busy end time for each channel type
Definition at line 359 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), GetPer20MHzBusy(), InitLastBusyStructs(), IsBusy(), NotifyCcaBusyStartNow(), and UpdateLastIdlePeriod().
|
private |
the last CTS timeout end time
Definition at line 353 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), NotifyCtsTimeoutResetNow(), NotifyCtsTimeoutStartNow(), and NotifySwitchingStartNow().
|
private |
the last idle start and end time for each channel type
Definition at line 363 of file channel-access-manager.h.
Referenced by GetLargestIdlePrimaryChannel(), InitLastBusyStructs(), and UpdateLastIdlePeriod().
|
private |
the last NAV end time
Definition at line 354 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), IsBusy(), NotifyNavResetNow(), NotifyNavStartNow(), and NotifySwitchingStartNow().
|
private |
the last busy end time per 20 MHz channel (HE stations and channel width > 20 MHz only)
Definition at line 360 of file channel-access-manager.h.
Referenced by GetPer20MHzBusy(), InitLastBusyStructs(), and NotifyCcaBusyStartNow().
|
private |
the last receive start and end time
Definition at line 355 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), IsBusy(), NotifyRxEndErrorNow(), NotifyRxEndOkNow(), NotifyRxStartNow(), NotifySwitchingStartNow(), NotifyTxStartNow(), and UpdateLastIdlePeriod().
|
private |
the last receive OK
Definition at line 356 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), NotifyRxEndErrorNow(), NotifyRxEndOkNow(), NotifyRxStartNow(), NotifySwitchingStartNow(), and NotifyTxStartNow().
|
private |
the last switching end time
Definition at line 364 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), NotifySwitchingStartNow(), and UpdateLastIdlePeriod().
|
private |
the last transmit end time
Definition at line 357 of file channel-access-manager.h.
Referenced by GetAccessGrantStart(), IsBusy(), NotifySwitchingStartNow(), NotifyTxStartNow(), and UpdateLastIdlePeriod().
|
private |
the ID of the link this object is associated with
Definition at line 372 of file channel-access-manager.h.
Referenced by DisableEdcaFor(), DoGrantDcfAccess(), DoRestartAccessTimeoutIfNeeded(), GetBackoffEndFor(), GetBackoffStartFor(), NeedBackoffUponAccess(), NotifyOnNow(), NotifySleepNow(), NotifySwitchingStartNow(), NotifyWakeupNow(), RequestAccess(), SetLinkId(), and UpdateBackoff().
|
private |
flag whether it is in off state
Definition at line 366 of file channel-access-manager.h.
Referenced by NeedBackoffUponAccess(), NotifyOffNow(), NotifyOnNow(), and RequestAccess().
pointer to the PHY
Definition at line 370 of file channel-access-manager.h.
Referenced by DoDispose(), DoGrantDcfAccess(), GetEifsNoDifs(), GetPer20MHzBusy(), GetSifs(), GetSlot(), InitLastBusyStructs(), RemovePhyListener(), RequestAccess(), and SetupPhyListener().
|
private |
the PHY listener
Definition at line 369 of file channel-access-manager.h.
Referenced by ~ChannelAccessManager(), RemovePhyListener(), and SetupPhyListener().
|
private |
flag whether it is in sleeping state
Definition at line 365 of file channel-access-manager.h.
Referenced by NeedBackoffUponAccess(), NotifySleepNow(), NotifyWakeupNow(), and RequestAccess().
|
private |
the vector of managed Txops
Definition at line 351 of file channel-access-manager.h.
Referenced by Add(), DoDispose(), DoGrantDcfAccess(), DoRestartAccessTimeoutIfNeeded(), NotifyOffNow(), NotifyOnNow(), NotifySleepNow(), NotifySwitchingStartNow(), NotifyWakeupNow(), and UpdateBackoff().