wlanDMGConfig

Create DMG-format configuration object

Description

The wlanDMGConfig object is a directional-multi-gigabit-format (DMG-format) configuration object for the WLAN DMG packet format.

Creation

Description

example

cfgDMG = wlanDMGConfig creates cfgDMG, a configuration object that initializes parameters for an IEEE® 802.11™ DMG-format PPDU.

example

cfgDMG = wlanDMGConfig(Name,Value) sets properties using one or more name-value pairs. Enclose each property name in quotation marks. For example, wlanDMGConfig('MCS','13','TrainingLength',4) specifies a DMG format with these properties:

  • A modulation and coding scheme corresponding to orthogonal frequency division multiplexing (OFDM) physical layer (PHY) modulation and a coding rate of ½

  • A PPDU with four training fields

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

Properties

expand all

Modulation and coding scheme (MCS) used for transmission, specified as an integer in the interval [0, 24], or as one of the extended MCS values: '9.1', '12.1', '12.2', '12.3', '12.4','12.5', or '12.6'. Specify an extended (non-integer) MCS value as a character vector or string scalar. Specify an integer MCS value as a character vector, string scalar, or integer. The value of this property indicates the MCS used in transmitting the current packet in accordance with these tables:

  • Control PHY:

    MCSModulationCoding RateComment

    0

    Differential binary phase-shift keying (DBPSK)

    1/2

    The coding rate may be lower due to codeword shortening.

  • Single-carrier modulation:

    MCSModulationCoding RateNCBPSRepetition

    1

    π/2-BPSK

    1/2

    1

    2

    2

    1/2

    1

    3

    5/8

    4

    3/4

    5

    13/16

    6

    π/2 quadrature phase-shift keying (π/2-QPSK)

    1/2

    2

    7

    5/8

    8

    3/4

    9

    13/16

    9.1

    7/8

    10

    π/2-16-point quadrature amplitude modulation (π/2-16-QAM)

    1/2

    4

    11

    5/8

    12

    3/4

    12.1

    13/16

    12.2

    7/8

    12.3

    π/2-64QAM

    5/8

    6

    12.4

    3/4

    12.5

    13/16

    12.6

    7/8

    NCBPS is the number of coded bits per symbol.

  • OFDM modulation:

MCSModulationCoding RateNBPSCNCBPSNDBPS

13

Staggered QPSK (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

16-QAM

1/2

4

1344

672

19

5/8

840

20

3/4

1008

21

13/16

1092

22

64-QAM

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 | char | string

Number of training fields, specified as a multiple of four in the interval [0, 64].

Data Types: double

Packet training field type, specified as one of these values:

  • 'TRN-R' – Indicates that the packet includes or requests receive-training subfields

  • 'TRN-T' – Indicates that the packet includes transmit-training subfields

Dependencies

This property applies only when the value of the TrainingLength property is positive.

Data Types: char | string

Beam tracking request indicator, specified as a numeric or logical value of 1 (true) or 0 (false). To indicate that beam tracking is requested, set this property to 1 (true).

Dependencies

This property applies only when the value of the TrainingLength property is positive.

Data Types: logical

Tone pairing type, specified as 'Static' or 'Dynamic'.

Dependencies

This property applies only when the MCS property is in the interval [13, 17], specifying OFDM modulation with either SQPSK or QPSK.

Data Types: char | string

Dynamic tone pairing (DTP) group pair index, specified as a 42-by-1 vector of integers in the interval [0, 41] with no duplicated elements. Specify one vector for each pair.

Dependencies

This property applies only when the MCS property is in the interval [13, 17] and when the TonePairingType property is 'Dynamic'.

Data Types: double

DTP update indicator, specified as a numeric or logical value of 1 (true) or 0 (false). To indicate that the DTP mapping has been updated, set this property to 1 (true).

Dependencies

This property applies only when the MCS property is in the interval [13, 17] and when the TonePairingType property is 'Dynamic'.

Data Types: logical

Physical layer convergence procedure (PLCP) service data unit (PSDU) length, in bytes, specified as an integer in the interval [1, 218].

Data Types: double

Initial scrambler state of the data scrambler for each packet generated, specified as an integer in the interval [0, 127] or a corresponding binary column vector. For example, you can set the initial scrambler state to 26 by specifying 'ScramblerInitialization',26 or 'ScramblerInitialization',[1;1;0;1;0]. The value of the MCS property determines the values to which you can set this property.

  • If you set MCS to 0, specify this property as an integer in the interval [0, 15] or a 4-by-1 binary column vector.

  • If you set MCS to '9.1', '12.1', '12.2', '12.3', '12.4', '12.5', or '12.6', specify this property as an integer in the interval [0, 31] or a 5-by-1 binary column vector.

  • If you set MCS, specify this property as an integer in the interval [0, 127] or a 7-by-1 column vector.

The default value of 2 is the example state given in Section L.5.2 of [1].

Data Types: double | int8

MPDU aggregation indicator, specified as a logical value of 1 (true) or 0 (false). To indicate that the current packet contains aggregated MPDUs (A-MPDUs), set this property to 1 (true).

Dependencies

This property applies only when you set the MCS property to a value other than 0.

Data Types: logical

Received power level of the last packet, specified as an integer in the interval [0, 15]. This property corresponds to the LAST_RSSI parameter within the TXVECTOR or RXVECTOR field.

When transmitting a response frame immediately following a short interframe space (SIFS) period, a DMG STA sets the LAST_RSSI parameter of TXVECTOR as specified in Section 9.3.2.3.3 of [1].

  • To represent power values greater than or equal to –42 dBm, set this property to 15 .

  • To represent power values p between –68 dBm and –42 dBm, set this property to a value v in the interval [2, 14]. The values of p and v are related by v = round((p – (–71 dBm))/2).

  • To represent power values less than or equal to –68 dBm, set this property to 1.

  • To indicate that the last packet was not received following a SIFS period, set this property to 0.

The LAST_RSSI parameter of RXVECTOR indicates the received power level of the last packet with a valid PHY header according to Table 21-1 of [1].

  • To represent power values greater than or equal to –42 dBm, set this property to 15 .

  • To represent power values p between –68 dBm and –42 dBm, set this property to a value v in the interval [2, 14]. The values of p and v are related by v = round((p – (–71 dBm))/2).

  • To represent power values less than or equal to –68 dBm, set this property to 1.

  • To indicate that the previous packet was not received during the SIFS period before the current transmission, set this property to 0.

Dependencies

This property applies only when you set the MCS property to a value other than 0.

Data Types: double

Turnaround indication, specified as a logical value of 1 (true) or 0 (false). To indicate that the STA is required to listen for an incoming PPDU immediately following the transmission of the PPDU, set this property to 1 (true). For more information, see Section 9.3.2.3.3 of [1].

Data Types: logical

Object Functions

phyType Return DMG PHY modulation type

Examples

collapse all

cfgDMG = wlanDMGConfig
cfgDMG = 
  wlanDMGConfig with properties:

                        MCS: '0'
             TrainingLength: 0
                 PSDULength: 1000
    ScramblerInitialization: 2
                 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'

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 MCS setting by using dot notation.

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 extended MCS of 9.1.

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

More About

expand all

References

[1] IEEE Std 802.11ad™-2012. "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." IEEE Standard for Information technology — Telecommunications and information exchange between systems — Local and metropolitan area networks — Specific requirements.

Extended Capabilities

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

Introduced in R2017b