wlanMultilinkDeviceConfig
Description
Use the wlanMultilinkDeviceConfig
object to set IEEE®
802.11be™ (Wi-Fi® 7) multilink device (MLD) configuration parameters.
Creation
Syntax
Description
creates a default WLAN MLD configuration object.multilinkDeviceCfg
= wlanMultilinkDeviceConfig
multilinkDeviceCfg = wlanMultilinkDeviceConfig(
sets the properties of the
WLAN MLD configuration object by using one or more optional name-value arguments. For
example, Name=Value
)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
EnhancedMultilinkMode
— Mode of enhanced MLO
"none"
(default) | "EMLSR"
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
EnhancedMultilinkTransitionDelay
— EMLSR transition delay in seconds
0
(default) | 16e-6
| 32e-6
| 64e-6
| 128e-6
| 256e-6
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"
.
EnhancedMultilinkPaddingDelay
— EMLSR padding delay in seconds
0
(default) | 32e-6
| 64e-6
| 128e-6
| 256e-6
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"
.
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:
Create an 802.11be network consisting of an access point (AP) MLD and a station (STA) MLD.
Configure the AP MLD and STA MLD to operate in the 2.4 GHz, 5 GHz, and 6 GHz bands.
Associate the STA MLD with the AP MLD, and add full buffer downlink (DL) and uplink (UL) application traffic between them.
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 R2024aR2024b: Model EMLSR mode
You can now model the enhanced multilink single radio (EMLSR) mode of the multilink
operation. To use this feature, specify the EnhancedMultilinkMode
property as "EMLSR"
.
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)