bluetoothTestWaveformConfig

Bluetooth BR/EDR or LE test waveform configuration parameters

Since R2022a

Description

The bluetoothTestWaveformConfig object parameterizes the bluetoothTestWaveform function for generating the Bluetooth^® basic rate/enhanced data rate (BR/EDR) or low energy (LE) test waveform.

Creation

Syntax

cfgTestWaveform = bluetoothTestWaveformConfig

cfgTestWaveform = bluetoothTestWaveformConfig(Name=Value)

Description

cfgTestWaveform = bluetoothTestWaveformConfig creates a default Bluetooth BR/EDR or LE test waveform generation configuration object.

cfgTestWaveform = bluetoothTestWaveformConfig(Name=Value) sets properties by using one or more optional name-value arguments. For example, Mode="BR" sets the physical layer (PHY) transmission mode to basic rate.

Properties

Mode — PHY transmission mode

"LE1M" (default) | "LE2M" | "LE125K" | "LE500K" | "BR" | "EDR2M" | "EDR3M"

PHY transmission mode, specified as one of these values.

Mode Value	Characteristics
"BR"	Modulation scheme is Gaussian frequency-shift keying (GFSK) Data rate is 1 Mb/s
"EDR2M"	Modulation scheme is π/4 differential quadrature phase-shift keying (DQPSK) Data rate is 2 Mb/s
"EDR3M"	Modulation scheme is 8 differential phase-shift keying (DPSK) Data rate is 3 Mb/s
"LE1M"	LE Uncoded PHY Modulation scheme is GFSK Data rate is 1 Mb/s
"LE2M"	LE Uncoded PHY Modulation scheme is GFSK Data rate is 2 Mb/s
"LE125K"	LE Coded PHY Modulation scheme is GFSK Data rate is 125 kb/s
"LE500K"	LE Coded PHY Modulation scheme is GFSK Data rate is 500 kb/s

Data Types: char | string

PayloadType — Type of payload for which to generate test packet

0 (default) | integer in the range [0, 7]

Type of payload for which to generate test packet, specified as an integer in the range [0, 7].

Data Types: double

PayloadLength — Payload length of Bluetooth LE test packet

255 (default) | integer in the range [0, 255]

Payload length of Bluetooth LE test packet, specified as an integer in the range [0, 255]. This value specifies the number of bytes that the object processes in a packet.

Dependencies

To enable this property, set the Mode property to "LE1M", "LE2M", "LE125K", or "LE500K".

Data Types: double

PacketType — Type of test packet

"Disabled" (default) | "ConnectionCTE" | "DH1" | ...

Type of test packet, specified as one of these values corresponding to the Mode property.

Mode Value	PacketType Value
"BR"	"DH1" "DH3" "DH5" "DM1" "DM3" "DM5"
"EDR2M"	"2-DH1" "2-DH3" "2-DH5" "2-EV3" "2-EV5"
"EDR3M"	"3-DH1" "3-DH3" "3-DH5" "3-EV3" "3-EV5"
"LE1M" or "LE2M"	"ConnectionCTE" "Disabled"
"LE125K" or "LE500K"	"Disabled"

Because the constant tone extension (CTE) field position is the same for an LE test packet and the data packet, this object specifies the "ConnectionCTE" packet type for the CTE-based tests.

Data Types: char | string

FixedPayloadLength — Fixed payload length of Bluetooth BR/EDR test packet

positive integer

This property is read-only.

Fixed payload length of Bluetooth BR/EDR test packet, returned as a positive integer. Units are in bytes.

Dependencies

To enable this property, set the Mode property to "BR", "EDR2M", or "EDR3M". This table shows the valid values of this property for each PacketType of the "BR", "EDR2M", and "EDR3M" mode.

Value of Mode	Value of PacketType	Value of FixedPayloadLength
"BR"	"DH1"	27
	"DH3"	183
	"DH5"	339
	"DM1"	17
	"DM3"	121
	"DM5"	224
"EDR2M"	"2-DH1"	54
	"2-DH3"	367
	"2-DH5"	679
	"2-EV3"	60
	"2-EV5"	360
"EDR3M"	"3-DH1"	83
	"3-DH3"	552
	"3-DH5"	1021
	"3-EV3"	90
	"3-EV5"	540

Data Types: double

SamplesPerSymbol — Samples per symbol

8 (default) | positive integer

Samples per symbol, specified as a positive integer.

Data Types: double

WhitenStatus — Data whiten status

"On" (default) | "Off"

Data whiten status, specified as "On" or "Off". If you set this value to "On", this object performs whitening on the header and payload.

Data Types: char | string

