wlanHEMUConfig
Configure HE MU transmission
配置 HE MU 传输
Description 描述
The wlanHEMUConfig
object is a configuration object for the WLAN
high-efficiency multi-user (HE MU) packet format.wlanHEMUConfig
对象是 WLAN 高效多用户 (HE MU) 数据包格式的配置对象。
Creation 创造
Syntax 语法
Description 描述
creates cfgHEMU
= wlanHEMUConfig(AllocationIndex
)cfgHEMU
, a configuration object that initializes transmit
parameters for an IEEE®
802.11™ HE MU PPDU for
AllocationIndex
, the input resource unit allocation. For a detailed
description of the HE WLAN format, see [2].
创建 cfgHEMU
= wlanHEMUConfig(AllocationIndex
)cfgHEMU
,一个配置对象,用于初始化 IEEE® 802.11™ HE MU PPDU 的传输参数,为 AllocationIndex
输入资源单元的分配。有关 HE WLAN 格式的详细描述,请参阅 [2]。
sets properties using one or more name-value pairs. Enclose each property name in
quotation marks. For example, cfgHEMU
= wlanHEMUConfig(AllocationIndex
,Name,Value)wlanHEMUConfig([200 114 114
200],'LowerCenter26ToneRU',true)
specifies an 80 MHz bandwidth allocation for
three users on three RUs with lower center 26-tone RU allocation signaling.
使用一个或多个名称-值对设置属性。将每个属性名称用引号括起来。例如, cfgHEMU
= wlanHEMUConfig(AllocationIndex
,Name,Value)wlanHEMUConfig([200 114 114
200],'LowerCenter26ToneRU',true)
指定了三个 RU 上三个用户的 80MHz 带宽分配,其中 RU 分配信令为较低中心 26-tone RU。
At runtime, the calling function validates object settings for
properties relevant to the operation of the function.
在运行时,调用函数验证与函数操作相关的属性的对象设置。
Properties 属性
AllocationIndex
— Resource unit allocation index
integer | vector of integers | character vector | cell array
AllocationIndex
— 资源单元分配索引整数 | 整数向量 | 字符向量 | 单元数组
Resource unit (RU) allocation index for each 20 MHz subchannel. This property
defines the number of RUs, the size of each RU, and the number of users assigned to each
RU. For more information, see Allocation Index.
资源单元(RU)为每个 20 MHz 子信道分配指数。该属性定义了 RU 的数量、每个 RU 的大小以及分配给每个 RU 的用户数量。有关更多信息,请参见Allocation Index。
You can specify this value as an integer, a vector of integers, a string array, a
character vector, or a cell array of character vectors. The format in which you specify
these indices depends on how many you are specifying.
您可以将该值指定为整数、整数向量、字符串数组、字符向量或字符向量的单元数组。您指定这些索引的格式取决于您指定的数量。
Specify a single allocation index using one integer in either of these forms.
使用任一形式中的一个整数指定一个单一的分配索引。An integer in the interval [0, 223]
一个在区间[0, 223]内的整数An 8-bit binary sequence specified as a string or character vector
一个指定为字符串或字符向量的 8 位二进制序列
Specify multiple allocation indices using two, four, or eight integer values in any of these forms.
在任何一种形式中,使用两个、四个或八个整数值指定多个分配索引。A vector of integers in the interval [0, 223]
一个整数向量,取值范围为[0, 223]An 8-bit binary sequence specified as a string array
一个指定为字符串数组的 8 位二进制序列An 8-bit binary sequence specified as a cell array of character vectors
一个被指定为字符向量单元数组的 8 位二进制序列
In an 80 MHz transmission, you can signal a punctured 20 MHz subchannel at any location.
在 80 MHz 传输中,您可以在任何位置信号穿孔的 20 MHz 子信道。In a 160 MHz transmission, you can signal a punctured 20 or 40 MHz subchannel. You can only signal a punctured 20 MHz subchannel in the 40 MHz subchannel containing the primary 20 MHz subchannel, as shown in this figure.
在 160 MHz 传输中,您可以标记一个中断的 20 或 40 MHz 子信道。您只能在包含主要 20 MHz 子信道的 40 MHz 子信道中标记一个中断的 20 MHz 子信道,如图所示。Similarly, you can only signal a punctured 40 MHz subchannel in the 80 MHz subchannel containing the primary 20 MHz subchannel, as shown in this figure.
同样,您只能在包含主要 20 MHz 子信道的 80 MHz 子信道中信号一个被刺穿的 40 MHz 子信道,如图所示。To signal a punctured 20 MHz subchannel, set the corresponding element of this property to
113
. To signal a punctured 40 MHz subchannel, set the two corresponding adjacent elements to114
.
要信号一个 20 MHz 子信道受损,将此属性的对应元素设置为113
。要信号一个 40 MHz 子信道受损,将两个相邻的对应元素设置为114
。To signal an empty HE-SIG-B user field in an HE-SIG-B content channel, set the corresponding element of this property to
114
or115
.
为了在 HE-SIG-B 内容通道中信号一个空的 HE-SIG-B 用户字段,请将此属性的相应元素设置为114
或115
。
Note 注意
This property is read-only after the object is created.
此属性在对象创建后为只读。
Data Types: double
| char
| string
| cell
数据类型:double
| char
| string
| cell
ChannelBandwidth
— Channel bandwidth of PPDU transmission
'CBW20'
(default) | 'CBW40'
| 'CBW80'
| 'CBW160'
频道带宽
— PPDU 传输的信道带宽'CBW20'
(默认) | 'CBW40'
| 'CBW80'
| 'CBW160'
Channel bandwidth of PPDU transmission, specified as one of these values:
PPDU 传输的信道带宽,指定为以下这些值之一:
'CBW20'
– Channel bandwidth of 20 MHz'CBW20'
– 20 MHz 的信道带宽'CBW40'
– Channel bandwidth of 40 MHz'CBW40'
– 40 MHz 的频道带宽'CBW80'
– Channel bandwidth of 80 MHz'CBW80'
– 80 MHz 的信道带宽'CBW160'
– Channel bandwidth of 160 MHz'CBW160'
– 160 MHz 的信道带宽
When you create a wlanHEMUConfig
object, this property is
configured based on the value to which you set the AllocationIndex
property.
当您创建一个wlanHEMUConfig
对象时,此属性将基于您设置AllocationIndex
属性的值进行配置。
Note 注意
This property is read-only after the object is created.
创建对象后,此属性为只读。
Data Types: char
| string
数据类型:char
| string
LowerCenter26ToneRU
— Enable lower center 26-tone RU allocation signaling
false
or 0
(default) | true
or 1
LowerCenter26ToneRU
— 启用低中心 26-tone RU 分配信令false
或 0
(默认)| true
或 1
Enable lower center 26-tone RU allocation signaling, specified as a numeric or
logical 1
(true
) or 0
(false
). To enable the lower frequency center 26-tone RU, set this
property to 1
(true
). This property can be set
during object creation only.
启用较低中心 26-tone RU 分配信令,指定为数字或逻辑1
(true
)或0
(false
)。要启用较低频率中心 26-tone RU,请将此属性设置为1
(true
)。此属性仅可在对象创建期间设置。
Dependencies 依赖关系
This property applies only when the AllocationIndex
property defines a channel bandwidth of 80 MHz or 160
MHz and does not specify a full bandwidth allocation.
此属性仅在AllocationIndex
属性定义了 80 MHz 或 160 MHz 的信道带宽且未指定完整带宽分配时适用。
Data Types: logical
数据类型: 逻辑型
UpperCenter26ToneRU
— Enable upper center 26-tone RU allocation signaling
false
or 0
(default) | true
or 1
UpperCenter26ToneRU
— 启用上中心 26 调 RU 分配信令false
或 0
(默认)| true
或 1
Enable upper center 26-tone RU allocation signaling, specified as a numeric or
logical 1
(true
) or 0
(false
). To enable the upper frequency center 26-tone RU, set this
property to 1
(true
). This property can be set
during object creation only.
启用上限中心 26-tone RU 分配信令,指定为数字或逻辑 1
(true
) 或 0
(false
)。要启用上频率中心 26-tone RU,请将此属性设置为 1
(true
)。此属性仅在对象创建期间设置。
Dependencies 依赖关系
This property applies only when the AllocationIndex
property defines a channel bandwidth of 80 MHz or 160
MHz and does not specify a full bandwidth allocation.
此属性仅在 AllocationIndex
属性定义了 80 MHz 或 160 MHz 的信道带宽,并且未指定完整带宽分配时才适用。
Data Types: logical
数据类型: 逻辑型
RU
— Transmission properties of each RU in transmission
cell array of wlanHEMURU
objects
RU
— 每个 RU 在传输中的传输特性传输中的每个 RU 的传输特性
Transmission properties of each RU in the transmission, specified as a cell array of
wlanHEMURU
objects. When you
create a wlanHEMUConfig
object, the AllocationIndex
property determines this property.
每个 RU 的传输属性,指定为一个单元数组的wlanHEMURU
对象。创建wlanHEMUConfig
对象时,AllocationIndex
属性确定了此属性。
Data Types: cell
数据类型: cell
User
— Transmission properties of each user
cell array of wlanHEMUUser
objects
用户
— 每个用户的传输特性wlanHEMUUser
对象的单元数组
Transmission properties of each user, specified as a cell array of wlanHEMUUser
objects. When you
create a wlanHEMUConfig
object, the AllocationIndex
property determines this property.
传输属性每个用户,指定为wlanHEMUUser
对象的单元数组。当您创建wlanHEMUConfig
对象时,AllocationIndex
属性确定此属性。
Data Types: cell
数据类型: 单元格
PrimarySubchannel
— Index of primary 20 MHz subchannel
1
(default) | integer in the interval [1, 8]
PrimarySubchannel
— 主要 20 MHz 子信道的索引1
(默认) | 区间 [1, 8] 中的整数
Index of primary 20 MHz subchannel in an 80 or 160 MHz transmission, specified as
one of these options.
80 或者 160MHz 传输中的 20 MHz 主子信道索引,指定为以下选项之一。
When the
ChannelBandwidth
property is'CBW80'
, set this property to an integer in the interval [1, 4].
当ChannelBandwidth
属性为'CBW80'
时,将此属性设置为区间[1,4]内的整数。When the
ChannelBandwidth
property is'CBW160'
, set this property to an integer in the interval [1, 8].
当ChannelBandwidth
属性为'CBW160'
时,将此属性设置为区间[1,8]内的整数。
The location of the primary subchannel and the preamble puncturing pattern (defined
by the AllocationIndex
property) determine the bandwidth value signaled in the
HE-SIG-A field of the transmission, as specified in Table 27-20 of [2].
主要子信道的位置和前导穿孔模式(由< a id=0> AllocationIndex
属性定义)确定了在传输的 HE-SIG-A 字段中向信号传递的带宽值, 如 < [2] > 中表 27-20 指定的那样。
Dependencies 依赖关系
This property applies only when the AllocationIndex
property defines a channel bandwidth of 80 MHz or 160
MHz.
该属性仅在 AllocationIndex
属性定义通道带宽为 80 MHz 或 160 MHz 时适用。
Data Types: double
数据类型: 双精度
NumTransmitAntennas
— Number of transmit antennas
1
(default) | positive integer
NumTransmitAntennas
— 发射天线数量1
(默认)| 正整数
Number of transmit antennas, specified as a positive integer.
传输天线数量,指定为正整数。
Data Types: double
数据类型: 双精度
PreHECyclicShifts
— Cyclic shift values of additional transmit antennas
-75
(default) | integer in the interval [–200, 0] | row vector
PreHECyclicShifts
— 附加发射天线的循环移位值-75
(默认值) | 区间中的整数 [–200, 0] | 行向量
Cyclic shift values, in nanoseconds, of additional transmit antennas for the pre-HE
fields of the waveform. The first eight antennas use the cyclic shift values specified
in Table 21-10 of [1].
The remaining L antennas use the values you specify in this property,
where L = NumTransmitAntennas
–
8. Specify this property as one of these values:
循环移位值以纳秒为单位,用于波形的预-HE 字段的额外发送天线。前八个天线使用[1]中指定的循环移位值。剩下的 L 个天线使用您在此属性中指定的值,其中 L = NumTransmitAntennas
– 8。将此属性指定为以下值之一:
An integer in the interval [–200, 0] – the
wlanHEMUConfig
object uses this cyclic shift value for each of the L additional antennas.
在区间[–200, 0]中的整数 –wlanHEMUConfig
对象为每个L个额外天线都使用这个循环移位值。A row vector of length L of integers in the interval [–200, 0] – the
wlanHEMUConfig
object uses the kth element as the cyclic shift value for the (k + 8)th transmit antenna.
一个长度为L的整数行向量,其取值范围为[–200, 0] –wlanHEMUConfig
对象使用第k个元素作为第(k + 8)个发射天线的循环移位值。Note 注意
If you specify this property as a row vector of length greater than L, the
wlanHEMUConfig
object uses only the first L elements. For example, if you set theNumTransmitAntennas
property to16
, thewlanHEMUConfig
object uses only the first L = 16 – 8 = 8 elements of this vector.
如果将此属性指定为长度大于 L 的行向量,则wlanHEMUConfig
对象仅使用前 L 个元素。例如,如果将NumTransmitAntennas
属性设置为16
,则wlanHEMUConfig
对象仅使用此向量的前 L = 16 – 8 = 8 个元素。
Dependencies 依赖关系
To enable this property, set the NumTransmitAntennas
property to a value greater than
8
.
要启用此属性,请将 NumTransmitAntennas
属性设置为大于 8
的值。
Data Types: double
数据类型: 双精度
STBC
— Enable space-time block coding
false
or 0
(default) | true
or 1
STBC
— 启用时空分组编码false
或0
(默认) | true
或1
Enable space-time block coding (STBC) of the PPDU data field for all users,
specified as a numeric or logical 1
(true
) or
0
(false
). STBC transmits multiple copies of the
data stream across assigned antennas.
使所有用户的 PPDU 数据字段启用时空分组编码(STBC),指定为一个数字或逻辑1
(true
)或0
(false
)。STBC 通过分配的天线传输数据流的多个副本。
When you set this property to
0
(false
), STBC is not applied to the data field. The number of space-time streams is equal to the number of spatial streams.
当您将此属性设置为0
(false
)时,STBC 不会应用到数据字段。空时流的数量等于空间流的数量。When you set this property to
1
(true
), STBC is applied to the data field. The number of space-time streams is twice the number of spatial streams.
当您将此属性设置为1
(true
),STBC 将应用于数据字段。时空流的数量是空间流数量的两倍。
Dependencies 依赖关系
This property applies only when all of these conditions are satisfied:
此属性仅在满足这些条件时适用:
The
NumSpaceTimeStreams
subproperty of each element of theUser
property is2
.NumSpaceTimeStreams
属性的每个元素的子属性User
是2
。The
MCS
subproperty of each element of theUser
property is0
(false
).
元素根据其 User 属性的每个子属性 MCS 是 0(false)。No RU specifies multi-user multiple input/multiple output (MU-MIMO).
没有 RU 指定多用户多输入/多输出(MU-MIMO)。
Data Types: logical
数据类型: 逻辑型
GuardInterval
— Guard interval (cyclic prefix) duration
3.2
(default) | 1.6
| 0.8
保护间隔
— 保护间隔(循环前缀)持续时间3.2
(默认)| 1.6
| 0.8
Guard interval (cyclic prefix) duration for the data field within a packet, in
microseconds, specified as 3.2
, 1.6
, or
0.8
.
守卫间隔(循环前缀)持续时间为分组内数据字段,以微秒为单位,指定为3.2
、1.6
或0.8
。
Data Types: double
数据类型: 双精度
HELTFType
— HE-LTF compression mode
4
(default) | 2
HELTFType
— HE-LTF 压缩模式4
(默认)| 2
HE-LTF compression mode, specified as 4
or 2
.
This property indicates the type of HE-LTF, where a value of 4
or
2
corresponds to four times or two times HE-LTF duration compression
mode, respectively. The HE-LTF type is enumerated in Table 27-1 of [2]
as:
HE-LTF 压缩模式,指定为4
或2
。此属性表示 HE-LTF 的类型,其中值4
或2
分别对应四倍或两倍 HE-LTF 时长压缩模式。在[2]的表 27-1 中枚举了 HE-LTF 类型:
2xHE-LTF – Duration of 6.4 μs with a guard interval duration of 0.8 μs or 1.6 μs
2xHE-LTF - 持续时间为 6.4 微秒,带有 0.8 微秒或 1.6 微秒的保护间隔持续时间4xHE-LTF – Duration of 12.8 μs with a guard interval duration of 0.8 μs or 3.2 μs
4xHE-LTF - 持续时间为 12.8 微秒,护卫间隔持续时间为 0.8 微秒或 3.2 微秒
For more information on the HE-LTF, see section 27.3.11.10 of [2].
有关 HE-LTF 的更多信息,请参见 [2] 的第 27.3.11.10 节。
Data Types: double
数据类型: 双精度
SIGBCompression
— HE-SIG-B compression indicator
true
or 1
(default) | false
or 0
SIGBCompression
— HE-SIG-B 压缩指示器true
或 1
(默认)| false
或 0
HE-SIG-B compression indicator, specified as a numeric or logical
1
(true
) or 0
(false
). To enable HE-SIG-B compression for a full-bandwidth 20 MHz
MU-MIMO transmission, set this property to 1
(true
).
HE-SIG-B 压缩指示器,指定为数值或逻辑1
(true
)或0
(false
)。要为全带宽 20 MHz MU-MIMO 传输启用 HE-SIG-B 压缩,请将此属性设置为1
(true
)。
Dependencies 依赖关系
This property applies only when you indicate a 20 MHz channel bandwidth by setting
the AllocationIndex
to a value in the interval [192,199].
此属性仅在将 AllocationIndex
设置为区间[192,199]内的值来指示 20 MHz 频道带宽时适用。
Note 注意
This property is not used for bandwidths of 40, 80, or 160 MHz because, at these
bandwidths, the AllocationIndex
alone determines if HE-SIG-B
compression is used:
此属性不用于 40、80 或 160 MHz 的带宽,因为在这些带宽下,只有AllocationIndex
决定是否使用 HE-SIG-B 压缩:
If you specify a single, full-band allocation index, the transmission uses HE-SIG-B compression. The allocation index is not signaled.
如果您指定单个完整带宽分配索引,则传输将使用 HE-SIG-B 压缩。分配索引不会被信令。If you specify 2, 4, or 8 full-band allocation indices, the transmission does not use HE-SIG-B compression. The allocation indices are signaled.
如果指定 2、4 或 8 个全频段分配索引,则传输不使用 HE-SIG-B 压缩。分配索引是被信令的。
For more information, see the tutorial on HE MU Transmission or the example Demonstrate SIGB Compression in HE MU Waveforms.
有关更多信息,请参阅HE MU 传输的教程或示例在 HE MU 波形中演示 SIGB 压缩。
Data Types: logical
数据类型: 逻辑型
SIGBMCS
— MCS for HE-SIG-B field
0
(default) | integer in the interval [0, 5]
SIGBMCS
— MCS for HE-SIG-B field0
(默认)|区间内的整数[0, 5]
Modulation and coding scheme (MCS) for the HE-SIG-B field, specified as an integer
in the interval [0, 5].
HE-SIG-B 字段的调制和编码方案(MCS)指定为区间[0, 5]内的整数。
Data Types: double
数据类型: 双精度
SIGBDCM
— Enable DCM for HE-SIG-B field
false
or 0
(default) | true
or 1
SIGBDCM
— 启用 HE-SIG-B 领域的 DCMfalse
或 0
(默认)| true
或 1
HE-SIG-B dual-carrier modulation (DCM) indicator, specified as a numeric or logical
1
(true
) or 0
(false
). A value of 1
(true
)
indicates that the HE-SIG-B field is modulated with DCM. A value of 0
(false
) indicates that the HE-SIG-B field is not modulated with
DCM.
HE-SIG-B 双载波调制(DCM)指示器,指定为数字或逻辑1
(true
)或0
(false
)。1
(true
)的值表示 HE-SIG-B 字段采用 DCM 调制。值0
(false
)表示 HE-SIG-B 字段未采用 DCM 调制。
Dependencies 依赖关系
This property applies only when the MCS
subproperty of each element of the User
property is 0
, 1
, 3
, or
4
.
此属性仅适用于MCS
子属性的每个元素属性为0
、1
、3
或4
。
Data Types: logical
数据类型: 逻辑型
UplinkIndication
— Uplink indication
false
or 0
(default) | true
or 1
UplinkIndication
— 上行指示false
或 0
(默认) | true
或 1
Uplink indication, specified as a numeric or logical 1
(true
) or 0
(false
). To
indicate that the PPDU is sent on a downlink transmission, set this property to
0
(false
). To indicate that the PPDU is sent on
an uplink transmission, set this property to 1
(true
).
上行指示,指定为数字或逻辑1
(true
)或0
(false
)。 要指示 PPDU 在下行传输上发送,请将此属性设置为0
(false
)。 要指示 PPDU 在上行传输上发送,请将此属性设置为1
(true
)。
Data Types: logical
数据类型: 逻辑型
BSSColor
— Basic service set color identifier
0
(default) | integer in the interval [0, 63]
BSSColor
— 基本服务集颜色标识符0
(默认)| 范围内的整数 [0, 63]
Basic service set (BSS) color identifier, specified as an integer in the interval
[0, 63].
基本服务集(BSS)颜色标识符,指定为区间[0, 63]内的整数。
Data Types: double
数据类型: 双精度
SpatialReuse
— Spatial reuse indication
0
(default) | integer in the interval [0, 15]
空间重用
— 空间重用指示0
(默认) | 整数区间为[0, 15]
Spatial reuse indication, specified as an integer in the interval [0, 15].
空间重用指示,指定为区间[0,15]内的整数。
Data Types: double
数据类型: 双精度
TXOPDuration
— Duration information for TXOP protection
127
(default) | integer in the interval [0, 127]
TXOP 持续时间
— TXOP 保护的持续时间信息127
(默认)| 一个在区间[0, 127]内的整数
Duration information for transmit opportunity (TXOP) protection, specified as an
integer in the interval [0, 127]. Except for the first bit, which specifies TXOP length
granularity, each bit of the TXOP field of HE-SIG-A is equal to
TXOPDuration
. Therefore a duration in microseconds must be
converted according to the procedure set out in Table 27-18 of [2].
持续时间信息用于发送机会(TXOP)保护,规定为区间[0, 127]内的整数。除了第一位指定 TXOP 长度粒度外,HE-SIG-A 的 TXOP 字段的每一位均等于TXOPDuration
。因此,微秒级的持续时间必须按照[2]的表 27-18 中所列的步骤进行转换。
Data Types: double
数据类型: 双精度
HighDoppler
— High-Doppler mode indicator
false
or 0
(default) | true
or 1
HighDoppler
— 高多普勒模式指示器false
或 0
(默认) | true
或 1
High-Doppler mode indicator, specified as a numeric or logical 0
(false
) or 1
(true
). To
indicate high-Doppler mode in the HE-SIG-A field, set this property to
1
(true
).
高多普勒模式指示器,指定为数值或逻辑0
(false
)或1
(true
)。要在 HE-SIG-A 字段中指示高多普勒模式,请将此属性设置为1
(true
)。
Dependencies 依赖关系
The 1
(true
) value for this property is
valid only when the NumSpaceTimeStreams
subproperty of each element of the RU
property
is less than or equal to 4.1
(true
)该属性的值仅在NumSpaceTimeStreams
元素的RU
属性的子属性小于或等于 4 时有效。
Data Types: logical
数据类型: 逻辑型
MidamblePeriodicity
— Midamble periodicity of HE-data field
10
(default) | 20
中期间隔周期性
— HE 数据字段的中段周期性 10
(默认)| 20
Midamble periodicity of the HE-data field, in number of OFDM symbols, specified as
10
or 20
.
HE-data 字段的中间周期性,以 OFDM 符号数量指定为10
或20
。
Dependencies 依赖关系
This property applies only when the HighDoppler
property is 1
(true
).
此属性仅在 HighDoppler
属性为 1
(true
) 时适用。
Data Types: double
数据类型: 双精度
Object Functions 对象功能
getNumPostFECPaddingBits | Calculate required number of post-FEC padding bits 计算所需的后 FEC 填充位数 |
getPSDULength | Calculate HE or WUR PSDU length 计算 HE 或 WUR PSDU 的长度 |
packetFormat | WLAN packet format WLAN 数据包格式 |
ruInfo | Resource unit allocation information 资源单元分配信息 |
showAllocation | Resource unit allocation 资源单位分配 |
transmitTime | Packet transmission time 数据包传输时间 |
Examples 例子
Create Multiuser HE Configuration Object
创建多用户 HE 配置对象
Create a 20 MHz multiuser HE configuration object with the allocation index set to 0. An allocation index of 0 specifies nine 26-tone RUs in a 20 MHz channel.
使用分配索引设置为 0 创建一个 20 MHz 的多用户 HE 配置对象。分配索引为 0 表示 20 MHz 频道中的九个 26-tone RU。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgMU = wlanHEMUConfig(0); for i=1:numel(cfgMU.User) % Set the APEPLength of each user cfgMU.User{i}.APEPLength = 100; end
Display the configuration object properties for the fourth user.
显示第四个用户的配置对象属性。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgMU.User{4}
ans = wlanHEMUUser with properties: APEPLength: 100 MCS: 0 NumSpaceTimeStreams: 1 DCM: 0 ChannelCoding: 'LDPC' STAID: 0 NominalPacketPadding: 0 PostFECPaddingSource: 'mt19937ar with seed' PostFECPaddingSeed: 4 Read-only properties: RUNumber: 4
Create HE MU Object Using Binary Allocation Indexing
使用二进制分配索引来创建 HE MU 对象
Create an HE MU configuration object for a 40 MHz transmission with an allocation index of 11000000
for each 20 MHz subchannel. This configuration specifies two 242-tone RUs, each with one user.
创建一个用于 40 MHz 传输的 HE MU 配置对象,每个 20 MHz 子通道的分配索引为11000000
。该配置指定两个 242-tone RUs,每个 RU 各有一个用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHEMU = wlanHEMUConfig(["11000000" "11000000"],'NumTransmitAntennas',2);
Configure the first RU and the first user.
配置第一个 RU 和第一个用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHEMU.RU{1}.SpatialMapping = 'Direct'; cfgHEMU.User{1}.APEPLength = 1e3; cfgHEMU.User{1}.MCS = 2; cfgHEMU.User{1}.NumSpaceTimeStreams = 2; cfgHEMU.User{1}.ChannelCoding = 'LDPC'; cfgHEMU.User{1}.NominalPacketPadding = 16;
Configure the second RU and the second user.
配置第二 RU 和第二个用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHEMU.RU{2}.SpatialMapping = 'Fourier'; cfgHEMU.User{2}.APEPLength = 500; cfgHEMU.User{2}.MCS = 3; cfgHEMU.User{2}.NumSpaceTimeStreams = 1; cfgHEMU.User{2}.ChannelCoding = 'LDPC'; cfgHEMU.User{2}.NominalPacketPadding = 8;
Display the configuration object properties for both RUs and both users.
显示 RUs 和两个用户的配置对象属性。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
disp(cfgHEMU)
wlanHEMUConfig with properties:
RU: {[1x1 wlanHEMURU] [1x1 wlanHEMURU]}
User: {[1x1 wlanHEMUUser] [1x1 wlanHEMUUser]}
NumTransmitAntennas: 2
STBC: 0
GuardInterval: 3.2000
HELTFType: 4
SIGBMCS: 0
SIGBDCM: 0
UplinkIndication: 0
BSSColor: 0
SpatialReuse: 0
TXOPDuration: 127
HighDoppler: 0
Read-only properties:
ChannelBandwidth: 'CBW40'
AllocationIndex: [192 192]
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHEMU.RU{1:2}
ans = wlanHEMURU with properties: PowerBoostFactor: 1 SpatialMapping: 'Direct' Read-only properties: Size: 242 Index: 1 UserNumbers: 1
ans = wlanHEMURU with properties: PowerBoostFactor: 1 SpatialMapping: 'Fourier' Read-only properties: Size: 242 Index: 2 UserNumbers: 2
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHEMU.User{1:2}
ans = wlanHEMUUser with properties: APEPLength: 1000 MCS: 2 NumSpaceTimeStreams: 2 DCM: 0 ChannelCoding: 'LDPC' STAID: 0 NominalPacketPadding: 16 PostFECPaddingSource: 'mt19937ar with seed' PostFECPaddingSeed: 1 Read-only properties: RUNumber: 1
ans = wlanHEMUUser with properties: APEPLength: 500 MCS: 3 NumSpaceTimeStreams: 1 DCM: 0 ChannelCoding: 'LDPC' STAID: 0 NominalPacketPadding: 8 PostFECPaddingSource: 'mt19937ar with seed' PostFECPaddingSeed: 2 Read-only properties: RUNumber: 2
Demonstrate SIGB Compression in HE MU Waveforms
在 HE MU 波形中展示 SIGB 压缩
HE MU-MIMO Configuration With SIGB Compression
HE MU-MIMO 配置与 SIGB 压缩
Generate a full bandwidth HE MU-MIMO configuration at 20 MHz bandwidth with SIGB compression. All three users are on a single content channel, which includes only the user field bits.
在 20 MHz 带宽下使用 SIGB 压缩生成一个全带宽 HE MU-MIMO 配置。所有三个用户位于单一内容信道上,该信道只包括用户字段位。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHE = wlanHEMUConfig(194);
cfgHE.NumTransmitAntennas = 3;
Create PSDU data for all users.
为所有用户创建 PSDU 数据。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
psdu = cell(1,numel(cfgHE.User)); psduLength = getPSDULength(cfgHE); for j = 1:numel(cfgHE.User) psdu = randi([0 1],psduLength(j)*8,1,'int8'); end
Generate and plot the waveform.
生成并绘制波形。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
y = wlanWaveformGenerator(psdu,cfgHE); plot(abs(y))
Generate a full bandwidth HE MU-MIMO waveform at 80 MHz bandwidth with SIGB compression. HE-SIG-B content channel 1 has four users. HE-SIG-B content channel 2 has three users.
在 80 MHz 带宽下使用 SIGB 压缩生成全带宽 HE MU-MIMO 波形。HE-SIG-B 内容信道 1 有四个用户。HE-SIG-B 内容信道 2 有三个用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHE = wlanHEMUConfig(214);
cfgHE.NumTransmitAntennas = 7;
Create PSDU data for all users.
为所有用户创建 PSDU 数据。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
psdu = cell(1,numel(cfgHE.User)); psduLength = getPSDULength(cfgHE); for j = 1:numel(cfgHE.User) psdu = randi([0 1],psduLength(j)*8,1,'int8'); end
Generate and plot the waveform.
生成并绘制波形。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
y = wlanWaveformGenerator(psdu,cfgHE); plot(abs(y));
HE MU-MIMO Configuration Without SIGB Compression
HE MU-MIMO 配置无 SIGB 压缩
Generate a full bandwidth HE MU-MIMO configuration at 20 MHz bandwidth without SIGB compression. All three users are on a single content channel, which includes both common and user field bits.
在 20 MHz 带宽下生成一个全带宽的 HE MU-MIMO 配置,不使用 SIGB 压缩。三个用户都在单个内容信道上,其中包括公共位和用户位。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHE = wlanHEMUConfig(194);
cfgHE.SIGBCompression = false;
cfgHE.NumTransmitAntennas = 3;
Create PSDU data for all users.
为所有用户创建 PSDU 数据。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
psdu = cell(1,numel(cfgHE.User)); psduLength = getPSDULength(cfgHE); for j = 1:numel(cfgHE.User) psdu = randi([0 1],psduLength(j)*8,1,'int8'); end
Generate and plot the waveform.
生成并绘制波形。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
y = wlanWaveformGenerator(psdu,cfgHE); plot(abs(y))
Generate an 80 MHz HE MU waveform for six users without SIGB compression. HE-SIG-B content channel 1 has four users. HE-SIG-B content channel 2 has two users.
为六个用户生成一个 80 MHz 的 HE MU 波形,不进行 SIGB 压缩。HE-SIG-B 内容通道 1 有四个用户。HE-SIG-B 内容通道 2 有两个用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHE = wlanHEMUConfig([202 114 192 193]); cfgHE.NumTransmitAntennas = 6; for i = 1:numel(cfgHE.RU) cfgHE.RU{i}.SpatialMapping = 'Fourier'; end
Create PSDU data for all users.
为所有用户创建 PSDU 数据。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
psdu = cell(1,numel(cfgHE.User)); psduLength = getPSDULength(cfgHE); for j = 1:numel(cfgHE.User) psdu = randi([0 1],psduLength(j)*8,1,'int8'); end
Generate and plot the waveform.
生成并绘制波形。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
y = wlanWaveformGenerator(psdu,cfgHE); plot(abs(y));
Generate a full bandwidth HE MU-MIMO waveform at 80 MHz bandwidth without SIGB compression. HE-SIG-B content channel 1 has seven users. HE-SIG-B content channel 2 has zero users.
在 80 MHz 带宽下生成一个无 SIGB 压缩的全带宽 HE MU-MIMO 波形。HE-SIG-B 内容信道 1 有七个用户。HE-SIG-B 内容信道 2 没有用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgHE = wlanHEMUConfig([214 115 115 115]);
cfgHE.NumTransmitAntennas = 7;
Create PSDU data for all users.
为所有用户创建 PSDU 数据。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
psdu = cell(1,numel(cfgHE.User)); psduLength = getPSDULength(cfgHE); for j = 1:numel(cfgHE.User) psdu = randi([0 1],psduLength(j)*8,1,'int8'); end
Generate and plot the waveform.
生成并绘制波形。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
y = wlanWaveformGenerator(psdu,cfgHE); plot(abs(y))
Create Multiuser HE Object for Three Users in One RU with SIG-B Compression
为一个 RU 中的三个用户创建使用 SIG-B 压缩的多用户 HE 对象
Create an 80 MHz MU-MIMO configuration with three users in a single RU with SIG-B compression. Display the configuration object properties.
在单个 RU 中创建一个带有 SIG-B 压缩的 80 MHz MU-MIMO 配置,其中包括三个用户。显示配置对象属性。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgMU = wlanHEMUConfig(210);
cfgMU.NumTransmitAntennas = 3;
cfgMU.User{1}.NumSpaceTimeStreams = 1;
cfgMU.User{2}.NumSpaceTimeStreams = 1;
cfgMU.User{3}.NumSpaceTimeStreams = 1;
disp(cfgMU)
wlanHEMUConfig with properties:
RU: {[1x1 wlanHEMURU]}
User: {[1x1 wlanHEMUUser] [1x1 wlanHEMUUser] [1x1 wlanHEMUUser]}
NumTransmitAntennas: 3
STBC: 0
GuardInterval: 3.2000
HELTFType: 4
SIGBMCS: 0
SIGBDCM: 0
UplinkIndication: 0
BSSColor: 0
SpatialReuse: 0
TXOPDuration: 127
HighDoppler: 0
Read-only properties:
ChannelBandwidth: 'CBW80'
AllocationIndex: 210
Create Multiuser HE Object Using Upper Center 26-Tone RU
使用上部中央的 26 音 RU 创建多用户 HE 对象
Create a 160 MHz configuration using the upper center 26-tone RU. A total of four RUs are created. The RU tone assignments are 996, 484, 484, and 26. One user is allocated to each RU. The last RU created is the center 26-tone RU. Display the configuration properties of the object.
使用上部中心 26-tone RU 创建 160 MHz 配置。总共创建四个 RU。 RU 音调分配是 996、484、484 和 26。 每个 RU 分配一个用户。 创建的最后一个 RU 是中心 26-tone RU。 显示对象的配置属性。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfgMU = wlanHEMUConfig([208 115 115 115 200 114 114 200], ... 'UpperCenter26ToneRU',true); cfgMU.RU{:}
ans = wlanHEMURU with properties: PowerBoostFactor: 1 SpatialMapping: 'Direct' Read-only properties: Size: 996 Index: 1 UserNumbers: 1
ans = wlanHEMURU with properties: PowerBoostFactor: 1 SpatialMapping: 'Direct' Read-only properties: Size: 484 Index: 3 UserNumbers: 2
ans = wlanHEMURU with properties: PowerBoostFactor: 1 SpatialMapping: 'Direct' Read-only properties: Size: 484 Index: 4 UserNumbers: 3
ans = wlanHEMURU with properties: PowerBoostFactor: 1 SpatialMapping: 'Direct' Read-only properties: Size: 26 Index: 56 UserNumbers: 4
Disable a User in an HE MU Transmission
在 HE MU 传输中禁用用户
This example shows how to disable a user in an HE MU transmission.
此示例显示如何在 HE MU 传输中禁用用户。
Create an HE MU configuration object with allocation index equal to 112
. This specifies four 52-tone RUs in a 20 MHz channel bandwidth. Each RU has one user.
创建一个具有分配索引等于112
的 HE MU 配置对象。这指定了一个 20 MHz 频道带宽中的四个 52-tone RU。每个 RU 都有一个用户。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfg = wlanHEMUConfig(112);
Display the allocation. 显示分配。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
showAllocation(cfg)
Set the STAID
property of the third user to 2046
. This specifies that the RU that corresponds to the third user transmits no data.
设置第三个用户的STAID
属性为2046
。这指定对应第三个用户的 RU 不传输数据。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
cfg.User{3}.STAID = 2046;
Display the allocation. 显示分配。
Copy openExample Command
Paste command in MATLAB to download and open example files- Open in MATLAB Online
showAllocation(cfg)
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.
物理层(PHY)协议数据单元(PPDU)是完整的物理层收敛过程(PLCP)帧,包括 PLCP 头、MAC 头、MAC 数据字段以及 MAC 和 PLCP 尾部。
RU and User Cell Arrays
RU 和用户单元阵列
When you create a wlanHEMUConfig
object, the properties
are set based on the chosen AllocationIndex
property and any name-value pairs you include. Upon creation of the object, RU
and User
cell arrays
are configured. The RU
cell array elements contain the configuration
properties for each RU. The User
cell array elements contain the
configuration properties for each user.
当您创建wlanHEMUConfig
对象时,属性会基于所选的AllocationIndex
属性以及您包括的任何名值对进行设置。在对象创建时,会配置RU
和User
单元数组。RU
单元数组元素包含每个 RU 的配置属性。User
单元数组元素包含每个用户的配置属性。
The UserNumbers
subproperty of the RU
property
indicates which users are transmitted on each RU. UserNumbers
属性的RU
子属性指示每个 RU 上传输的用户。
The RUNumber
subproperty of the User
property
indicates which RUs are used to transmit data for each user.RUNumber
子属性传输数据的User
属性指示哪些 RUs 用于每个用户。
As shown here, an RU can be assigned to multiple users.
如图所示,一个 RU 可以分配给多个用户。
After creating the object, you can modify some of the RU
and
User
properties, but other RU
and
User
properties are read-only. For more information about the
elements of the RU
cell array, see wlanHEMURU
. For more information about
the elements of the User
cell array, see wlanHEMUUser
.
创建对象后,您可以修改一些RU
和User
属性,但其他RU
和User
属性是只读的。有关RU
单元数组元素的更多信息,请参见wlanHEMURU
。有关User
单元数组元素的更多信息,请参见wlanHEMUUser
。
References 参考资料
[1] IEEE Std
802.11-2020 (Revision of IEEE Std 802.11-2016). “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer
(PHY) Specifications.” IEEE Standard for Information Technology —
Telecommunications and Information Exchange between Systems — Local and Metropolitan Area
Networks — Specific Requirements.
IEEE 标准 802.11-2020(IEEE 标准 802.11-2016 修订版)。"第 11 部分:无线局域网介质访问控制(MAC)和物理层(PHY)规范。"信息技术-系统之间的电信和信息交换的 IEEE 标准-本地和城域网-具体要求。
[2]
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.
IEEE Std 802.11ax™-2021(IEEE Std 802.11-2020 修订版)。“第 11 部分:无线局域网介质访问控制(MAC)和物理层(PHY)规范。修正案 1:高效率 WLAN 增强。”信息技术 - 系统之间的电信和信息交换的 IEEE 标准。本地和城域网 - 特定要求。
Extended Capabilities 扩展功能
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
C/C++ 代码生成使用 MATLAB® Coder™ 生成 C 和 C++ 代码。
You must specify the data type of the postFECPaddingBits
subproperty of the user
property as int8
.
您必须将 postFECPaddingBits
子属性的数据类型指定为 int8
。
Version History 版本历史
Introduced in R2018b 在 R2018b 中引入
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)