wlanMACTriggerConfig

Configure WLAN MAC trigger frame

Since R2021a

Description

The wlanMACTriggerConfig object configures the Common Info and User Info fields in an IEEE^® 802.11™ medium access control (MAC) trigger frame body.

Creation

Syntax

cfgTrigger = wlanMACTriggerConfig

cfgTrigger = wlanMACTriggerConfig(Name,Value)

Description

cfgTrigger = wlanMACTriggerConfig creates a default WLAN MAC trigger frame-body configuration object. For more information on the trigger frame format, see section 9.3.1.22 of [1].

cfgTrigger = wlanMACTriggerConfig(Name,Value) sets property values by using one or more name-value arguments. Enclose each property name in quotes. For example, 'TriggerType','Basic' specifies a basic trigger frame type.

Properties

TriggerType — Trigger frame type

'Basic' (default) | 'MU-BAR' | 'MU-RTS'

Trigger frame type, specified as one of these values.

• 'Basic' — Basic trigger frame

• 'MU-BAR' — Multi-user block ack request (MU-BAR) frame

• 'MU-RTS' — Multi-user request to send (MU-RTS) frame

For more information, see section 9.3.1.22 of [1].

Data Types: char | string

LSIGLength — Length of L-SIG field

142 (default) | integer in the interval [1, 4093]

Length of the legacy signal (L-SIG) field of the high-efficiency trigger-based (HE TB) PPDU response, specified as an integer in the interval [1, 4093]. For more information about the L-SIG field, see section 27.3.10.5 of [1].

The value of this property must satisfy mod(LSIGLength,3) = 1, where mod(a,m) returns the remainder after dividing a by m. For more information, see mod.

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

MoreTF — Additional trigger frame indication

false or 0 (default) | true or 1

Additional trigger frame indication, specified as 1 (true) or 0 (false). To indicate that the sender has more trigger frames to send, set this property to 1 (true). Otherwise, set this property to 0 (false).

Data Types: logical

CSRequired — Carrier sensing required indication

true or 1 (default) | false or 0

Carrier sensing required indication, specified as 1 (true) or 0 (false).

To indicate that the stations identified in the User Info fields need to sense the medium by using energy detection, set this property to 1 (true). This setting also indicates that those stations must consider the medium state and the network allocation vector when determining whether they respond.

Otherwise, set this property to 0 (false).

Data Types: logical

ChannelBandwidth — Channel bandwidth signaled in HE-SIG-A field

'CBW20' (default) | 'CBW40' | 'CBW80' | 'CBW80+80 or CBW160'

Channel bandwidth signaled in the HE Signal A (HE-SIG-A) field of the HE TB PPDU response, specified as one of these values.

• 'CBW20' — Channel bandwidth of 20 MHz

• 'CBW40' — Channel bandwidth of 40 MHz

• 'CBW80' — Channel bandwidth of 80 MHz

• 'CBW80+80 or CBW160' — Channel bandwidth of 160 MHz

Data Types: char | string

HELTFTypeAndGuardInterval — HE-LTF compression mode and guard interval duration

'4x HE-LTF + 3.2 us GI' (default) | '2x HE-LTF + 1.6 us GI' | '1x HE-LTF + 1.6 us GI'

High-efficiency long training field (HE-LTF) compression mode and guard interval (cyclic prefix) duration of the HE TB PPDU response, specified as one of these values.

• '4x HE-LTF + 3.2 us GI' — 4 × HE-LTF duration compression mode with a guard interval duration of 3.2 μs

• '2x HE-LTF + 1.6 us GI' — 2 × HE-LTF duration compression mode with a guard interval duration of 1.6 μs

• '1x HE-LTF + 1.6 us GI' — 1 × HE-LTF duration compression mode with a guard interval duration of 1.6 μs

For more information about the HE-LTF, see section 27.3.10.10 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: char | string

SingleStreamPilots — HE-LTF single-stream pilots indicator

true or 1 (default) | false or 0

HE-LTF single-stream pilots indicator, specified as 1 (true) or 0 (false). To indicate that the HE-LTF of the HE TB PPDU response uses single-stream pilots, set this property to 1 (true). Otherwise, set this property to 0 (false).

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: logical

NumHELTFSymbols — Number of HE-LTF symbols in PPDU

1 (default) | 2 | 4 | 6 | 8

Number of HE-LTF symbols in the HE TB PPDU response, specified as 1, 2, 4, 6, or 8.

If you set the HighDoppler property to 1 (true), then you must set this property to 1, 2, or 4.

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

MidamblePeriodicity — Midamble periodicity of HE-Data field

10 (default) | 20

Midamble periodicity of the HE-Data field of the HE TB PPDU response, in number of orthogonal frequency-division multiplexing (OFDM) symbols, specified as 10 or 20.

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR' and the HighDoppler property to 1 (true).

Data Types: double

STBC — Enable STBC

false or 0 (default) | true or 1

Enable space-time block coding (STBC) of the HE-Data field of the HE TB PPDU response, specified as 1 (true) or 0 (false). STBC transmits multiple copies of the data stream across assigned antennas.

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: logical

LDPCExtraSymbol — Extra OFDM symbol segment indicator

false or 0 (default) | true or 1