WhitenInitialization — Whiten initialization

[1; 1; 1; 1; 1; 1; 1] (default) | 7-bit binary-valued column vector

Whiten initialization, specified as a 7-bit binary-valued column vector. This property specifies the shift register initialization for data whitening or dewhitening.

Dependencies

To enable this property, set the WhitenStatus property to "On".

Data Types: double

ModulationIndex — Modulation index

0.5 (default) | scalar in range [0.28, 0.35] | scalar in range [0.45, 0.55]

Modulation index, specified as one of these values.

• Scalar in the range [0.28, 0.35] — For Mode values "BR", "EDR2M", and "EDR3M"

• Scalar in the range [0.45, 0.55] — For Mode values "LE1M", "LE2M", "LE125K", and "LE500K"

This property specifies the modulation index that the object uses while implementing Gaussian frequency shift keying (GFSK) modulation or demodulation.

Data Types: double

PulseLength — Length of frequency pulse shape

1 (default) | integer in range [1, 4]

Length of the frequency pulse shape, specified as an integer in the range [1, 4]. Units are in symbol intervals.

Dependencies

To enable this property, set the Mode property to "LE1M", "LE2M", "LE125K", or "LE500K".

Data Types: double

CTELength — Length of CTE

2 (default) | integer in the range [2, 20]

Length of the CTE, specified as an integer in the range [2, 20]. This property specifies the length of the CTE in 8 microsecond units.

Dependencies

To enable this property, apply these configurations.

• Set the Mode property to "LE1M" or "LE2M".

• Set the PacketType property to "ConnectionCTE".

Data Types: double

CTEType — Type of CTE

[0; 0] (default) | [0; 1] | [1; 0]

Type of CTE, specified as [0; 0], [0; 1], or [1; 0].

Dependencies

To enable this property, apply these configurations.

• Set the Mode property to "LE1M" or "LE2M".

• Set the PacketType property to "ConnectionCTE".

Data Types: double | logical

Examples

Create Bluetooth BR/EDR or LE Test Waveform Configuration Object

Create a default Bluetooth BR/EDR or LE test waveform configuration object.

cfgTestWaveform = bluetoothTestWaveformConfig

cfgTestWaveform = 
  bluetoothTestWaveformConfig with properties:

                Mode: 'LE1M'
       PayloadLength: 255
     ModulationIndex: 0.5000
         PulseLength: 1
          PacketType: 'Disabled'
         PayloadType: 0
    SamplesPerSymbol: 8

Create a Bluetooth BR/EDR or LE test waveform configuration object, specifying the PHY transmission mode as EDR2M. Set the packet type to 2-DH1 and disable the data whiten status.

cfgEDR2MTestWaveform = bluetoothTestWaveformConfig(Mode="EDR2M", ...
    PacketType="2-DH1", ...
    WhitenStatus="Off")

cfgEDR2MTestWaveform = 
  bluetoothTestWaveformConfig with properties:

                  Mode: 'EDR2M'
          WhitenStatus: 'Off'
       ModulationIndex: 0.3200
            PacketType: '2-DH1'
           PayloadType: 0
      SamplesPerSymbol: 8

   Read-only properties:
    FixedPayloadLength: 54

Create a default Bluetooth BR/EDR or LE test waveform configuration object. Set the PHY transmission mode to LE2M, packet type to connection-oriented CTE, and CTE length to 3.

cfgLE2MTestWaveform = bluetoothTestWaveformConfig;
cfgLE2MTestWaveform.Mode = "LE2M";
cfgLE2MTestWaveform.PacketType = "ConnectionCTE";
cfgLE2MTestWaveform.CTELength = 3

cfgLE2MTestWaveform = 
  bluetoothTestWaveformConfig with properties:

                Mode: 'LE2M'
       PayloadLength: 255
     ModulationIndex: 0.5000
         PulseLength: 1
          PacketType: 'ConnectionCTE'
         PayloadType: 0
    SamplesPerSymbol: 8
           CTELength: 3
             CTEType: [2x1 double]

References

[1] Bluetooth Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed November 27, 2021. https://www.bluetooth.com/.

[2] Bluetooth Special Interest Group (SIG). "Bluetooth Core Specification." Version 5.3. https://www.bluetooth.com/.

Extended Capabilities

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

Version History

Introduced in R2022a

R2023a: Includes support for pulse length and all Bluetooth LE modulation indices

• The object includes a new property, PulseLength, that enables you to specify the length of the frequency pulse shape in the range [1, 4].

• The ModulationIndex property now supports Bluetooth LE modulation indices in the range [0.45, 0.55].