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 Properties

Define parameter values for S1G format packet

The wlanS1GConfig object specifies the transmission properties for the IEEE® 802.11 sub 1 GHz (S1G) format physical layer (PHY) packet.

After you create an object, use dot notation to change or access the object parameters. For example:

Create a wlanS1GConfig object. Then modify the default setting for the ChannelBandwidth property.

cfgS1G = wlanS1GConfig;
cfgS1G.ChannelBandwidth = 'CBW2';

S1G Format Configuration

expand 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

This property is read-only.

Type of forward error correction coding for the data field, specified as 'BCC'. Only binary convolutional coding is supported.

Data Types: char | cell

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

This property is read-only.

Number of bytes carried in the user payload, including the A-MPDU and any MAC padding, specified as an integer scalar or vector. For a null data packet (NDP), the PSDU length is zero.

  • For a single user, the PSDU length is a scalar integer from 1 to 1,048,575.

  • For multiple users, the PSDU length is a 1-by-NUsers vector of integers from 1 to 65,535, where NUsers ≤ 4.

  • When undefined, PSDULength is returned as an empty, []. This can happen when the set of property values for the object are in an invalid state.

PSDULength is calculated internally based on the APEPLength property and other coding-related properties. It is accessible only by direct property call.

Example: [1031 2065] is the PSDU length vector for a wlanS1GConfig object with two users, where the MCS for the first user is 4 and the MCS for the second user is 8.

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

References

[1] IEEE Std 802.11ac™-2013 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 4: Enhancements for Very High Throughput for Operation in Bands below 6 GHz.

[2] IEEE Std 802.11™-2012 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.

Introduced in R2016b

Was this topic helpful?