wlanLinkConfig
Description
Use the wlanLinkConfig
object to set the link configuration of an
IEEE®
802.11be™ (Wi-Fi® 7) multilink device (MLD).
Creation
Description
creates a
default link configuration object for a WLAN MLD.mldLinkCfg
= wlanLinkConfig
mldLinkCfg = wlanLinkConfig(
sets
the properties of the
link configuration object by using one or more optional name-value arguments. For example,
Name=Value
)TransmissionFormat="VHT"
sets the physical layer (PHY) transmission
format to very high throughput (VHT).
Properties
BandAndChannel
— Operating frequency band and channel number
[5, 36]
(default) | N-by-2 matrix
Operating frequency band and channel number, specified as an
N-by-2 matrix. N specifies the number of
wlanLinkConfig
objects, and must be greater than or equal to 1. The
first value in each row is the operating frequency band, specified as 2.4, 5, or 6. The
second value in each row is the channel number, specified according to the constraints
in this table.
Operating Frequency Band | Channel Number |
---|---|
2.4 | Integer in the range [1, 14] |
5 | Integer in the range [1, 200] |
6 | Integer in the range [1, 233] |
When creating a wlanLinkConfig
object, configure multiple links
simultaneously by setting this property as a name-value argument. Once you create the
object, you can configure a single wlanLinkConfig
object at a time by
setting this property.
Data Types: double
TransmissionFormat
— PHY transmission format for unicast data frame
"EHT-SU"
(default) | "Non-HT"
| "HT-Mixed"
| "VHT"
| "HE-SU"
| "HE-EXT-SU"
PHY transmission format for unicast data frame, specified as
"Non-HT"
, "HT-Mixed"
, "VHT"
,
"HE-SU"
, "HE-EXT-SU"
, or
"EHT-SU"
. To set this property to "EHT-SU"
, you
must set the MACFrameAbstraction
property of the
object associated with the MLD
configured by the wlanNode
wlanLinkConfig
object to true
.
Note that the broadcast data frame transmissions always use the
"Non-HT"
PHY transmission format, regardless of the value of this
property.
Data Types: char
| string
ChannelBandwidth
— Channel bandwidth in Hz
20e6
(default) | 40e6
| 80e6
| 160e6
| 320e6
Channel bandwidth in Hz, specified as 20e6
,
40e6
, 80e6
, 160e6
, or
320e6
. The possible values for this property depend on the
BandAndChannel
and TransmissionFormat
properties.
If you set the first entry of the
BandAndChannel
to2.4
, this property supports20e6
Hz and40e6
Hz.If you set the
property toTransmissionFormat
"Non-HT"
or"HE-EXT-SU"
, this property supports only20e6
Hz.If you set the
TransmissionFormat
property to"HT-Mixed"
, this property supports20e6
Hz and40e6
Hz.If you set the
TransmissionFormat
property to"VHT"
or"HE-SU"
this property supports20e6
Hz,40e6
Hz,80e6
Hz, and160e6
Hz.If you set the
TransmissionFormat
property to"EHT-SU"
, this property supports all channel bandwidths.Note
Links operating on the same center frequency must specify an identical value to this property.
Data Types: double
MCS
— Modulation and coding scheme
0
(default) | integer in range [0, 13]
Modulation and coding scheme (MCS), specified as an integer in the range [0, 13].
For unicast data frame transmissions, the set of values that this property can take
depends on the TransmissionFormat
property.
When
TransmissionFormat
is"Non-HT"
or"HT-Mixed"
, the range of values is [0, 7]. WhenTransmissionFormat
is"HT-Mixed"
, the given value in the range [0, 7] maps to a value in the range [0, 31] using the calculation MCS + (NSTS – 1) × 8, where NSTS is the value of theNumSpaceTimeStreams
property.When
TransmissionFormat
is"VHT"
, the range of values is [0, 9]. The set of possible values additionally depends on theChannelBandwidth
andNumSpaceTimeStreams
properties.When
ChannelBandwidth
is20e6
, you can set theMCS
value to9
only whenNumSpaceTimeStreams
is set to3
or6
.When
ChannelBandwidth
is80e6
, theMCS
value6
is not supported when you set theNumSpaceTimeStreams
property to3
or7
. TheMCS
value9
is not supported when you set theNumSpaceTimeStreams
property to6
.When
ChannelBandwidth
is160e6
, theMCS
value9
is not supported whenNumSpaceTimeStreams
is set to3
.
When
TransmissionFormat
is"HE-EXT-SU"
, the range of values is [0, 2].When
TransmissionFormat
is"HE-SU"
the range of values is [0, 11].When
TransmissionFormat
is"EHT-SU"
, the range of values is [0, 13].
Note that the MCS value for broadcast data frame transmissions is always
0
, regardless of the value set for this property.
Data Types: double
NumTransmitAntennas
— Number of transmit antennas
1
(default) | integer in range [1, 8]
Number of transmit antennas, specified as an integer in the range [1, 8]. The link uses the same number of antennas for reception.
If you specify the EnhancedMultilinkMode
property of the corresponding wlanMultilinkDeviceConfig
object as "EMLSR"
, the link
also uses this number of antennas to listen for an initial control frame (ICF). When the
link is active, it aggregates the NumTransmitAntennas
values of all the links in the wlanMultilinkDeviceConfig
object and
uses this value for transmission and reception. The aggregate must be less than or equal
to eight. An EMLSR link at a STA is active when it initiates a frame exchange sequence
with an AP MLD or responds to an ICF to continue a frame exchange sequence initiated by
an AP MLD. (since R2024b)
Note
All the links operating in simultaneous transmit and receive (STR) mode in the network must have the same value for this property.
If an EMLSR STA has i links with
NumTransmitAntennas
values of N1, …, Ni, its associated AP must have aNumTransmitAntennas
value of N1 + ⋯ + Ni for each link.
Data Types: double
NumSpaceTimeStreams
— Number of space-time streams
1
(default) | integer in range [1, 8]
Number of space-time streams, specified as an integer in the range [1, 8]. The value
of this property must be less than or equal to the value of the NumTransmitAntennas
property. If you set this value as less than the
NumTransmitAntennas
value, the node uses Fourier spatial mapping
to transmit unicast data frames. This property is applicable only for transmitting
unicast data frames. The number of space-time streams for broadcast data frame
transmissions is always 1
, regardless of the value of this
property.
If you specify the EnhancedMultilinkMode
property of the corresponding wlanMultilinkDeviceConfig
object as "EMLSR"
, when the
link is active, it aggregates the NumSpaceTimeStreams
values of all the links in the wlanMultilinkDeviceConfig
object and
uses this value for data frame transmission. (since R2024b)
Data Types: double
AggregateHTMPDU
— HT MPDU aggregation selection
true
or 1
(default) | false
or 0
High throughput (HT) MAC protocol data unit (MPDU) aggregation selection, specified
as a logical 1
(true
) or 0
(false
). To create an aggregated MPDU (A-MPDU) by concatenating
multiple MPDUs, set this property to true
.
Dependencies
To enable this property, set the
property to
TransmissionFormat
"HT-Mixed"
.
Data Types: logical
MPDUAggregationLimit
— Maximum number of MPDUs in A-MPDU
64
(default) | integer in range [1, 1024]
Maximum number of MPDUs in an A-MPDU, specified as an integer in the range [1,
1024]. The set of values that this property can take depends on the
property:TransmissionFormat
When
TransmissionFormat
is"HT-Mixed"
and theAggregateHTMPDU
property istrue
, the range of values is [1, 64].When
TransmissionFormat
is"VHT"
, the range of values is [1, 64].When
TransmissionFormat
is"HE-SU"
or"HE-EXT-SU"
, the range of values is [1, 256].When
TransmissionFormat
is"EHT-SU"
, the range of values is [1, 1024].
This property does not apply when TransmissionFormat
is
"Non-HT"
, or when TransmissionFormat
is
"HT-Mixed"
and AggregateHTMPDU
is
false
.
Note
All MLDs in the network must have the same value for this property.
Data Types: double
RTSThreshold
— Threshold for RTS transmission
0
(default) | integer in the range [0, 6500631]
Threshold for RTS transmission, specified as an integer in the range [0, 6500631]. If the size of a MAC frame exceeds the value of this property, the node uses the request to send/clear to send (RTS/CTS) mechanism.
Dependencies
To enable this property, set the
property to DisableRTS
false
.
Data Types: double
DisableRTS
— RTS/CTS mechanism selection
false
or 0
(default) | true
or 1
RTS/CTS mechanism selection, specified as a logical 0
(false
) or 1
(true
). To
disable the RTS/CTS mechanism in the simulation, set this property to
1
or true
.
This property does not apply to multi-user request to send (MU-RTS) ICF transmissions from an AP to an EMLSR STA.
Data Types: logical
DisableACK
— Disable acknowledgements selection
false
or 0
(default) | true
or 1
Disable acknowledgements selection, specified as a logical 0
(false
) or 1
(true
). To
disable the transmission of acknowledgements in response to data frames, set this
property to 1
or true
.
Data Types: logical
CWMin
— Minimum range of contention window for access categories
[15 15 7 3]
(default) | four-element vector of integers in range [1, 1023]
Minimum range of the contention window for the four access categories (ACs), specified as a four-element vector of integers in the range [1, 1023]. The four entries are the minimum ranges, in slots, for the Best Effort, Background, Video, and Voice ACs, respectively.
CWMax
— Maximum range of contention window for access categories
[1023 1023 15 7]
(default) | four-element vector of integers in the range [1, 1023]
Maximum range of the contention window for the four ACs, specified as a four-element vector of integers in the range [1, 1023]. The four entries are the maximum ranges, in slots, for the Best Effort, Background, Video, and Voice ACs, respectively.
AIFS
— Arbitrary interframe space values for access categories
[3 7 2 2]
(default) | four-element vector of integers in the range [1, 15]
Arbitrary interframe space values for the four ACs, specified as a four-element vector of integers in the range [1, 15]. The entries of the vector represent the AIFS values, in slots, for the Best Effort, Background, Video, and Voice ACs, respectively.
If the
Mode
property of thewlanMultilinkDeviceConfig
object is"AP"
, each element of this vector must be in the range [1, 15].If the
Mode
property of thewlanMultilinkDeviceConfig
object is"STA"
, each element of this vector must be in the range [2, 15].
TXOPLimit
— Transmission opportunity duration limit
[0 0 0 0]
(default) | vector of four integers in the range [0, 1023]
Transmission opportunity (TXOP) duration limit, specified as a vector of four
integers in the range [0, 1023]. The four integers are the TXOP limit values for the
Best Effort, Background, Video, and Voice ACs, respectively. The limits are in units of
32 microseconds. If you specify a vector element as 0
, the object
disables multiple frame transmissions within a TXOP for the AC that corresponds to that
element.
Note
The value of this property must be [0 0 0 0]
in these cases:
You specify the
TransmissionFormat
property as"Non-HT"
.You specify the
TransmissionFormat
property as"HT-Mixed"
and theAggregateHTMPDU
property asfalse
.
Use6MbpsForControlFrames
— Control frames rate of 6 Mb/s
false
or 0
(default) | true
or 1
Control frames rate of 6 Mb/s, specified as a logical 0
(false
) or 1
(true
). To use a
data rate of 6 Mb/s for control frames, set this property to 1
or
true
.
Data Types: logical
BasicRates
— Non-HT data rates supported in basic service set
[6 12 24]
(default) | vector which is a subset of [6 9 12 18 24 36 48 54]
Non-HT data rates supported in the basic service set (BSS), specified as a vector
that is a subset of these values: [6 9 12 18 24 36 48 54]
. The
mandatory data rates are 6
, 12
, and
24
. The stations associated with an AP use the same basic rates as
the AP.
Dependencies
To enable this property, set the Mode
property of the wlanMultilinkDeviceConfig
object to "AP"
.
Data Types: double
TransmitPower
— Transmit power in dBm
10
(default) | real scalar
Transmit power in dBm, specified as a real scalar.
Data Types: double
TransmitGain
— Transmit gain in dB
0
(default) | real scalar
Transmit gain in dB, specified as a real scalar.
Data Types: double
ReceiveGain
— Receive gain in dB
0
(default) | real scalar
Receive gain in dB, specified as a real scalar.
Data Types: double
NoiseFigure
— Receiver noise figure in dB
7
(default) | nonnegative scalar
Receiver noise figure in dB, specified as a nonnegative scalar.
Data Types: double
BeaconInterval
— Beacon interval in time units (TUs)
Inf
(default) | integer in range [1, 254]
Beacon interval in TU, specified as an integer in the range [1, 254]. A TU is a
measurement of time equal to 1024 microseconds. At the end of each beacon interval, the
beacon frames contend for medium access by using the voice access category. The MAC
internally sets the service set identifier (SSID) in a beacon frame to
"WLAN"
. To differentiate beacons of different APs in a packet
analyzer tool, such as Wireshark, use the MAC address of the AP transmitting the beacon.
Dependencies
To enable this property, set the Mode
property of the wlanMultilinkDeviceConfig
object to "AP"
.
Data Types: double
InitialBeaconOffset
— Time offset specified for first beacon transmission in TUs
[0, BeaconInterval
]
| []
| nonnegative integer | nonnegative vector of form [MinTimeOffset
MaxTimeOffset]
BeaconInterval
]Time offset specified for the first beacon transmission in TUs, specified as a nonnegative integer or a nonnegative vector of form [MinTimeOffset MaxTimeOffset]. A TU is a measurement of time equal to 1024 microseconds.
If you specify this value as a scalar, this object assigns this value to the initial time offset.
If you specify this value as a vector, this object assigns a random initial time offset between MinTimeOffset and MaxTimeOffset. MinTimeOffset must be less than MaxTimeOffset.
Each element of this property must be an integer in the range [0, 254].
If you enable beacon transmission, the default value is [0,
. Otherwise, the default property is
an empty array (BeaconInterval
][]
).
Dependencies
To enable this property, set the Mode
property of the wlanMultilinkDeviceConfig
object to "AP"
and the
BeaconInterval
property of the wlanLinkConfig
object to
a finite value.
Data Types: double
ChannelFrequency
— Channel center frequency in Hz
numeric scalar
This property is read-only.
Channel center frequency in Hz, specified as a numeric scalar. This value specifies
the operating center frequency of the link corresponding to the value that you set using
the BandAndChannel
property.
Data Types: double
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: Transmit multiple data frames within a TXOP
You can now transmit multiple data frames within a single transmission opportunity
(TXOP). To use this feature, specify the TXOPLimit
property as a vector with at least one nonzero element.
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)