22 #include "ns3/abort.h" 28 #undef NS_LOG_APPEND_CONTEXT 29 #define NS_LOG_APPEND_CONTEXT std::clog << "[mac=" << m_self << "] " 40 static TypeId tid =
TypeId (
"ns3::QosFrameExchangeManager")
42 .AddConstructor<QosFrameExchangeManager> ()
43 .SetGroupName (
"Wifi")
44 .AddAttribute (
"PifsRecovery",
45 "Perform a PIFS recovery as a response to transmission failure " 55 : m_initialFrame (false)
84 cfEnd.SetDsNotFrom ();
87 cfEnd.SetNoMoreFragments ();
88 cfEnd.SetDuration (
Seconds (0));
92 WifiTxVector cfEndTxVector =
m_mac->GetWifiRemoteStationManager ()->GetRtsTxVector (cfEnd.GetAddr1 ());
101 m_phy->
Send (Create<WifiPsdu> (Create<Packet> (), cfEnd), cfEndTxVector);
272 txParams.
m_txVector =
m_mac->GetWifiRemoteStationManager ()->GetDataTxVector (mpdu->GetHeader ());
284 "We should not get an A-MSDU here");
290 if (item->IsFragment () && item->GetSize () != mpdu->GetSize ())
305 Time availableTime)
const 317 std::unique_ptr<WifiProtection> protection;
319 bool protectionSwapped =
false;
325 protectionTime = protection->protectionTime;
329 protectionSwapped =
true;
341 std::unique_ptr<WifiAcknowledgment> acknowledgment;
342 acknowledgment =
GetAckManager ()->TryAddMpdu (mpdu, txParams);
343 bool acknowledgmentSwapped =
false;
349 acknowledgmentTime = acknowledgment->acknowledgmentTime;
353 acknowledgmentSwapped =
true;
356 NS_LOG_DEBUG (
"acknowledgment time=" << acknowledgmentTime);
361 ppduDurationLimit = availableTime - protectionTime - acknowledgmentTime;
368 if (protectionSwapped)
372 if (acknowledgmentSwapped)
389 Time ppduDurationLimit)
const 397 txParams, ppduDurationLimit);
403 Time ppduDurationLimit)
const 405 NS_LOG_FUNCTION (
this << ppduPayloadSize << receiver << &txParams << ppduDurationLimit);
409 NS_LOG_DEBUG (
"ppduDurationLimit is null or negative, time limit is trivially exceeded");
428 NS_LOG_DEBUG (
"the frame does not meet the constraint on max PPDU duration or PPDU duration limit");
440 NS_LOG_FUNCTION (
this << header << size << &txParams << fragmentedPacket);
489 Time txDuration,
Time response)
const 528 NS_LOG_DEBUG (
"Schedule another transmission in a SIFS");
558 NS_LOG_DEBUG (
"TX of the initial frame of a TXOP failed: terminate TXOP");
565 "Cannot transmit more than one frame if TXOP Limit is zero");
574 NS_LOG_DEBUG (
"TX of a non-initial frame of a TXOP failed: perform PIFS recovery");
583 NS_LOG_DEBUG (
"TX of a non-initial frame of a TXOP failed: invoke backoff");
584 m_edca->Txop::NotifyChannelReleased ();
643 double rxSnr = rxSignalInfo.
snr;
666 this, hdr, txVector.
GetMode (), rxSnr);
681 this, hdr, txVector, rxSnr);
EventId m_pifsRecoveryEvent
event associated with an attempt of PIFS recovery
static EventId Schedule(Time const &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Ptr< const WifiMacQueueItem > PeekNextMpdu(uint8_t tid=8, Mac48Address recipient=Mac48Address::GetBroadcast())
Peek the next frame to transmit to the given receiver and of the given TID from the block ack manager...
Simulation virtual time values and global simulation resolution.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
WifiTxTimer m_txTimer
the timer set upon frame transmission
AttributeValue implementation for Boolean.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
void SendMpduWithProtection(Ptr< WifiMacQueueItem > mpdu, WifiTxParameters &txParams)
Send an MPDU with the given TX parameters (with the specified protection).
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Ptr< WifiProtectionManager > GetProtectionManager(void) const
Get the Protection Manager used by this node.
Ptr< WifiPhy > m_phy
the PHY layer on this station
static Time Min()
Minimum representable Time Not to be confused with Min(Time,Time).
WifiPhyBand GetPhyBand(void) const
Get the configured Wi-Fi band.
std::unique_ptr< WifiProtection > m_protection
protection method
uint32_t GetRtsSize(void)
Return the total RTS size (including FCS trailer).
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
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 ...
WifiModulationClass GetModulationClass(void) const
Get the modulation class specified by this TXVECTOR.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
virtual void PreProcessFrame(Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector)
Perform actions that are possibly needed when receiving any frame, independently of whether the frame...
U * PeekPointer(const Ptr< U > &p)
Information needed to remove an MSDU from the queue.
static const uint16_t WIFI_MAC_FCS_LENGTH
The length in octects of the IEEE 802.11 MAC FCS field.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
virtual void CalculateProtectionTime(WifiProtection *protection) const
Calculate the time required to protect a frame according to the given protection method.
bool IsStrictlyPositive(void) const
Exactly equivalent to t > 0.
void(* Time)(Time oldValue, Time newValue)
TracedValue callback signature for Time.
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
virtual Time GetRemainingTxop(void) const
Return the remaining duration in the current TXOP.
void PifsRecovery(void)
Perform a PIFS recovery as a response to transmission failure within a TXOP.
Ptr< ChannelAccessManager > m_channelAccessManager
the channel access manager
virtual void TransmissionFailed(void)
Take necessary actions upon a transmission failure.
virtual void CalculateAcknowledgmentTime(WifiAcknowledgment *acknowledgment) const
Calculate the time required to acknowledge a frame according to the given acknowledgment method...
Ptr< WifiAckManager > GetAckManager(void) const
Get the Acknowledgment Manager used by this node.
Ptr< RegularWifiMac > m_mac
the MAC layer on this station
bool StartTransmission(Ptr< Txop > edca) override
Request the FrameExchangeManager to start a frame exchange sequence.
WifiMode GetMode(uint16_t staId=SU_STA_ID) const
If this TX vector is associated with an SU PPDU, return the selected payload transmission mode...
Ptr< WifiMacQueueItem > GetFirstFragmentIfNeeded(Ptr< WifiMacQueueItem > mpdu)
Fragment the given MPDU if needed.
void DoDispose() override
Destructor implementation.
WifiPreamble GetPreambleType(void) const
static Time CalculateTxDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID)
void TransmissionSucceeded(void) override
Take necessary actions upon a transmission success.
RxSignalInfo structure containing info on the received signal.
const WifiMacHeader & GetHeader(void) const
Get the header stored in this item.
virtual Time GetFrameDurationId(const WifiMacHeader &header, uint32_t size, const WifiTxParameters &txParams, Ptr< Packet > fragmentedPacket) const
Compute how to set the Duration/ID field of a frame being transmitted with the given TX parameters...
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...
bool IsZero(void) const
Exactly equivalent to t == 0.
QosFrameExchangeManager handles the frame exchange sequences for QoS stations.
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...
static TypeId GetTypeId(void)
Get the type ID.
virtual void NotifyChannelReleased(void)
Called by the FrameExchangeManager to notify the completion of the transmissions. ...
virtual bool StartTransmission(Ptr< Txop > dcf)
Request the FrameExchangeManager to start a frame exchange sequence.
Ptr< Txop > m_edcaBackingOff
channel access function that invoked backoff during TXOP
static Mac48Address GetBroadcast(void)
virtual Time GetRtsDurationId(const WifiTxVector &rtsTxVector, Time txDuration, Time response) const
Compute how to set the Duration/ID field of an RTS frame to send to protect a frame transmitted with ...
Mac48Address GetAddr2(void) const
Get the Transmitter Address (TA), which is common to all the MPDUs.
virtual void SetTxopHolder(Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector)
Set the TXOP holder, if needed, based on the received frame.
virtual bool IsQosTxop() const
Check for QoS TXOP.
virtual bool SendCfEndIfNeeded(void)
Send a CF-End frame to indicate the completion of the TXOP, provided that the remaining duration is l...
bool m_initialFrame
true if transmitting the initial frame of a TXOP
const WifiMacHeader & GetHeader(std::size_t i) const
Get the header of the i-th MPDU.
Mac48Address m_self
the MAC address of this device
void CancelPifsRecovery(void)
Cancel the PIFS recovery event and have the EDCAF attempting PIFS recovery release the channel...
WifiTxVector m_txVector
TXVECTOR of the frame being prepared.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
static uint32_t GetMaxPsduSize(WifiModulationClass modulation)
Get the maximum PSDU size in bytes for the given modulation class.
bool m_pifsRecovery
true if performing a PIFS recovery after failure
void DoDispose() override
Destructor implementation.
void NotifyChannelAccessed(Time txopDuration) override
Called by the FrameExchangeManager to notify that channel access has been granted for the given amoun...
void Cancel(void)
Cancel the timer.
bool IsRunning(void) const
Return true if the timer is running.
Mac48Address m_txopHolder
MAC address of the TXOP holder.
Time GetPifs(void) const
Return the PCF Interframe Space (PIFS) for this PHY.
Ptr< QosTxop > m_edca
the EDCAF that gained channel access
void SendCtsAfterRts(const WifiMacHeader &rtsHdr, WifiMode rtsTxMode, double rtsSnr)
Send CTS after receiving RTS.
static Time Now(void)
Return the current simulation virtual time.
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...
void SendNormalAck(const WifiMacHeader &hdr, const WifiTxVector &dataTxVector, double dataSnr)
Send Normal Ack.
FrameExchangeManager is a base class handling the basic frame exchange sequences for non-QoS stations...
virtual Time GetTxDuration(uint32_t ppduPayloadSize, Mac48Address receiver, const WifiTxParameters &txParams) const
Get the updated TX duration of the frame associated with the given TX parameters if the size of the P...
void AddMpdu(Ptr< const WifiMacQueueItem > mpdu)
Record that an MPDU is being added to the current frame.
uint32_t GetCtsSize(void)
Return the total CTS size (including FCS trailer).
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
Time GetPpduMaxTime(WifiPreamble preamble)
Get the maximum PPDU duration (see Section 10.14 of 802.11-2016) for the PHY layers defining the aPPD...
Time GetSifs(void) const
Return the Short Interframe Space (SIFS) for this PHY.
void NotifyChannelReleased(void) override
Called by the FrameExchangeManager to notify the completion of the transmissions. ...
double snr
SNR in linear scale.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Time Seconds(double value)
Construct a Time in the indicated unit.
Ptr< const AttributeChecker > MakeBooleanChecker(void)
This class stores the TX parameters (TX vector, protection mechanism, acknowledgment mechanism...
Ptr< Txop > m_dcf
the DCF/EDCAF that gained channel access
bool IsRunning(void) const
This method is syntactic sugar for !IsExpired().
QosFrameExchangeManager()
void Send(Ptr< const WifiPsdu > psdu, const WifiTxVector &txVector)
This function is a wrapper for the Send variant that accepts a WifiConstPsduMap as first argument...
virtual Time GetCtsToSelfDurationId(const WifiTxVector &ctsTxVector, Time txDuration, Time response) const
Compute how to set the Duration/ID field of a CTS-to-self frame to send to protect a frame transmitte...
void Cancel(void)
This method is syntactic sugar for the ns3::Simulator::Cancel method.
Time m_navEnd
NAV expiration time.
virtual void ReceiveMpdu(Ptr< WifiMacQueueItem > mpdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, bool inAmpdu)
This method handles the reception of an MPDU (possibly included in an A-MPDU)
void ReceiveMpdu(Ptr< WifiMacQueueItem > mpdu, RxSignalInfo rxSignalInfo, const WifiTxVector &txVector, bool inAmpdu) override
This method handles the reception of an MPDU (possibly included in an A-MPDU)
void TransmissionFailed(void) override
Take necessary actions upon a transmission failure.
virtual void TransmissionSucceeded(void)
Take necessary actions upon a transmission success.
std::unique_ptr< WifiAcknowledgment > m_acknowledgment
acknowledgment method
virtual ~QosFrameExchangeManager()
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 re...
Mac48Address GetAddr1(void) const
Get the Receiver Address (RA), which is common to all the MPDUs.
Ptr< WifiMacQueueItem > GetNextMpdu(Ptr< const WifiMacQueueItem > peekedItem, WifiTxParameters &txParams, Time availableTime, bool initialFrame, WifiMacQueueItem::QueueIteratorPair &queueIt)
Prepare the frame to transmit starting from the MPDU that has been previously peeked by calling PeekN...
bool TryAddMpdu(Ptr< const WifiMacQueueItem > mpdu, WifiTxParameters &txParams, Time availableTime) const
Recompute the protection and acknowledgment methods to use if the given MPDU is added to the frame be...
Ptr< MacRxMiddle > m_rxMiddle
the MAC RX Middle on this station
virtual bool StartFrameExchange(Ptr< QosTxop > edca, Time availableTime, bool initialFrame)
Start a frame exchange (including protection frames and acknowledgment frames as needed) that fits wi...
a unique identifier for an interface.
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 transmitte...
TypeId SetParent(TypeId tid)
Set the parent TypeId.
virtual bool IsWithinLimitsIfAddMpdu(Ptr< const WifiMacQueueItem > mpdu, const WifiTxParameters &txParams, Time ppduDurationLimit) const
Check whether the given MPDU can be added to the frame being built (as described by the given TX para...
bool IsNegative(void) const
Exactly equivalent to t <= 0.
virtual bool IsTxopStarted(void) const
Return true if a TXOP has started.
virtual void NavResetTimeout(void)
Reset the NAV upon expiration of the NAV reset timer.
Time GetTxopLimit(void) const
Return the TXOP limit.