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

Syntax

cfgUser = wlanMACTriggerUserConfig

cfgUser = wlanMACTriggerUserConfig(Name,Value)

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.

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

AID12 — Value of AID12 subfield

1 (default) | integer in the interval [0, 2007] | 2045 | 2046

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

RUAllocationRegion — RU allocation region

'primary 80MHz' (default) | 'secondary 80MHz'

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

RUSize — RU size

242 (default) | 26 | 52 | 106 | 484 | 996 | 1992

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

Data Types: double

RUIndex — RU index for subcarrier allocation

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

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

ChannelCoding — FEC coding type

'LDPC' (default) | 'BCC'

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

MCS — Modulation and coding scheme

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

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 MCS	Modulation Type	Dual Carrier Modulation	Coding Rate
0	Binary phase-shift keying (BPSK)	0 or 1	1/2
1	Quadrature phase-shift keying (QPSK)		1/2
2		Not applicable	3/4
3	16-point quadrature amplitude modulation (16-QAM)	0 or 1	1/2
4			3/4
5	64-QAM	Not applicable	2/3
6			3/4
7			5/6
8	256-QAM		3/4
9			5/6
10	1024-QAM		3/4
11			5/6

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

Data Types: double

DCM — DCM indicator

false or 0 (default) | true or 1

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

StartingSpatialStream — Starting spatial stream index

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

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

NumSpatialStreams — Number of spatial streams

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

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

NumRARU — Number of allocated contiguous RA-RUs

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

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

MoreRARU — Indication of more RA-RU allocations in subsequent trigger frames

false or 0 (default) | true or 1

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

UseMaxTransmitPower — Maximum transmit power indicator

true or 1 (default) | false or 0

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

TargetRSSI — Expected power of received signal

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

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

MPDUMUSpacingFactor — Value of MU MPDU Spacing Factor subfield

0 (default) | 1 | 2 | 3

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

TIDAggregationLimit — Value of TID Aggregation Limit subfield

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

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

PreferredAC — Value of Preferred AC subfield

0 (default) | 1 | 2 | 3

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

TID — Traffic identifier

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

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

StartingSequenceNum — Starting MSDU or A-MSDU sequence number

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

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

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

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