wlanUHRRU

R2026b

Configure resource units for Wi-Fi 8 multi-user transmission

Since R2026b

expand all in page

Description

The wlanUHRRU object contains properties that configure a WLAN ultra high-reliability (UHR) resource unit (RU). The RU property of a wlanUHRMUConfig object is a cell array of wlanUHRRU objects. For an OFDMA wlanUHRMUConfig object, the AllocationIndex property determines the RU property. For a non-OFDMA wlanUHEMUConfig object, the ChannelBandwidth property determines the RU property.

Creation

Syntax

cfgUHR.RU = wlanUHRRU(Size,Index,UserNumbers)
cfgUHR.RU = wlanUHRRU(___,PropertyName=Value)

Description

cfgUHR.RU = wlanUHRRU(Size,Index,UserNumbers) creates an object that contains properties to configure a UHR-format RU. The Size input is the RU size, Index is the RU index, and UserNumbers specifies the indices of users transmitted on the RU.

example

cfgUHR.RU = wlanUHRRU(___,PropertyName=Value) sets properties using one or more name-value arguments.

Properties

expand all

Power boost factor, specified as a scalar in the range [0.5, 2].

Data Types: double

Spatial mapping scheme, specified as "direct", "hadamard", "fourier", or "custom".

The default value, "direct", applies only when you set the NumTransmitAntennas property equal to the sum of the number of space-time streams for all users assigned to the RU.

Data Types: char | string | enumeration

Spatial mapping matrix, specified as one of these values:

  • A complex-valued scalar. This value applies to all the subcarriers.

  • A complex-valued matrix of size NSTSTotal -by-NT, where:

    • NSTSTotal is the sum of the number of the space-time streams for all users assigned to the RU;

    • NT is the number of transmit antennas.

    In this case, the spatial mapping matrix applies to all the subcarriers.

  • A complex-valued 3-D array of size Size-by-NSTSTotal-by-NT. The ChannelBandwidth property determines the value of the Size property. In this case, each occupied subcarrier has its own spatial mapping matrix.

Use this property to rotate and scale the output vector of the constellation mapper. The spatial mapping matrix controls beamforming and mixing space-time streams over the transmit antennas. The calling function normalizes the spatial mapping matrix for each subcarrier.

Example: [0.6 0.2; 0.5 0.4; 0.5 0.9] represents a spatial mapping matrix with three space-time streams and two transmit antennas.

Dependencies

This property applies only when you set the SpatialMapping property to "Custom".

Data Types: double
Complex Number Support: Yes

Enable beamforming by setting this property to true or 1. The SpatialMappingMatrix property specifies the beamform steering matrix.

Dependencies

This property applies only when you set the SpatialMapping property to "Custom".

Data Types: logical

Resource unit size, specified as a positive integer or a vector of positive integers. If the RU is an MRU, Size is a vector with entries given by the sizes of the RUs that make up the MRU. Otherwise, Size is a scalar. The possible RU sizes are 26, 52, 106, 242, 484, 968, 996, 1992, and 3984.

Note

This property is read-only after you create the object.

Data Types: double

Resource unit index, specified as an integer in the range [1, 144] or a vector of such integers. If the RU is an MRU, Index is a vector with entries given by the indices of the RUs that make up the MRU. Otherwise, Index is a scalar. Use this property to indicate the location of the RU within the channel.

Note

This property is read-only after you create the object.

Example: An 80 MHz transmission has four possible 242-tone RUs, one in each 20 MHz subchannel. RU 242-1 (Size = 242, Index = 1) is the RU occupying the lowest absolute frequency within the 80MHz, and RU 242-4 (Size = 242, Index = 4) is the RU occupying the highest absolute frequency.

Data Types: double

Indices of users transmitted on the RU, in one-based format, specified as an integer or a vector of integers. This property indexes the appropriate cell array element of the User property.

Note

This property is read-only after you create the object.

Data Types: double

Object Functions

Examples

collapse all

Open Live Script

Create a multi-user UHR configuration object with the allocation index set to 0. This setting specifies an OFDMA configuration with nine 26-tone RUs and nine users in a 20 MHz. Each RU has one user.

cfgUHRMU = wlanUHRMUConfig(0);

Display the RU information for the configuration.

ruInfo(cfgUHRMU)
ans = struct with fields:
                    NumUsers: 9
                      NumRUs: 9
                   RUIndices: {[1]  [2]  [3]  [4]  [5]  [6]  [7]  [8]  [9]}
                     RUSizes: {[26]  [26]  [26]  [26]  [26]  [26]  [26]  [26]  [26]}
               NumUsersPerRU: [1 1 1 1 1 1 1 1 1]
    NumSpaceTimeStreamsPerRU: [1 1 1 1 1 1 1 1 1]
       PowerBoostFactorPerRU: [1 1 1 1 1 1 1 1 1]
                   RUNumbers: [1 2 3 4 5 6 7 8 9]
                  RUAssigned: [1 1 1 1 1 1 1 1 1]

Change the SpatialMapping property of the first RU to "custom". Display the first RU.

cfgUHRMU.RU{1}.SpatialMapping = "custom";
disp(cfgUHRMU.RU{1})
  wlanUHRRU with properties:

        PowerBoostFactor: 1
          SpatialMapping: custom
    SpatialMappingMatrix: 1.0000 + 0.0000i
             Beamforming: 1

   Read-only properties:
                    Size: 26
                   Index: 1
             UserNumbers: 1

Version History

Introduced in R2026b

See Also

|