Main Content

wlanMACTriggerUserConfig

Configure User Info field of WLAN MAC trigger frame

expand all in page

Description

ThewlanMACTriggerUserConfigobject 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= wlanMACTriggerUserConfigcreates 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].

example

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

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 theRUSizeproperty to a value other than1992.

  • To enable this property when this object is an element of theUserInfo财产的wlanMACTriggerConfigobject, set theChannelBandwidthproperty of thewlanMACTriggerConfigobject to'CBW80+80 or CBW160'.

Data Types:char|string

RU size, specified as26,52,106,242,484,996, or1992.

Data Types:double

俄文指数副载波分配,指定为一个n 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 theRUAllocationRegionproperty.

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 ofMCS Modulation Type Dual Carrier Modulation Coding Rate
0 Binary phase-shift keying (BPSK)

0or1

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

Not applicable

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

0or1

 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 theDCMproperty to1(true), you must set this property to0,1,3, or4.

Data Types:double

Dual carrier modulation (DCM) indicator, specified as1(true) or0(false). To use DCM for the HE-Data field of the HE TB PPDU response, set this property to1(true). Otherwise, set this property to0(false).

当这个对象的一个元素UserInfo财产的wlanMACTriggerConfigobject, you can set this property to1(true) only when theSTBCproperty of thewlanMACTriggerConfigobject is0(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 theAID12property to a value other than0or2045.

Data Types:double

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

Dependencies

To enable this property, set theAID12property to a value other than0or2045.

Data Types:double

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

Dependencies

To enable this property, set theAID12property to0or2045.

Data Types:double

Indication of more RA-RU allocations in subsequent trigger frames, specified as1(true) or0(false). To indicate more RA-RU allocations in subsequent trigger frames, set this property to1(true). Otherwise, set this property to0(false).

Dependencies

  • To enable this property, set theAID12property to0or2045.

  • To enable this property when this object is an element of theUserInfo财产的wlanMACTriggerConfigobject, set theMoreTFproperty of thewlanMACTriggerConfigobject to1(true).

Data Types:logical

Maximum transmit power indicator, specified as1(true) or0(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 to1(true). Otherwise, set this property to0(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 theUseMaxTransmitPowerproperty to0(false).

Data Types:double

Value of the MU MPDU Spacing Factor subfield in a basic trigger frame, specified as0,1,2, or3. 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 theTriggerTypeproperty 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 theTriggerTypeproperty to'Basic'.

Data Types:double

Value of the Preferred AC subfield, specified as0,1,2, or3. 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 theTriggerTypeproperty to'Basic'.

Data Types:double

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

Dependencies

To enable this property, set theTriggerTypeproperty 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 theTriggerTypeproperty to'MU-BAR'.

Data Types:double

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

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

中on History

Introduced in R2021a

See Also

Functions

Objects

Topics