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.

wlanDMGConfig

Create DMG format configuration object

Syntax

cfgDMG = wlanDMGConfig
cfgDMG = wlanDMGConfig(Name,Value)

Description

example

cfgDMG = wlanDMGConfig creates a configuration object that initializes parameters for an IEEE® 802.11™ directional multi-gigabit (DMG) format PPDU.

example

cfgDMG = wlanDMGConfig(Name,Value) creates a DMG 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

cfgDMG = wlanDMGConfig
cfgDMG = 

  wlanDMGConfig with properties:

                        MCS: 0
             TrainingLength: 0
                 PSDULength: 1000
    ScramblerInitialization: 2
                 Turnaround: 0

Create a DMG configuration object and use Name,Value pairs to override default settings.

dtpgrouppairs = (randperm(42)-1)';
cfgDMG = wlanDMGConfig('MCS',13,'TonePairingType','Dynamic', ...
    'DTPGroupPairIndex',dtpgrouppairs)
cfgDMG = 

  wlanDMGConfig with properties:

                        MCS: 13
             TrainingLength: 0
            TonePairingType: 'Dynamic'
          DTPGroupPairIndex: [42x1 double]
               DTPIndicator: 0
                 PSDULength: 1000
    ScramblerInitialization: 2
             AggregatedMPDU: 0
                   LastRSSI: 0
                 Turnaround: 0

Create DMG configuration objects and change the default property settings by using dot notation. Use the phyType object function to access the DMG PHY modulation type.

Create a DMG configuration object and return the DMG PHY modulation type. By default, the configuration object creates properties to model the DMG control PHY.

dmg = wlanDMGConfig;
phyType(dmg)
ans = 
'Control'

Model the SC PHY by modifying the defaults by using the dot notation to specify an MCS of 5.

dmg.MCS = 5;
phyType(dmg)
ans = 
'SC'

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: 'MCS','13','TrainingLength',4 specifies a modulation and coding scheme of 13, which indicates OFDM PHY modulation and code rate of 1/2. Also, a PPDU with four training fields is specified for the DMG format packet.

collapse all

Modulation and coding scheme index, specified as an integer from 0 to 24. The MCS index indicates the modulation and coding scheme used in transmitting the current packet.

  • Modulation and coding scheme for control PHY

    MCS IndexModulationCoding RateComment

    0

    DBPSK

    1/2

    Code rate and data rate might be lower due to codeword shortening.

  • Modulation and coding schemes for single-carrier modulation

    MCS IndexModulationCoding RateNCBPSRepetition

    1

    π/2 BPSK

    1/2

    1

    2

    2

    1/2

    1

    3

    5/8

    4

    3/4

    5

    13/16

    6

    π/2 QPSK

    1/2

    2

    7

    5/8

    8

    3/4

    9

    13/16

    10

    π/2 16QAM

    1/2

    4

    11

    5/8

    12

    3/4

    NCBPS is the number of coded bits per symbol.

  • Modulation and coding schemes for OFDM modulation

MCS IndexModulationCoding RateNBPSCNCBPSNDBPS

13

SQPSK

1/2

1

336

168

14

5/8

210

15

QPSK

1/2

2

672

336

16

5/8

420

17

3/4

504

18

16QAM

1/2

4

1344

672

19

5/8

840

20

3/4

1008

21

13/16

1092

22

64QAM

5/8

6

2016

1260

23

3/4

1512

24

13/16

1638

NBPSC is the number of coded bits per single carrier.

NCBPS is the number of coded bits per symbol.

NDBPS is the number of data bits per symbol.

Data Types: double

Number of training fields, specified as an integer from 0 to 64. TrainingLength must be a multiple of four.

Data Types: double

Packet training field type, specified as 'TRN-R' or 'TRN-T'. This property applies when TrainingLength > 0.

'TRN-R' indicates that the packet includes or requests receive-training subfields and 'TRN-T' indicates that the packet includes transmit-training subfields.

Data Types: char | string

Request beam tracking, specified as a logical. Setting BeamTrackingRequest to true indicates that beam tracking is requested. This property applies when TrainingLength > 0.

Data Types: logical

Tone pairing type, specified as 'Static' or 'Dynamic'. This property applies when MCS is from 13 to 17. Specifically, TonePairingType applies when using OFDM and either SQPSK or QPSK modulation.

Data Types: char | string

DTP group pair index, specified as a 42-by-1 integer vector for each pair. Element values must be from 0 to 41, with no duplicates. This property applies when MCS is from 13 to 17 and when TonePairingType is 'Dynamic'.

Data Types: double

DTP update indicator, specified as a logical. Toggle DTPIndicator between packets to indicate that the dynamic tone pair mapping has been updated. This property applies when MCS is from 13 to 17 and when TonePairingType is 'Dynamic'.

Data Types: logical

Number of bytes carried in the user payload, specified as an integer from 1 to 262,143.

Data Types: double

Initial scrambler state of the data scrambler for each packet generated, specified as an integer from 1 to 127. When MCS is 0, the initial scrambler state is limited to values from 1 to 15. The default value of 2 is the example state given in IEEE Std 802.11-2012, Amendment 3, Section L.5.2.

Data Types: double | int8

MPDU aggregation indicator, specified as a logical. Setting AggregatedMPDU to true indicates that the current packet uses A-MPDU aggregation.

Data Types: logical

Received power level of the last packet, specified as an integer from 0 to 15.

When transmitting a response frame immediately following a short interframe space (SIFS) period, a DMG STA sets the LastRSSI as specified in IEEE 802.11ad™-2012, Section 9.3.2.3.3, to map to the TXVECTOR parameter LAST_RSSI of the response frame to the power that was measured on the received packet, as reported in the RCPI field of the frame that elicited the response frame. The encoding of the value for TXVECTOR is as follows:

  • Power values equal to or above –42 dBm are represented as the value 15.

  • Power values between –68 dBm and –42 dBm are represented as round((power – (–71 dBm))/2).

  • Power values less than or equal to –68 dBm are represented as the value of 1.

  • For all other cases, the DMG STA shall set the TXVECTOR parameter LAST_RSSI of the transmitted frame to 0.

The LAST_RSSI parameter in RXVECTOR maps to LastRSSI and indicates the value of the LAST_RSSI field from the PCLP header of the received packet. The encoding of the value for RXVECTOR is as follows:

  • A value of 15 represents power greater than or equal to –42 dBm.

  • Values from 2 to 14 represent power levels (–71+value×2) dBm.

  • A value of 1 represents power less than or equal to –68 dBm.

  • A value of 0 indicates that the previous packet was not received during the SIFS period before the current transmission.

For more information, see IEEE 802.11ad-2012, Section 21.2.

Data Types: double

Turnaround indication, specified as a logical. Setting Turnaround to true indicates that the STA is required to listen for an incoming PPDU immediately following the transmission of the PPDU. For more information, see IEEE 802.11ad-2012, Section 9.3.2.3.3.

Data Types: logical

Output Arguments

collapse all

DMG PPDU configuration, returned as a wlanDMGConfig object. The properties of cfgDMG are described in wlanDMGConfig 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 802.11ad™-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 — Amendment 3: Enhancements for Very High Throughput in the 60 GHz Band.

Extended Capabilities

Introduced in R2017a

Was this topic helpful?