MultiUserScheduler is an abstract base class defining the API that APs supporting at least VHT can use to determine the format of their next transmission. More...
#include "multi-user-scheduler.h"
Classes | |
struct | DlMuInfo |
Information to be provided in case of DL MU transmission. More... | |
struct | LastTxInfo |
Type for the information about the last transmission. More... | |
struct | UlMuInfo |
Information to be provided in case of UL MU transmission. More... | |
Public Types | |
enum | TxFormat { NO_TX = 0 , SU_TX , DL_MU_TX , UL_MU_TX } |
Enumeration of the possible transmission formats. More... | |
Public Member Functions | |
MultiUserScheduler () | |
~MultiUserScheduler () override | |
DlMuInfo & | GetDlMuInfo (uint8_t linkId) |
Get the information required to perform a DL MU transmission on the given link. More... | |
UlMuInfo & | GetUlMuInfo (uint8_t linkId) |
Get the information required to solicit an UL MU transmission on the given link. More... | |
TxFormat | NotifyAccessGranted (Ptr< QosTxop > edca, Time availableTime, bool initialFrame, uint16_t allowedWidth, uint8_t linkId) |
Notify the Multi-user Scheduler that the given AC of the AP gained channel access. More... | |
void | SetAccessReqInterval (Time interval) |
Set the duration of the interval between two consecutive requests for channel access made by the MultiUserScheduler. More... | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. More... | |
~Object () override | |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose () |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. More... | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. More... | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated 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... | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized () 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 () const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= (const SimpleRefCount &o[[maybe_unused]]) |
Assignment operator. More... | |
void | Ref () const |
Increment the reference count. More... | |
void | Unref () 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 errors. 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 () |
Register this type. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Protected Member Functions | |
void | DoDispose () override |
Destructor implementation. More... | |
void | DoInitialize () override |
Initialize() implementation. More... | |
Ptr< HeFrameExchangeManager > | GetHeFem (uint8_t linkId) const |
Get the HE Frame Exchange Manager attached to the AP on the given link. More... | |
TxFormat | GetLastTxFormat (uint8_t linkId) |
Get the format of the last transmission on the given link, as determined by the last call to NotifyAccessGranted that did not return NO_TX. More... | |
uint32_t | GetMaxSizeOfQosNullAmpdu (const CtrlTriggerHeader &trigger) const |
Get the maximum size in bytes among the A-MPDUs containing QoS Null frames and solicited by the given (BSRP) Trigger Frame. More... | |
Ptr< WifiMpdu > | GetTriggerFrame (const CtrlTriggerHeader &trigger, uint8_t linkId) const |
Get an MPDU containing the given Trigger Frame. More... | |
Ptr< WifiRemoteStationManager > | GetWifiRemoteStationManager (uint8_t linkId) const |
Get the station manager attached to the AP on the given link. More... | |
void | NotifyNewAggregate () override |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. 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 () |
Notifier called once the ObjectBase is fully constructed. More... | |
Protected Attributes | |
uint16_t | m_allowedWidth |
the allowed width in MHz for the current transmission More... | |
Ptr< ApWifiMac > | m_apMac |
the AP wifi MAC More... | |
Time | m_availableTime |
the time available for frame exchange More... | |
Ptr< QosTxop > | m_edca |
the AC that gained channel access More... | |
bool | m_initialFrame |
true if a TXOP is being started More... | |
uint8_t | m_linkId |
the ID of the link over which channel access has been granted More... | |
Private Member Functions | |
void | AccessReqTimeout () |
Perform actions required on expiration of the channel access request timer, such as requesting channel access (if not requested already) and restarting the channel access request timer. More... | |
void | CheckTriggerFrame () |
Ensure that the Trigger Frame returned in case of UL MU transmission is correct. More... | |
virtual DlMuInfo | ComputeDlMuInfo ()=0 |
Compute the information required to perform a DL MU transmission. More... | |
virtual UlMuInfo | ComputeUlMuInfo ()=0 |
Prepare the information required to solicit an UL MU transmission. More... | |
virtual TxFormat | SelectTxFormat ()=0 |
Select the format of the next transmission. More... | |
void | SetWifiMac (Ptr< ApWifiMac > mac) |
Set the wifi MAC. More... | |
Private Attributes | |
AcIndex | m_accessReqAc |
AC we request channel access for. More... | |
Time | m_accessReqInterval |
duration of the interval between channel access requests More... | |
EventId | m_accessReqTimer |
the timer controlling additional channel access requests More... | |
std::map< uint8_t, LastTxInfo > | m_lastTxInfo |
Information about the last transmission. More... | |
bool | m_restartTimerUponAccess |
whether the channel access timer has to be restarted upon channel access More... | |
Additional Inherited Members | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
MultiUserScheduler is an abstract base class defining the API that APs supporting at least VHT can use to determine the format of their next transmission.
VHT APs can only transmit DL MU PPDUs by using MU-MIMO, while HE APs can transmit both DL MU PPDUs and UL MU PPDUs by using OFDMA in addition to MU-MIMO.
However, given that DL MU-MIMO is not yet supported, a MultiUserScheduler can only be aggregated to HE APs.
Definition at line 51 of file multi-user-scheduler.h.
Enumeration of the possible transmission formats.
Enumerator | |
---|---|
NO_TX | |
SU_TX | |
DL_MU_TX | |
UL_MU_TX |
Definition at line 63 of file multi-user-scheduler.h.
ns3::MultiUserScheduler::MultiUserScheduler | ( | ) |
Definition at line 81 of file multi-user-scheduler.cc.
|
override |
Definition at line 85 of file multi-user-scheduler.cc.
References NS_LOG_FUNCTION_NOARGS.
|
private |
Perform actions required on expiration of the channel access request timer, such as requesting channel access (if not requested already) and restarting the channel access request timer.
Definition at line 175 of file multi-user-scheduler.cc.
References ns3::WifiMac::GetChannelAccessManager(), ns3::WifiMac::GetNLinks(), ns3::WifiMac::GetQosTxop(), ns3::Time::IsStrictlyPositive(), m_accessReqAc, m_accessReqInterval, m_accessReqTimer, m_apMac, ns3::Txop::NOT_REQUESTED, NS_LOG_FUNCTION, ns3::ChannelAccessManager::RequestAccess(), and ns3::Simulator::Schedule().
Referenced by DoInitialize(), NotifyAccessGranted(), and SetAccessReqInterval().
|
private |
Ensure that the Trigger Frame returned in case of UL MU transmission is correct.
Currently, this method sets the CS Required, the AP Tx Power and the UL Target Receive Power subfields.
Definition at line 307 of file multi-user-scheduler.cc.
References GetHeFem(), m_lastTxInfo, m_linkId, and NS_LOG_FUNCTION.
Referenced by NotifyAccessGranted().
|
privatepure virtual |
Compute the information required to perform a DL MU transmission.
Implemented in TestMultiUserScheduler, and ns3::RrMultiUserScheduler.
Referenced by NotifyAccessGranted().
|
privatepure virtual |
Prepare the information required to solicit an UL MU transmission.
Implemented in TestMultiUserScheduler, and ns3::RrMultiUserScheduler.
Referenced by NotifyAccessGranted().
|
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.
Reimplemented in ns3::RrMultiUserScheduler.
Definition at line 91 of file multi-user-scheduler.cc.
References ns3::EventId::Cancel(), ns3::Object::DoDispose(), m_accessReqTimer, m_apMac, m_edca, m_lastTxInfo, and NS_LOG_FUNCTION.
Referenced by ns3::RrMultiUserScheduler::DoDispose().
|
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.
Reimplemented in ns3::RrMultiUserScheduler.
Definition at line 119 of file multi-user-scheduler.cc.
References AccessReqTimeout(), ns3::Time::IsStrictlyPositive(), m_accessReqInterval, m_accessReqTimer, NS_LOG_FUNCTION, and ns3::Simulator::Schedule().
Referenced by ns3::RrMultiUserScheduler::DoInitialize().
MultiUserScheduler::DlMuInfo & ns3::MultiUserScheduler::GetDlMuInfo | ( | uint8_t | linkId | ) |
Get the information required to perform a DL MU transmission on the given link.
Note that this method can only be called if GetTxFormat returns DL_MU_TX on the given link.
linkId | the ID of the given link |
Definition at line 251 of file multi-user-scheduler.cc.
References DL_MU_TX, GetWifiRemoteStationManager(), ns3::ApWifiMac::IsAssociated(), m_apMac, m_lastTxInfo, and NS_ABORT_MSG_IF.
|
protected |
Get the HE Frame Exchange Manager attached to the AP on the given link.
linkId | the ID of the given link |
Definition at line 169 of file multi-user-scheduler.cc.
References ns3::WifiMac::GetFrameExchangeManager(), and m_apMac.
Referenced by CheckTriggerFrame(), GetTriggerFrame(), TestMultiUserScheduler::SelectTxFormat(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
|
protected |
Get the format of the last transmission on the given link, as determined by the last call to NotifyAccessGranted that did not return NO_TX.
linkId | the ID of the given link |
Definition at line 245 of file multi-user-scheduler.cc.
References m_lastTxInfo.
Referenced by ns3::RrMultiUserScheduler::SelectTxFormat().
|
protected |
Get the maximum size in bytes among the A-MPDUs containing QoS Null frames and solicited by the given (BSRP) Trigger Frame.
For each station addressed by the Trigger Frame, the expected response is an A-MPDU containing as many QoS Null frames as the number of TIDs for which a BlockAck agreement has been established between the station and the AP.
trigger | the given Trigger Frame |
Definition at line 320 of file multi-user-scheduler.cc.
References first::address, ns3::WifiMac::GetBaAgreementEstablishedAsRecipient(), ns3::ApWifiMac::GetMldOrLinkAddressByAid(), ns3::WifiMacHeader::GetSerializedSize(), ns3::MpduAggregator::GetSizeIfAggregated(), m_apMac, max, NS_ASSERT_MSG, ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsTo(), ns3::WIFI_MAC_FCS_LENGTH, and ns3::WIFI_MAC_QOSDATA_NULL.
Referenced by TestMultiUserScheduler::SelectTxFormat(), and ns3::RrMultiUserScheduler::TrySendingBsrpTf().
|
protected |
Get an MPDU containing the given Trigger Frame.
trigger | the given Trigger Frame |
linkId | the ID of the link on which the Trigger Frame has to be sent |
Definition at line 281 of file multi-user-scheduler.cc.
References ns3::Packet::AddHeader(), ns3::CtrlTriggerHeader::begin(), ns3::Mac48Address::GetBroadcast(), GetHeFem(), ns3::CtrlTriggerHeader::GetNUserInfoFields(), ns3::ApWifiMac::GetStaList(), m_apMac, NS_ASSERT, NS_LOG_FUNCTION, ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), and ns3::WIFI_MAC_CTL_TRIGGER.
Referenced by ns3::RrMultiUserScheduler::TrySendingBasicTf(), and ns3::RrMultiUserScheduler::TrySendingBsrpTf().
|
static |
Get the type ID.
Definition at line 40 of file multi-user-scheduler.cc.
References ns3::AC_BE, ns3::AC_BK, ns3::AC_VI, ns3::AC_VO, m_accessReqAc, m_accessReqInterval, m_restartTimerUponAccess, ns3::MakeBooleanAccessor(), ns3::MakeBooleanChecker(), ns3::MakeEnumChecker(), ns3::MakeTimeAccessor(), ns3::MakeTimeChecker(), ns3::Seconds(), and ns3::TypeId::SetParent().
MultiUserScheduler::UlMuInfo & ns3::MultiUserScheduler::GetUlMuInfo | ( | uint8_t | linkId | ) |
Get the information required to solicit an UL MU transmission on the given link.
Note that this method can only be called if GetTxFormat returns UL_MU_TX on the given link.
linkId | the ID of the given link |
Definition at line 272 of file multi-user-scheduler.cc.
References m_lastTxInfo, NS_ABORT_MSG_IF, and UL_MU_TX.
|
protected |
Get the station manager attached to the AP on the given link.
linkId | the ID of the given link |
Definition at line 163 of file multi-user-scheduler.cc.
References ns3::WifiMac::GetWifiRemoteStationManager(), and m_apMac.
Referenced by TestMultiUserScheduler::ComputeWifiTxVector(), GetDlMuInfo(), ns3::RrMultiUserScheduler::GetTxVectorForUlMu(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
MultiUserScheduler::TxFormat ns3::MultiUserScheduler::NotifyAccessGranted | ( | Ptr< QosTxop > | edca, |
Time | availableTime, | ||
bool | initialFrame, | ||
uint16_t | allowedWidth, | ||
uint8_t | linkId | ||
) |
Notify the Multi-user Scheduler that the given AC of the AP gained channel access.
The Multi-user Scheduler determines the format of the next transmission.
edca | the EDCAF which has been granted the opportunity to transmit |
availableTime | the amount of time allowed for the frame exchange. Pass Time::Min() in case the TXOP limit is null |
initialFrame | true if the frame being transmitted is the initial frame of the TXOP. This is used to determine whether the TXOP limit can be exceeded |
allowedWidth | the allowed width in MHz for the next transmission |
linkId | the ID of the link over which channel access was gained |
Definition at line 199 of file multi-user-scheduler.cc.
References AccessReqTimeout(), ns3::EventId::Cancel(), CheckTriggerFrame(), ComputeDlMuInfo(), ComputeUlMuInfo(), DL_MU_TX, ns3::EventId::IsRunning(), ns3::Time::IsStrictlyPositive(), m_accessReqInterval, m_accessReqTimer, m_allowedWidth, m_availableTime, m_edca, m_initialFrame, m_lastTxInfo, m_linkId, m_restartTimerUponAccess, NO_TX, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), SelectTxFormat(), and UL_MU_TX.
|
overrideprotectedvirtual |
Notify all Objects aggregated to this one of a new Object being aggregated.
This function must be implemented in the stack that needs to notify other stacks connected to the node of their presence in the node.
This method is invoked whenever two sets of Objects are aggregated together. It is invoked exactly once for each Object in both sets. This method can be overridden by subclasses who wish to be notified of aggregation events. These subclasses must chain up to their base class NotifyNewAggregate() method.
It is safe to call GetObject() and AggregateObject() from within this method.
Reimplemented from ns3::Object.
Definition at line 102 of file multi-user-scheduler.cc.
References m_apMac, ns3::Object::NotifyNewAggregate(), NS_LOG_FUNCTION, and SetWifiMac().
|
privatepure virtual |
Select the format of the next transmission.
Implemented in TestMultiUserScheduler, and ns3::RrMultiUserScheduler.
Referenced by NotifyAccessGranted().
void ns3::MultiUserScheduler::SetAccessReqInterval | ( | Time | interval | ) |
Set the duration of the interval between two consecutive requests for channel access made by the MultiUserScheduler.
interval | the duration of the interval between two consecutive requests for channel access |
Definition at line 131 of file multi-user-scheduler.cc.
References AccessReqTimeout(), ns3::Time::As(), ns3::Object::IsInitialized(), ns3::Time::IsStrictlyPositive(), m_accessReqInterval, m_accessReqTimer, ns3::Time::MS, NS_LOG_FUNCTION, and ns3::Simulator::Schedule().
Set the wifi MAC.
Note that it must be the MAC of an HE AP.
mac | the AP wifi MAC |
Definition at line 144 of file multi-user-scheduler.cc.
References ns3::WifiMac::GetFrameExchangeManager(), ns3::WifiMac::GetHeConfiguration(), ns3::WifiMac::GetNLinks(), m_apMac, third::mac, NS_ABORT_MSG_IF, NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by NotifyNewAggregate().
|
private |
AC we request channel access for.
Definition at line 248 of file multi-user-scheduler.h.
Referenced by AccessReqTimeout(), and GetTypeId().
|
private |
duration of the interval between channel access requests
Definition at line 247 of file multi-user-scheduler.h.
Referenced by AccessReqTimeout(), DoInitialize(), GetTypeId(), NotifyAccessGranted(), and SetAccessReqInterval().
|
private |
the timer controlling additional channel access requests
Definition at line 246 of file multi-user-scheduler.h.
Referenced by AccessReqTimeout(), DoDispose(), DoInitialize(), NotifyAccessGranted(), and SetAccessReqInterval().
|
protected |
the allowed width in MHz for the current transmission
Definition at line 189 of file multi-user-scheduler.h.
Referenced by ns3::RrMultiUserScheduler::GetTxVectorForUlMu(), NotifyAccessGranted(), TestMultiUserScheduler::SelectTxFormat(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
the AP wifi MAC
Definition at line 185 of file multi-user-scheduler.h.
Referenced by AccessReqTimeout(), TestMultiUserScheduler::ComputeWifiTxVector(), DoDispose(), ns3::RrMultiUserScheduler::DoDispose(), ns3::RrMultiUserScheduler::DoInitialize(), GetDlMuInfo(), GetHeFem(), GetMaxSizeOfQosNullAmpdu(), GetTriggerFrame(), ns3::RrMultiUserScheduler::GetTxVectorForUlMu(), GetWifiRemoteStationManager(), NotifyNewAggregate(), ns3::RrMultiUserScheduler::NotifyStationAssociated(), ns3::RrMultiUserScheduler::NotifyStationDeassociated(), ns3::RrMultiUserScheduler::SelectTxFormat(), TestMultiUserScheduler::SelectTxFormat(), SetWifiMac(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
|
protected |
the time available for frame exchange
Definition at line 187 of file multi-user-scheduler.h.
Referenced by NotifyAccessGranted(), TestMultiUserScheduler::SelectTxFormat(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
the AC that gained channel access
Definition at line 186 of file multi-user-scheduler.h.
Referenced by DoDispose(), NotifyAccessGranted(), ns3::RrMultiUserScheduler::SelectTxFormat(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
|
protected |
true if a TXOP is being started
Definition at line 188 of file multi-user-scheduler.h.
Referenced by NotifyAccessGranted(), TestMultiUserScheduler::SelectTxFormat(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
|
private |
Information about the last transmission.
Definition at line 245 of file multi-user-scheduler.h.
Referenced by CheckTriggerFrame(), DoDispose(), GetDlMuInfo(), GetLastTxFormat(), GetUlMuInfo(), and NotifyAccessGranted().
|
protected |
the ID of the link over which channel access has been granted
Definition at line 190 of file multi-user-scheduler.h.
Referenced by CheckTriggerFrame(), ns3::RrMultiUserScheduler::GetTxVectorForUlMu(), NotifyAccessGranted(), ns3::RrMultiUserScheduler::SelectTxFormat(), ns3::RrMultiUserScheduler::TrySendingBasicTf(), ns3::RrMultiUserScheduler::TrySendingBsrpTf(), and ns3::RrMultiUserScheduler::TrySendingDlMuPpdu().
|
private |
whether the channel access timer has to be restarted upon channel access
Definition at line 249 of file multi-user-scheduler.h.
Referenced by GetTypeId(), and NotifyAccessGranted().