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 Properties

Define property values for MAC frame configuration

The wlanMACFrameConfig object creates a WLAN medium access control (MAC) frame configuration object that initializes properties for an IEEE® 802.11™ MAC frame.

After you create an object, use dot notation to change or access the object properties. For example, create a wlanMACFrameConfig object, then modify the default setting for the FrameType property.

cfg = wlanMACFrameConfig;
cfg.FrameType = 'ACK';

Properties

expand all

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

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

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

Data Types: double

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

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.

Introduced in R2018b