wlanMACTriggerConfig
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
Description
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
sets property values by using one or more name-value arguments. Enclose each property name
in quotes. For example, cfgTrigger
= wlanMACTriggerConfig(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
LSIGLength
— Length of L-SIG field
142
(default) | integer in the interval [1, 4093]
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
MoreTF
— Additional trigger frame indication
false
or 0
(default) | true
or 1
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
CSRequired
— Carrier sensing required indication
true
or 1
(default) | false
or 0
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
ChannelBandwidth
— Channel bandwidth signaled in HE-SIG-A field
'CBW20'
(default) | 'CBW40'
| 'CBW80'
| 'CBW80+80 or CBW160'
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
HELTFTypeAndGuardInterval
— HE-LTF compression mode and guard interval duration
'4x HE-LTF + 3.2 us GI'
(default) | '2x HE-LTF + 1.6 us GI'
| '1x HE-LTF + 1.6 us GI'
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
SingleStreamPilots
— HE-LTF single-stream pilots indicator
true
or 1
(default) | false
or 0
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
NumHELTFSymbols
— Number of HE-LTF symbols in PPDU
1
(default) | 2
| 4
| 6
| 8
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
MidamblePeriodicity
— Midamble periodicity of HE-Data field
10
(default) | 20
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
STBC
— Enable STBC
false
or 0
(default) | true
or 1
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
LDPCExtraSymbol
— Extra OFDM symbol segment indicator
false
or 0
(default) | true
or 1
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
APTransmitPower
— AP transmit power
-20
(default) | integer in the interval [–20, 40]
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
PreFECPaddingFactor
— Pre-FEC padding factor
4
(default) | 1
| 2
| 3
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
PEDisambiguity
— Value of PE Disambiguity subfield
false
or 0
(default) | true
or 1
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
SpatialReuse1
— Value of Spatial Reuse 1 subfield
15
(default) | integer in the interval [0, 15]
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
SpatialReuse2
— Value of Spatial Reuse 2 subfield
15
(default) | integer in the interval [0, 15]
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
SpatialReuse3
— Value of Spatial Reuse 3 subfield
15
(default) | integer in the interval [0, 15]
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
SpatialReuse4
— Value of Spatial Reuse 4 subfield
15
(default) | integer in the interval [0, 15]
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
HighDoppler
— High-Doppler mode indicator
false
or 0
(default) | true
or 1
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
HESIGAReservedBits
— Reserved bits in HE-SIG-A field
ones(9,1)
(default) | nine-element binary-valued column vector
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
UserInfo
— User Info fields of trigger frame
cell array of wlanMACTriggerUserConfig
objects
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.
NumUserInfo
— Number of User Info fields
1
(default) | positive integer
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
addUserInfo | Add User Info field to WLAN MAC trigger frame |
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
More About
PPDU
The physical layer (PHY) protocol data unit (PPDU) is the complete physical layer convergence procedure (PLCP) frame, including PLCP headers, MAC headers, the MAC data field, and the MAC and PLCP trailers.
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)