wlanMACManagementConfig

Create WLAN MAC management frame-body configuration object

expand all in page

Description

The wlanMACManagementConfig is a WLAN medium access control (MAC) management frame-body configuration object. This object contains properties for configuring the fields and information elements (IEs) in a management frame body.

Creation

Syntax

config = wlanMACManagementConfig
config = wlanMACManagementConfig(Name,Value)

Description

example

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

example

config = wlanMACManagementConfig(Name,Value) sets properties of config using one or more Name,Value pair arguments. At run time, the calling function, wlanMACFrame, validates object settings for properties relevant to its operation.

Properties

expand all

Type of MAC management frame, specified as 'Beacon'.

Note

Currently you can only set this property to 'Beacon'.

Data Types: char | string

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

Data Types: double | uint64

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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
displayIEsDisplay list of IEs in MAC management frame

Examples

collapse all

Open Live Script

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}
Open Live Script

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}
Open Live Script

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™-2016 (Revision of IEEE Std 802.11-2012). “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 P802.11ax™/D4.1. “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 1: Enhancements for High Efficiency WLAN.” Draft 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™.

See Also

Functions

Objects

Topics

Introduced in R2019b

WLAN Toolbox Documentation

Support