wlanMACManagementConfig

Configure WLAN MAC management frame

Since R2019b

Description

The wlanMACManagementConfig configures the fields and information elements (IEs) in an IEEE^® 802.11™ management frame body.

Creation

Syntax

config = wlanMACManagementConfig

config = wlanMACManagementConfig(Name,Value)

Description

config = wlanMACManagementConfig creates a WLAN MAC management frame-body configuration object with default property values.

config = wlanMACManagementConfig(Name,Value) sets properties using one or more name-value pair arguments.

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, 2⁶⁴ – 1]

Timing synchronization function (TSF) timer value, specified as an integer in the interval [0, 2⁶⁴ – 1].

Data Types: double | uint64

BeaconInterval — Number of time units between two beacon transmissions

100 (default) | integer in the interval [0, 2¹⁶ – 1]

Number of time units between two beacon transmissions, specified as a nonnegative integer in the interval [0, 2¹⁶ – 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