This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

wlanMACManagementConfig

Create WLAN MAC management frame-body configuration object

Syntax

config = wlanMACManagementConfig
config = wlanMACManagementConfig(Name,Value)

Description

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

example

config = wlanMACManagementConfig(Name,Value) sets properties of the WLAN MAC management frame-body configuration object using one or more Name,Value pair arguments. At runtime, the calling function, wlanMACFrame, validates object settings for properties relevant to the operation of that function.

Examples

collapse all

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 a MAC management frame-body configuration object for a beacon frame. Set the SSID to 'demo ssid' and the beacon interval to 100 TUs (1 TU = 1024 microsecond). Display the properties of the object.

mgmtConfig = wlanMACManagementConfig('SSID','demo ssid','BeaconInterval',100);
disp(mgmtConfig);
  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 the information element 'DSSS Parameter Set' to a WLAN MAC management frame-body configuration object using the addIE object function. The element ID for 'DSSS Parameter Set' is 3. The information is '0b', representing the current channel (11) in hexadecimal format.

config = wlanMACManagementConfig('FrameType','Beacon');
config = addIE(config,3,'0b');

Display the information elements of the frame-body configuration object using the displayIEs object function.

displayIEs(config); 
Element ID: 0, Information: 0x64656661756C742053534944
Element ID: 1, Information: 0x8C98B0
Element ID: 3, Information: 0x0B

Input Arguments

collapse all

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Timestamp',2,'ESSCapability',false

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

Note

Currently FrameType accepts only the value 'Beacon'.

Data Types: char | string

Timing synchronization function (TSF) timer value, specified as a nonnegative 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 range [0, 216 – 1] in time units (TUs).

Note

1 TU = 1024 microseconds

Data Types: double

Extended service set (ESS) capability, specified as a logical value. Setting this property to true sets IBSSCapability to false.

Dependencies

If IBSSCapability is set to true, then this property is set to false.

Data Types: logical

Independent basic service set (IBSS) capability, specified as a logical value.

Dependencies

If ESSCapability is set to true, then you must specify this property as false.

Data Types: logical

Privacy required for all data frames, specified as a logical value. Set Privacy to true to enable the privacy flag in the capability information field.

Data Types: logical

Support short preamble, specified as a logical value. Set ShortPreamble to true to enable support for short preamble in the capability information field.

Data Types: logical

Spectrum management required, specified as a logical value. Set SpectrumManagement to true to enable the spectrum management flag in the capability information field and to indicate that spectrum management is required for device operation.

Data Types: logical

Support quality of service (QoS), specified as a logical value. Set QoSSupport to true to enable QoS support in the Capability information field.

Data Types: logical

Support automatic power save delivery (APSD), specified as a logical value. Set APSDSupport to true to enable the APSD feature in the capability information field.

Data Types: logical

Short slot time is in use, specified as a logical value. Set ShortSlotTimeUsed to true to enable the short slot time flag in the capability information field.

Data Types: logical

Enable radio measurement, specified as a logical value. Set RadioMeasurement to true to enable the radio measurement flag in the capability information field. This flag indicates that radio measurement is active.

Data Types: logical

Support delayed Block ACK, specified as a logical value. Set DelayedBlockAckSupport to true to indicate delayed Block ACK support in the capability information field.

Data Types: logical

Support immediate Block ACK, specified as a logical value. Set ImmediateBlockAckSupport to true to indicate immediate Block ACK support in the capability information field.

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 rate 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 BasicRates and AdditionalRates must be an integer in the interval [1, 8].

Data Types: char | string | 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 BasicRates and AdditionalRates must be an integer in the interval [1, 8].

Data Types: char | string | cell

IEs added using addIE method, 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 using addIE and display IEs you add using displayIEs. If an IE is added using the addIE method and is specified as a configuration property, preference is given to the value assigned by the former.

Data Types: cell

Output Arguments

collapse all

MAC management frame-body configuration, returned as a wlanMACManagementConfig object. The properties of config are described in wlanMACManagementConfig Properties.

References

[1] 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. URL: https://ieeexplore.ieee.org/document/7786995/

[2] IEEE P802.11ax™/D3.1. “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 6: 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™.

Introduced in R2018b