This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

wlanHESUConfig

Create single user HE format configuration object

Syntax

cfgHESU = wlanHESUConfig
cfgHESU = wlanHESUConfig(Name,Value)

Description

example

cfgHESU = wlanHESUConfig creates a configuration object that initializes parameters for a single user IEEE® 802.11™ high efficiency (HE) format PPDU. For a detailed description of the WLAN HE format, see IEEE 802.11ax™ [1].

example

cfgHESU = wlanHESUConfig(Name,Value) creates a single user HE format configuration object that overrides the default settings using one or more Name,Value pair arguments.

At runtime, the calling function validates object settings for properties relevant to the operation of the function.

Examples

collapse all

Create an HE single user configuration object for a 40MHz channel bandwidth. Display the configuration object properties.

cfgHE = wlanHESUConfig;
cfgHE.ChannelBandwidth = 'CBW40';
disp(cfgHE)
  wlanHESUConfig with properties:

       ChannelBandwidth: 'CBW40'
    NumTransmitAntennas: 1
    NumSpaceTimeStreams: 1
         SpatialMapping: 'Direct'
    PreHESpatialMapping: 0
                   STBC: 0
                    MCS: 0
                    DCM: 0
          ChannelCoding: 'LDPC'
             APEPLength: 100
          GuardInterval: 3.2000
              HELTFType: 4
       UplinkIndication: 0
               BSSColor: 0
           SpatialReuse: 0
           TXOPDuration: 127
            HighDoppler: 0

Create an HE extended range single user configuration object for a 20MHz channel bandwidth. Display the configuration object properties.

cfgHE = wlanHESUConfig('ExtendedRange',true);
disp(cfgHE)
  wlanHESUConfig with properties:

       ChannelBandwidth: 'CBW20'
          ExtendedRange: 1
         Upper106ToneRU: 0
    NumTransmitAntennas: 1
    NumSpaceTimeStreams: 1
         SpatialMapping: 'Direct'
    PreHESpatialMapping: 0
                   STBC: 0
                    MCS: 0
                    DCM: 0
          ChannelCoding: 'LDPC'
             APEPLength: 100
          GuardInterval: 3.2000
              HELTFType: 4
       UplinkIndication: 0
               BSSColor: 0
           SpatialReuse: 0
           TXOPDuration: 127
            HighDoppler: 0

Input Arguments

collapse all

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'ExtendedRange',true,'MCS',2 specifies an extended range single user HE format packet with the modulation and coding scheme set to 2.

Channel bandwidth, specified as 'CBW20', 'CBW40', 'CBW80', or 'CBW160'. The default value of 'CBW20' sets the channel bandwidth to 20 MHz.

Data Types: char | string

Enable extended range single user (SU) format, specified as a logical value. Set ExtendedRange to true to generate the HE extended range single user format packet.

Dependencies

This property applies only when you set the ChannelBandwidth property to 'CBW20'.

Data Types: logical

Enable higher frequency 106 RU tone, specified as a logical value. Set Upper106ToneRU to true to indicate that only the higher frequency 106 tone resource unit (RU) within the primary 20MHz channel bandwidth of an extended range single user transmission is used.

Dependencies

This property applies only when the ChannelBandwidth property is 'CBW20' and the ExtendedRange property is true.

Data Types: logical

Number of transmit antennas, specified as a positive integer in the interval [1, 8].

Data Types: double

Number of space-time streams (NSTS) in the transmission, specified as a positive integer in the interval [1, 8].

Data Types: double

Spatial mapping scheme, specified as 'Direct', 'Hadamard', 'Fourier', or 'Custom'. The default value 'Direct' applies when NumTransmitAntennas and NumSpaceTimeStreams are equal.

Data Types: char | string

Spatial mapping matrix, specified as a scalar, matrix, or 3-D array. Use this property to rotate and scale the output vector of the constellation mapper. The spatial mapping matrix is used for beamforming and mixing space-time streams over the transmit antennas.

  • When specified as a scalar, that scalar value applies to all the subcarriers.

  • When specified as a matrix, its size must be NSTS -by-NT. Where NSTS is the number of space-time streams, and NT is the number of transmit antennas. The spatial mapping matrix applies to all the subcarriers.

  • When specified as a 3-D array, its size must be NST-by-NSTS-by-NT. NST is the number of occupied subcarriers, as determined by ChannelBandwidth. NSTS is the number of space-time streams. NT is the number of transmit antennas. In this case, each data and pilot subcarrier can have its own spatial mapping matrix.

    The table shows the ChannelBandwidth setting and the corresponding NST.

    ChannelBandwidthNST
    'CBW20'242
    'CBW40'484
    'CBW80'996
    'CBW160'

    1992, configured as 2-by-996

    Each occupied subcarrier can have its own spatial mapping matrix.

The calling function normalizes the spatial mapping matrix for each subcarrier.

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

Dependencies

This property applies only when the SpatialMapping property is set to 'Custom'.

