22#undef NS_LOG_APPEND_CONTEXT
23#define NS_LOG_APPEND_CONTEXT WIFI_FEM_NS_LOG_APPEND_CONTEXT
28#define PSDU_DURATION_SAFEGUARD 400
41 TypeId(
"ns3::FrameExchangeManager")
43 .AddConstructor<FrameExchangeManager>()
45 .AddAttribute(
"ProtectedIfResponded",
46 "Whether a station is assumed to be protected if replied to a frame "
47 "requiring acknowledgment. If a station is protected, subsequent "
48 "transmissions to the same station in the same TXOP are not "
49 "preceded by protection mechanisms.",
62 m_moreFragments(false)
205 const std::vector<bool>&>());
293 <<
" (txVector: " << txVector <<
")");
296 "The TX timer and the NAV reset event cannot be both running");
327std::optional<std::reference_wrapper<const FrameExchangeManager::OngoingRxInfo>>
337std::optional<std::reference_wrapper<const WifiMacHeader>>
340 if (
auto info =
GetOngoingRxInfo(); info.has_value() && info->get().macHdr.has_value())
342 return info->get().
macHdr.value();
365 queue->WipeAllExpiredMpdus();
379 NS_ASSERT(mpdu->GetHeader().IsData() || mpdu->GetHeader().IsMgt());
382 if (!mpdu->IsFragment() && !mpdu->GetHeader().IsRetry())
384 uint16_t sequence =
m_txMiddle->GetNextSequenceNumberFor(&mpdu->GetHeader());
385 mpdu->AssignSeqNo(sequence);
388 NS_LOG_DEBUG(
"MPDU payload size=" << mpdu->GetPacketSize()
389 <<
", to=" << mpdu->GetHeader().GetAddr1()
390 <<
", seq=" << mpdu->GetHeader().GetSequenceControl());
415 if (mpdu->IsFragment())
430 item->GetHeader().SetMoreFragments();
431 m_mac->GetTxopQueue(mpdu->GetQueueAc())->Replace(mpdu, item);
508const std::set<Mac48Address>&
533 NS_LOG_DEBUG(
"Prepare groupcast MPDU for retry");
534 mpdu->ResetInFlight(m_linkId);
536 if (m_apMac->GetGcrManager()->UseConcealment(mpdu->GetHeader()))
538 mpdu->GetHeader().SetAddr1(mpdu->begin()->second.GetDestinationAddr());
540 mpdu->GetHeader().SetRetry();
545 if (
m_apMac->GetGcrManager()->GetRetransmissionPolicy() ==
553 else if (!
m_mpdu->GetHeader().IsQosData() ||
567 m_mpdu->GetHeader().SetDuration(
568 GetFrameDurationId(m_mpdu->GetHeader(),
569 GetPsduSize(m_mpdu, m_txParams.m_txVector),
571 m_fragmentedPacket));
576 auto normalAcknowledgment =
static_cast<WifiNormalAck*
>(m_txParams.m_acknowledgment.get());
579 txDuration + m_phy->GetSifs() + m_phy->GetSlot() +
584 {m_mpdu->GetHeader().GetAddr1()},
588 m_txParams.m_txVector);
589 m_channelAccessManager->NotifyAckTimeoutStartNow(
timeout);
593 NS_ABORT_MSG(
"Unable to handle the selected acknowledgment method ("
594 << m_txParams.m_acknowledgment.get() <<
")");
598 ForwardMpduDown(m_mpdu, m_txParams.m_txVector);
600 if (m_txTimer.IsRunning())
603 m_sentFrameTo = {m_mpdu->GetHeader().GetAddr1()};
612 auto psdu = Create<WifiPsdu>(mpdu,
false);
613 FinalizeMacHeader(psdu);
615 auto txDuration = WifiPhy::CalculateTxDuration(psdu, txVector, m_phy->GetPhyBand());
619 if (!mpdu->GetHeader().IsPsPoll())
621 m_txNav =
Max(m_txNav, Simulator::Now() + txDuration + mpdu->GetHeader().GetDuration());
623 m_phy->Send(psdu, txVector);
631 if (m_mac->GetTypeOfStation() !=
STA)
636 auto pmMode = StaticCast<StaWifiMac>(m_mac)->GetPmMode(m_linkId);
644 mpdu->GetHeader().SetNoPowerManagement();
648 mpdu->GetHeader().SetPowerManagement();
661 if (mpdu->IsQueued())
663 m_mac->GetTxopQueue(mpdu->GetQueueAc())->DequeueIfQueued({mpdu});
670 return mpdu->GetSize();
679 if (protection->
method == WifiProtection::NONE)
683 else if (protection->
method == WifiProtection::RTS_CTS)
688 rtsCtsProtection->rtsTxVector,
689 m_phy->GetPhyBand()) +
691 rtsCtsProtection->ctsTxVector,
692 m_phy->GetPhyBand()) +
693 2 * m_phy->GetSifs();
695 else if (protection->
method == WifiProtection::CTS_TO_SELF)
700 ctsToSelfProtection->ctsTxVector,
701 m_phy->GetPhyBand()) +
712 if (acknowledgment->
method == WifiAcknowledgment::NONE)
716 else if (acknowledgment->
method == WifiAcknowledgment::NORMAL_ACK)
718 auto normalAcknowledgment =
static_cast<WifiNormalAck*
>(acknowledgment);
720 m_phy->GetSifs() + WifiPhy::CalculateTxDuration(
GetAckSize(),
721 normalAcknowledgment->ackTxVector,
722 m_phy->GetPhyBand());
727FrameExchangeManager::GetTxDuration(
uint32_t ppduPayloadSize,
731 return WifiPhy::CalculateTxDuration(ppduPayloadSize, txParams.
m_txVector, m_phy->GetPhyBand());
746 NS_LOG_FUNCTION(
this << header << size << &txParams << fragmentedPacket);
759 std::min(fragmentedPacket->GetSize() - nextFragmentOffset, payloadSize);
761 GetWifiRemoteStationManager()->GetAckTxVector(header.
GetAddr1(), txParams.
m_txVector);
763 durationId += 2 * m_phy->GetSifs() +
764 WifiPhy::CalculateTxDuration(
GetAckSize(), ackTxVector, m_phy->GetPhyBand()) +
765 WifiPhy::CalculateTxDuration(nextFragmentSize,
767 m_phy->GetPhyBand());
780 ctsTxVector = GetWifiRemoteStationManager()->GetCtsTxVector(m_self, rtsTxVector.
GetMode());
782 return m_phy->GetSifs() +
783 WifiPhy::CalculateTxDuration(
GetCtsSize(), ctsTxVector, m_phy->GetPhyBand())
784 + m_phy->GetSifs() + txDuration + response;
794 const auto& hdr = txParams.
GetPsduInfoMap().begin()->second.header;
811 rts.
SetDuration(GetRtsDurationId(rtsCtsProtection->rtsTxVector,
814 Ptr<WifiMpdu> mpdu = Create<WifiMpdu>(Create<Packet>(), rts);
820 rtsCtsProtection->rtsTxVector,
821 m_phy->GetPhyBand()) +
822 m_phy->GetSifs() + m_phy->GetSlot() +
823 WifiPhy::CalculatePhyPreambleAndHeaderDuration(rtsCtsProtection->ctsTxVector);
825 m_txTimer.Set(WifiTxTimer::WAIT_CTS,
828 &FrameExchangeManager::CtsTimeout,
831 rtsCtsProtection->rtsTxVector);
832 m_channelAccessManager->NotifyCtsTimeoutStartNow(
timeout);
834 m_sentRtsTo = {receiver};
836 ForwardMpduDown(mpdu, rtsCtsProtection->rtsTxVector);
854 WifiPhy::CalculateTxDuration(
GetCtsSize(), ctsTxVector, m_phy->GetPhyBand());
866 packet->AddPacketTag(tag);
869 ForwardMpduDown(Create<WifiMpdu>(packet, cts), ctsTxVector);
880 GetWifiRemoteStationManager()->GetCtsTxVector(rtsHdr.
GetAddr2(), rtsTxMode);
881 DoSendCtsAfterRts(rtsHdr, ctsTxVector, rtsSnr);
885FrameExchangeManager::GetCtsToSelfDurationId(
const WifiTxVector& ctsTxVector,
891 return m_phy->GetSifs() + txDuration + response;
908 txParams.
m_protection->method == WifiProtection::CTS_TO_SELF);
913 cts.
SetDuration(GetCtsToSelfDurationId(ctsToSelfProtection->ctsTxVector,
917 ForwardMpduDown(Create<WifiMpdu>(Create<Packet>(), cts), ctsToSelfProtection->ctsTxVector);
920 ctsToSelfProtection->ctsTxVector,
921 m_phy->GetPhyBand());
922 Simulator::Schedule(ctsDuration, &FrameExchangeManager::ProtectionCompleted,
this);
933 GetWifiRemoteStationManager()->GetAckTxVector(hdr.
GetAddr2(), dataTxVector);
944 WifiPhy::CalculateTxDuration(
GetAckSize(), ackTxVector, m_phy->GetPhyBand());
956 packet->AddPacketTag(tag);
958 ForwardMpduDown(Create<WifiMpdu>(packet, ack), ackTxVector);
962FrameExchangeManager::GetNextFragment()
965 NS_ASSERT(m_mpdu->GetHeader().IsMoreFragments());
971 uint32_t size = m_fragmentedPacket->GetSize() - startOffset;
973 if (size > m_mpdu->GetPacketSize())
976 size = m_mpdu->GetPacketSize();
984 return Create<WifiMpdu>(m_fragmentedPacket->CreateFragment(startOffset, size), hdr);
988FrameExchangeManager::TransmissionSucceeded()
991 m_sentFrameTo.clear();
997 NS_LOG_DEBUG(
"Schedule transmission of next fragment in a SIFS");
998 Simulator::Schedule(m_phy->GetSifs(),
999 &FrameExchangeManager::StartTransmission,
1003 m_moreFragments =
false;
1007 NotifyChannelReleased(m_dcf);
1013FrameExchangeManager::TransmissionFailed(
bool forceCurrentCw)
1016 if (!forceCurrentCw)
1018 m_dcf->UpdateFailedCw(m_linkId);
1020 m_sentFrameTo.clear();
1022 NotifyChannelReleased(m_dcf);
1025 m_txNav = Simulator::Now();
1032 txop->NotifyChannelReleased(m_linkId);
1033 m_protectedStas.clear();
1041 const auto mpdusToDrop = GetWifiRemoteStationManager()->GetMpdusToDropOnTxFailure(psdu);
1044 for (
const auto& mpdu : mpdusToDrop)
1048 NotifyPacketDiscarded(mpdu);
1060 GetWifiRemoteStationManager()->ReportDataFailed(mpdu);
1061 if (
auto droppedMpdu = DropMpduIfRetryLimitReached(Create<WifiPsdu>(mpdu,
false)))
1064 GetWifiRemoteStationManager()->ReportFinalDataFailed(droppedMpdu);
1069 if (mpdu->IsQueued())
1071 mpdu = m_mac->GetTxopQueue(mpdu->GetQueueAc())->GetOriginal(mpdu);
1072 mpdu->ResetInFlight(m_linkId);
1073 mpdu->GetHeader().SetRetry();
1074 RetransmitMpduAfterMissedAck(mpdu);
1078 TransmissionFailed();
1092 DoCtsTimeout(Create<WifiPsdu>(m_mpdu,
true));
1102 const auto updateCw = GetUpdateCwOnCtsTimeout();
1104 m_sentRtsTo.clear();
1107 if (mpdu->IsQueued())
1109 mpdu->ResetInFlight(m_linkId);
1113 GetWifiRemoteStationManager()->ReportRtsFailed(psdu->GetHeader(0));
1114 if (
auto droppedMpdu = DropMpduIfRetryLimitReached(psdu))
1116 GetWifiRemoteStationManager()->ReportFinalRtsFailed(droppedMpdu->GetHeader());
1123 ReleaseSequenceNumbers(psdu);
1125 TransmissionFailed(!updateCw);
1129FrameExchangeManager::GetUpdateCwOnCtsTimeout()
const
1139 NS_ASSERT_MSG(psdu->GetNMpdus() == 1,
"A-MPDUs should be handled by the HT FEM override");
1140 auto mpdu = *psdu->begin();
1146 if (!mpdu->GetHeader().IsRetry() && !mpdu->IsInFlight())
1148 mpdu->UnassignSeqNo();
1149 m_txMiddle->SetSequenceNumberFor(&mpdu->GetOriginal()->GetHeader());
1154FrameExchangeManager::NotifyInternalCollision(
Ptr<Txop> txop)
1162 Ptr<QosTxop> qosTxop = (txop->IsQosTxop() ? StaticCast<QosTxop>(txop) :
nullptr);
1165 (qosTxop ? qosTxop->PeekNextMpdu(m_linkId) : txop->GetWifiMacQueue()->Peek(m_linkId));
1166 mpdu && !mpdu->GetHeader().GetAddr1().IsGroup())
1168 if (mpdu->GetHeader().HasData())
1170 GetWifiRemoteStationManager()->ReportDataFailed(mpdu);
1173 if (DropMpduIfRetryLimitReached(Create<WifiPsdu>(mpdu,
false)))
1175 GetWifiRemoteStationManager()->ReportFinalDataFailed(mpdu);
1179 txop->UpdateFailedCw(m_linkId);
1180 txop->Txop::NotifyChannelReleased(m_linkId);
1184FrameExchangeManager::NotifySwitchingStartNow(
Time duration)
1186 NS_LOG_DEBUG(
"Switching channel. Cancelling MAC pending events");
1187 Simulator::Schedule(duration, &WifiMac::NotifyChannelSwitching, m_mac, m_linkId);
1188 if (m_txTimer.IsRunning())
1193 m_txTimer.Reschedule(
Seconds(0));
1195 Simulator::ScheduleNow(&FrameExchangeManager::Reset,
this);
1199FrameExchangeManager::NotifySleepNow()
1201 NS_LOG_DEBUG(
"Device in sleep mode. Cancelling MAC pending events");
1206FrameExchangeManager::NotifyOffNow()
1208 NS_LOG_DEBUG(
"Device is switched off. Cancelling MAC pending events");
1222 const std::vector<bool>& perMpduStatus)
1225 this << psdu << rxSignalInfo << txVector << perMpduStatus.size()
1226 << std::all_of(perMpduStatus.begin(), perMpduStatus.end(), [](
bool v) { return v; }));
1228 if (!perMpduStatus.empty())
1231 PreProcessFrame(psdu, txVector);
1236 if (addr1.
IsGroup() || addr1 == m_self)
1239 if (psdu->GetNMpdus() == 1)
1244 NS_ASSERT(perMpduStatus.empty() || (perMpduStatus.size() == 1 && perMpduStatus[0]));
1246 if (!psdu->GetHeader(0).IsAck() && !psdu->GetHeader(0).IsCts())
1248 GetWifiRemoteStationManager()->ReportRxOk(psdu->GetHeader(0).GetAddr2(),
1252 ReceiveMpdu(*(psdu->begin()), rxSignalInfo, txVector, perMpduStatus.empty());
1256 EndReceiveAmpdu(psdu, rxSignalInfo, txVector, perMpduStatus);
1263 if (!mpdu->GetHeader().IsCtl())
1265 m_rxMiddle->Receive(mpdu, m_linkId);
1270 if (!perMpduStatus.empty())
1273 PostProcessFrame(psdu, txVector);
1288 UpdateNav(psdu, txVector);
1296 if (!psdu->HasNav())
1301 Time duration = psdu->GetDuration();
1304 if (psdu->GetAddr1() == m_self)
1313 Time navEnd = Simulator::Now() + duration;
1314 if (navEnd > m_navEnd)
1328 if (psdu->GetHeader(0).IsRts())
1331 GetWifiRemoteStationManager()->GetCtsTxVector(psdu->GetAddr2(), txVector.
GetMode());
1332 Time navResetDelay =
1333 2 * m_phy->GetSifs() +
1334 WifiPhy::CalculateTxDuration(
GetCtsSize(), ctsTxVector, m_phy->GetPhyBand()) +
1335 WifiPhy::CalculatePhyPreambleAndHeaderDuration(ctsTxVector) + 2 * m_phy->GetSlot();
1337 Simulator::Schedule(navResetDelay, &FrameExchangeManager::NavResetTimeout,
this);
1342 m_channelAccessManager->NotifyNavStartNow(duration);
1346FrameExchangeManager::NavResetTimeout()
1349 m_navEnd = Simulator::Now();
1350 m_channelAccessManager->NotifyNavResetNow(
Seconds(0));
1354FrameExchangeManager::VirtualCsMediumIdle()
const
1356 return m_navEnd <= Simulator::Now();
1365 NS_LOG_FUNCTION(
this << *mpdu << rxSignalInfo << txVector << inAmpdu);
1367 NS_ASSERT(mpdu->GetHeader().GetAddr1().IsGroup() || mpdu->GetHeader().GetAddr1() == m_self);
1369 double rxSnr = rxSignalInfo.
snr;
1382 if (VirtualCsMediumIdle())
1385 m_sendCtsEvent = Simulator::Schedule(m_phy->GetSifs(),
1386 &FrameExchangeManager::SendCtsAfterRts,
1397 else if (hdr.
IsCts() && m_txTimer.IsRunning() &&
1398 m_txTimer.GetReason() == WifiTxTimer::WAIT_CTS && m_mpdu)
1407 mpdu->GetPacket()->PeekPacketTag(tag);
1408 GetWifiRemoteStationManager()->ReportRxOk(sender, rxSignalInfo, txVector);
1409 GetWifiRemoteStationManager()->ReportRtsOk(m_mpdu->GetHeader(),
1415 m_channelAccessManager->NotifyCtsTimeoutResetNow();
1416 ProtectionCompleted();
1418 else if (hdr.
IsAck() && m_mpdu && m_txTimer.IsRunning() &&
1419 m_txTimer.GetReason() == WifiTxTimer::WAIT_NORMAL_ACK)
1423 mpdu->GetPacket()->PeekPacketTag(tag);
1424 ReceivedNormalAck(m_mpdu, m_txParams.m_txVector, txVector, rxSignalInfo, tag.
Get());
1428 else if (hdr.
IsMgt())
1430 NS_ABORT_MSG_IF(inAmpdu,
"Received management frame as part of an A-MPDU");
1438 packet->AddPacketTag(tag);
1439 mpdu = Create<WifiMpdu>(packet, hdr);
1445 <<
", schedule ACK");
1446 Simulator::Schedule(m_phy->GetSifs(),
1447 &FrameExchangeManager::SendNormalAck,
1454 m_rxMiddle->Receive(mpdu, m_linkId);
1461 <<
", schedule ACK");
1462 Simulator::Schedule(m_phy->GetSifs(),
1463 &FrameExchangeManager::SendNormalAck,
1470 m_rxMiddle->Receive(mpdu, m_linkId);
1483 m_txTimer.GotResponseFrom(sender);
1485 NotifyReceivedNormalAck(mpdu);
1488 if (!mpdu->GetHeader().IsMoreFragments())
1490 GetWifiRemoteStationManager()->ReportRxOk(sender, rxInfo, ackTxVector);
1491 GetWifiRemoteStationManager()->ReportDataOk(mpdu,
1499 m_channelAccessManager->NotifyAckTimeoutResetNow();
1503 m_dcf->ResetCw(m_linkId);
1505 if (mpdu->GetHeader().IsMoreFragments())
1508 m_dcf->GetWifiMacQueue()->Replace(mpdu, GetNextFragment());
1509 m_moreFragments =
true;
1517 TransmissionSucceeded();
1526 if (!m_ackedMpduCallback.IsNull())
1528 m_ackedMpduCallback(mpdu);
1536 const std::vector<bool>& perMpduStatus)
1538 NS_ASSERT_MSG(
false,
"A non-QoS station should not receive an A-MPDU");
1544 NS_ASSERT_MSG(
false,
"A non-QoS station should not use GCR-UR");
bool IsNull() const
Check for null implementation.
void Cancel()
This method is syntactic sugar for the ns3::Simulator::Cancel method.
bool IsPending() const
This method is syntactic sugar for !IsExpired().
std::set< Mac48Address > m_sentRtsTo
the STA(s) which we sent an RTS to (waiting for CTS)
Ptr< WifiMpdu > m_mpdu
the MPDU being transmitted
virtual void SetAckManager(Ptr< WifiAckManager > ackManager)
Set the Acknowledgment Manager to use.
virtual void NotifyLastGcrUrTx(Ptr< const WifiMpdu > mpdu)
Notify the last (re)transmission of a groupcast MPDU using the GCR-UR service.
static TypeId GetTypeId()
Get the type ID.
uint8_t m_linkId
the ID of the link this object is associated with
Ptr< WifiMac > m_mac
the MAC layer on this station
DroppedMpdu m_droppedMpduCallback
the dropped MPDU callback
bool m_protectedIfResponded
whether a STA is assumed to be protected if replied to a frame requiring acknowledgment
virtual void SetWifiMac(const Ptr< WifiMac > mac)
Set the MAC layer to use.
virtual void ResetPhy()
Remove WifiPhy associated with this FrameExchangeManager.
void SendMpduWithProtection(Ptr< WifiMpdu > mpdu, WifiTxParameters &txParams)
Send an MPDU with the given TX parameters (with the specified protection).
Ptr< WifiAckManager > m_ackManager
Acknowledgment manager.
Ptr< WifiRemoteStationManager > GetWifiRemoteStationManager() const
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...
virtual void CalculateAcknowledgmentTime(WifiAcknowledgment *acknowledgment) const
Calculate the time required to acknowledge a frame according to the given acknowledgment method.
Ptr< MacTxMiddle > m_txMiddle
the MAC TX Middle on this station
Ptr< Packet > m_fragmentedPacket
the MSDU being fragmented
virtual void SetDroppedMpduCallback(DroppedMpdu callback)
Set the callback to invoke when an MPDU is dropped.
virtual void Reset()
Reset this frame exchange manager.
Mac48Address m_self
the MAC address of this device
virtual void StartProtection(const WifiTxParameters &txParams)
Start the protection mechanism indicated by the given TX parameters.
virtual void NotifyPacketDiscarded(Ptr< const WifiMpdu > mpdu)
Pass the given MPDU, discarded because of the max retry limit was reached, to the MPDU dropped callba...
std::optional< std::reference_wrapper< const WifiMacHeader > > GetReceivedMacHdr() const
WifiTxTimer m_txTimer
the timer set upon frame transmission
std::set< Mac48Address > m_protectedStas
STAs that have replied to an RTS in this TXOP.
Mac48Address GetAddress() const
Get the MAC address.
Ptr< WifiProtectionManager > m_protectionManager
Protection manager.
OngoingRxInfo m_ongoingRxInfo
information about the MAC header of the MPDU being received
virtual void ProtectionCompleted()
Transmit prepared frame immediately, if no protection was used, or in a SIFS, if protection was compl...
virtual void SetLinkId(uint8_t linkId)
Set the ID of the link this Frame Exchange Manager is associated with.
void SendRts(const WifiTxParameters &txParams)
Send RTS to begin RTS-CTS-Data-Ack transaction.
virtual void NotifyChannelReleased(Ptr< Txop > txop)
Notify the given Txop that channel has been released.
virtual void NormalAckTimeout(Ptr< WifiMpdu > mpdu, const WifiTxVector &txVector)
Called when the Ack timeout expires.
virtual void SetBssid(Mac48Address bssid)
Set the Basic Service Set Identification.
void SendCtsToSelf(const WifiTxParameters &txParams)
Send CTS for a CTS-to-self mechanism.
virtual void ReceivedMacHdr(const WifiMacHeader &macHdr, const WifiTxVector &txVector, Time psduDuration)
Store information about the MAC header of the MPDU being received.
std::optional< std::reference_wrapper< const OngoingRxInfo > > GetOngoingRxInfo() const
virtual void SetAddress(Mac48Address address)
Set the MAC address.
Ptr< WifiAckManager > GetAckManager() const
Get the Acknowledgment Manager used by this node.
virtual void DequeueMpdu(Ptr< const WifiMpdu > mpdu)
Dequeue the given MPDU from the queue in which it is stored.
const std::set< Mac48Address > & GetProtectedStas() const
Ptr< WifiProtectionManager > GetProtectionManager() const
Get the Protection Manager used by this node.
bool IsPromisc() const
Check if the device is operating in promiscuous mode.
void SendMpdu()
Send the current MPDU, which can be acknowledged by a Normal Ack.
Ptr< MacRxMiddle > m_rxMiddle
the MAC RX Middle on this station
virtual void TransmissionSucceeded()
Take necessary actions upon a transmission success.
Ptr< Txop > m_dcf
the DCF/EDCAF that gained channel access
EventId m_sendCtsEvent
the event to send a CTS after an (MU-)RTS
Ptr< WifiPhy > m_phy
the PHY layer on this station
Ptr< WifiMpdu > GetFirstFragmentIfNeeded(Ptr< WifiMpdu > mpdu)
Fragment the given MPDU if needed.
void SetAckedMpduCallback(AckedMpdu callback)
Set the callback to invoke when an MPDU is successfully acked.
~FrameExchangeManager() override
Ptr< ApWifiMac > m_apMac
AP MAC layer pointer (null if not an AP)
Mac48Address m_bssid
BSSID address (Mac48Address)
virtual void SetWifiPhy(const Ptr< WifiPhy > phy)
Set the PHY layer to use.
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 th...
AckedMpdu m_ackedMpduCallback
the acknowledged MPDU callback
virtual uint32_t GetPsduSize(Ptr< const WifiMpdu > mpdu, const WifiTxVector &txVector) const
Get the size in bytes of the given MPDU, which is to be transmitted with the given TXVECTOR.
Ptr< ChannelAccessManager > m_channelAccessManager
the channel access manager
bool m_promisc
Flag if the device is operating in promiscuous mode.
virtual void SetChannelAccessManager(const Ptr< ChannelAccessManager > channelAccessManager)
Set the channel access manager to use.
virtual bool StartTransmission(Ptr< Txop > dcf, MHz_u allowedWidth)
Request the FrameExchangeManager to start a frame exchange sequence.
void SetPromisc()
Enable promiscuous mode.
MHz_u m_allowedWidth
the allowed width for the current transmission
MHz_u GetAllowedWidth() const
virtual void PsduRxError(Ptr< const WifiPsdu > psdu)
This method is called when the reception of a PSDU fails.
Time m_navEnd
NAV expiration time.
virtual void SetMacTxMiddle(const Ptr< MacTxMiddle > txMiddle)
Set the MAC TX Middle to use.
virtual void SetMacRxMiddle(const Ptr< MacRxMiddle > rxMiddle)
Set the MAC RX Middle to use.
virtual void SetProtectionManager(Ptr< WifiProtectionManager > protectionManager)
Set the Protection Manager to use.
Mac48Address GetBssid() const
Get the Basic Service Set Identification.
Ptr< StaWifiMac > m_staMac
STA MAC layer pointer (null if not a STA)
void DoDispose() override
Destructor implementation.
WifiTxParameters m_txParams
the TX parameters for the current frame
virtual void RxStartIndication(WifiTxVector txVector, Time psduDuration)
EventId m_navResetEvent
the event to reset the NAV after an RTS
const WifiTxTimer & GetWifiTxTimer() const
Get a const reference to the WifiTxTimer object.
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
bool TraceDisconnectWithoutContext(std::string name, const CallbackBase &cb)
Disconnect from a TraceSource a Callback previously connected without a context.
A base class which provides memory management and object aggregation.
virtual void DoDispose()
Destructor implementation.
Ptr< Packet > CreateFragment(uint32_t start, uint32_t length) const
Create a new packet which contains a fragment of the original packet.
Smart pointer class similar to boost::intrusive_ptr.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
static Time Now()
Return the current simulation virtual time.
void Set(double snr)
Set the SNR to the given value.
double Get() const
Return the SNR value.
Simulation virtual time values and global simulation resolution.
TimeWithUnit As(const Unit unit=Time::AUTO) const
Attach a unit to a Time, to facilitate output in a specific unit.
bool IsStrictlyPositive() const
Exactly equivalent to t > 0.
bool IsStrictlyNegative() const
Exactly equivalent to t < 0.
virtual void NotifyChannelAccessed(uint8_t linkId, Time txopDuration=Seconds(0))
Called by the FrameExchangeManager to notify that channel access has been granted on the given link f...
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
static void SetQosAckPolicy(Ptr< WifiMpdu > item, const WifiAcknowledgment *acknowledgment)
Set the QoS Ack policy for the given MPDU, which must be a QoS data frame.
represent a single transmission mode
Time GetSifs() const
Return the Short Interframe Space (SIFS) for this PHY.
void SetReceiveErrorCallback(RxErrorCallback callback)
static Time CalculateTxDuration(uint32_t size, const WifiTxVector &txVector, WifiPhyBand band, uint16_t staId=SU_STA_ID)
Ptr< WifiPhyStateHelper > GetState() const
Return the WifiPhyStateHelper of this PHY.
WifiPhyBand GetPhyBand() const
Get the configured Wi-Fi band.
void SetReceiveOkCallback(RxOkCallback callback)
static Time CalculatePhyPreambleAndHeaderDuration(const WifiTxVector &txVector)
This class stores the TX parameters (TX vector, protection mechanism, acknowledgment mechanism,...
std::optional< Time > m_txDuration
TX duration of the frame.
const PsduInfoMap & GetPsduInfoMap() const
Get a const reference to the map containing information about PSDUs.
std::unique_ptr< WifiProtection > m_protection
protection method
uint32_t GetSize(Mac48Address receiver) const
Get the size in bytes of the (A-)MPDU addressed to the given receiver.
std::unique_ptr< WifiAcknowledgment > m_acknowledgment
acknowledgment method
WifiTxVector m_txVector
TXVECTOR of the frame being prepared.
void AddMpdu(Ptr< const WifiMpdu > mpdu)
Record that an MPDU is being added to the current frame.
void Clear()
Reset the TX parameters.
This class is used to handle the timer that a station starts when transmitting a frame that solicits ...
bool IsRunning() const
Return true if the timer is running.
void Cancel()
Cancel the timer.
void Reschedule(const Time &delay)
Reschedule the timer to time out the given amount of time from the moment this function is called.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
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.
MHz_u GetChannelWidth() const
#define PSDU_DURATION_SAFEGUARD
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Callback< R, Args... > MakeNullCallback()
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if a condition is true, with a message.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Ptr< T > Create(Ts &&... args)
Create class instances by constructors with varying numbers of arguments and return them by Ptr.
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Time Seconds(double value)
Construct a Time in the indicated unit.
@ WIFI_MAC_DROP_REACHED_RETRY_LIMIT
@ WIFI_PM_SWITCHING_TO_ACTIVE
@ WIFI_PM_SWITCHING_TO_PS
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Ptr< const AttributeChecker > MakeBooleanChecker()
U * PeekPointer(const Ptr< U > &p)
Callback< R, Args... > MakeCallback(R(T::*memPtr)(Args...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
uint32_t GetRtsSize()
Return the total RTS size (including FCS trailer).
double MHz_u
MHz weak type.
Ptr< T1 > DynamicCast(const Ptr< T2 > &p)
Cast a Ptr.
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
uint32_t GetAckSize()
Return the total Ack size (including FCS trailer).
uint32_t GetCtsSize()
Return the total CTS size (including FCS trailer).
Mac48Address GetIndividuallyAddressedRecipient(Ptr< WifiMac > mac, const WifiMacHeader &hdr)
Get the MAC address of the individually addressed recipient to use for a given packet.
Time endOfPsduRx
time when reception of PSDU ends
std::optional< WifiMacHeader > macHdr
MAC header of the MPDU being received.
RxSignalInfo structure containing info on the received signal.
double snr
SNR in linear scale.
WifiAcknowledgment is an abstract base struct.
const Method method
acknowledgment method
std::optional< Time > acknowledgmentTime
time required by the acknowledgment method
WifiCtsToSelfProtection specifies that CTS-to-self protection method is used.
WifiNormalAck specifies that acknowledgment via Normal Ack is required.
WifiProtection is an abstract base struct.
std::optional< Time > protectionTime
time required by the protection method
const Method method
protection method
WifiRtsCtsProtection specifies that RTS/CTS protection method is used.