F5/unison
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

wifi: Update model documentation

Browse Source
This commit is contained in:
Stefano Avallone
2024-11-06 22:26:14 +01:00
parent 5f52b08c3e
commit 6e6cbd1a88
2 changed files with 12 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
CHANGES.md
View File

@@ -17,6 +17,7 @@ This file is a best-effort approach to solving this issue; we will do our best b
### New API
* (network) Added a function to detect IPv4 APIPA addresses (169.254.0.0/16).
* (wifi) Added a new `AssocType` attribute to `StaWifiMac` to configure the type of association performed by a device, provided that it is supported by the standard configured for the device. By using this attribute, it is possible for an EHT single-link device to perform ML setup with an AP MLD and for an EHT multi-link device to perform legacy association with an AP MLD.
### Changes to existing API

18
src/wifi/doc/source/wifi-design.rst
View File

@@ -803,9 +803,12 @@ Infrastructure association
Association in infrastructure mode is a high-level MAC function performed by
the Association Manager, which is implemented through a base class (``WifiAssocManager``)
and a default subclass (``WifiDefaultAssocManager``). The interaction between
the station MAC, the Association Manager base class and subclass is illustrated
in Figure :ref:`fig-assoc-manager`.
and a default subclass (``WifiDefaultAssocManager``), and controlled by the ``AssocType``
attribute of the ``StaWifiMac`` class. This attribute controls whether the non-AP STA/MLD
performs a legacy association or an ML setup with the AP device (the latter is only available for
EHT devices associating with a multi-link AP; if this option is selected when this condition is not
met, it falls back to legacy association automatically). The interaction between the station MAC,
the Association Manager base class and subclass is illustrated in Figure :ref:`fig-assoc-manager`.
.. _fig-assoc-manager:
@@ -1165,11 +1168,12 @@ MLD. Given that frame exchanges can occur on any of the EMLSR links, the link on
Enabling/disabling EMLSR mode
-----------------------------
EMLSR mode can be enabled on the links (at least two) of a non-AP MLD that supports the EMLSR
EMLSR mode can be enabled on the link(s) of a non-AP EHT device that supports the EMLSR
operating mode and performs ML setup with an AP MLD that supports the EMLSR operating mode. The
``EmlsrActivated`` attribute of the EHT configuration of an MLD determines whether the EMLSR
operating mode is supported by the MLD. When the ``EmlsrActivated`` attribute is set to true for
a non-AP MLD, the WifiMacHelper will install an EMLSR Manager by using the type and attribute
``EmlsrActivated`` attribute of the EHT configuration of an EHT device determines whether the EMLSR
operating mode is supported by the device. When the ``EmlsrActivated`` attribute is set to true for
a non-AP EHT device and the ``ns3::StaWifiMac::AssocType`` attribute is set to ``ML_SETUP``, the
WifiMacHelper will install an EMLSR Manager by using the type and attribute
values configured through the ``SetEmlsrManager`` method.
EMLSR mode on the links of a non-AP MLD can be enabled or disabled by using the ``EmlsrLinkSet``