Documentation

This is machine translation

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

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

wlanS1GConfig

Create S1G format configuration object

Syntax

cfgS1G = wlanS1GConfig
cfgS1G = wlanS1GConfig(Name,Value)

Description

example

cfgS1G = wlanS1GConfig creates a configuration object that initializes parameters for an IEEE® 802.11™ sub 1 GHz (S1G) format PPDU.

example

cfgS1G = wlanS1GConfig(Name,Value) creates an S1G 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 S1G configuration object with default settings for a single user. Override the default by specifying a 4 MHz channel bandwidth and short preamble configuration.

cfgS1G = wlanS1GConfig;
cfgS1G.ChannelBandwidth = 'CBW4';
cfgS1G.Preamble = 'Short';
cfgS1G
cfgS1G = 

  wlanS1GConfig with properties:

       ChannelBandwidth: 'CBW4'
               Preamble: 'Short'
               NumUsers: 1
    NumTransmitAntennas: 1
    NumSpaceTimeStreams: 1
         SpatialMapping: 'Direct'
                   STBC: 0
                    MCS: 0
             APEPLength: 256
          GuardInterval: 'Long'
             PartialAID: 37
       UplinkIndication: 0
                  Color: 0
        TravelingPilots: 0
     ResponseIndication: 'None'
     RecommendSmoothing: 1

   Read-only properties:
          ChannelCoding: 'BCC'
             PSDULength: 261

Create an S1G configuration object that assigns a 2 MHz bandwidth and two users. Use a combination of Name,Value pairs and in-line initialization to change default settings. In vector-valued properties, each element applies to a specific user.

cfgMU = wlanS1GConfig('ChannelBandwidth','CBW2', ...
    'Preamble','Long', ...
    'NumUsers',2, ...
    'GroupID',2, ...
    'NumTransmitAntennas', 2);
cfgMU.NumSpaceTimeStreams = [1 1];
cfgMU.MCS = [4 8];
cfgMU.APEPLength = [1024 2048];
cfgMU
cfgMU = 

  wlanS1GConfig with properties:

       ChannelBandwidth: 'CBW2'
               Preamble: 'Long'
               NumUsers: 2
          UserPositions: [0 1]
    NumTransmitAntennas: 2
    NumSpaceTimeStreams: [1 1]
         SpatialMapping: 'Direct'
                    MCS: [4 8]
             APEPLength: [1024 2048]
          GuardInterval: 'Long'
                GroupID: 2
        TravelingPilots: 0
     ResponseIndication: 'None'

   Read-only properties:
          ChannelCoding: 'BCC'
             PSDULength: [1031 2065]

NumUsers is set to 2 and the user-dependent properties are two-element vectors.

Create an S1G configuration object with default settings for a single user and change the default property settings by using dot notation. Use the packetFormat object function to access the S1G packet format of the object.

Create an S1G configuration object with default settings. By default, the configuration object creates properties to model the short S1G packet format.

cfgS1G = wlanS1GConfig;
packetFormat(cfgS1G)
ans = 
'S1G-Short'

Modify the defaults by using the dot notation to specify a long preamble.

cfgS1G.Preamble = 'Long';
packetFormat(cfgS1G)
ans = 
'S1G-Long'

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 single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'ChannelBandwidth','CBW4','NumUsers',2 specifies a channel bandwidth of 4 MHz and two users for the S1G format packet.

collapse all

Channel bandwidth, specified as 'CBW1', 'CBW2', 'CBW4', 'CBW8', or 'CBW16'. If the transmission has multiple users, the same channel bandwidth is applied to all users.

Example: 'CBW16' sets the channel bandwidth to 16 MHz.

Data Types: char | string

Preamble type, specified as 'Short' or 'Long'. This property applies only when ChannelBandwidth is not 'CBW1'.

Data Types: char | string

Number of users, specified as 1, 2, 3, or 4. (NUsers)

Data Types: double

Position of users, specified as an integer row vector with length equal to NumUsers and element values from 0 to 3 in a strictly increasing order. This property applies when NumUsers > 1.

Example: [0 2 3] indicates positions for three users, where the first user occupies position 0, the second user occupies position 2, and the third user occupies position 3.

Data Types: double

Number of transmit antennas, specified as a scalar integer from 1 to 4.

Data Types: double

Number of space-time streams in the transmission, specified as a scalar or vector. (Nsts)

  • For a single user, the number of space-time streams is an integer scalar from 1 to 4.

  • For multiple users, the number of space-time streams is a 1-by-NUsers vector of integers from 1 to 4, where NUsers ≤ 4. The sum total of space-time streams for all users, Nsts_Total, must not exceed four.

Example: [1 1 2] indicates number of space-time streams for three users, where the first user gets 1 space-time stream, the second user gets 1 space-time stream, and the third user gets 2 space-time streams. The total number of space-time streams assigned is 4.

Data Types: double

