wlanMACTriggerUserConfig
Description
The wlanMACTriggerUserConfig
object configures the User Info field of an
IEEE®
802.11™ medium access control (MAC) trigger frame body.
Creation
Description
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
sets property values by using one or more name-value arguments. Enclose each property name
in quotes. For example, cfgUser
= wlanMACTriggerUserConfig(Name,Value
)'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 than1992
.To enable this property when this object is an element of the
UserInfo
property of awlanMACTriggerConfig
object, set theChannelBandwidth
property of thewlanMACTriggerConfig
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) |
| 1/2 |
1 | Quadrature phase-shift keying (QPSK) | 1/2 | |
2 | Not applicable | 3/4 | |
3 | 16-point quadrature amplitude modulation (16-QAM) |
| 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 to0
or2045
.To enable this property when this object is an element of the
UserInfo
property of awlanMACTriggerConfig
object, set theMoreTF
property of thewlanMACTriggerConfig
object to1
(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
See Also
Functions
Objects
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)