Data Types: double
Complex Number Support: Yes

Enable signalling of a transmission with beamforming, specified as a logical value. Beamforming is signalled when this property is set to true. The SpatialMappingMatrix property specifies the beamforming steering matrix.

Dependencies

This property applies only when the SpatialMapping property is set to 'Custom'.

Data Types: logical

Enable spatial mapping of the pre-HE-STF portion, specified as a logical value. Specify PreHESpactialMapping as true to spatially map the pre-HE-STF portion of the PPDU in the same way as the first symbol of the HE-LTF field on each tone. Specify PreHESpatialMapping as false to apply no spatial mapping to the pre-HE-STF portion of the PPDU.

Data Types: logical

Enable space-time block coding (STBC) of the PPDU data field, specified as a logical value. STBC transmits multiple copies of the data stream across assigned antennas.

  • When set to false, STBC is not applied to the data field, and the number of space-time streams is equal to the number of spatial streams.

  • When set to true, STBC is applied to the data field, and the number of space-time streams is double the number of spatial streams.

Dependencies

This property applies only when the NumSpaceTimeStreams property is 2 and the DCM property is false.

Data Types: logical

Modulation and coding scheme (MCS) used in transmitting the current packet, specified as a nonnegative integer in the interval [0, 11].

MCSModulationDual carrier Modulation (DCM)Coding Rate
0BPSK

0 or 1

1/2
1QPSK

0 or 1

1/2
2

Not applicable

3/4
316-QAM

0 or 1

1/2
43/4
564-QAM

Not applicable

2/3
63/4
75/6
8256-QAM3/4
95/6
101024-QAM3/4
115/6

For ExtendedRange, only

Dependencies

  • When ExtendedRange is true, only MCS settings 0, 1, and 2 are valid.

  • When Upper106ToneRU is true, only MCS setting 0 is valid.

Data Types: double

Enable dual carrier modulation (DCM) for HE-data field, specified as a logical value.

Dependencies

DCM can only be used when all of these conditions are satisfied:

Data Types: logical

Type of forward error correction coding for the data field, specified as 'LDPC' for low-density parity-check coding or 'BCC' for binary convolutional coding.

Dependencies

The 'BCC' value for ChannelCoding is valid only when all of these conditions are satisfied:

  • The MCS property is not 10 or 11.

  • The RU property is less than or equal to 242.

  • The NumSpaceTimeStreams property is less than or equal to 4.

Data Types: char | string

Number of bytes in the A-MPDU pre-EOF padding, specified as a nonnegative integer in the interval [0, 6500531].

APEPLength is used internally to determine the number of OFDM symbols in the data field. For more information, see 802.11ax 802.11-17/1001r4.

Data Types: double

Cyclic prefix length, in microseconds, for the data field within a packet, specified as 3.2, 1.6, or 0.8.

Data Types: double

HE-LTF compression mode of HE PPDU, specified as 4, 2 or 1. This value corresponds four times, two times, or one times HE-LTF duration compression mode, respectively. The HE-LTF type is enumerated in Table 28-1 of IEEE 802.11ax/D2.0 as:

  • 1x HE-LTF — For 3.2 μs with a guard interval duration of 0.8 μs or 1.6μs

  • 2x HE-LTF — For 6.4 μs with a guard interval duration of 0.8 μs or 1.6 μs

  • 4x HE-LTF — For 12.8 μs with a guard interval duration of 0.8 μs or 3.2 μs

Data Types: double

Uplink indication, specified as a logical value. Specify UplinkIndication as false to indicate that the PPDU is sent on a downlink transmission. Specify UplinkIndication as true to indicate that the PPDU is sent on an uplink transmission.

Data Types: logical

Basic service set (BSS) color identifier, specified as a nonnegative integer in the interval [0, 63].

Data Types: double

Spatial reuse indication, specified as a nonnegative integer in the interval [0, 15].

Data Types: double

Duration information for TXOP protection, specified as a nonnegative 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 28-18 of [1].

Data Types: double

High Doppler mode indication, specified as a logical value. Set HighDoppler to true to indicate high Doppler in HE-SIG-A.

Dependencies

The true value for this property is valid only when the NumSpaceTimeStreams property is less than or equal to 4 for any RU.

Data Types: logical

HE-data field midamble periodicity in the number of OFDM symbols, specified as 10 or 20.

Dependencies

This property applies only when HighDoppler is true.

Data Types: double

Output Arguments

collapse all

Single user HE PPDU configuration, returned as a wlanHESUConfig object. The properties of cfgHESU are described in wlanHESUConfig Properties.

More About

collapse all

PPDU

The physical layer convergence procedure (PLCP) protocol data unit (PPDU) is the complete PLCP frame, including PLCP headers, MAC headers, the MAC data field, and the MAC and PLCP trailers.

References

[1] IEEE Std P802.11ax™/D2.0 Draft 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 6: Enhancements for High Efficiency WLAN.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Introduced in R2018b