这是用户在 2024-11-7 9:54 为 https://ww2.mathworks.cn/help/wlan/ref/wlanhemuconfig.html?searchHighlight=wlanHEMUConfig&s_tid=srch... 保存的双语快照页面，由 沉浸式翻译 提供双语支持。了解如何保存？
Main Content 主要内容

wlanHEMUConfig

Configure HE MU transmission
配置 HE MU 传输

collapse all in page 在页面中折叠全部

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 语法

cfgHEMU = wlanHEMUConfig(AllocationIndex)
cfgHEMU = wlanHEMUConfig(AllocationIndex,Name,Value)

Description 描述

cfgHEMU = wlanHEMUConfig(AllocationIndex) creates 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]。

example 示例

cfgHEMU = wlanHEMUConfig(AllocationIndex,Name,Value) sets properties using one or more name-value pairs. Enclose each property name in quotation marks. For example, 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.
在运行时，调用函数验证与函数操作相关的属性的对象设置。

example 示例

Properties 属性

collapse all 全部折叠

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 子信道，如图所示。

    20 MHz subchannel puncturing for 160 MHz transmission

    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 子信道，如图所示。

    40 MHz subchannel puncturing for 160 MHz transmission

    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 to 114.
    要信号一个 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 or 115.
    为了在 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

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

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
数据类型： 逻辑型

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
数据类型： 逻辑型

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

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
数据类型: 单元格

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
数据类型: 双精度

Number of transmit antennas, specified as a positive integer.
传输天线数量，指定为正整数。

Data Types: double
数据类型: 双精度

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 the NumTransmitAntennas property to 16, the wlanHEMUConfig 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
数据类型: 双精度

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 the User property is 2.
    NumSpaceTimeStreams 属性的每个元素的子属性 User 是 2。

  • The MCS subproperty of each element of the User property is 0 (false).
    元素根据其 User 属性的每个子属性 MCS 是 0(false)。

  • No RU specifies multi-user multiple input/multiple output (MU-MIMO).
    没有 RU 指定多用户多输入/多输出（MU-MIMO）。

Data Types: logical
数据类型： 逻辑型

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
数据类型: 双精度

HE-LTF compression mode, specified as 4 or 2. This property indicates the type of HE-LTF, where a value of 4 or 2corresponds 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
数据类型: 双精度

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
数据类型： 逻辑型

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
数据类型: 双精度

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
数据类型： 逻辑型

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
数据类型： 逻辑型

Basic service set (BSS) color identifier, specified as an integer in the interval [0, 63].
基本服务集（BSS）颜色标识符，指定为区间[0, 63]内的整数。

Data Types: double
数据类型: 双精度

Spatial reuse indication, specified as an integer in the interval [0, 15].
空间重用指示，指定为区间[0,15]内的整数。

Data Types: double
数据类型: 双精度

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
数据类型: 双精度

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
数据类型： 逻辑型

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 对象功能

getNumPostFECPaddingBitsCalculate required number of post-FEC padding bits
计算所需的后 FEC 填充位数
getPSDULengthCalculate HE or WUR PSDU length
计算 HE 或 WUR PSDU 的长度
packetFormat WLAN packet format WLAN 数据包格式
ruInfoResource unit allocation information
资源单元分配信息
showAllocationResource unit allocation 资源单位分配
transmitTimePacket transmission time 数据包传输时间

Examples 例子

collapse all 全部折叠

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

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))

Figure contains an axes object. The axes object contains 3 objects of type line.

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));

Figure contains an axes object. The axes object contains 7 objects of type line.

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))

Figure contains an axes object. The axes object contains 3 objects of type line.

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));

Figure contains an axes object. The axes object contains 6 objects of type line.

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))

Figure contains an axes object. The axes object contains 7 objects of type line.

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

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)

Figure RU Assignment and Occupied Subcarriers contains an axes object. The axes object with ylabel Subcarrier Index contains 11 objects of type patch, line, text.

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)

Figure RU Assignment and Occupied Subcarriers contains an axes object. The axes object with ylabel Subcarrier Index contains 9 objects of type patch, line, text.

More About 更多关于

collapse all

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单元数组元素包含每个用户的配置属性。

RU and user cell arrays. The cell array shows the properties that the user can configure.

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 用于每个用户。

Read-only subproperties of RU and User. UserNumbers and RUNumber subproperties are highlighted.

As shown here, an RU can be assigned to multiple users.
如图所示，一个 RU 可以分配给多个用户。

Read-only subproperties of RU and User. UserNumbers and RUNumber subproperties are highlighted showing how an RU can be assigned to multiple users.

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 中引入

See Also 另请参阅

| |

Topics 话题