wlanEHTUser
Description
The wlanEHTUser
object contains properties of a user within a
WLAN extremely high-throughput multi-user (EHT MU) resource unit (RU). The User
property of a
wlanEHTMUConfig
object is a cell array of wlanEHTUser
objects. For an OFDMA
wlanEHTMUConfig
object, the AllocationIndex
property determines the User
property. For a non-OFDMA
wlanEHTMUConfig
object, the ChannelBandwidth
property determines the User
property.
Creation
Description
creates an EHT user configuration object for cfgEHT.User
= wlanEHTUser(RUNumber
)RUNumber
, the input RU
number.
sets properties using one or more name-value pairs.cfgEHT.User
= wlanEHTUser(___,Name=Value)
Properties
APEPLength
— APEP length
100
(default) | integer in the range [0, 15523198]
Aggregated MPDU (A-MPDU) pre-end-of-frame (pre-EOF) padding (APEP) length, in bytes, specified as an integer in the range [0, 15523198].
The object uses this property to determine the number of OFDM symbols in the data field. For more information, see [1].
Data Types: double
MCS
— MCS used for transmission
0
(default) | integer in the range [0, 13] | 15
Modulation and coding scheme (MCS) used for transmission, specified as a nonnegative
integer in the range [0, 13], or 15. This table shows the modulation type and coding
rate for each valid value of MCS
:
MCS | Modulation | Dual Carrier Modulation | Coding Rate |
---|---|---|---|
0 | Binary phase-shift keying (BPSK) | Not applicable | 1/2 |
1 | Quadrature phase-shift keying (QPSK) | Not applicable | 1/2 |
2 | Not applicable | 3/4 | |
3 | 16-point quadrature amplitude modulation (16-QAM) | Not applicable | 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 | ||
12 | 4096-QAM | 3/4 | |
13 | 5/6 | ||
15 | BPSK-DCM | In use | 1/2 |
A value of 14 for this property indicates that EHT DUP mode is in use.
To use EHT DUP mode, set the EHTDUPMode
property to true
or
1
.
Data Types: double
NumSpaceTimeStreams
— Number of space-time streams
1
(default) | positive integer
Number of space-time streams in the transmission, specified as an integer in the range [1, 8]. The maximum number of space-time streams for any user within an MU-MIMO RU is four. The maximum value of the sum of the number of space-time streams over all users in an RU is eight. For information on these and other restrictions on the number of space-time streams, see Table 36-42 of [1].
Data Types: double
ChannelCoding
— Forward error correction coding type
"ldpc"
(default) | "bcc"
Forward-error-correction (FEC) coding type for the EHT-Data field, specified as
"ldpc"
for low-density parity-check (LDPC) coding or
"bcc"
for binary convolutional coding (BCC).
You can set this property to "bcc"
only when all of these
conditions are satisfied:
The
MCS
property is in the range [0, 9] or equal to 15.The size of any RU is less than or equal to 242. Obtain the RU sizes by using the
ruInfo
object function.The
NumSpaceTimeStreams
property is less than or equal to 4.
Data Types: char
| string
| enumeration
STAID
— STA identifier
0
(default) | integer in the range [0, 2047]
Station (STA) identifier, specified as an integer in the range [0, 2047]. The value
of this property determines the station association identifier (AID) field as defined in
Section 35.12.1.1 of [1]. The 11 least significant bits (LSBs) of the AID field are used to address the STA.
When you create a wlanEHTUser
object, the default value of this
property is 0 for the first wlanEHTUser
object and increases by 1 for
each subsequent object. When you set this property to 2046
, the
associated RU carries no data.
Data Types: double
RUNumber
— RU number
1
(default) | integer | vector of integers
RU number, specified as an integer or a vector of integers. This property indexes
the appropriate cell array elements of the RU
property.
Note
This property is read-only after you create the object.
Data Types: double
NominalPacketPadding
— Nominal packet padding
0
(default) | 8
| 16
| 20
Nominal packet padding, in microseconds, specified as 0
,
8
, 16
, or 20
. The
wlanEHTUser
object uses this property and the
pre-forward-error-correction (pre-FEC) padding factor to calculate the duration,
TPE, of the packet extension field. For more
information about the packet extension field, see Section 36.3.14 of [1].
This table shows the possible values of TPE for different values of this property and a, a parameter defined by Equation (36-58) or (36-59) of [1].
Value of a | Value of TPE in Microseconds | |||
---|---|---|---|---|
NominalPacketPadding Set to
0 | NominalPacketPadding Set to
8 | NominalPacketPadding Set to
16 | NominalPacketPadding Set to
20 | |
1 | 0 | 0 | 4 | 8 |
2 | 0 | 0 | 8 | 12 |
3 | 0 | 4 | 12 | 16 |
4 | 0 | 8 | 16 | 20 |
For an EHT MU PPDU, Equation 36-91 of [1] defines the value of TPE as the maximum of the TPE values that you specify for each user.
Data Types: double
PostFECPaddingSource
— Post-FEC padding bit source
"mt19937arwithseed"
(default) | "globalstream"
| "userdefined"
Post-FEC padding bit source used by the wlanWaveformGenerator
function, specified as one of these values.
"mt19937arwithseed"
— Generate normally distributed random bits by using the mt19937ar algorithm with seed specified in thePostFECPaddingSeed
property."globalstream"
— Generate normally distributed random bits by using the current global random number stream."userdefined"
— Use the bits specified in thePostFECPaddingBits
property as the post-FEC padding bits.
Data Types: char
| string
| enumeration
PostFECPaddingSeed
— Post-FEC padding bit seed for mt19937ar algorithm
73
(default) | nonnegative integer
Post-FEC padding bit seed for the mt19937ar algorithm, specified as a nonnegative integer.
Dependencies
To enable this property, set the PostFECPaddingSource
property to "mt19937arWithSeed"
.
Data Types: double
PostFECPaddingBits
— Post-FEC padding bits
0
(default) | binary-valued column vector
Post-FEC padding bits, specified as a binary-valued scalar or column vector.
To generate a waveform, the wlanWaveformGenerator
function requires n bits, where
n depends on the configuration you specify. To calculate
n, use the numPostFECPaddingBits
object function with your specified configuration
object as the input argument and specify this property as a vector of length
n. Alternatively, specify this input as a binary-valued scalar or
column vector of arbitrary length. If the length of this property is less than
n, the waveform generator loops the vector to create a vector of
length n. If the length of this property is greater than
n, the function uses only the first n entries as
the post-FEC padding bits.
Note
For C/C++ code generation, you must specify the data type of this property as
int8
.
Data Types: single
| double
| int8
Object Functions
Examples
Create EHT Non-OFDMA Configuration Object Using DUP Mode
Create a non-OFDMA EHT MU configuration object. Set the channel bandwidth to 160 MHz.
cfg = wlanEHTMUConfig("CBW160");
Display the configuration properties of the user. The modulation and coding scheme is 0
.
cfg.User{1}
ans = wlanEHTUser with properties: APEPLength: 100 MCS: 0 NumSpaceTimeStreams: 1 ChannelCoding: ldpc STAID: 0 NominalPacketPadding: 0 PostFECPaddingSource: mt19937arwithseed PostFECPaddingSeed: 1 Read-only properties: RUNumber: 1
Create another non-OFDMA EHT MU configuration object with the same channel bandwidth. Enable EHT DUP mode.
cfg = wlanEHTMUConfig("CBW160", EHTDUPMode=1);
Display the modulation and coding scheme used. The value 14 indicates that EHT DUP mode is being used.
cfg.User{1}.MCS
ans = 14
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
To use the strcmp
function with the ChannelCoding
and
PostFECPaddingSource
properties, you must specify the properties as members of
the wlan.type.ChannelCoding
and
wlan.type.PostFECPaddingSource
enumeration classes,
respectively. (since R2023a)
Version History
Introduced in R2022bR2023a: ChannelCoding
and PostFECPaddingSource
enumeration classes
The ChannelCoding
and
PostFECPaddingSource
properties are saved, respectively, as members of the
wlan.type.ChannelCoding
and
wlan.type.PostFECPaddingSource
enumeration classes.
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
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)