Extra OFDM symbol segment indicator, specified as 1 (true) or 0 (false). To indicate the presence of an extra OFDM symbol segment in the HE TB PPDU response for low-density parity-check (LDPC) coding, set this property to 1 (true). Otherwise, set this property to 0 (false).

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: logical

APTransmitPower — AP transmit power

-20 (default) | integer in the interval [–20, 40]

Access point (AP) transmit power, in dBm, specified as an integer in the interval [–20, 40]. The value of this property specifies the combined average power of all antennas used to transmit the trigger frame per 20 MHz channel bandwidth. For more information, see section 9.3.1.22.1 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

PreFECPaddingFactor — Pre-FEC padding factor

4 (default) | 1 | 2 | 3

Pre-forward-error-correction (pre-FEC) padding factor of the HE TB PPDU response, specified as 1, 2, 3, or 4.

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

PEDisambiguity — Value of PE Disambiguity subfield

false or 0 (default) | true or 1

Value of the PE Disambiguity subfield in the HE-SIG-A field of the HE TB PPDU response, specified as 1 (true) or 0 (false). For more information, see section 27.3.12 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: logical

SpatialReuse1 — Value of Spatial Reuse 1 subfield

15 (default) | integer in the interval [0, 15]

Value of the Spatial Reuse 1 subfield in the HE-SIG-A field of the HE TB PPDU response, specified as an integer in the interval [0, 15]. For more information, see Table 27-20 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

SpatialReuse2 — Value of Spatial Reuse 2 subfield

15 (default) | integer in the interval [0, 15]

Value of the Spatial Reuse 2 subfield in the HE-SIG-A field of the HE TB PPDU response, specified as an integer in the interval [0, 15]. For more information, see Table 27-20 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

SpatialReuse3 — Value of Spatial Reuse 3 subfield

15 (default) | integer in the interval [0, 15]

Value of the Spatial Reuse 3 subfield in the HE-SIG-A field of the HE TB PPDU response, specified as an integer in the interval [0, 15]. For more information, see Table 27-20 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

SpatialReuse4 — Value of Spatial Reuse 4 subfield

15 (default) | integer in the interval [0, 15]

Value of the Spatial Reuse 4 subfield in the HE-SIG-A field of the HE TB PPDU response, specified as an integer in the interval [0, 15]. For more information, see Table 27-20 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

HighDoppler — High-Doppler mode indicator

false or 0 (default) | true or 1

High-Doppler mode indicator, specified as 1 (true) or 0 (false). To indicate high-Doppler mode in the HE-SIG-A field of the HE TB PPDU response, set this property to 1 (true). Otherwise, set this property to 0 (false).

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: logical

HESIGAReservedBits — Reserved bits in HE-SIG-A field

ones(9,1) (default) | nine-element binary-valued column vector

Reserved bits in the HE-SIG-A field, specified as a nine-element binary-valued column vector.

Dependencies

To enable this property, set the TriggerType property to 'Basic' or 'MU-BAR'.

Data Types: double

UserInfo — User Info fields of trigger frame

Read-only: cell array of wlanMACTriggerUserConfig objects

This property is read-only.

User Info fields of the trigger frame, returned as a cell array of wlanMACTriggerUserConfig objects.

When you first create a wlanMACTriggerConfig object, this property contains a single User Info field corresponding to a wlanMACTriggerUserConfig object with default property values. To add more User Info fields to this property, use the addUserInfo object function. The first User Info field you add by using the addUserInfo object function overwrites the default User Info field. The addUserInfo object function appends subsequent User Info fields that you add to this property.

NumUserInfo — Number of User Info fields

Read-only: 1 (default) | positive integer

This property is read-only.

Number of User Info fields contained in the UserInfo property, returned as a positive integer.

Data Types: double

Object Functions

addUserInfo

Add User Info field to WLAN MAC trigger frame

Examples

Create Basic MAC Trigger Frame

Create a basic MAC trigger frame to carry information for two users.

Create a MAC trigger frame-body configuration object, specifying a channel bandwidth of 40 MHz.

cfgTrigger = wlanMACTriggerConfig(ChannelBandwidth="CBW40");

Create configuration objects for the User Info fields of the trigger frame.

cfgUser1 = wlanMACTriggerUserConfig(AID12=1, ...
    RUSize=242,RUIndex=1);
cfgUser2 = wlanMACTriggerUserConfig(AID12=2, ...
    RUSize=242,RUIndex=2);

Add the User Info fields to the trigger frame.

cfgTrigger = addUserInfo(cfgTrigger,cfgUser1);
cfgTrigger = addUserInfo(cfgTrigger,cfgUser2);

Configure the trigger frame by creating a MAC frame-body configuration object, specifying the frame type and the trigger frame-body configuration.

cfgMAC = wlanMACFrameConfig(FrameType="Trigger", ...
    TriggerConfig=cfgTrigger);

Specify a non-HT PHY configuration by creating a default non-HT configuration object.

cfgPHY = wlanNonHTConfig;

Create the MAC trigger frame and display its length.

[frame,frameLength] = wlanMACFrame(cfgMAC,cfgPHY);
disp(frameLength)

    40

More About

PPDU

The physical layer (PHY) protocol data unit (PPDU) is the complete physical layer convergence procedure (PLCP) frame, including PLCP headers, MAC headers, the MAC data field, and the MAC and PLCP trailers.

References

[1] 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 R2021a