wlanMACManagementConfig
Configure WLAN MAC management frame
Description
The wlanMACManagementConfig
configures the fields and information elements
(IEs) in an IEEE®
802.11™ management frame body.
Creation
Properties
FrameType
— Type of MAC management frame
'Beacon'
(default)
Type of MAC management frame, specified as 'Beacon'
.
Note
Currently you can only set this property to 'Beacon'
.
Data Types: char
| string
Timestamp
— TSF timer value
0
(default) | integer in the interval [0, 264 – 1]
Timing synchronization function (TSF) timer value, specified as an integer in the interval [0, 264 – 1].
Data Types: double
| uint64
BeaconInterval
— Number of time units between two beacon transmissions
100
(default) | integer in the interval [0, 216 – 1]
Number of time units between two beacon transmissions, specified as a nonnegative integer in the interval [0, 216 – 1].
Note
A TU is equivalent to 1024 microseconds.
Data Types: double
ESSCapability
— ESS capability
true
or 1
(default) | false
or 0
Extended service set (ESS) capability, specified as a numeric or logical
1
(true
) or 0
(false
).
Setting this property to 1
(true
) sets the
IBSSCapability
property to 0
(false
). Setting the IBSSCapability
property to
1
(true
) sets this property to
0
(false
).
Data Types: logical
IBSSCapability
— IBSS capability
false
or 0
(default) | true
or 1
Independent basic service set (IBSS) capability, specified as a numeric or logical
1
(true
) or 0
(false
).
If you set the ESSCapability
property to 1
(true
), then you must set this
property to 0
(false
).
Data Types: logical
Privacy
— Privacy required for all data frames
false
or 0
(default) | true
or 1
Privacy required for all data frames, specified as a numeric or logical
1
(true
) or 0
(false
). To enable the privacy flag in the capability information
field, set this property to 1
(true
).
Data Types: logical
ShortPreamble
— Support short preamble
false
or 0
(default) | true
or 1
Support short preamble, specified as a logical value of 1
(true
) or 0
(false
). To
enable support for short preamble in the capability information field, set this property
to 1
(true
).
Data Types: logical
SpectrumManagement
— Spectrum management required
false
or 0
(default) | true
or 1
Spectrum management required, specified as a numeric or logical 1
(true
) or 0
(false
). To
enable the spectrum management flag in the capability information field, set this
property to 1
(true
). This flag indicates that
spectrum management is required for device operation
Data Types: logical
QoSSupport
— Support QoS
true
or 1
(default) | false
or 0
Support quality of service (QoS), specified as a numeric or logical
1
(true
) or 0
(false
). To enable QoS support in the capability information field,
set this property to 1
(true
).
Data Types: logical
APSDSupport
— Support APSD
false
or 0
(default) | true
or 1
Support automatic power save delivery (APSD), specified as a numeric or logical
1
(true
) or 0
(false
). To enable the APSD feature in the capability information
field, set this property to 1
(true
).
Data Types: logical
ShortSlotTimeUsed
— Use short slot time
false
or 0
(default) | true
or 1
Use short slot time, specified as a numeric or logical 1
(true
) or 0
(false
). To
enable the short slot time flag in the capability information field, set this property
to 1
(true
).
Data Types: logical
RadioMeasurement
— Enable radio measurement
false
or 0
(default) | true
or 1
Enable radio measurement, specified as a numeric or logical 1
(true
) or 0
(false
). To
enable the radio measurement flag in the capability information field, set this property
to 1
(true
). This flag indicates that radio
measurement is active.
Data Types: logical
DelayedBlockAckSupport
— Support delayed block ack
false
(default) | true
Support delayed block ack, specified as a numeric or logical 1
(true
) or 0
(false
). To
indicate delayed block ack support in the capability information field, set this
property to 1
(true
).
Data Types: logical
ImmediateBlockAckSupport
— Support immediate block ack
false
or 0
(default) | true
or 1
Support immediate block ack, specified as a numeric or logical 1
(true
) or 0
(false
). To
indicate immediate block ack support in the capability information field, set this
property to 1
(true
).
Data Types: logical
SSID
— Service set identifier
'default SSID'
(default) | string scalar | character vector
Service set identifier (name of the WLAN network), specified as a string scalar or a character vector with no more than 32 elements.
Data Types: char
| string
BasicRates
— Basic rates included in supported rates IE
{'6 Mbps' '12 Mbps' '24 Mbps'}
(default) | character array | string array | cell array
Basic rates included in supported rates information element (IE), specified as a
character array, string array, or cell array containing one or more of these values:
'1 Mbps'
, '2 Mbps'
, '5.5
Mbps'
, '6 Mbps'
, '9 Mbps'
,
'11 Mbps'
, '12 Mbps'
, '18
Mbps'
, '24 Mbps'
, '36 Mbps'
,
'48 Mbps'
, or '54 Mbps'
.
The combined number of unique rate values in the BasicRates
and
AdditionalRates
properties must be an integer in the interval [1,
8].
Data Types: char
| string
| cell
AdditionalRates
— Additional rates included in supported rates IE
{}
(default) | character array | string array | cell array
Additional rates included in supported rates IE, specified as a character array,
string array, or cell array containing one or more of these values: '1
Mbps'
, '2 Mbps'
, '5.5 Mbps'
,
'6 Mbps'
, '9 Mbps'
, '11
Mbps'
, '12 Mbps'
, '18 Mbps'
,
'24 Mbps'
, '36 Mbps'
, '48
Mbps'
, or '54 Mbps'
.
The combined number of unique rate values in the BasicRates
and AdditionalRates
properties must be an integer in the interval
[1, 8].
Data Types: char
| string
| cell
InformationElements
— IEs added using addIE
object function
cell array
This property is read-only.
IEs added using the addIE
object
function, specified as a cell array. Each row in the cell array represents an IE. Each
IE holds an element ID and information. For element with ID 255, the IE also holds an
optional element ID extension. These IEs are carried in the management frame body in
addition to any IEs included in the configuration properties.
You can change this property by using the addIE
object
function and display IEs by using the displayIEs
object function. If
you add an IE that is already specified as a configuration property of this object, the
value listed in this property takes precedence.
Data Types: cell
Object Functions
addIE | Update MAC management frame with IE |
displayIEs | Display list of IEs in MAC management frame |
Examples
Create Default WLAN MAC Management Frame-Body Configuration Object
Create a WLAN MAC management frame-body configuration object with default property values.
config = wlanMACManagementConfig;
Display the resulting object.
disp(config);
wlanMACManagementConfig with properties: FrameType: 'Beacon' Timestamp: 0 BeaconInterval: 100 ESSCapability: 1 IBSSCapability: 0 Privacy: 0 ShortPreamble: 0 SpectrumManagement: 0 QoSSupport: 1 ShortSlotTimeUsed: 0 APSDSupport: 0 RadioMeasurement: 0 DelayedBlockAckSupport: 0 ImmediateBlockAckSupport: 0 SSID: 'default SSID' BasicRates: {'6 Mbps' '12 Mbps' '24 Mbps'} AdditionalRates: {} Read-only properties: InformationElements: {511x2 cell}
Create MAC Management Frame-Body Configuration Object with SSID and Beacon Interval
Create a MAC management frame-body configuration object for a beacon frame, setting the service set identifier (SSID) to 'demo ssid'
and the beacon interval to 100 TUs (1 TU = 1024 microsecond). Display the properties of the object.
config = wlanMACManagementConfig('SSID','demo ssid','BeaconInterval',100); disp(config)
wlanMACManagementConfig with properties: FrameType: 'Beacon' Timestamp: 0 BeaconInterval: 100 ESSCapability: 1 IBSSCapability: 0 Privacy: 0 ShortPreamble: 0 SpectrumManagement: 0 QoSSupport: 1 ShortSlotTimeUsed: 0 APSDSupport: 0 RadioMeasurement: 0 DelayedBlockAckSupport: 0 ImmediateBlockAckSupport: 0 SSID: 'demo ssid' BasicRates: {'6 Mbps' '12 Mbps' '24 Mbps'} AdditionalRates: {} Read-only properties: InformationElements: {511x2 cell}
Add Information Element to WLAN MAC Management Frame-Body Configuration Object
Add the DSSS Parameter Set information element to a WLAN MAC management frame-body configuration object by using the addIE
object function. The element ID for this information element is 3
. The information is '0b'
, representing the current channel (11) in hexadecimal format.
config = wlanMACManagementConfig('FrameType','Beacon'); id = 3; information = '0b'
information = '0b'
config = addIE(config,id,information);
Display the information elements of the frame-body configuration object by using the displayIEs
object function.
displayIEs(config)
Element ID: 0, Information: 0x64656661756C742053534944 Element ID: 1, Information: 0x8C98B0 Element ID: 3, Information: 0x0B
References
[1] IEEE Std 802.11-2020 (Revision of IEEE Std 802.11-2016). “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications.” IEEE Standard for Information Technology — Telecommunications and Information Exchange between Systems — Local and Metropolitan Area Networks — Specific Requirements.
[2] IEEE Std 802.11ax™-2021 (Amendment to IEEE Std 802.11-2020). “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 1: Enhancements for High Efficiency WLAN.” IEEE Standard for Information Technology — Telecommunications and Information Exchange between Systems. Local and Metropolitan Area Networks — Specific Requirements.
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Version History
Introduced in R2019b
See Also
Functions
Objects
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
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)