Spatial mapping scheme, specified as 'Direct', 'Hadamard', 'Fourier', or 'Custom'. The default value of '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 apply a beamforming steering matrix, and to rotate and scale the constellation mapper output vector. If applicable, scale the space-time block coder output instead. SpatialMappingMatrix applies when the SpatialMapping property is set to 'Custom'. For more information, see IEEE Std 802.11-2012, Section 20.3.11.11.2.

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

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

  • When specified as a 3-D array, the size must be NST-by-NSTS_Total-by-NT. NST is the sum of the occupied data (NSD) and pilot (NSP) subcarriers, as determined by ChannelBandwidth. NSTS_Total is the sum of space-time streams for all users. NT is the number of transmit antennas.

    NST increases with channel bandwidth.

    ChannelBandwidthNumber of Occupied Subcarriers (NST)Number of Data Subcarriers (NSD)Number of Pilot Subcarriers (NSP)
    'CBW1'26242
    'CBW2'56524
    'CBW4'1141086
    'CBW8'2422348
    'CBW16'48446816

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 having two space-time streams and three transmit antennas.

Data Types: double
Complex Number Support: Yes

Enable beamforming in a long preamble packet, specified as a logical. Beamforming is performed when this setting is true. This property applies for a long preamble (Preamble = 'Long') with NumUsers = 1 and SpatialMapping  = 'Custom'. The SpatialMappingMatrix property specifies the beamforming steering matrix.

Data Types: logical

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

  • When set to false, no STBC is 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.

See IEEE 802.11ac™-2013, Section 22.3.10.9.4 for further description.

Note

STBC is relevant for single-user transmissions only.

Data Types: logical

Modulation and coding scheme used in transmitting the current packet, specified as a scalar or vector.

  • For a single user, the MCS value is a scalar integer from 0 to 10.

  • For multiple users, MCS is a 1-by-NUsers vector of integers or a scalar with values from 0 to 10, where NUsers ≤ 4.

MCSModulationCoding RateComment
0BPSK1/2 
1QPSK1/2 
2QPSK3/4 
316QAM1/2 
416QAM3/4 
564QAM2/3 
664QAM3/4 
764QAM5/6 
8256QAM3/4 
9256QAM5/6 
10BPSK1/2Applies only for ChannelBandwidth = 'CBW1'

Data Types: double

Number of bytes in the A-MPDU pre-EOF padding, specified as an integer scalar or vector.

  • For a single user, APEPLength is a scalar integer from 0 to 65,535.

  • For multiple users, APEPLength is a 1-by-NUsers vector of integers or a scalar with values from 0 to 65,535, where NUsers ≤ 4.

  • APEPLength = 0 for a null data packet (NDP).

APEPLength is used internally to determine the number of OFDM symbols in the data field.

Note

Only aggregated data transmission is supported.

Data Types: double

Cyclic prefix length for the data field within a packet, specified as 'Long' or 'Short'.

  • The long guard interval length is 800 ns.

  • The short guard interval length is 400 ns.

Note

For S1G, the first OFDM symbol within the data field always has a long guard interval, even when GuardInterval is set to 'Short'.

Data Types: char | string

Group identification number, specified as an integer scalar from 1 to 62. The group identification number is signaled during a multi-user transmission. Therefore this property applies for a long preamble (Preamble = 'Long') and when NumUsers is greater than 1.

Data Types: double

Abbreviated indication of the PSDU recipient, specified as an integer scalar from 0 to 511.

  • For an uplink transmission, the partial identification number is the last nine bits of the basic service set identifier (BSSID) and must be an integer from 0 to 511.

  • For a downlink transmission, the partial identification of a client is an identifier that combines the association ID with the BSSID of its serving AP and must be an integer from 0 to 63.

For more information, see IEEE Std 802.11ac-2013, Table 22-1.

Data Types: double

Enable uplink indication, specified as a logical. Set UplinkIndication to true for uplink transmission or false for downlink transmission. This property applies when ChannelBandwidth is not 'CBW1' and NumUsers = 1.

Data Types: logical

Access point (AP) color identifier, specified as an integer from 0 to 7. An AP includes a Color number for the basic service set (BSS). An S1G station (STA) can use the Color setting to determine if the transmission is within a BSS it is associated with. An S1G STA can terminate the reception process for transmissions received from a BSS that it is not associated with. This property applies when ChannelBandwidth is not 'CBW1', NumUsers = 1, and UplinkIndication = false.

Data Types: double

Enable traveling pilots, specified as a logical. Set TravelingPilots to true for nonconstant pilot locations. Traveling pilots allow a receiver to track a changing channel due to Doppler spread.

Data Types: logical

Response indication type, specified as 'None', 'NDP', 'Normal', or 'Long'. This information is used to indicate the presence and type of frame that will be sent a short interframe space (SIFS) after the current frame transmission. The response indication field is set based on the value of ResponseIndication and transmitted in;

  • The SIG2 field of the S1G_SHORT preamble

  • The SIG-A-2 field of the S1G_LONG preamble

  • The SIG field of the S1G_1M preamble

Data Types: char | string

Recommend smoothing for channel estimation, specified as a logical.

  • If the frequency profile is nonvarying across the channel , the receiver sets this property to true. In this case, frequency-domain smoothing is recommended as part of channel estimation.

  • If the frequency profile varies across the channel, the receiver sets this property to false. In this case, frequency-domain smoothing is not recommended as part of channel estimation.

Data Types: logical

Output Arguments

collapse all

S1G PPDU configuration, returned as a wlanS1GConfig object. The properties of cfgS1G are described in wlanS1GConfig 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.

Extended Capabilities

Introduced in R2016b

Was this topic helpful?