Main Content

wlanMACTriggerConfig

Configure WLAN MAC trigger frame

Since R2021a

expand all in page

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.

example

Properties

expand all

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

addUserInfoAdd User Info field to WLAN MAC trigger frame

Examples

collapse all

Open Live Script

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

expand all

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

See Also

Functions

Objects

Topics