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

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).

Properties

Mode — Operating mode of MLD

"STA" (default) | "AP"

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

Data Types: char | string

ShortRetryLimit — Maximum number of transmission attempts for frame

7 (default) | integer in range [1, 65535]

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

Data Types: double

LinkConfig — Link configuration of MLD

wlanLinkConfig (default) | wlanLinkConfig object | vector of wlanLinkConfig objects

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

Simulate MLO in 802.11be Network

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.

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