wlanS1GConfig

Create S1G format configuration object

Syntax

cfgS1G = wlanS1GConfig

cfgS1G = wlanS1GConfig(Name,Value)

Description

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

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

Create wlanS1GConfig Object for Single User

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 wlanS1GConfig Object for Two Users

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 wlanS1GConfig Object and Return Packet Format

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

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: 'ChannelBandwidth','CBW4','NumUsers',2 specifies a channel bandwidth of 4 MHz and two users for the S1G format packet.

'ChannelBandwidth' — Channel bandwidth

'CBW2' (default) | 'CBW1' | 'CBW4' | 'CBW8' | 'CBW16'

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' — Preamble type

'Short' (default) | 'Long'

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

Data Types: char | string

'NumUsers' — Number of users

1 (default) | 2 | 3 | 4

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

Data Types: double

'UserPositions' — Position of users

[0 1] (default) | row vector of integers from 0 to 3 in strictly increasing order

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

'NumTransmitAntennas' — Number of transmit antennas

1 (default) | integer from 1 to 4

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

Data Types: double

'NumSpaceTimeStreams' — Number of space-time streams

1 (default) | integer from 1 to 4 | 1-by-N_Users vector of integers from 1 to 4

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

• 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-N_Users vector of integers from 1 to 4, where N_Users ≤ 4. The sum total of space-time streams for all users, N_{sts_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

'SpatialMapping' — Spatial mapping scheme

'Direct' (default) | 'Hadamard' | 'Fourier' | 'Custom'

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

'SpatialMappingMatrix' — Spatial mapping matrix

1 (default) | scalar | matrix | 3-D array

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 N_{STS_Total}-by-N_T. The spatial mapping matrix applies to all the subcarriers. N_{STS_Total} is the sum of space-time streams for all users, and N_T is the number of transmit antennas.

• When specified as a 3-D array, the size must be N_ST-by-N_{STS_Total}-by-N_T. N_ST is the sum of the occupied data (N_SD) and pilot (N_SP) subcarriers, as determined by ChannelBandwidth. N_{STS_Total} is the sum of space-time streams for all users. N_T is the number of transmit antennas.

  N_ST increases with channel bandwidth.

  ChannelBandwidth	Number of Occupied Subcarriers (NST)	Number of Data Subcarriers (NSD)	Number of Pilot Subcarriers (NSP)
  'CBW1'	26	24	2
  'CBW2'	56	52	4
  'CBW4'	114	108	6
  'CBW8'	242	234	8
  'CBW16'	484	468	16

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

'Beamforming' — Enable beamforming in a long preamble packet

true (default) | false

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

'STBC' — Enable space-time block coding

false (default) | true

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

'MCS' — Modulation and coding scheme

0 (default) | integer from 0 to 10 | 1-by-N_Users vector of integers

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-N_Users vector of integers or a scalar with values from 0 to 10, where N_Users ≤ 4.

MCS	Modulation	Coding Rate	Comment
0	BPSK	1/2
1	QPSK	1/2
2	QPSK	3/4
3	16QAM	1/2
4	16QAM	3/4
5	64QAM	2/3
6	64QAM	3/4
7	64QAM	5/6
8	256QAM	3/4
9	256QAM	5/6
10	BPSK	1/2	Applies only for ChannelBandwidth = 'CBW1'

Data Types: double

'APEPLength' — Number of bytes in the A-MPDU pre-EOF padding

256 (default) | nonnegative integer | vector of nonnegative integers

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

• For a single user, APEPLength is a nonnegative integer in the interval [0, 2¹⁶ – 1].

• For multi-user, APEPLength is a 1-by-N_Users vector of nonnegative integers, where N_Users is an integer in [1, 4]. The entries in APEPLength are integers in the interval [0, 2¹⁶ – 1].

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

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

'GuardInterval' — Cyclic prefix length for the data field within a packet

'Long' (default) | 'Short'

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

'GroupID' — Group identification number

1 (default) | integer from 1 to 62

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

'PartialAID' — Abbreviated indication of the PSDU recipient

37 (default) | integer from 0 to 511

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

'UplinkIndication' — Enable uplink indication

false (default) | true

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

'Color' — Access point color identifier

0 (default) | integer scalar from 0 to 7

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

'TravelingPilots' — Enable traveling pilots

false (default) | true

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

'ResponseIndication' — Response indication type

'None' (default) | 'NDP' | 'Normal' | 'Long'

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

'RecommendSmoothing' — Recommend smoothing for channel estimation

true (default) | false

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

cfgS1G — S1G PPDU configuration

wlanS1GConfig object

S1G PPDU configuration, returned as a wlanS1GConfig object. The properties of cfgS1G are described in wlanS1GConfig Properties.

More About

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

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