Main Content

bluetoothRangeConfig

Bluetooth BR/EDR or LE range estimation configuration parameters

Since R2022a

expand all in page

    Description

    The bluetoothRangeConfig object parameterizes the bluetoothRange function for estimating the range between two Bluetooth® basic rate/enhanced data rate (BR/EDR) or low energy (LE) devices.

    Creation

    Syntax

    cfgRange = bluetoothRangeConfig
    cfgRange = bluetoothRangeConfig(Name=Value)

    Description

    cfgRange = bluetoothRangeConfig creates a default Bluetooth BR/EDR or LE range estimation configuration object.

    cfgRange = bluetoothRangeConfig(Name=Value) sets properties by using one or more optional name-value arguments. For example, bluetoothRangeConfig(Environment="Home") sets the signal propagation environment to Home.

    example

    Properties

    expand all

    Signal propagation environment, specified as "Outdoor", "Industrial", "Home", or "Office".

    Data Types: char | string

    Type of received signal power, specified as "ReceiverSensitivity" or "ReceivedSignalPower"

    Data Types: char | string

    Received signal power, specified as a negative scalar. Units are in dBm.

    Dependencies

    To enable this property, set the SignalPowerType property to "ReceivedSignalPower".

    Data Types: double

    Physical layer (PHY) transmission mode, specified as "LE1M", "LE2M", "LE500K", "LE125K", "BR", "EDR2M", or "EDR3M".

    Data Types: char | string

    Minimum signal strength that receiver can detect, specified as a negative scalar. Units are in dBm. This table shows the valid range of values of this property corresponding to the Mode property.

    Mode Value ReceiverSensitivity Range

    • "LE1M"

    • "LE2M"

    • "BR"

    • "EDR2M"

    • "EDR3M"

    [-110, -70]

    "LE125K"

    [-110, -82]

    "LE500K"

    [-110, -75]

    Dependencies

    To enable this property, set the SignalPowerType property to "ReceiverSensitivity".

    Data Types: double

    Link margin, specified as nonnegative scalar. Units are in dB. This property specifies the difference between the minimum expected power received at the receiver's end, and receiver sensitivity.

    Dependencies

    To enable this property, set the SignalPowerType property to "ReceiverSensitivity".

    Data Types: double

    Transmitter output power, specified as a scalar in the range [-20, 20]. Units are in dBm.

    Data Types: double

    Transmitter antenna gain, specified as a scalar in the range [-10, 10]. Units are in dBi.

    Data Types: double

    Receiver antenna gain, specified as a scalar in the range [-10, 10]. Units are in dBi.

    Data Types: double

    Transmitter cable loss, specified as a nonnegative scalar. Units are in dB.

    Data Types: double

    Transmitter antenna height, specified as a positive scalar. Units are in meters.

    Dependencies

    To enable this property, set the Environment property to "Outdoor".

    Data Types: double

    Receiver antenna height, specified as a positive scalar. Units are in meters.

    Dependencies

    To enable this property, set the Environment property to "Outdoor".

    Data Types: double

    Path loss exponent, specified as a positive scalar. This property denotes the rate at which the received signal strength decreases as a function of the distance between the transmitter and receiver.

    Dependencies

    To enable this property, set the Environment property to "Industrial".

    Data Types: double

    Standard deviation, specified as a positive scalar. Units are in dB.

    Dependencies

    To enable this property, set the Environment property to "Industrial".

    Data Types: double

    This property is read-only.

    Distance estimated by using free space path loss model, returned as a positive scalar. Units are in meters.

    Data Types: double

    This property is read-only.

    Path loss model based on the specified environment, returned as "TwoRayGroundReflection", "LogNormalShadowing", or "NISTPAP02Task6". This table shows how this property depends on the Environment property.

    Environment Value PathLossModel Value

    • "Home"

    • "Office"

    "NISTPAP02Task6"

    "Outdoor"

    "TwoRayGroundReflection"

    "Industrial"

    "LogNormalShadowing"

    Data Types: char | string

    Object Functions

    expand all

    pathLossCompute path loss and received signal power

    Examples

    collapse all

    Open Live Script

    Create a default Bluetooth BR/EDR or LE range estimation configuration object.

    cfgRange1 = bluetoothRangeConfig
    cfgRange1 = 
  bluetoothRangeConfig with properties:

                 Environment: 'Outdoor'
             SignalPowerType: 'ReceiverSensitivity'
                        Mode: 'LE1M'
         ReceiverSensitivity: -94
                  LinkMargin: 15
            TransmitterPower: 0
      TransmitterAntennaGain: 0
         ReceiverAntennaGain: 0
        TransmitterCableLoss: 1.2500
           ReceiverCableLoss: 1.2500
    TransmitterAntennaHeight: 1
       ReceiverAntennaHeight: 1

   Read-only properties:
                FSPLDistance: 65.3645
               PathLossModel: 'TwoRayGroundReflection'

    Set the PHY transmission mode to "EDR2M".

    cfgRange1.Mode = "EDR2M";

    Set an industrial environment for signal propagation and specify the path loss exponent.

    cfgRange1.Environment = "Industrial";
cfgRange1.PathLossExponent = 3
    cfgRange1 = 
  bluetoothRangeConfig with properties:

               Environment: 'Industrial'
           SignalPowerType: 'ReceiverSensitivity'
                      Mode: 'EDR2M'
       ReceiverSensitivity: -94
                LinkMargin: 15
          TransmitterPower: 0
    TransmitterAntennaGain: 0
       ReceiverAntennaGain: 0
      TransmitterCableLoss: 1.2500
         ReceiverCableLoss: 1.2500
          PathLossExponent: 3
         StandardDeviation: 2.6670

   Read-only properties:
              FSPLDistance: 65.3645
             PathLossModel: 'LogNormalShadowing'

    Now, create another Bluetooth BR/EDR or LE range estimation configuration object, specifying the PHY transmission mode and receiver sensitivity as "LE500K" and -80, respectively. Specify the antenna height of transmitter and receiver.

    cfgRange2 = bluetoothRangeConfig(Mode="LE500K",ReceiverSensitivity=-80,TransmitterAntennaHeight=1.5,ReceiverAntennaHeight=1.5)
    cfgRange2 = 
  bluetoothRangeConfig with properties:

                 Environment: 'Outdoor'
             SignalPowerType: 'ReceiverSensitivity'
                        Mode: 'LE500K'
         ReceiverSensitivity: -80
                  LinkMargin: 15
            TransmitterPower: 0
      TransmitterAntennaGain: 0
         ReceiverAntennaGain: 0
        TransmitterCableLoss: 1.2500
           ReceiverCableLoss: 1.2500
    TransmitterAntennaHeight: 1.5000
       ReceiverAntennaHeight: 1.5000

   Read-only properties:
                FSPLDistance: 13.0419
               PathLossModel: 'TwoRayGroundReflection'

    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

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

    Version History

    Introduced in R2022a

    See Also

    Functions

    Objects

    Topics