Main Content

wlanMultilinkDeviceConfig

WLAN MLD configuration

Since R2024a

    Description

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

    Creation

    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. This property applies only when you specify the Mode property as "STA". For a demonstration of the EMLSR mode, see the 802.11be System-Level Simulation Using EMLSR Multilink Operation example.

    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. This property applies only when you 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. This property applies only when you 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

    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: [1x1 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: [1x1 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: [1x1 struct]
         MAC: [1x1 struct]
         PHY: [1x1 struct]
        Mesh: [1x1 struct]
    
    
    mldStationStats = statistics(mldStationNode)
    mldStationStats = struct with fields:
        Name: "STA"
          ID: 2
         App: [1x1 struct]
         MAC: [1x1 struct]
         PHY: [1x1 struct]
        Mesh: [1x1 struct]
    
    

    Version History

    Introduced in R2024a

    expand all