Main Content

bluetoothPhyConfig

Configuration object for Bluetooth BR/EDR PHY

Download Required: To use bluetoothPhyConfig, first download Communications Toolbox™ Library for the Bluetooth® Protocol. For more information, see Get and Manage Add-Ons. Alternatively, see Communications Toolbox Library for the Bluetooth Protocol File Exchange.

Description

The bluetoothPhyConfig object creates a configuration object for the Bluetooth physical layer (PHY) using default and specified values. You can configure the Bluetooth PHY by using the applicable properties of the bluetoothPhyConfig object.

Creation

Description

example

cfg = bluetoothPhyConfig creates a configuration object, cfg, for Bluetooth PHY with default property values.

example

cfg = bluetoothPhyConfig(Name,Value) sets Properties by using one or more name-value pairs. Enclose each property name in quotes. For example, bluetoothPhyConfig('Mode','EDR3M') sets the physical layer transmission mode to 3 Mbps.

Properties

expand all

Note

For more information about Bluetooth BR/EDR waveform generator properties and their respective values, see volume 2, part B, sections 6 and 7 of the Bluetooth Core Specification [2].

PHY transmission mode, specified as 'BR', 'EDR2M' or 'EDR3M'. This value indicates the type of Bluetooth BR/EDR waveform.

Data Types: char | string

Bluetooth device address, specified as a 12-element character vector or a string scalar denoting a 6-octet hexadecimal value.

Data Types: char | string

Modulation index, specified as a scalar in the range [0.28, 0.35]. This property is the modulation index that the object uses when performing Gaussian frequency shift keying (GFSK) modulation or demodulation.

Data Types: double

Samples per symbol, specified as a positive integer. This value is used for GFSK modulation and demodulation.

Data Types: double

Data whiten status, specified as 'On' or 'Off'. Set this value to 'On' for the object to perform whitening on header and payload bits.

Data Types: char | string

Whiten initialization, specified as a 7-bit binary column vector.

Dependencies

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

Data Types: double

Object Functions

expand all

bluetoothIdealReceiverIdeal receiver for Bluetooth BR/EDR PHY waveform

Examples

collapse all

Create two unique Bluetooth BR/EDR PHY configuration objects: one for synchronous connection oriented (SCO) logical transport and the other for connectionless slave broadcast (CSB) logical transport.

Create a Bluetooth BR/EDR PHY configuration object for an SCO logical transport. For SCO logical transport, the PHY transmission mode must be set to basic rate (BR).

cfg = bluetoothPhyConfig
cfg = 
  bluetoothPhyConfig with properties:

                    Mode: 'BR'
           DeviceAddress: '0123456789AB'
         ModulationIndex: 0.3200
        SamplesPerSymbol: 8
            WhitenStatus: 'On'
    WhitenInitialization: [7x1 double]

Create another Bluetooth BR/EDR PHY configuration object for a CSB logical transport by disabling the whiten status.

cfg = bluetoothPhyConfig('WhitenStatus','Off')
cfg = 
  bluetoothPhyConfig with properties:

                Mode: 'BR'
       DeviceAddress: '0123456789AB'
     ModulationIndex: 0.3200
    SamplesPerSymbol: 8
        WhitenStatus: 'Off'

References

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

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

Extended Capabilities

Introduced in R2020a