diff --git a/CHANGES.md b/CHANGES.md index ef21c6a3d..7adc84c59 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -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 diff --git a/src/wifi/doc/source/wifi-design.rst b/src/wifi/doc/source/wifi-design.rst index a492e8fb3..33383c605 100644 --- a/src/wifi/doc/source/wifi-design.rst +++ b/src/wifi/doc/source/wifi-design.rst @@ -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``