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.

wlanMACFrameConfig

Create WLAN MAC frame configuration object

Syntax

config = wlanMACFrameConfig
config = wlanMACFrameConfig(Name,Value)

Description

example

config = wlanMACFrameConfig creates a WLAN medium access control (MAC) frame configuration object, config, with default property values. This object initializes properties for an IEEE® 802.11™ MAC frame.

example

config = wlanMACFrameConfig(Name,Value) sets properties of the WLAN MAC frame configuration object using one or more Name,Value pair arguments.

At run time, the calling function, wlanMACFrame, validates object settings for properties relevant to the operation of that function.

Examples

collapse all

Create a wlanMACFrameConfig object for a request to send (RTS) frame and display the properties of the object.

cfgMAC = wlanMACFrameConfig;
cfgMAC.FrameType = 'RTS';
disp(cfgMAC)
  wlanMACFrameConfig with properties:

          FrameType: 'RTS'
    PowerManagement: 0
           MoreData: 0
           Duration: 0
           Address1: 'FFFFFFFFFFFF'
           Address2: '00123456789B'

Create a wlanMACFrameConfig object for a Quality of Service (QoS) data frame. Disable acknowledgement and enable power-saving mode.

cfgMAC = wlanMACFrameConfig('FrameType','QoS Data','AckPolicy','No Ack','PowerManagement',true);

Specify the frame sequence number and traffic identifier. Display the properties of the configuration object.

cfgMAC.SequenceNumber = 5;
cfgMAC.TID            = 7;
disp(cfgMAC);
  wlanMACFrameConfig with properties:

          FrameType: 'QoS Data'
        FrameFormat: 'Non-HT'
               ToDS: 0
             FromDS: 1
     Retransmission: 0
    PowerManagement: 1
           MoreData: 0
           Duration: 0
           Address1: 'FFFFFFFFFFFF'
           Address2: '00123456789B'
           Address3: '00123456789B'
     SequenceNumber: 5
                TID: 7
          AckPolicy: 'No Ack'
    MSDUAggregation: 0

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: wlanMACFrameConfig('FrameType','RTS','MoreData',true)

Type of MAC frame, specified as one of these values: 'Beacon', 'RTS', 'CTS', 'ACK', 'Block Ack', 'Data', 'Null', 'QoS Data', or 'QoS Null'.

Data Types: char | string

Format of the MAC frame, specified as 'Non-HT', 'HT-Mixed', 'VHT', 'HE-SU', or 'HE-EXT-SU'.

Dependencies

To enable this property, set FrameType to 'QoS Data' or 'QoS Null'. The 'VHT', 'HE-SU', and 'HE-EXT-SU' values apply only when FrameType is 'QoS Data'.

Data Types: char | string

Frame is directed to a distributed system (DS), specified as a logical value. Setting ToDS to true indicates that the frame is directed from a non-AP station to a DS.

Data Types: logical

Frame is exiting a DS, specified as a logical value. Setting FromDS to true indicates that the frame is directed from a DS to a non-AP station.

Data Types: logical

Retransmitted frame, specified as a logical value. Setting Retransmission to true indicates that the frame is a retransmission.

Data Types: logical

Power management mode, specified as a logical value. Setting PowerManagement to true indicates that the sender is in power-saving mode.

Data Types: logical

More data indication, specified as a logical value. Setting MoreData to true indicates that the sender has more frames to send.

Data Types: logical

Frame includes the high throughput (HT) control field, specified as a logical value. Setting HTControlPresent to true indicates that the HT control field is included in the MAC header.

Data Types: logical

Amount of time, in microseconds, for which the channel is reserved after the current frame transmission ends. Specify Duration as a nonnegative integer in the interval [0, 215 – 1].

Data Types: double

Receiver address, specified as a 12-element character vector or a string scalar representing a 6-octet hexadecimal value. The default value 'FFFFFFFFFFFF' is a broadcast address.

Data Types: char | string

Transmitter address, specified as a 12-element character vector or a string scalar representing a 6-octet hexadecimal value.

Data Types: char | string

Basic service set identifier (BSSID), destination address (DA), or source address (SA), specified as a 12-element character vector or a string scalar representing a 6-octet hexadecimal value.

This property represents BSSID when both ToDS and FromDS are false. This property represents DA when ToDS is true and FromDS is false. This property represents SA when ToDS is false and FromDS is true.

Data Types: char | string

Frame sequence number, specified as a nonnegative integer in the interval [0, 4095]. If MPDUAggregation is true, SequenceNumber represents the sequence number of the first MAC protocol data unit (MPDU). The sequence numbers for subsequent MPDUs increase by increments of 1.

When FrameType is 'Block Ack', SequenceNumber represents the starting sequence number.

Data Types: double

Traffic identifier representing user priority, specified as a nonnegative integer in the interval [0, 7].

Data Types: double

Acknowledgement policy, specified as 'No Ack', 'Normal Ack/Implicit Block Ack Request', 'No explicit acknowledgment/PSMP Ack/HTP Ack', or 'Block Ack'.

Data Types: string | char

HT control field of the MAC header, specified as an eight-element character vector or a string scalar representing a 4-octet hexadecimal value. The leftmost byte in HTControl must be the most significant byte.

Data Types: string | char

Form aggregated MAC service data units (A-MSDUs) using MSDU aggregation, specified as a logical value. When you set MSDUAggregation to true, the MAC frame returned on calling wlanMACFrameConfig in wlanMACFrame contains A-MSDUs instead of MSDUs.

Dependencies

To enable this property, set FrameType to 'QoS Data'.

Data Types: logical

Form A-MPDUs using MPDU aggregation, specified as a logical value. Setting MPDUAggregation to true indicates that the MAC frame initialized by wlanMACMFrameConfig contains A-MPDUs instead of MPDUs. When you set FrameType to 'QoS Data' and FrameFormat to 'VHT', the MAC frame returned on calling wlanMACFrameConfig in wlanMACFrame contains A-MPDUs instead of MPDUs.

Dependencies

To enable this property, set FrameType to 'QoS Data' and FrameFormat to 'HT-Mixed'.

Data Types: logical

Destination address of all A-MSDU subframes, specified as a 12-element character vector or a string scalar representing a 6-octet hexadecimal value.

Data Types: char | string

Source address of all A-MSDU subframes, specified as a 12-element character vector or a string scalar representing a 6-octet hexadecimal value.

Data Types: char | string

Minimum spacing between the start of MPDUs, specified as a nonnegative integer in the interval [0, 7]. For more information, see Table 9.163 in [1]

Data Types: double

Block ack bitmap, specified as a character vector or string scalar. To indicate an eight-octet hexadecimal-valued block ack bitmap, specify BlockAckBitmap as a 16-element character vector or string scalar. To indicate a 32-octet hexadecimal-valued block ack bitmap, specify BlockAckBitmap as a 64-element character vector or string scalar.

Data Types: char | string

Management frame body configuration object, specified as a wlanMACManagementConfig object. This configuration is only applicable for management frames. This property specifies the fields and information elements (IEs) present within the frame body of the management frame.

Dependencies

This property applies only when you specify FrameType as 'Beacon'.

Output Arguments

collapse all

MAC frame configuration, returned as a wlanMACFrameConfig object. The properties of config are described in wlanMACFrameConfig 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