wlanDMGConfig
Configure DMG transmission
Description
The wlanDMGConfig
object is a configuration object for the WLAN
directional multi-gigabit (DMG) packet format.
Creation
Description
creates
cfgDMG
= wlanDMGConfigcfgDMG
, a configuration object that initializes parameters for an
IEEE®
802.11™ DMG PPDU.
sets properties using one or more name-value pairs. Enclose each property name in
quotation marks. For example,
cfgDMG
= wlanDMGConfig(Name,Value
)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 |
---|---|---|---|---|---|
| Staggered QPSK (SQPSK) | 1/2 | 1 | 336 | 168 |
| 5/8 | 210 | |||
| QPSK | 1/2 | 2 | 672 | 336 |
| 5/8 | 420 | |||
| 3/4 | 504 | |||
| 16-QAM | 1/2 | 4 | 1344 | 672 |
| 5/8 | 840 | |||
| 3/4 | 1008 | |||
| 13/16 | 1092 | |||
| 64-QAM | 5/8 | 6 | 2016 | 1260 |
| 3/4 | 1512 | |||
| 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, 218]
Physical layer convergence procedure (PLCP) service data unit (PSDU) length, in bytes, specified as an integer in the interval [1, 218].
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
to0
, 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
See Also
Objects
wlanHEMUConfig
|wlanHESUConfig
|wlanHETBConfig
|wlanHTConfig
|wlanNonHTConfig
|wlanS1GConfig
|wlanVHTConfig
Functions
phyType
|transmitTime
|wlanDMGDataBitRecover
|wlanDMGHeaderBitRecover
|wlanDMGOFDMDemodulate
|wlanDMGOFDMInfo
|wlanWaveformGenerator
Apps
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)