From 83bb6f064ebc5503a17d0237a1667e8fb03a52aa Mon Sep 17 00:00:00 2001 From: Stefano Avallone Date: Wed, 18 May 2022 10:35:22 +0200 Subject: [PATCH] Update wifi documentation --- CHANGES.md | 2 ++ RELEASE_NOTES.md | 2 ++ src/wifi/doc/source/wifi-user.rst | 18 +++++++++++++++--- 3 files changed, 19 insertions(+), 3 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index e2ca6e34c..d8aec3c42 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -18,6 +18,8 @@ Changes from ns-3.36 to ns-3.37 ### New API +* Added a new attribute **MaxTbPpduDelay** in HeConfiguration for configuring the maximum delay with which a TB PPDU can arrive at the AP after the first TB PPDU in order to be decoded properly. If the delay is higher than **MaxTbPpduDelay**, the TB PPDU is discarded and treated as interference. + ### Changes to existing API ### Changes to build system diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 6e1ae0bec..a2cd5cdcd 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -16,6 +16,8 @@ Release 3-dev ### Bugs fixed +- (wifi) Fix setting of stations' max supported channel width + Release 3.36.1 -------------- diff --git a/src/wifi/doc/source/wifi-user.rst b/src/wifi/doc/source/wifi-user.rst index ba4f2f1f1..f24aaab4b 100644 --- a/src/wifi/doc/source/wifi-user.rst +++ b/src/wifi/doc/source/wifi-user.rst @@ -799,12 +799,24 @@ attributes for 802.11ax devices. Ptr heConfiguration = wnd->GetHeConfiguration (); heConfiguration->SetGuardInterval (NanoSeconds (1600)); - 802.11ax allows extended compressed Block ACKs containing a 256-bits bitmap, making possible transmissions of A-MPDUs containing up to 256 MPDUs, - depending on the negotiated buffer size. In order to configure the buffer size of an 802.11ax device, the following line of code could be used:: +802.11ax allows extended compressed Block ACKs containing a 256-bits bitmap, making +possible transmissions of A-MPDUs containing up to 256 MPDUs, depending on the +negotiated buffer size. In order to configure the buffer size of an 802.11ax device, +the following line of code could be used:: heConfiguration->SetMpduBufferSize (256); - For transmitting large MPDUs, it might also be needed to increase the maximum aggregation size (see above). +For transmitting large MPDUs, it might also be needed to increase the maximum +aggregation size (see above). + +When using UL MU transmissions, solicited TB PPDUs can arrive at the AP with a +different delay, due to the different propagation delay from the various stations. +In real systems, late TB PPDUs cause a variable amount of interference depending on +the receiver's sensitivity. This phenomenon can be modeled through the +``ns3::HeConfiguration::MaxTbPpduDelay`` attribute, which defines the maximum delay +with which a TB PPDU can arrive with respect to the first TB PPDU in order to be +decoded properly. TB PPDUs arriving after more than ``MaxTbPpduDelay`` since the +first TB PPDU are discarded and considered as interference. Mobility configuration ======================