Main Content

bluetoothPhyConfig

Bluetooth BR/EDR PHY configuration parameters

    Description

    The bluetoothPhyConfig object sets properties to configure the Bluetooth® physical layer (PHY).

    Creation

    Description

    example

    cfgPHY = bluetoothPhyConfig creates a default Bluetooth PHY configuration object, cfg.

    example

    cfgPHY = bluetoothPhyConfig(Name,Value) sets properties by using one or more name-value pairs. Enclose each property name in quotes. For example, ('Mode','EDR3M') sets the PHY 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 BR/EDR 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. The object uses this value for GFSK modulation and demodulation.

    Data Types: double

    Data whiten status, specified as 'On' or 'Off'. To perform whitening on header and payload bits, set this value to 'On'.

    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

    Note

    From R2022a, this object uses 'Central' and 'Peripheral' terminologies to represent 'Master' and 'Slave' nodes, respectively.

    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 peripheral broadcast (CPB) logical transport.

    Create a default Bluetooth BR/EDR PHY configuration object for an SCO logical transport.

    cfgPHY = bluetoothPhyConfig
    cfgPHY = 
      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.

    cfgPHY = bluetoothPhyConfig('WhitenStatus','Off')
    cfgPHY = 
      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, 2021. https://www.bluetooth.com/.

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

    Extended Capabilities

    Version History

    Introduced in R2020a