EhtFrameExchangeManager handles the frame exchange sequences for EHT stations. More...
#include "eht-frame-exchange-manager.h"
Public Member Functions | |
EhtFrameExchangeManager () | |
~EhtFrameExchangeManager () override | |
bool | CheckEmlsrClientStartingTxop (const WifiMacHeader &hdr, const WifiTxVector &txVector) |
Check if the frame received (or being received) is sent by an EMLSR client to start an UL TXOP. | |
Ptr< WifiMpdu > | CreateAliasIfNeeded (Ptr< WifiMpdu > mpdu) const override |
Create an alias of the given MPDU for transmission by this Frame Exchange Manager. | |
void | EmlsrSwitchToListening (Mac48Address address, const Time &delay) |
This method is intended to be called when an AP MLD detects that an EMLSR client previously involved in the current TXOP will start waiting for the transition delay interval (to switch back to listening operation) after the given delay. | |
bool | GetEmlsrSwitchToListening (Ptr< const WifiPsdu > psdu, uint16_t aid, const Mac48Address &address) const |
std::optional< dBm_u > | GetMostRecentRssi (const Mac48Address &address) const override |
Get the RSSI of the most recent packet received from the station having the given address. | |
EventId & | GetOngoingTxopEndEvent () |
void | NotifySwitchingEmlsrLink (Ptr< WifiPhy > phy, uint8_t linkId, Time delay) |
Notify that the given PHY will switch channel to operate on another EMLSR link after the given delay. | |
void | SendEmlOmn (const Mac48Address &dest, const MgtEmlOmn &frame) |
Send an EML Operating Mode Notification frame to the given station. | |
void | SetIcfPaddingAndTxVector (CtrlTriggerHeader &trigger, WifiTxVector &txVector) const |
Set the padding and the TXVECTOR of the given Trigger Frame, in case it is an Initial Control Frame for some EMLSR client(s). | |
void | SetLinkId (uint8_t linkId) override |
Set the ID of the link this Frame Exchange Manager is associated with. | |
bool | StartTransmission (Ptr< Txop > edca, MHz_u allowedWidth) override |
Request the FrameExchangeManager to start a frame exchange sequence. | |
bool | UsingOtherEmlsrLink () const |
Public Member Functions inherited from ns3::HeFrameExchangeManager | |
HeFrameExchangeManager () | |
~HeFrameExchangeManager () override | |
void | CalculateAcknowledgmentTime (WifiAcknowledgment *acknowledgment) const override |
Calculate the time required to acknowledge a frame according to the given acknowledgment method. | |
void | CalculateProtectionTime (WifiProtection *protection) const override |
Calculate the time required to protect a frame according to the given protection method. | |
std::optional< Mac48Address > | FindTxopHolder (const WifiMacHeader &hdr, const WifiTxVector &txVector) override |
Determine the holder of the TXOP, if possible, based on the received frame. | |
std::set< Mac48Address > | GetTfRecipients (const CtrlTriggerHeader &trigger) const |
Get the (link) address of the non-AP stations solicited by the given Trigger Frame. | |
bool | IsIntraBssPpdu (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) const |
Return whether the received frame is classified as intra-BSS. | |
void | SetMultiUserScheduler (const Ptr< MultiUserScheduler > muScheduler) |
Set the Multi-user Scheduler associated with this Frame Exchange Manager. | |
virtual void | SetTargetRssi (CtrlTriggerHeader &trigger) const |
Set the UL Target RSSI subfield of every User Info fields of the given Trigger Frame to the most recent RSSI observed from the corresponding station. | |
bool | StartFrameExchange (Ptr< QosTxop > edca, Time availableTime, bool initialFrame) override |
Start a frame exchange (including protection frames and acknowledgment frames as needed) that fits within the given availableTime (if different than Time::Min()). | |
bool | UlMuCsMediumIdle (const CtrlTriggerHeader &trigger) const |
This method is intended to be called a SIFS after the reception of a Trigger Frame to determine whether the station is allowed to respond. | |
bool | VirtualCsMediumIdle () const override |
Public Member Functions inherited from ns3::VhtFrameExchangeManager | |
VhtFrameExchangeManager () | |
~VhtFrameExchangeManager () override | |
Ptr< WifiPsdu > | GetWifiPsdu (Ptr< WifiMpdu > mpdu, const WifiTxVector &txVector) const override |
Get a PSDU containing the given MPDU. | |
Public Member Functions inherited from ns3::HtFrameExchangeManager | |
HtFrameExchangeManager () | |
~HtFrameExchangeManager () override | |
void | CalculateAcknowledgmentTime (WifiAcknowledgment *acknowledgment) const override |
Calculate the time required to acknowledge a frame according to the given acknowledgment method. | |
Ptr< WifiMpdu > | GetBar (AcIndex ac, std::optional< uint8_t > optTid=std::nullopt, std::optional< Mac48Address > optAddress=std::nullopt) |
Get the next BlockAckRequest or MU-BAR Trigger Frame to send, if any. | |
Ptr< MpduAggregator > | GetMpduAggregator () const |
Returns the aggregator used to construct A-MPDU subframes. | |
Ptr< MsduAggregator > | GetMsduAggregator () const |
Returns the aggregator used to construct A-MSDU subframes. | |
virtual bool | IsWithinAmpduSizeLimit (uint32_t ampduSize, Mac48Address receiver, uint8_t tid, WifiModulationClass modulation) const |
Check whether an A-MPDU of the given size meets the constraint on the maximum size for A-MPDUs sent to the given receiver, belonging to the given TID and transmitted using the given modulation class. | |
bool | IsWithinLimitsIfAddMpdu (Ptr< const WifiMpdu > mpdu, const WifiTxParameters &txParams, Time ppduDurationLimit) const override |
Check if the PSDU obtained by aggregating the given MPDU to the PSDU specified by the given TX parameters meets the constraints on the maximum A-MPDU size and its transmission time does not exceed the given PPDU duration limit (if different than Time::Min()). | |
virtual bool | IsWithinLimitsIfAggregateMsdu (Ptr< const WifiMpdu > msdu, const WifiTxParameters &txParams, Time ppduDurationLimit) const |
Check if the PSDU obtained by aggregating the given MSDU to the PSDU specified by the given TX parameters meets the constraints on the maximum A-MSDU size and its transmission time does not exceed the given PPDU duration limit (if different than Time::Min()). | |
void | SendAddBaResponse (const MgtAddBaRequestHeader &reqHdr, Mac48Address originator) |
This method can be called to accept a received ADDBA Request. | |
void | SendDelbaFrame (Mac48Address addr, uint8_t tid, bool byOriginator) |
Sends DELBA frame to cancel a block ack agreement with STA addressed by addr for TID tid. | |
void | SetWifiMac (const Ptr< WifiMac > mac) override |
Set the MAC layer to use. | |
bool | StartFrameExchange (Ptr< QosTxop > edca, Time availableTime, bool initialFrame) override |
Start a frame exchange (including protection frames and acknowledgment frames as needed) that fits within the given availableTime (if different than Time::Min()). | |
virtual bool | TryAggregateMsdu (Ptr< const WifiMpdu > msdu, WifiTxParameters &txParams, Time availableTime) const |
Check if aggregating an MSDU to the current MPDU (as specified by the given TX parameters) does not violate the size and time constraints, while taking into account the possibly updated protection and acknowledgment methods. | |
Public Member Functions inherited from ns3::QosFrameExchangeManager | |
QosFrameExchangeManager () | |
~QosFrameExchangeManager () override | |
virtual bool | IsWithinSizeAndTimeLimits (uint32_t ppduPayloadSize, Mac48Address receiver, const WifiTxParameters &txParams, Time ppduDurationLimit) const |
Check whether the transmission time of the frame being built (as described by the given TX parameters) does not exceed the given PPDU duration limit if the size of the PSDU addressed to the given receiver becomes ppduPayloadSize. | |
bool | StartTransmission (Ptr< Txop > edca, MHz_u allowedWidth) override |
Request the FrameExchangeManager to start a frame exchange sequence. | |
bool | TryAddMpdu (Ptr< const WifiMpdu > mpdu, WifiTxParameters &txParams, Time availableTime) const |
Recompute the protection and acknowledgment methods to use if the given MPDU is added to the frame being built (as described by the given TX parameters) and check whether the duration of the frame exchange sequence (including protection and acknowledgment) does not exceed the given available time. | |
Public Member Functions inherited from ns3::FrameExchangeManager | |
FrameExchangeManager () | |
~FrameExchangeManager () override | |
Ptr< WifiAckManager > | GetAckManager () const |
Get the Acknowledgment Manager used by this node. | |
Mac48Address | GetAddress () const |
Get the MAC address. | |
MHz_u | GetAllowedWidth () const |
Mac48Address | GetBssid () const |
Get the Basic Service Set Identification. | |
std::optional< std::reference_wrapper< const OngoingRxInfo > > | GetOngoingRxInfo () const |
const std::set< Mac48Address > & | GetProtectedStas () const |
Ptr< WifiProtectionManager > | GetProtectionManager () const |
Get the Protection Manager used by this node. | |
std::optional< std::reference_wrapper< const WifiMacHeader > > | GetReceivedMacHdr () const |
const WifiTxTimer & | GetWifiTxTimer () const |
Get a const reference to the WifiTxTimer object. | |
bool | IsPromisc () const |
Check if the device is operating in promiscuous mode. | |
virtual void | NotifyInternalCollision (Ptr< Txop > txop) |
Notify that an internal collision has occurred for the given Txop. | |
void | NotifyOffNow () |
This method is typically invoked by the PhyListener to notify the MAC layer that the device has been put into off mode. | |
void | NotifySleepNow () |
This method is typically invoked by the PhyListener to notify the MAC layer that the device has been put into sleep mode. | |
virtual void | NotifySwitchingStartNow (Time duration) |
void | Receive (Ptr< const WifiPsdu > psdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &perMpduStatus) |
This method is intended to be called by the PHY layer every time an MPDU is received and also when the reception of an A-MPDU is completed. | |
virtual void | ResetPhy () |
Remove WifiPhy associated with this FrameExchangeManager. | |
void | SetAckedMpduCallback (AckedMpdu callback) |
Set the callback to invoke when an MPDU is successfully acked. | |
virtual void | SetAckManager (Ptr< WifiAckManager > ackManager) |
Set the Acknowledgment Manager to use. | |
virtual void | SetAddress (Mac48Address address) |
Set the MAC address. | |
virtual void | SetBssid (Mac48Address bssid) |
Set the Basic Service Set Identification. | |
virtual void | SetChannelAccessManager (const Ptr< ChannelAccessManager > channelAccessManager) |
Set the channel access manager to use. | |
virtual void | SetDroppedMpduCallback (DroppedMpdu callback) |
Set the callback to invoke when an MPDU is dropped. | |
virtual void | SetMacRxMiddle (const Ptr< MacRxMiddle > rxMiddle) |
Set the MAC RX Middle to use. | |
virtual void | SetMacTxMiddle (const Ptr< MacTxMiddle > txMiddle) |
Set the MAC TX Middle to use. | |
void | SetPromisc () |
Enable promiscuous mode. | |
virtual void | SetProtectionManager (Ptr< WifiProtectionManager > protectionManager) |
Set the Protection Manager to use. | |
virtual void | SetWifiPhy (const Ptr< WifiPhy > phy) |
Set the PHY layer to use. | |
Public Member Functions inherited from ns3::Object | |
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. | |
void | UnidirectionalAggregateObject (Ptr< Object > other) |
Aggregate an Object to another Object. | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
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. | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value, bool permissive=false) 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. | |
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. | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::HeFrameExchangeManager | |
static Ptr< WifiPsdu > | GetPsduTo (Mac48Address to, const WifiPsduMap &psduMap) |
Get the PSDU in the given PSDU map that is addressed to the given MAC address, if any, or a null pointer, otherwise. | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::VhtFrameExchangeManager | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::HtFrameExchangeManager | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::QosFrameExchangeManager | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::FrameExchangeManager | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. | |
Public Attributes | |
TracedCallback< WifiIcfDrop, uint8_t > | m_icfDropCallback |
ICF drop reason traced callback (WifiMac exposes this trace source) | |
Protected Member Functions | |
void | BlockAcksInTbPpduTimeout (WifiPsduMap *psduMap, std::size_t nSolicitedStations) override |
Take the necessary actions after that some BlockAck frames are missing in response to a DL MU PPDU. | |
void | CtsAfterMuRtsTimeout (Ptr< WifiMpdu > muRts, const WifiTxVector &txVector) override |
Called when no CTS frame is received after an MU-RTS. | |
void | DoDispose () override |
Destructor implementation. | |
bool | EmlsrClientCannotRespondToIcf () const |
void | EndReceiveAmpdu (Ptr< const WifiPsdu > psdu, const RxSignalInfo &rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &perMpduStatus) override |
This method is called when the reception of an A-MPDU including multiple MPDUs is completed. | |
void | ForwardPsduDown (Ptr< const WifiPsdu > psdu, WifiTxVector &txVector) override |
Forward a PSDU down to the PHY layer. | |
void | ForwardPsduMapDown (WifiConstPsduMap psduMap, WifiTxVector &txVector) override |
Forward a map of PSDUs down to the PHY layer. | |
void | IntraBssNavResetTimeout () override |
Reset the intra-BSS NAV upon expiration of the intra-BSS NAV reset timer. | |
bool | IsCrossLinkCollision (const std::set< Mac48Address > &staMissedResponseFrom) |
Check whether all the stations that did not respond (to a certain frame) are EMLSR clients trying to start an UL TXOP on another link. | |
void | NavResetTimeout () override |
Reset the NAV upon expiration of the NAV reset timer. | |
void | NotifyChannelReleased (Ptr< Txop > txop) override |
Notify the given Txop that channel has been released. | |
void | PostProcessFrame (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Perform actions that are possibly needed after receiving any frame, independently of whether the frame is addressed to this station (e.g., setting the NAV or the TXOP holder). | |
void | PreProcessFrame (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Perform actions that are possibly needed when receiving any frame, independently of whether the frame is addressed to this station (e.g., storing buffer status reports). | |
void | ProtectionCompleted () override |
Transmit prepared frame immediately, if no protection was used, or in a SIFS, if protection was completed successfully. | |
void | PsduRxError (Ptr< const WifiPsdu > psdu) override |
This method is called when the reception of a PSDU fails. | |
void | ReceivedQosNullAfterBsrpTf (Mac48Address sender) override |
Perform the actions required when receiving QoS Null frame(s) from the given sender after a BSRP Trigger Frame. | |
void | ReceiveMpdu (Ptr< const WifiMpdu > mpdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, bool inAmpdu) override |
This method handles the reception of an MPDU (possibly included in an A-MPDU) | |
void | RxStartIndication (WifiTxVector txVector, Time psduDuration) override |
void | SendCtsAfterMuRts (const WifiMacHeader &muRtsHdr, const CtrlTriggerHeader &trigger, double muRtsSnr) override |
Send CTS after receiving an MU-RTS. | |
void | SendCtsAfterRts (const WifiMacHeader &rtsHdr, WifiMode rtsTxMode, double rtsSnr) override |
Send CTS after receiving RTS. | |
void | SendQosNullFramesInTbPpdu (const CtrlTriggerHeader &trigger, const WifiMacHeader &hdr) override |
Send QoS Null frames in response to a Basic or BSRP Trigger Frame. | |
bool | ShallDropReceivedMpdu (Ptr< const WifiMpdu > mpdu) const |
Check if the MPDU that has been received on this link shall be dropped. | |
void | TbPpduTimeout (WifiPsduMap *psduMap, std::size_t nSolicitedStations) override |
Take the necessary actions after that some TB PPDUs are missing in response to Trigger Frame. | |
void | TransmissionFailed (bool forceCurrentCw=false) override |
Take necessary actions upon a transmission failure. | |
void | TransmissionSucceeded () override |
Take necessary actions upon a transmission success. | |
bool | UnblockEmlsrLinksIfAllowed (Mac48Address address) |
Unblock transmissions on all the links of the given EMLSR client, provided that the latter is not involved in any DL or UL TXOP on another link. | |
Protected Member Functions inherited from ns3::HeFrameExchangeManager | |
virtual void | BlockAckAfterTbPpduTimeout (Ptr< WifiPsdu > psdu, const WifiTxVector &txVector) |
Take the necessary actions after that a Block Ack is missing after a TB PPDU solicited through a Trigger Frame. | |
void | BlockAckTimeout (Ptr< WifiPsdu > psdu, const WifiTxVector &txVector) override |
Called when the BlockAck timeout expires. | |
void | ClearTxopHolderIfNeeded () override |
Clear the TXOP holder if the intra-BSS NAV counted down to zero (includes the case of intra-BSS NAV reset). | |
void | CtsTimeout (Ptr< WifiMpdu > rts, const WifiTxVector &txVector) override |
Called when the CTS timeout expires. | |
void | DoCtsAfterMuRtsTimeout (Ptr< WifiMpdu > muRts, const WifiTxVector &txVector, bool updateFailedCw) |
Called when no CTS frame is received after an MU-RTS. | |
void | DoDispose () override |
Destructor implementation. | |
void | DoTbPpduTimeout (WifiPsduMap *psduMap, std::size_t nSolicitedStations, bool updateFailedCw) |
Take the necessary actions after that some TB PPDUs are missing in response to Trigger Frame. | |
void | EndReceiveAmpdu (Ptr< const WifiPsdu > psdu, const RxSignalInfo &rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &perMpduStatus) override |
This method is called when the reception of an A-MPDU including multiple MPDUs is completed. | |
WifiMode | GetCtsModeAfterMuRts () const |
WifiTxVector | GetCtsTxVectorAfterMuRts (const CtrlTriggerHeader &trigger, uint16_t staId) const |
Get the TXVECTOR that the station having the given station ID has to use to send a CTS frame after receiving an MU-RTS Trigger Frame from the AP it is associated with. | |
WifiTxVector | GetHeTbTxVector (CtrlTriggerHeader trigger, Mac48Address triggerSender) const |
Return a TXVECTOR for the UL frame that the station will send in response to the given Trigger frame, configured with the BSS color and transmit power level to use for the consequent HE TB PPDU. | |
virtual Time | GetMuRtsDurationId (uint32_t muRtsSize, const WifiTxVector &muRtsTxVector, Time txDuration, Time response) const |
Compute how to set the Duration/ID field of an MU-RTS Trigger Frame to send to protect a frame transmitted with the given TX vector. | |
WifiTxVector | GetTrigVector (const CtrlTriggerHeader &trigger) const |
Get the TRIGVECTOR that the MAC has to pass to the PHY when transmitting the given Trigger Frame. | |
Time | GetTxDuration (uint32_t ppduPayloadSize, Mac48Address receiver, const WifiTxParameters &txParams) const override |
Get the updated TX duration of the frame associated with the given TX parameters if the size of the PSDU addressed to the given receiver becomes ppduPayloadSize. | |
void | NavResetTimeout () override |
Reset the NAV upon expiration of the NAV reset timer. | |
void | NormalAckTimeout (Ptr< WifiMpdu > mpdu, const WifiTxVector &txVector) override |
Called when the Ack timeout expires. | |
void | PostProcessFrame (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Perform actions that are possibly needed after receiving any frame, independently of whether the frame is addressed to this station (e.g., setting the NAV or the TXOP holder). | |
Ptr< WifiMpdu > | PrepareMuBar (const WifiTxVector &responseTxVector, std::map< uint16_t, CtrlBAckRequestHeader > recipients) const |
Build a MU-BAR Trigger Frame starting from the TXVECTOR used to respond to the MU-BAR (in case of multiple responders, their TXVECTORs need to be "merged" into a single TXVECTOR) and from the BlockAckReq headers for every recipient. | |
void | ProtectionCompleted () override |
Transmit prepared frame immediately, if no protection was used, or in a SIFS, if protection was completed successfully. | |
void | ReceiveMpdu (Ptr< const WifiMpdu > mpdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, bool inAmpdu) override |
This method handles the reception of an MPDU (possibly included in an A-MPDU) | |
void | Reset () override |
Reset this frame exchange manager. | |
void | RxStartIndication (WifiTxVector txVector, Time psduDuration) override |
void | SendMultiStaBlockAck (const WifiTxParameters &txParams, Time durationId) |
Send a Multi-STA Block Ack frame after the reception of some TB PPDUs. | |
virtual void | SendMuRts (const WifiTxParameters &txParams) |
Send an MU-RTS to begin an MU-RTS/CTS frame exchange protecting an MU PPDU. | |
void | SendPsduMapWithProtection (WifiPsduMap psduMap, WifiTxParameters &txParams) |
Send a map of PSDUs as a DL MU PPDU. | |
void | StartProtection (const WifiTxParameters &txParams) override |
Start the protection mechanism indicated by the given TX parameters. | |
void | TransmissionSucceeded () override |
Take necessary actions upon a transmission success. | |
void | UpdateNav (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Update the NAV, if needed, based on the Duration/ID of the given psdu. | |
Protected Member Functions inherited from ns3::VhtFrameExchangeManager | |
uint32_t | GetPsduSize (Ptr< const WifiMpdu > mpdu, const WifiTxVector &txVector) const override |
Get the size in bytes of the given MPDU, which is to be transmitted with the given TXVECTOR. | |
Protected Member Functions inherited from ns3::HtFrameExchangeManager | |
void | CtsTimeout (Ptr< WifiMpdu > rts, const WifiTxVector &txVector) override |
Called when the CTS timeout expires. | |
void | DequeuePsdu (Ptr< const WifiPsdu > psdu) |
Dequeue the MPDUs of the given PSDU from the queue in which they are stored. | |
void | DoDispose () override |
Destructor implementation. | |
void | EndReceiveAmpdu (Ptr< const WifiPsdu > psdu, const RxSignalInfo &rxSignalInfo, const WifiTxVector &txVector, const std::vector< bool > &perMpduStatus) override |
This method is called when the reception of an A-MPDU including multiple MPDUs is completed. | |
void | FinalizeMacHeader (Ptr< const WifiPsdu > psdu) override |
Finalize the MAC header of the MPDUs in the given PSDU before transmission. | |
void | ForwardMpduDown (Ptr< WifiMpdu > mpdu, WifiTxVector &txVector) override |
Forward an MPDU down to the PHY layer. | |
Ptr< BlockAckManager > | GetBaManager (uint8_t tid) const |
Get the Block Ack Manager handling the given TID. | |
virtual Time | GetPsduDurationId (Time txDuration, const WifiTxParameters &txParams) const |
Compute how to set the Duration/ID field of PSDUs that do not include fragments. | |
virtual void | MissedBlockAck (Ptr< WifiPsdu > psdu, const WifiTxVector &txVector) |
Take necessary actions when a BlockAck is missed, such as scheduling a BlockAckReq frame or the retransmission of the unacknowledged frames. | |
virtual bool | NeedSetupBlockAck (Mac48Address recipient, uint8_t tid) |
A Block Ack agreement needs to be established with the given recipient for the given TID if it does not already exist (or exists and is in state RESET) and: | |
void | NotifyPacketDiscarded (Ptr< const WifiMpdu > mpdu) override |
Pass the given MPDU, discarded because of the max retry limit was reached, to the MPDU dropped callback. | |
void | NotifyReceivedNormalAck (Ptr< WifiMpdu > mpdu) override |
Notify other components that an MPDU was acknowledged. | |
virtual void | NotifyTxToEdca (Ptr< const WifiPsdu > psdu) const |
Notify the transmission of the given PSDU to the EDCAF associated with the AC the PSDU belongs to. | |
void | ProtectionCompleted () override |
Transmit prepared frame immediately, if no protection was used, or in a SIFS, if protection was completed successfully. | |
void | ReceiveMgtAction (Ptr< const WifiMpdu > mpdu, const WifiTxVector &txVector) |
Process a received management action frame that relates to Block Ack agreement. | |
void | ReceiveMpdu (Ptr< const WifiMpdu > mpdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, bool inAmpdu) override |
This method handles the reception of an MPDU (possibly included in an A-MPDU) | |
void | ReleaseSequenceNumbers (Ptr< const WifiPsdu > psdu) const override |
Make the sequence numbers of MPDUs included in the given PSDU available again if the MPDUs have never been transmitted. | |
void | RetransmitMpduAfterMissedAck (Ptr< WifiMpdu > mpdu) const override |
Retransmit an MPDU that was not acknowledged. | |
bool | SendAddBaRequest (Mac48Address recipient, uint8_t tid, uint16_t startingSeq, uint16_t timeout, bool immediateBAck, Time availableTime, std::optional< Mac48Address > gcrGroupAddr=std::nullopt) |
Sends an ADDBA Request to establish a block ack agreement with STA addressed by recipient for TID tid. | |
void | SendBlockAck (const RecipientBlockAckAgreement &agreement, Time durationId, WifiTxVector &blockAckTxVector, double rxSnr) |
Create a BlockAck frame with header equal to blockAck and start its transmission. | |
virtual bool | SendDataFrame (Ptr< WifiMpdu > peekedItem, Time availableTime, bool initialFrame) |
Given a non-broadcast QoS data frame, prepare the PSDU to transmit by attempting A-MSDU and A-MPDU aggregation (if enabled), while making sure that the frame exchange (possibly including protection and acknowledgment) is completed within the given available time. | |
virtual bool | SendMpduFromBaManager (Ptr< WifiMpdu > mpdu, Time availableTime, bool initialFrame) |
If the given MPDU contains a BlockAckReq frame (the duration of which plus the response fits within the given available time, if the latter is not Time::Min() and this is not the initial frame of a TXOP), transmit the frame and return true. | |
void | SendPsduWithProtection (Ptr< WifiPsdu > psdu, WifiTxParameters &txParams) |
Send a PSDU (A-MPDU or BlockAckReq frame) requesting a BlockAck frame or a BlockAckReq frame followed by a BlockAck frame for the acknowledgment. | |
void | TransmissionSucceeded () override |
Take necessary actions upon a transmission success. | |
Protected Member Functions inherited from ns3::QosFrameExchangeManager | |
void | DoDispose () override |
Destructor implementation. | |
void | ForwardMpduDown (Ptr< WifiMpdu > mpdu, WifiTxVector &txVector) override |
Forward an MPDU down to the PHY layer. | |
Time | GetCtsToSelfDurationId (const WifiTxVector &ctsTxVector, Time txDuration, Time response) const override |
Compute how to set the Duration/ID field of a CTS-to-self frame to send to protect a frame transmitted with the given TX vector. | |
Time | GetFrameDurationId (const WifiMacHeader &header, uint32_t size, const WifiTxParameters &txParams, Ptr< Packet > fragmentedPacket) const override |
Compute how to set the Duration/ID field of a frame being transmitted with the given TX parameters. | |
Time | GetRtsDurationId (const WifiTxVector &rtsTxVector, Time txDuration, Time response) const override |
Compute how to set the Duration/ID field of an RTS frame to send to protect a frame transmitted with the given TX vector. | |
void | NavResetTimeout () override |
Reset the NAV upon expiration of the NAV reset timer. | |
void | PifsRecovery (bool forceCurrentCw) |
Perform a PIFS recovery as a response to transmission failure within a TXOP. | |
void | PostProcessFrame (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Perform actions that are possibly needed after receiving any frame, independently of whether the frame is addressed to this station (e.g., setting the NAV or the TXOP holder). | |
void | PreProcessFrame (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Perform actions that are possibly needed when receiving any frame, independently of whether the frame is addressed to this station (e.g., storing buffer status reports). | |
void | ReceiveMpdu (Ptr< const WifiMpdu > mpdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, bool inAmpdu) override |
This method handles the reception of an MPDU (possibly included in an A-MPDU) | |
virtual bool | SendCfEndIfNeeded () |
Send a CF-End frame to indicate the completion of the TXOP, provided that the remaining duration is long enough to transmit this frame. | |
virtual bool | StartTransmission (Ptr< QosTxop > edca, Time txopDuration) |
Request the FrameExchangeManager to start a frame exchange sequence. | |
void | TransmissionFailed (bool forceCurrentCw=false) override |
Take necessary actions upon a transmission failure. | |
void | TransmissionSucceeded () override |
Take necessary actions upon a transmission success. | |
void | UpdateNav (Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector) override |
Update the NAV, if needed, based on the Duration/ID of the given psdu. | |
Protected Member Functions inherited from ns3::FrameExchangeManager | |
virtual void | DequeueMpdu (Ptr< const WifiMpdu > mpdu) |
Dequeue the given MPDU from the queue in which it is stored. | |
void | DoCtsTimeout (Ptr< WifiPsdu > psdu) |
Take required actions when the CTS timer fired after sending an RTS to protect the given PSDU expires. | |
void | DoSendCtsAfterRts (const WifiMacHeader &rtsHdr, WifiTxVector &ctsTxVector, double rtsSnr) |
Send CTS after receiving RTS. | |
Ptr< WifiMpdu > | DropMpduIfRetryLimitReached (Ptr< WifiPsdu > psdu) |
Wrapper for the GetMpdusToDropOnTxFailure function of the remote station manager that additionally drops the MPDUs in the given PSDU that the remote station manager requested to drop. | |
Ptr< WifiMpdu > | GetFirstFragmentIfNeeded (Ptr< WifiMpdu > mpdu) |
Fragment the given MPDU if needed. | |
Ptr< WifiMpdu > | GetNextFragment () |
Get the next fragment of the current MSDU. | |
Ptr< WifiRemoteStationManager > | GetWifiRemoteStationManager () const |
virtual void | ReceivedMacHdr (const WifiMacHeader &macHdr, const WifiTxVector &txVector, Time psduDuration) |
Store information about the MAC header of the MPDU being received. | |
virtual void | ReceivedNormalAck (Ptr< WifiMpdu > mpdu, const WifiTxVector &txVector, const WifiTxVector &ackTxVector, const RxSignalInfo &rxInfo, double snr) |
Perform the actions needed when a Normal Ack is received. | |
void | SendCtsToSelf (const WifiTxParameters &txParams) |
Send CTS for a CTS-to-self mechanism. | |
void | SendMpduWithProtection (Ptr< WifiMpdu > mpdu, WifiTxParameters &txParams) |
Send an MPDU with the given TX parameters (with the specified protection). | |
void | SendNormalAck (const WifiMacHeader &hdr, const WifiTxVector &dataTxVector, double dataSnr) |
Send Normal Ack. | |
void | SendRts (const WifiTxParameters &txParams) |
Send RTS to begin RTS-CTS-Data-Ack transaction. | |
void | UpdateTxDuration (Mac48Address receiver, WifiTxParameters &txParams) const |
Update the TX duration field of the given TX parameters after that the PSDU addressed to the given receiver has changed. | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | DoInitialize () |
Initialize() implementation. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
Protected Member Functions inherited from ns3::ObjectBase | |
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 Member Functions | |
bool | DropReceivedIcf () |
void | GenerateInDeviceInterference (uint8_t linkId, Time duration, Watt_u txPower) |
Generate an in-device interference of the given power on the given link for the given duration. | |
void | SwitchToListeningOrUnblockLinks (const std::set< Mac48Address > &clients) |
For each EMLSR client in the given set of clients that did not respond to a frame requesting a response from multiple clients, have the client switch to listening or simply unblock links depending on whether the EMLSR client was protected or not. | |
void | TxopEnd (const std::optional< Mac48Address > &txopHolder) |
Take actions when a TXOP (of which we are not the holder) ends. | |
void | UpdateTxopEndOnRxEnd (Time durationId) |
Update the TXOP end timer when a frame reception ends. | |
void | UpdateTxopEndOnRxStartIndication (Time psduDuration) |
Update the TXOP end timer when receiving a PHY-RXSTART.indication. | |
void | UpdateTxopEndOnTxStart (Time txDuration, Time durationId) |
Update the TXOP end timer when starting a frame transmission. | |
Private Attributes | |
bool | m_icfReceived {false} |
whether an ICF has been received and needs to be notified to the EMLSR manager after post-processing the frame | |
EventId | m_ongoingTxopEnd |
event indicating the possible end of the current TXOP (of which we are not the holder) | |
std::unordered_map< Mac48Address, EventId, WifiAddressHash > | m_transDelayTimer |
MLD address-indexed map of transition delay timers. | |
Additional Inherited Members | |
Public Types inherited from ns3::FrameExchangeManager | |
typedef Callback< void, Ptr< const WifiMpdu > > | AckedMpdu |
typedef for a callback to invoke when an MPDU is successfully acknowledged. | |
typedef Callback< void, WifiMacDropReason, Ptr< const WifiMpdu > > | DroppedMpdu |
typedef for a callback to invoke when an MPDU is dropped. | |
Protected Types inherited from ns3::HtFrameExchangeManager | |
typedef std::pair< Mac48Address, uint8_t > | AgreementKey |
agreement key typedef (MAC address and TID) | |
Protected Attributes inherited from ns3::HeFrameExchangeManager | |
Time | m_intraBssNavEnd |
intra-BSS NAV expiration time | |
EventId | m_intraBssNavResetEvent |
the event to reset the intra-BSS NAV after an RTS | |
WifiTxVector | m_trigVector |
the TRIGVECTOR | |
Protected Attributes inherited from ns3::HtFrameExchangeManager | |
Ptr< MpduAggregator > | m_mpduAggregator |
A-MPDU aggregator. | |
Ptr< MsduAggregator > | m_msduAggregator |
A-MSDU aggregator. | |
std::map< AgreementKey, Ptr< WifiMpdu > > | m_pendingAddBaResp |
pending ADDBA_RESPONSE frames indexed by agreement key | |
Protected Attributes inherited from ns3::QosFrameExchangeManager | |
Ptr< QosTxop > | m_edca |
the EDCAF that gained channel access | |
bool | m_setQosQueueSize |
whether to set the Queue Size subfield of the QoS Control field of QoS data frames | |
std::optional< Mac48Address > | m_txopHolder |
MAC address of the TXOP holder. | |
Protected Attributes inherited from ns3::FrameExchangeManager | |
AckedMpdu | m_ackedMpduCallback |
the acknowledged MPDU callback | |
MHz_u | m_allowedWidth |
the allowed width for the current transmission | |
Ptr< ApWifiMac > | m_apMac |
AP MAC layer pointer (null if not an AP) | |
Mac48Address | m_bssid |
BSSID address (Mac48Address) | |
Ptr< ChannelAccessManager > | m_channelAccessManager |
the channel access manager | |
Ptr< Txop > | m_dcf |
the DCF/EDCAF that gained channel access | |
DroppedMpdu | m_droppedMpduCallback |
the dropped MPDU callback | |
uint8_t | m_linkId |
the ID of the link this object is associated with | |
Ptr< WifiMac > | m_mac |
the MAC layer on this station | |
Time | m_navEnd |
NAV expiration time. | |
EventId | m_navResetEvent |
the event to reset the NAV after an RTS | |
Ptr< WifiPhy > | m_phy |
the PHY layer on this station | |
bool | m_promisc |
Flag if the device is operating in promiscuous mode. | |
bool | m_protectedIfResponded |
whether a STA is assumed to be protected if replied to a frame requiring acknowledgment | |
std::set< Mac48Address > | m_protectedStas |
STAs that have replied to an RTS in this TXOP. | |
Ptr< MacRxMiddle > | m_rxMiddle |
the MAC RX Middle on this station | |
Mac48Address | m_self |
the MAC address of this device | |
std::set< Mac48Address > | m_sentFrameTo |
the STA(s) to which we sent a frame requesting a response | |
std::set< Mac48Address > | m_sentRtsTo |
the STA(s) which we sent an RTS to (waiting for CTS) | |
Ptr< StaWifiMac > | m_staMac |
STA MAC layer pointer (null if not a STA) | |
Ptr< MacTxMiddle > | m_txMiddle |
the MAC TX Middle on this station | |
Time | m_txNav |
the TXNAV timer | |
WifiTxTimer | m_txTimer |
the timer set upon frame transmission | |
Related Symbols inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
EhtFrameExchangeManager handles the frame exchange sequences for EHT stations.
ns3::EhtFrameExchangeManager is accessible through the following paths with Config::Set and Config::Connect:
No Attributes are defined for this type.
No TraceSources are defined for this type.
Group: Wifi
Size of this type is 2536 bytes (on a 64-bit architecture).
Definition at line 73 of file eht-frame-exchange-manager.h.
ns3::EhtFrameExchangeManager::EhtFrameExchangeManager | ( | ) |
Definition at line 65 of file eht-frame-exchange-manager.cc.
References NS_LOG_FUNCTION.
|
override |
Definition at line 70 of file eht-frame-exchange-manager.cc.
References NS_LOG_FUNCTION_NOARGS.
|
overrideprotectedvirtual |
Take the necessary actions after that some BlockAck frames are missing in response to a DL MU PPDU.
This method must not be called if all the expected BlockAck frames were received.
psduMap | a pointer to PSDU map transmitted in a DL MU PPDU |
nSolicitedStations | the number of stations solicited to send a TB PPDU |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 956 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::BlockAcksInTbPpduTimeout(), ns3::WifiTxTimer::GetStasExpectedToRespond(), ns3::FrameExchangeManager::m_txTimer, NS_LOG_FUNCTION, and SwitchToListeningOrUnblockLinks().
bool ns3::EhtFrameExchangeManager::CheckEmlsrClientStartingTxop | ( | const WifiMacHeader & | hdr, |
const WifiTxVector & | txVector ) |
Check if the frame received (or being received) is sent by an EMLSR client to start an UL TXOP.
If so, take the appropriate actions (e.g., block transmission to the EMLSR client on the other links). This method is intended to be called when an MPDU (possibly within an A-MPDU) is received or when the reception of the MAC header in an MPDU is notified.
hdr | the MAC header of the received (or being received) MPDU |
txVector | the TXVECTOR used to transmit the frame received (or being received) |
Definition at line 1312 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::FindTxopHolder(), ns3::WifiMacHeader::GetAddr2(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::EventId::IsPending(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, m_ongoingTxopEnd, m_transDelayTimer, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::StaticCast(), and ns3::USING_OTHER_EMLSR_LINK.
Referenced by ReceiveMpdu().
|
overridevirtual |
Create an alias of the given MPDU for transmission by this Frame Exchange Manager.
This is required by 11be MLDs to support translation of MAC addresses. For single link devices, the given MPDU is simply returned.
mpdu | the given MPDU |
Reimplemented from ns3::QosFrameExchangeManager.
Definition at line 109 of file eht-frame-exchange-manager.cc.
References ns3::QosFrameExchangeManager::CreateAliasIfNeeded(), ns3::FrameExchangeManager::GetAddress(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, NS_ASSERT, and NS_LOG_FUNCTION.
|
overrideprotectedvirtual |
Called when no CTS frame is received after an MU-RTS.
muRts | the MU-RTS that solicited CTS responses |
txVector | the TXVECTOR used to transmit the MU-RTS frame |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 920 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::DoCtsAfterMuRtsTimeout(), IsCrossLinkCollision(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_sentRtsTo, NS_LOG_FUNCTION, and SwitchToListeningOrUnblockLinks().
|
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 76 of file eht-frame-exchange-manager.cc.
References ns3::EventId::Cancel(), ns3::HeFrameExchangeManager::DoDispose(), m_ongoingTxopEnd, and NS_LOG_FUNCTION.
|
private |
It might happen that, while the aux PHY is receiving an ICF, the main PHY is completing a TXOP on another link or is returning to the primary link after a TXOP is completed on another link. In order to respond to the ICF, it is necessary that the main PHY has enough time to switch and be ready to operate on this link by the end of the ICF padding.
TXOP end │ ┌───┐ another
AP MLD │ACK│ link ───────────┬─────────┬┴───┴─────────────────────────────────────── EMLSR │ QoS │ │ main PHY client │ Data │ │ └─────────┘ │ ┌─────┬───┐ this AP MLD │ ICF │pad│ link ────────────────────┴─────┴───┴─────────────────────────────────── aux PHY
Definition at line 1539 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_bssid, m_icfDropCallback, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_staMac, ns3::NOT_ENOUGH_TIME_SLEEP, ns3::NOT_ENOUGH_TIME_SWITCH, ns3::NOT_ENOUGH_TIME_TX, ns3::Simulator::Now(), NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::SLEEP, ns3::StaticCast(), ns3::SWITCHING, ns3::TX, ns3::USING_OTHER_EMLSR_LINK, ns3::USING_OTHER_LINK, and UsingOtherEmlsrLink().
Referenced by ReceiveMpdu().
|
protected |
Definition at line 851 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, ns3::FrameExchangeManager::m_staMac, NS_ASSERT, and NS_LOG_DEBUG.
Referenced by SendCtsAfterMuRts(), and SendQosNullFramesInTbPpdu().
void ns3::EhtFrameExchangeManager::EmlsrSwitchToListening | ( | Mac48Address | address, |
const Time & | delay ) |
This method is intended to be called when an AP MLD detects that an EMLSR client previously involved in the current TXOP will start waiting for the transition delay interval (to switch back to listening operation) after the given delay.
This method blocks the transmissions on all the EMLSR links of the given EMLSR client until the transition delay advertised by the EMLSR client expires.
address | the link MAC address of the given EMLSR client |
delay | the given delay |
Definition at line 652 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::CommonInfoBasicMle::DecodeEmlsrTransitionDelay(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::Time::IsZero(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_mac, m_transDelayTimer, NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), UnblockEmlsrLinksIfAllowed(), ns3::Time::US, and ns3::WAITING_EMLSR_TRANSITION_DELAY.
Referenced by ForwardPsduDown(), ForwardPsduMapDown(), NotifyChannelReleased(), PreProcessFrame(), SwitchToListeningOrUnblockLinks(), and TxopEnd().
|
overrideprotectedvirtual |
This method is called when the reception of an A-MPDU including multiple MPDUs is completed.
psdu | the received PSDU |
rxSignalInfo | the info on the received signal ( |
txVector | TxVector of the received PSDU |
perMpduStatus | per MPDU reception status |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1473 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::EndReceiveAmpdu(), NS_LOG_FUNCTION, and ShallDropReceivedMpdu().
|
overrideprotectedvirtual |
Forward a PSDU down to the PHY layer.
Also, notify the Block Ack Manager of the transmission of the constituent MPDUs.
psdu | the PSDU to forward down |
txVector | the TXVECTOR used to transmit the MPDU |
Reimplemented from ns3::HtFrameExchangeManager.
Definition at line 335 of file eht-frame-exchange-manager.cc.
References ns3::WifiPhy::CalculateTxDuration(), ns3::DbmToW(), EmlsrSwitchToListening(), ns3::HtFrameExchangeManager::ForwardPsduDown(), GenerateInDeviceInterference(), GetEmlsrSwitchToListening(), ns3::WifiPhy::GetPhyBand(), ns3::WifiPhy::GetPhyEntity(), ns3::WifiTxVector::GetPreambleType(), ns3::WifiTxVector::GetTxPowerLevel(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_bssid, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_protectedStas, ns3::FrameExchangeManager::m_sentRtsTo, ns3::FrameExchangeManager::m_staMac, NS_ASSERT, NS_LOG_FUNCTION, ns3::WifiTxVector::SetSigBMode(), ns3::StaticCast(), UpdateTxopEndOnTxStart(), ns3::USING_OTHER_EMLSR_LINK, ns3::WIFI_MOD_CLASS_EHT, and ns3::WIFI_PREAMBLE_EHT_MU.
|
overrideprotectedvirtual |
Forward a map of PSDUs down to the PHY layer.
psduMap | the map of PSDUs to transmit |
txVector | the TXVECTOR used to transmit the MU PPDU |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 429 of file eht-frame-exchange-manager.cc.
References ns3::WifiPhy::CalculateTxDuration(), ns3::DbmToW(), EmlsrSwitchToListening(), ns3::HeFrameExchangeManager::ForwardPsduMapDown(), GenerateInDeviceInterference(), GetEmlsrSwitchToListening(), ns3::WifiPhy::GetPhyBand(), ns3::HeFrameExchangeManager::GetTfRecipients(), ns3::WifiTxVector::GetTxPowerLevel(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::CtrlTriggerHeader::IsBsrp(), ns3::IsTrigger(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_protectedStas, ns3::FrameExchangeManager::m_staMac, NS_ASSERT, NS_LOG_FUNCTION, UpdateTxopEndOnTxStart(), and ns3::USING_OTHER_EMLSR_LINK.
|
private |
Generate an in-device interference of the given power on the given link for the given duration.
linkId | the ID of the link on which in-device interference is generated |
duration | the duration of the in-device interference |
txPower | the TX power |
Definition at line 518 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::Create(), ns3::DynamicCast(), ns3::FrameExchangeManager::m_mac, ns3::FrameExchangeManager::m_phy, NS_ASSERT, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::Time::US.
Referenced by ForwardPsduDown(), and ForwardPsduMapDown().
bool ns3::EhtFrameExchangeManager::GetEmlsrSwitchToListening | ( | Ptr< const WifiPsdu > | psdu, |
uint16_t | aid, | ||
const Mac48Address & | address ) const |
psdu | the given PSDU |
aid | the AID of an EMLSR client |
address | the link MAC address of an EMLSR client |
Definition at line 1084 of file eht-frame-exchange-manager.cc.
References ns3::CtrlTriggerHeader::end(), ns3::CtrlBAckResponseHeader::FindPerAidTidInfoWithAid(), ns3::CtrlTriggerHeader::FindUserInfoWithAid(), ns3::CtrlBAckResponseHeader::IsMultiSta(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_bssid, ns3::FrameExchangeManager::m_self, ns3::FrameExchangeManager::m_staMac, NS_LOG_FUNCTION, and ns3::PeekPointer().
Referenced by ForwardPsduDown(), ForwardPsduMapDown(), and PostProcessFrame().
|
overridevirtual |
Get the RSSI of the most recent packet received from the station having the given address.
If there is no such information for the given station and the station is affiliated with an MLD, return the RSSI of the most recent packet received from another station of the same MLD.
address | of the remote station |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 756 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::GetMostRecentRssi(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_linkId, and ns3::FrameExchangeManager::m_mac.
EventId & ns3::EhtFrameExchangeManager::GetOngoingTxopEndEvent | ( | ) |
Definition at line 1387 of file eht-frame-exchange-manager.cc.
References m_ongoingTxopEnd.
|
static |
Get the type ID.
Definition at line 56 of file eht-frame-exchange-manager.cc.
References ns3::TypeId::SetParent().
|
overrideprotectedvirtual |
Reset the intra-BSS NAV upon expiration of the intra-BSS NAV reset timer.
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 558 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::IntraBssNavResetTimeout(), NS_LOG_FUNCTION, and UsingOtherEmlsrLink().
|
protected |
Check whether all the stations that did not respond (to a certain frame) are EMLSR clients trying to start an UL TXOP on another link.
staMissedResponseFrom | stations that did not respond |
Definition at line 974 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_mac, NS_ASSERT, and NS_LOG_FUNCTION.
Referenced by CtsAfterMuRtsTimeout(), and TbPpduTimeout().
|
overrideprotectedvirtual |
Reset the NAV upon expiration of the NAV reset timer.
Reimplemented from ns3::FrameExchangeManager.
Definition at line 546 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::NavResetTimeout(), NS_LOG_FUNCTION, and UsingOtherEmlsrLink().
|
overrideprotectedvirtual |
Notify the given Txop that channel has been released.
txop | the given Txop |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1182 of file eht-frame-exchange-manager.cc.
References ns3::DynamicCast(), EmlsrSwitchToListening(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::EventId::IsPending(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, m_ongoingTxopEnd, ns3::FrameExchangeManager::m_protectedStas, ns3::FrameExchangeManager::m_staMac, ns3::FrameExchangeManager::NotifyChannelReleased(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_FUNCTION, and ns3::Seconds().
Referenced by StartTransmission().
void ns3::EhtFrameExchangeManager::NotifySwitchingEmlsrLink | ( | Ptr< WifiPhy > | phy, |
uint8_t | linkId, | ||
Time | delay ) |
Notify that the given PHY will switch channel to operate on another EMLSR link after the given delay.
phy | the given PHY |
linkId | the ID of the EMLSR link on which the given PHY is operating |
delay | the delay after which the channel switch will be completed |
Definition at line 703 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_staMac, NS_ABORT_MSG_IF, NS_LOG_FUNCTION, ns3::FrameExchangeManager::ResetPhy(), and ns3::Time::US.
|
overrideprotectedvirtual |
Perform actions that are possibly needed after receiving any frame, independently of whether the frame is addressed to this station (e.g., setting the NAV or the TXOP holder).
psdu | the received PSDU |
txVector | TX vector of the received PSDU |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1264 of file eht-frame-exchange-manager.cc.
References ns3::EventId::Cancel(), GetEmlsrSwitchToListening(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::EventId::IsPending(), ns3::FrameExchangeManager::m_apMac, m_icfReceived, ns3::FrameExchangeManager::m_linkId, m_ongoingTxopEnd, ns3::FrameExchangeManager::m_self, ns3::FrameExchangeManager::m_staMac, ns3::QosFrameExchangeManager::m_txopHolder, NS_LOG_FUNCTION, ns3::HeFrameExchangeManager::PostProcessFrame(), ns3::Simulator::ScheduleNow(), TxopEnd(), and UpdateTxopEndOnRxEnd().
|
overrideprotectedvirtual |
Perform actions that are possibly needed when receiving any frame, independently of whether the frame is addressed to this station (e.g., storing buffer status reports).
psdu | the received PSDU |
txVector | TX vector of the received PSDU |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1215 of file eht-frame-exchange-manager.cc.
References EmlsrSwitchToListening(), ns3::WifiTxTimer::GetStasExpectedToRespond(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::WifiTxVector::IsUlMu(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_protectedStas, ns3::FrameExchangeManager::m_staMac, ns3::FrameExchangeManager::m_txTimer, NS_LOG_FUNCTION, ns3::FrameExchangeManager::PreProcessFrame(), and ns3::Seconds().
|
overrideprotectedvirtual |
Transmit prepared frame immediately, if no protection was used, or in a SIFS, if protection was completed successfully.
Reimplemented from ns3::FrameExchangeManager.
Definition at line 322 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_staMac, NS_LOG_FUNCTION, and ns3::HeFrameExchangeManager::ProtectionCompleted().
|
overrideprotectedvirtual |
This method is called when the reception of a PSDU fails.
psdu | the PSDU whose reception failed |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1393 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, and NS_LOG_FUNCTION.
|
overrideprotectedvirtual |
Perform the actions required when receiving QoS Null frame(s) from the given sender after a BSRP Trigger Frame.
sender | the MAC address of the given sender |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 837 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_protectedStas, NS_LOG_FUNCTION, and ns3::HeFrameExchangeManager::ReceivedQosNullAfterBsrpTf().
|
overrideprotectedvirtual |
This method handles the reception of an MPDU (possibly included in an A-MPDU)
mpdu | the received MPDU |
rxSignalInfo | the info on the received signal ( |
txVector | TxVector of the received PSDU |
inAmpdu | true if the MPDU is part of an A-MPDU |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1404 of file eht-frame-exchange-manager.cc.
References ns3::EventId::Cancel(), CheckEmlsrClientStartingTxop(), DropReceivedIcf(), ns3::CtrlTriggerHeader::end(), ns3::CtrlTriggerHeader::FindUserInfoWithAid(), ns3::WifiPhy::GetSifs(), ns3::CtrlTriggerHeader::IsBsrp(), ns3::CtrlTriggerHeader::IsMuRts(), ns3::EventId::IsPending(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_bssid, m_icfReceived, ns3::FrameExchangeManager::m_linkId, m_ongoingTxopEnd, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_self, ns3::FrameExchangeManager::m_staMac, ns3::NanoSeconds(), ns3::Simulator::Now(), NS_ASSERT, NS_LOG_DEBUG, ns3::HeFrameExchangeManager::ReceiveMpdu(), ns3::Time::S, ns3::Simulator::Schedule(), ShallDropReceivedMpdu(), and TxopEnd().
|
overrideprotectedvirtual |
txVector | the TXVECTOR decoded from PHY header. |
psduDuration | the duration of the PSDU that is about to be received. |
This method is typically invoked by the lower PHY layer to notify the MAC layer that the reception of a PSDU is starting. This is equivalent to the PHY-RXSTART primitive. If the reception is correct for at least one MPDU of the PSDU the Receive method will be called after psduDuration
.
Reimplemented from ns3::FrameExchangeManager.
Definition at line 84 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::Time::MS, NS_LOG_FUNCTION, ns3::HeFrameExchangeManager::RxStartIndication(), and UpdateTxopEndOnRxStartIndication().
|
overrideprotectedvirtual |
Send CTS after receiving an MU-RTS.
muRtsHdr | the MAC header of the received MU-RTS |
trigger | the MU-RTS Trigger Frame header |
muRtsSnr | the SNR of the MU-RTS in linear scale |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 875 of file eht-frame-exchange-manager.cc.
References EmlsrClientCannotRespondToIcf(), NS_LOG_FUNCTION, and ns3::HeFrameExchangeManager::SendCtsAfterMuRts().
|
overrideprotectedvirtual |
Send CTS after receiving RTS.
rtsHdr | the header of the received RTS |
rtsTxMode | the TX mode used to transmit the RTS |
rtsSnr | the SNR of the RTS in linear scale |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1040 of file eht-frame-exchange-manager.cc.
References ns3::AC_BE, ns3::WifiMacHeader::GetAddr2(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, NS_ASSERT_MSG, NS_LOG_FUNCTION, ns3::FrameExchangeManager::SendCtsAfterRts(), ns3::USING_OTHER_EMLSR_LINK, ns3::WIFI_QOSDATA_QUEUE, and ns3::WIFI_UNICAST.
void ns3::EhtFrameExchangeManager::SendEmlOmn | ( | const Mac48Address & | dest, |
const MgtEmlOmn & | frame ) |
Send an EML Operating Mode Notification frame to the given station.
dest | the MAC address of the receiver |
frame | the EML Operating Mode Notification frame to send |
Definition at line 726 of file eht-frame-exchange-manager.cc.
References ns3::AC_VO, ns3::Create(), ns3::FrameExchangeManager::m_bssid, ns3::FrameExchangeManager::m_mac, ns3::FrameExchangeManager::m_self, ns3::FrameExchangeManager::m_txMiddle, NS_LOG_FUNCTION, ns3::WifiActionHeader::PROTECTED_EHT, ns3::WifiActionHeader::PROTECTED_EHT_EML_OPERATING_MODE_NOTIFICATION, ns3::WifiActionHeader::SetAction(), ns3::WifiMacHeader::SetAddr1(), ns3::WifiMacHeader::SetAddr2(), ns3::WifiMacHeader::SetAddr3(), ns3::WifiMacHeader::SetDsNotFrom(), ns3::WifiMacHeader::SetDsNotTo(), ns3::WifiMacHeader::SetSequenceNumber(), ns3::WifiMacHeader::SetType(), and ns3::WIFI_MAC_MGT_ACTION.
|
overrideprotectedvirtual |
Send QoS Null frames in response to a Basic or BSRP Trigger Frame.
The number of QoS Null frames that are actually aggregated depends on the available time as indicated by the Trigger Frame and is at most 8 (one QoS Null frame per TID).
trigger | the Basic or BSRP Trigger Frame content |
hdr | the MAC header of the Basic or BSRP Trigger Frame |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 889 of file eht-frame-exchange-manager.cc.
References EmlsrClientCannotRespondToIcf(), ns3::CtrlTriggerHeader::IsBsrp(), NS_LOG_FUNCTION, and ns3::HeFrameExchangeManager::SendQosNullFramesInTbPpdu().
void ns3::EhtFrameExchangeManager::SetIcfPaddingAndTxVector | ( | CtrlTriggerHeader & | trigger, |
WifiTxVector & | txVector ) const |
Set the padding and the TXVECTOR of the given Trigger Frame, in case it is an Initial Control Frame for some EMLSR client(s).
trigger | the given Trigger Frame |
txVector | the TXVECTOR used to transmit the Trigger Frame |
Definition at line 789 of file eht-frame-exchange-manager.cc.
References ns3::WifiMode::GetDataRate(), ns3::WifiTxVector::GetMode(), ns3::HeFrameExchangeManager::GetTfRecipients(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::CtrlTriggerHeader::IsBsrp(), ns3::CtrlTriggerHeader::IsMuRts(), ns3::FrameExchangeManager::m_protectedStas, NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_INFO, and ns3::CtrlTriggerHeader::SetPaddingSize().
|
overridevirtual |
Set the ID of the link this Frame Exchange Manager is associated with.
linkId | the ID of the link this Frame Exchange Manager is associated with |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 93 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::GetAckManager(), ns3::FrameExchangeManager::GetProtectionManager(), ns3::HtFrameExchangeManager::m_mpduAggregator, ns3::HtFrameExchangeManager::m_msduAggregator, and ns3::FrameExchangeManager::SetLinkId().
|
protected |
Check if the MPDU that has been received on this link shall be dropped.
In our model, an aux PHY, or the main PHY that is not involved in any TXOP, can receive:
mpdu | the MPDU that has been received |
Definition at line 1491 of file eht-frame-exchange-manager.cc.
References ns3::EventId::IsPending(), ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, m_ongoingTxopEnd, ns3::FrameExchangeManager::m_staMac, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::wifiAcList.
Referenced by EndReceiveAmpdu(), and ReceiveMpdu().
|
overridevirtual |
Request the FrameExchangeManager to start a frame exchange sequence.
dcf | the channel access function that gained channel access. It is the DCF on non-QoS stations and an EDCA on QoS stations. |
allowedWidth | the allowed width for the frame exchange sequence |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 168 of file eht-frame-exchange-manager.cc.
References ns3::AC_BE, ns3::EventId::Cancel(), ns3::Txop::CHECK_MEDIUM_BUSY, ns3::Txop::DIDNT_HAVE_FRAMES_TO_TRANSMIT, ns3::Txop::DONT_CHECK_MEDIUM_BUSY, ns3::DynamicCast(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_allowedWidth, ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, m_ongoingTxopEnd, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_staMac, NotifyChannelReleased(), NS_ASSERT, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), ns3::Txop::StartAccessAfterEvent(), ns3::FrameExchangeManager::StartTransmission(), ns3::StaticCast(), ns3::USING_OTHER_EMLSR_LINK, UsingOtherEmlsrLink(), ns3::WIFI_QOSDATA_QUEUE, and ns3::WIFI_UNICAST.
|
private |
For each EMLSR client in the given set of clients that did not respond to a frame requesting a response from multiple clients, have the client switch to listening or simply unblock links depending on whether the EMLSR client was protected or not.
clients | the given set of clients |
Definition at line 902 of file eht-frame-exchange-manager.cc.
References EmlsrSwitchToListening(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_protectedStas, NS_LOG_FUNCTION, ns3::Seconds(), and UnblockEmlsrLinksIfAllowed().
Referenced by BlockAcksInTbPpduTimeout(), CtsAfterMuRtsTimeout(), and TbPpduTimeout().
|
overrideprotectedvirtual |
Take the necessary actions after that some TB PPDUs are missing in response to Trigger Frame.
This method must not be called if all the expected TB PPDUs were received.
psduMap | a pointer to PSDU map transmitted in a DL MU PPDU |
nSolicitedStations | the number of stations solicited to send a TB PPDU |
Reimplemented from ns3::HeFrameExchangeManager.
Definition at line 935 of file eht-frame-exchange-manager.cc.
References ns3::HeFrameExchangeManager::DoTbPpduTimeout(), ns3::WifiTxTimer::GetStasExpectedToRespond(), IsCrossLinkCollision(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_txTimer, NS_LOG_FUNCTION, and SwitchToListeningOrUnblockLinks().
|
overrideprotectedvirtual |
Take necessary actions upon a transmission failure.
A non-QoS station releases the channel when this method is called.
forceCurrentCw | whether to force the contention window to stay equal to the current value (normally, contention window is updated upon TX failure) |
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1166 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_staMac, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::FrameExchangeManager::TransmissionFailed().
|
overrideprotectedvirtual |
Take necessary actions upon a transmission success.
A non-QoS station transmits the next fragment, if any, or releases the channel, otherwise.
Reimplemented from ns3::FrameExchangeManager.
Definition at line 1150 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_staMac, NS_LOG_DEBUG, NS_LOG_FUNCTION, and ns3::HeFrameExchangeManager::TransmissionSucceeded().
|
private |
Take actions when a TXOP (of which we are not the holder) ends.
txopHolder | the holder of the TXOP (if any) |
Definition at line 1642 of file eht-frame-exchange-manager.cc.
References EmlsrSwitchToListening(), ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::WifiPhy::IsReceivingPhyHeader(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, m_ongoingTxopEnd, ns3::FrameExchangeManager::m_phy, ns3::FrameExchangeManager::m_staMac, ns3::MicroSeconds(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), ns3::Seconds(), TxopEnd(), and ns3::WAIT_FOR_RXSTART_DELAY_USEC.
Referenced by PostProcessFrame(), ReceiveMpdu(), TxopEnd(), UpdateTxopEndOnRxEnd(), UpdateTxopEndOnRxStartIndication(), and UpdateTxopEndOnTxStart().
|
protected |
Unblock transmissions on all the links of the given EMLSR client, provided that the latter is not involved in any DL or UL TXOP on another link.
address | the link MAC address of the given EMLSR client |
Do nothing if the EMLSR client is involved in a DL or UL TXOP on another EMLSR link. This may happen, e.g., when the AP MLD sent an MU-RTS to multiple stations on this link, some of which responded, but this EMLSR client did not, e.g., because it concurrently started an UL TXOP on another link. The AP MLD then started a (long) DL MU transmission on this link, during which the EMLSR client completed the UL TXOP and started being involved in another DL or UL TXOP (note that DL TXOP is possible because the AP MLD considered the EMLSR client unprotected as soon as it detected the start of the previous UL TXOP). A Block Ack timeout for the EMLSR client occurs at the end of the DL MU transmission (which brings us here) and it may occur while the EMLSR client is still involved in a DL or UL TXOP.
┌─────────────┐ ┌───────────────┐ │ MU-RTS to │ │ Data to │ BA timeout for us │us and others│ │ us and others │ |
────────┴─────────────┴┬────────┬┴───────────────┴┬───────┬────────────── [this link] │CTS from│ │BA from│ │ others │ │ others│ └────────┘ └───────┘ ┌───────┐ ┌───┐ ┌──┐ │ MU-RTS│ ┌──────┐ [other link] │CTS│ │BA│ │ to us │ │ Data │ ─────────┬────────┬┴───┴┬────┬┴──┴──────┴───────┴┬───┬┴──────┴┬──┬─────── │ RTS │ │Data│ │CTS│ │BA│ │from us │ └────┘ └───┘ └──┘ └────────┘
Definition at line 570 of file eht-frame-exchange-manager.cc.
References ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_apMac, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_mac, NS_ASSERT_MSG, NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::StaticCast(), and ns3::USING_OTHER_EMLSR_LINK.
Referenced by EmlsrSwitchToListening(), and SwitchToListeningOrUnblockLinks().
|
private |
Update the TXOP end timer when a frame reception ends.
durationId | the Duration/ID value carried by the received frame |
Definition at line 1735 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::EventId::Cancel(), ns3::EMLSR_RX_PHY_START_DELAY, ns3::WifiPhy::GetSifs(), ns3::WifiPhy::GetSlot(), ns3::EventId::IsPending(), m_ongoingTxopEnd, ns3::FrameExchangeManager::m_phy, ns3::QosFrameExchangeManager::m_txopHolder, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Time::S, ns3::Simulator::Schedule(), TxopEnd(), and ns3::Time::US.
Referenced by PostProcessFrame().
|
private |
Update the TXOP end timer when receiving a PHY-RXSTART.indication.
psduDuration | the TX duration of the PSDU being received |
Definition at line 1714 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::EventId::Cancel(), ns3::EventId::IsPending(), ns3::Time::IsStrictlyPositive(), m_ongoingTxopEnd, ns3::QosFrameExchangeManager::m_txopHolder, ns3::Time::MS, ns3::NanoSeconds(), ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Time::S, ns3::Simulator::Schedule(), and TxopEnd().
Referenced by RxStartIndication().
|
private |
Update the TXOP end timer when starting a frame transmission.
txDuration | the TX duration of the frame being transmitted |
durationId | the Duration/ID value carried by the frame being transmitted |
Definition at line 1672 of file eht-frame-exchange-manager.cc.
References ns3::Time::As(), ns3::EventId::Cancel(), ns3::EMLSR_RX_PHY_START_DELAY, ns3::WifiTxTimer::GetDelayLeft(), ns3::WifiPhy::GetSifs(), ns3::WifiPhy::GetSlot(), ns3::EventId::IsPending(), ns3::WifiTxTimer::IsRunning(), m_ongoingTxopEnd, ns3::FrameExchangeManager::m_phy, ns3::QosFrameExchangeManager::m_txopHolder, ns3::FrameExchangeManager::m_txTimer, ns3::Time::MS, ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, ns3::Time::S, ns3::Simulator::Schedule(), TxopEnd(), and ns3::Time::US.
Referenced by ForwardPsduDown(), and ForwardPsduMapDown().
bool ns3::EhtFrameExchangeManager::UsingOtherEmlsrLink | ( | ) | const |
Definition at line 152 of file eht-frame-exchange-manager.cc.
References ns3::AC_BE, ns3::FrameExchangeManager::GetWifiRemoteStationManager(), ns3::FrameExchangeManager::m_bssid, ns3::FrameExchangeManager::m_linkId, ns3::FrameExchangeManager::m_staMac, NS_ASSERT_MSG, ns3::USING_OTHER_EMLSR_LINK, ns3::WIFI_QOSDATA_QUEUE, and ns3::WIFI_UNICAST.
Referenced by DropReceivedIcf(), IntraBssNavResetTimeout(), NavResetTimeout(), and StartTransmission().
TracedCallback<WifiIcfDrop, uint8_t> ns3::EhtFrameExchangeManager::m_icfDropCallback |
ICF drop reason traced callback (WifiMac exposes this trace source)
Definition at line 174 of file eht-frame-exchange-manager.h.
Referenced by DropReceivedIcf().
|
private |
whether an ICF has been received and needs to be notified to the EMLSR manager after post-processing the frame
Definition at line 303 of file eht-frame-exchange-manager.h.
Referenced by PostProcessFrame(), and ReceiveMpdu().
|
private |
event indicating the possible end of the current TXOP (of which we are not the holder)
Definition at line 305 of file eht-frame-exchange-manager.h.
Referenced by CheckEmlsrClientStartingTxop(), DoDispose(), GetOngoingTxopEndEvent(), NotifyChannelReleased(), PostProcessFrame(), ReceiveMpdu(), ShallDropReceivedMpdu(), StartTransmission(), TxopEnd(), UpdateTxopEndOnRxEnd(), UpdateTxopEndOnRxStartIndication(), and UpdateTxopEndOnTxStart().
|
private |
MLD address-indexed map of transition delay timers.
Definition at line 308 of file eht-frame-exchange-manager.h.
Referenced by CheckEmlsrClientStartingTxop(), and EmlsrSwitchToListening().