wlanDMGConfig

Configure DMG transmission

Description

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

Creation

Syntax

cfgDMG = wlanDMGConfig

cfgDMG = wlanDMGConfig(Name,Value)

Description

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

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

MCS — MCS used for transmission

0 (default) | integer in the interval [0, 24] | '9.1' | '12.1' | '12.2' | '12.3' | '12.4' | '12.5' | '12.6'

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:

  MCS	Modulation	Coding Rate	Comment
  0	Differential binary phase-shift keying (DBPSK)	1/2	The coding rate may be lower due to codeword shortening.

• Single-carrier modulation:

  MCS	Modulation	Coding Rate	NCBPS	Repetition
  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:

MCS	Modulation	Coding Rate	NBPSC	NCBPS	NDBPS
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

TrainingLength — Number of training fields

0 (default) | multiple of four in the interval [0, 64]

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

Data Types: double

PacketType — Packet training field type

'TRN-R' (default) | 'TRN-T'

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

BeamTrackingRequest — Beam tracking request indicator

false or 0 (default) | true or 1

Beam tracking request indicator, specified as a numeric or logical 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

TonePairingType — Tone pairing type

'Static' (default) | 'Dynamic'

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

DTPGroupPairIndex — DTP group pair index

(0:1:41)' (default) | 42-by-1 vector of integers

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

DTPIndicator — DTP update indicator

false or 0 (default) | true or 1

DTP update indicator, specified as a numeric or logical 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

PSDULength — PSDU length

1000 (default) | integer in the interval [1, 2¹⁸]

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

Data Types: double

ScramblerInitialization — Initial scrambler state

2 (default) | integer in the interval [0, 127] | binary column vector

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

AggregatedMPDU — MPDU aggregation indicator

false or 0 (default) | true or 1

MPDU aggregation indicator, specified as a numeric or logical 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

LastRSSI — Received power level of the last packet

0 (default) | integer in the interval [0, 15]

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 — Turnaround indication

false or 0 (default) | true or 1

Turnaround indication, specified as a numeric or logical 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
transmitTime	Packet transmission time

Examples

Create DMG Configuration Object with Default Settings

cfgDMG = wlanDMGConfig

cfgDMG = 
  wlanDMGConfig with properties:

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

Create DMG Configuration Object and Return DMG PHY Type

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 DMG Configuration Object and Modify Default Settings

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 Object with Extended MCS

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

PPDU

The physical layer (PHY) protocol data unit (PPDU) is the complete physical layer convergence procedure (PLCP) frame, including PLCP headers, MAC headers, the MAC data field, and the MAC and PLCP trailers.

References

[1] IEEE STD 802.11ad™-2012 (Amendment to IEEE Std 802.11-2012, as amended by IEEE Std 802.11ae™-2012 and IEEE Std 802.11a™-2012). “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 4: Enhancements for Very High Throughput Operation in Bands below 6 GHz.” 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™.

Usage notes and limitations: To change the size of the MCS property during a simulation, you must set this property before using the object for the first time.

Version History

Introduced in R2017b