wlanUHRELRConfig

R2026b

Configure Wi-Fi 8 enhanced long range transmission

Since R2026b

Description

The wlanUHRELRConfig object is a configuration object for the WLAN ultra high-reliability enhanced long range (UHR ELR) packet format.

Creation

Syntax

cfgUHRELR = wlanUHRELRConfig

cfgUHRELR = wlanUHRELRConfig(PropertyName=Value)

Description

cfgUHRELR = wlanUHRELRConfig creates a configuration object that initializes transmit parameters for an IEEE^® 802.11bn™ (Wi-Fi^® 8) UHR ELR PPDU. For a detailed description of the UHR ELR format, see IEEE P802.11bn [1].

cfgUHRELR = wlanUHRELRConfig(PropertyName=Value) sets properties using one or more name-value arguments. For example, wlanUHRELRConfig(MCS=1) specifies modulation and coding scheme 1.

Properties

APEPLength — APEP length

100 (default) | integer in the range [0, 2241]

Aggregated MPDU (A-MPDU) pre-end-of-frame (pre-EOF) padding (APEP) length, in bytes, specified as an integer in the range [0, 2241].

The object uses this property to determine the number of OFDM symbols in the data field. For more information, see IEEE P802.11bn [1].

Data Types: double

MCS — MCS used for transmission

0 (default) | 1

Modulation and coding scheme (MCS) used for transmission, specified as 0 or 1. Specify 0 for binary phase-shift keying (BPSK) and 1 for quadrature phase-shift keying (QPSK). The coding rate is 1/2 in both cases.

Data Types: double

ChannelCoding — Forward error correction coding type

"ldpc" (default) | "bcc"

Forward-error-correction (FEC) coding type for the UHR-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 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

NumTransmitAntennas — Number of transmit antennas

1 (default) | positive integer

Number of transmit antennas, specified as a positive integer.

Data Types: double

PreUHRCyclicShifts — Cyclic shift values of additional transmit antennas

-75 (default) | integer in the range [–200, 0] | row vector

Cyclic shift values, in nanoseconds, of additional transmit antennas for the pre-UHR fields of the waveform. The first eight antennas use the cyclic shift values specified in Table 21-10 of IEEE Std 802.11™-2024 [3]. The remaining L antennas use the values that you specify in this property, where L = NumTransmitAntennas – 8. Specify this property as one of these values:

• An integer in the range [–200, 0] — the wlanUHRELRConfig object uses this cyclic shift value for each of the L additional antennas.

• A row vector of length L of integers in the range [–200, 0] — the wlanUHRELRConfig object uses the kth element as the cyclic shift value for the (k + 8)th transmit antenna.

  Note

  If you specify this property as a row vector of length greater than L, the wlanUHRELRConfig object uses only the first L elements. For example, if you set the NumTransmitAntennas property to 16, the wlanUHRELRConfig object uses only the first L = 16 – 8 = 8 elements of this vector.

Dependencies

To enable this property, set the NumTransmitAntennas property to a value greater than 8.

Data Types: double

SpatialMapping — Spatial mapping scheme

"direct" (default) | "hadamard" | "fourier" | "custom"

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

SpatialMappingMatrix — Spatial mapping matrix

1 (default) | complex-valued scalar | complex-valued row vector | complex-valued 3-D array

Spatial mapping matrix, specified as one of these values:

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

• A complex-valued row vector of length  N_T, where N_T 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 N_ST-by-1-by-N_T, N_ST where is the number of subcarriers. 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

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 37.13.1.1 of 802.11bn [1]. The 11 least significant bits (LSBs) of the AID field are used to address the STA. When you set this property to 2046, the associated RU carries no data.

Data Types: double

UplinkIndication — Uplink indication

false or 0 (default) | true or 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).

Data Types: logical

BSSColor — Basic service set color identifier

1 (default) | integer in the range [1, 63]

Basic service set (BSS) color identifier, specified as an integer in the range [1, 63].

Data Types: double

TXOPDuration — Duration information for TXOP protection

[] (default) | integer in the range [0, 8448]

Duration information for transmit opportunity (TXOP) protection, specified as an integer in the range [0, 8448]. This property represents a duration in microseconds. In the TXOP subfield of the U-SIG field, these durations are represented by integers in the range [0, 127]. Therefore, a duration in microseconds must be converted using the procedure given in Table 38-1 of 802.11bn [1]. The default, [], indicates that no information is specified. In this case, the TXOP subfield of the U-SIG field is set to 127.

Data Types: double

ChannelBandwidth — Channel bandwidth

Read-only: 'CBW20' (default)

This property is read-only.

Channel bandwidth, represented as 'CBW20'. The only possible channel bandwidth for ELR transmissions is 20 MHz.

Data Types: char | string

NumSpaceTimeStreams — Number of space-time streams

Read-only: 1 (default)

This property is read-only.

Number of space-time streams, represented as 1. The only possible number of space-time streams for ELR transmissions is one.

Data Types: double

GuardInterval — Guard range (cyclic prefix) duration

Read-only: 1.6 (default)

This property is read-only.

Guard range (cyclic prefix) duration for the data field within a packet, in microseconds, represented as 1.6. The only possible guard range duration for ELR transmissions is 1.6 μs.

Data Types: double

UHRLTFType — UHR-LTF compression mode

Read-only: 2 (default)

This property is read-only.

UHR long training field (UHR-LTF) compression mode, represented as 2. This value corresponds to the 2 × UHR-LTF compression mode, which is the only possible compression mode for ELR transmissions. The UHR-LTF type is defined in Table 38-18 of 802.11bn [1]. The duration of each OFDM symbol including guard interval in the UHR-LTF field is equal to 6.4+1.6 = 8μs.

For more information on the UHR-LTF, see Section 38.3.15.11 of 802.11bn [1].

Data Types: double

NumUHRLTFSymbols — Number of UHR-LTF symbols

Read-only: 2 (default)

This property is read-only.

Number of UHR-LTF symbols, represented as 2 In ELR transmissions, the only possible number of UHR-LTF symbols is two.

Data Types: double

Object Functions

psduLength	PSDU length
packetFormat	WLAN packet format
ruInfo	Resource unit allocation information
showAllocation	Resource unit allocation
transmitTime	Packet transmission time
compressionMode	Compression mode of UHR or EHT configuration

Examples

Create UHR ELR Configuration Object

Create a UHR ELR configuration object with default parameters.

cfg = wlanUHRELRConfig;

Display the resource unit allocation. This packet format increases reliability at the expense of the data rate by using fourfold repetitions of resource units.

showAllocation(cfg)

References

[1] IEEE P802.11bn/D1.4. “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 6: Enhancements for ultra high reliability (UHR).” Draft Standard for Information Technology — Telecommunications and Information Exchange between Systems — Local and Metropolitan Area Networks — Specific Requirements

[2] IEEE Std 802.11be™-2024 “IEEE Standard for Information Technology — Telecommunications and Information Exchange between Systems — Local and Metropolitan Area Networks — Specific Requirements — Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 2: Enhancements for Extremely High Throughput (EHT).” https://ieeexplore.ieee.org/document/11090080

[3] IEEE Std 802.11-2024 (Revision of IEEE Std 802.11-2020). “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. https://ieeexplore.ieee.org/document/10979691

Version History

Introduced in R2026b