wlanMultilinkDeviceConfig

WLAN MLD configuration

Since R2024a

expand all in page

    Description

    Use the wlanMultilinkDeviceConfig object to set IEEE® 802.11be™ (Wi-Fi® 7) multilink device (MLD) configuration parameters.

    Creation

    Syntax

    multilinkDeviceCfg = wlanMultilinkDeviceConfig
    multilinkDeviceCfg = wlanMultilinkDeviceConfig(Name=Value)

    Description

    multilinkDeviceCfg = wlanMultilinkDeviceConfig creates a default WLAN MLD configuration object.

    multilinkDeviceCfg = wlanMultilinkDeviceConfig(Name=Value) sets the properties of the WLAN MLD configuration object by using one or more optional name-value arguments. For example, Mode="AP" sets the operating mode of the WLAN MLD to access point (AP).

    example

    Properties

    expand all

    Operating mode of MLD, specified as "STA" or "AP".

    Data Types: char | string

    Maximum number of transmission attempts for a frame, specified as an integer in the range [1, 65535].

    Data Types: double

    Since R2024b

    Mode of enhanced MLO, specified as "none" or "EMLSR". Specify this property as "EMLSR" to enable the enhanced multilink single radio (EMLSR) mode for this MLD. For a demonstration of the EMLSR mode, see the 802.11be System-Level Simulation Using EMLSR Multilink Operation example.

    Dependencies

    To enable this property, specify the Mode property as "STA". Additionally, if you specify this property as "EMLSR", the PHYAbstractionMethod property of the wlanNode object must be set to "tgax-evaluation-methodology" or "tgax-mac-calibration".

    Data Types: char | string

    Since R2024b

    EMLSR transition delay in seconds, specified as 0, 16e-6, 32e-6, 64e-6, 128e-6, or 256e-6. This value is the time that the EMLSR STA takes to switch from exchanging frames on one of the EMLSR links to listening on all of the enabled EMLSR links.

    Dependencies

    To enable this property, specify the Mode property as "STA" and the EnhancedMultilinkMode property as "EMLSR".

    Since R2024b

    EMLSR padding delay in seconds, specified as 0, 32e-6, 64e-6, 128e-6, or 256e-6. This value is the minimum required duration of the MAC padding that the AP MLD adds to initial control frames it sends to an EMLSR STA. The EMLSR STA conveys this value to the associated AP MLD.

    Dependencies

    To enable this property, specify the Mode property as "STA" and the EnhancedMultilinkMode property as "EMLSR".

    This property is read-only.

    Link configuration of the MLD, specified as a wlanLinkConfig object or a vector of wlanLinkConfig objects.

    Note

    To set this property, you must specify it at object creation.

    Examples

    collapse all

    This example uses:

    Open Live Script

    Simulate an IEEE 802.11b (Wi-Fi 7) multilink operation (MLO) in the 2.4 GHz, 5 GHz, and 6 GHz bands.

    Using this example, you can:

    1. Create an 802.11be network consisting of an access point (AP) MLD and a station (STA) MLD.

    2. Configure the AP MLD and STA MLD to operate in the 2.4 GHz, 5 GHz, and 6 GHz bands.

    3. Associate the STA MLD with the AP MLD, and add full buffer downlink (DL) and uplink (UL) application traffic between them.

    4. Simulate the network and get the statistics.

    The example creates, configures, and simulates this scenario.

    DL and UL full buffer traffic scenario between AP MLD and STA MLD across 2.4 GHz, 5 GHz, and 6 GHz bands.

    Check if the Communications Toolbox™ Wireless Network Simulation Library support package is installed. If the support package is not installed, MATLAB® returns an error with a link to download and install the support package.

    wirelessnetworkSupportPackageCheck

    Specify the simulation time in seconds. Initialize the wireless network simulator

    simulationTime = 1;
networkSimulator = wirelessNetworkSimulator.init;

    Create an MLD link configuration object, specifying the operating frequency bands as 2.4 GHz, 5 GHz and 6 GHz.

    mldLinkCfg = wlanLinkConfig(BandAndChannel=[2.4 6; 5 36; 6 1]);

    Create a WLAN node with an AP MLD configuration.

    mldAccessPointCfg = wlanMultilinkDeviceConfig(Mode="AP",LinkConfig=mldLinkCfg);
mldAccessPointNode = wlanNode(Name="AP",DeviceConfig=mldAccessPointCfg)
    mldAccessPointNode = 
  wlanNode with properties:

                    Name: "AP"
                Position: [0 0 0]

   Read-only properties:
     MACFrameAbstraction: 1
    PHYAbstractionMethod: "tgax-evaluation-methodology"
            DeviceConfig: [1×1 wlanMultilinkDeviceConfig]
                      ID: 1

    Create a WLAN node with an STA MLD configuration.

    mldStationCfg = wlanMultilinkDeviceConfig(Mode="STA",LinkConfig=mldLinkCfg);
mldStationNode = wlanNode(Name="STA",DeviceConfig=mldStationCfg)
    mldStationNode = 
  wlanNode with properties:

                    Name: "STA"
                Position: [0 0 0]

   Read-only properties:
     MACFrameAbstraction: 1
    PHYAbstractionMethod: "tgax-evaluation-methodology"
            DeviceConfig: [1×1 wlanMultilinkDeviceConfig]
                      ID: 2

    Associate the STA MLD with the AP MLD, and add full buffer DL and UL application traffic between them.

    associateStations(mldAccessPointNode,mldStationNode,FullBufferTraffic="on")

    Add the nodes to the wireless network simulator.

    addNodes(networkSimulator,[mldAccessPointNode mldStationNode])

    Run the network simulation for the specified simulation time.

    run(networkSimulator,simulationTime)

    Retrieve and display statistics of the AP MLD and STA MLD. For more information about the MLO statistics, see WLAN System-Level Simulation Statistics.

    mldAccessPointStats = statistics(mldAccessPointNode)
    mldAccessPointStats = struct with fields:
    Name: "AP"
      ID: 1
     App: [1×1 struct]
     MAC: [1×1 struct]
     PHY: [1×1 struct]
    Mesh: [1×1 struct]


    mldStationStats = statistics(mldStationNode)
    mldStationStats = struct with fields:
    Name: "STA"
      ID: 2
     App: [1×1 struct]
     MAC: [1×1 struct]
     PHY: [1×1 struct]
    Mesh: [1×1 struct]

    Version History

    Introduced in R2024a

    expand all

    See Also

    Objects

    Topics