Main Content

wlanMACTriggerUserConfig

Configure User Info field of WLAN MAC trigger frame

Since R2021a

Description

The wlanMACTriggerUserConfig object configures the User Info field of an IEEE® 802.11™ medium access control (MAC) trigger frame body.

Creation

Description

cfgUser = wlanMACTriggerUserConfig creates a default configuration object for the User Info field of a WLAN MAC trigger frame. For more information on the trigger frame format and its User Info field, see section 9.3.1.22 of [1].

cfgUser = wlanMACTriggerUserConfig(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

Value of the AID12 subfield, specified as one of these values.

  • 0 — The User Info field allocates contiguous random access resource units (RA-RUs) for associated stations (STAs).

  • An integer in the interval [1, 2007] — This property represents the STA association identifier (AID) for the User Info field.

  • 2045 — The User Info field allocates one or more contiguous RA-RUs for unassociated STAs.

  • 2046 — The User Info field identifies an unallocated RU.

Data Types: double

RU allocation region in the 80+80 MHz or 160 MHz channel, specified as 'primary 80MHz' or 'secondary 80MHz'.

Dependencies

  • To enable this property, set the RUSize property to a value other than 1992.

  • To enable this property when this object is an element of the UserInfo property of a wlanMACTriggerConfig object, set the ChannelBandwidth property of the wlanMACTriggerConfig object to 'CBW80+80 or CBW160'.

Data Types: char | string

RU size, specified as 26, 52, 106, 242, 484, 996, or 1992.

Data Types: double

RU index for subcarrier allocation, specified as an integer in the interval [1, 37]. The RU index specifies the location of the RU within the channel. For example, an 80 MHz transmission contains four 242-tone RUs (one for each 20 MHz subchannel). RU number 242-1 (size 242, index 1) is the lowest absolute frequency within the 80 MHz channel. Similarly, RU number 242-4 is the highest absolute frequency. For a 160 MHz transmission, this property indicates the RU index value for the 80 MHz segment specified by the RUAllocationRegion property.

Data Types: double

Forward-error-correction (FEC) coding type for the HE-Data field of the HE TB PPDU response, specified as one of these values.

  • 'LDPC' — Low-density parity-check (LDPC) coding

  • 'BCC' — Binary convolutional coding (BCC)

Data Types: char | string

Modulation and coding scheme (MCS) used in transmitting the HE TB PPDU response, specified as an integer in the interval [0, 11]. This table shows the modulation type and coding rate for each valid value of this property.

Value of MCSModulation TypeDual Carrier ModulationCoding Rate
0Binary phase-shift keying (BPSK)

0 or 1

1/2
1Quadrature phase-shift keying (QPSK)1/2
2

Not applicable

3/4
316-point quadrature amplitude modulation (16-QAM)

0 or 1

1/2
43/4
564-QAM

Not applicable

2/3
63/4
75/6
8256-QAM3/4
95/6
101024-QAM3/4
115/6

When you set the DCM property to 1 (true), you must set this property to 0, 1, 3, or 4.

Data Types: double

Dual carrier modulation (DCM) indicator, specified as 1 (true) or 0 (false). To use DCM for the HE-Data field of the HE TB PPDU response, set this property to 1 (true). Otherwise, set this property to 0 (false).

When this object is an element of the UserInfo property of a wlanMACTriggerConfig object, you can set this property to 1 (true) only when the STBC property of the wlanMACTriggerConfig object is 0 (false).

Data Types: logical

Starting spatial stream index, in one-based form, specified as an integer in the interval [1, 8].

Dependencies

To enable this property, set the AID12 property to a value other than 0 or 2045.

Data Types: double

Number of spatial streams, specified as an integer in the interval [1, 8].

Dependencies

To enable this property, set the AID12 property to a value other than 0 or 2045.

Data Types: double

Number of allocated contiguous RA-RUs, specified as an integer in the interval [1, 32].

Dependencies

To enable this property, set the AID12 property to 0 or 2045.

Data Types: double

Indication of more RA-RU allocations in subsequent trigger frames, specified as 1 (true) or 0 (false). To indicate more RA-RU allocations in subsequent trigger frames, set this property to 1 (true). Otherwise, set this property to 0 (false).

Dependencies

  • To enable this property, set the AID12 property to 0 or 2045.

  • To enable this property when this object is an element of the UserInfo property of a wlanMACTriggerConfig object, set the MoreTF property of the wlanMACTriggerConfig object to 1 (true).

Data Types: logical

Maximum transmit power indicator, specified as 1 (true) or 0 (false). To solicit maximum transmit power of the HE TB PPDU response from the receiving station for the assigned HE MCS value, set this property to 1 (true). Otherwise, set this property to 0 (false).

Data Types: logical

Expected power of the received signal, in dBm, specified as an integer in the interval [–110, –20]. This property represents the expected power of the HE TB PPDU response transmitted on the assigned RU averaged over the AP antenna connectors and rounded to the nearest integer.

Dependencies

To enable this property, set the UseMaxTransmitPower property to 0 (false).

Data Types: double

Value of the MU MPDU Spacing Factor subfield in a basic trigger frame, specified as 0, 1, 2, or 3. This property indicates the minimum MPDU start spacing multiplication factor. For more information, see sections 9.3.1.22.2 and 10.13.3 of [1].

Dependencies

To enable this property, set the TriggerType property to 'Basic'.

Data Types: double

Value of the TID Aggregation Limit subfield, specified as an integer in the interval [0, 7]. This subfield indicates the maximum number of traffic identifiers (TIDs) that a station can aggregate.

Dependencies

To enable this property, set the TriggerType property to 'Basic'.

Data Types: double

Value of the Preferred AC subfield, specified as 0, 1, 2, or 3. This subfield indicates the lowest recommended access category for aggregation of MAC protocol data units (MPDUs) in the HE TB PPDU response.

Dependencies

To enable this property, set the TriggerType property to 'Basic'.

Data Types: double

Traffic identifier, specified as an integer in the interval [0, 7].

Dependencies

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

Data Types: double

Starting MAC service data unit (MSDU) or aggregate MSDU (A-MSDU) sequence number, specified as an integer in the interval [0, 4095].

Dependencies

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

Data Types: double

Examples

collapse all

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

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