bluetoothRangeConfig

Bluetooth BR/EDR or LE range estimation configuration parameters

Since R2022a

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.

Properties

Environment — Signal propagation environment

"Outdoor" (default) | "Industrial" | "Home" | "Office"

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

Data Types: char | string

SignalPowerType — Type of received signal power

"ReceiverSensitivity" (default) | "ReceivedSignalPower"

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

Data Types: char | string

ReceivedSignalPower — Received signal power

-79 (default) | negative scalar

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

Mode — PHY transmission mode

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

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

Data Types: char | string

ReceiverSensitivity — Minimum signal strength that receiver can detect

-94 (default) | negative scalar

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

LinkMargin — Link margin

15 (default) | nonnegative scalar

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

TransmitterPower — Transmitter output power

0 (default) | scalar in the range [-20, 20]

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

Data Types: double

TransmitterAntennaGain — Transmitter antenna gain

0 (default) | scalar in the range [-10, 10]

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

Data Types: double

ReceiverAntennaGain — Receiver antenna gain

0 (default) | scalar in the range [-10, 10]

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

Data Types: double

TransmitterCableLoss — Transmitter cable loss

1.25 (default) | nonnegative scalar

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

Data Types: double

TransmitterAntennaHeight — Transmitter antenna height

1 (default) | positive scalar

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

ReceiverAntennaHeight — Receiver antenna height

1 (default) | positive scalar

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

PathLossExponent — Path loss exponent

2.2 (default) | positive scalar

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

StandardDeviation — Standard deviation

2.667 (default) | positive scalar

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

FSPLDistance — Distance estimated by using free space path loss model

positive scalar

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

PathLossModel — Path loss model based on specified environment

"TwoRayGroundReflection" | "LogNormalShadowing" | "NISTPAP02Task6"

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

Specific to This Object

pathLoss

Compute path loss and received signal power

Examples

Create Bluetooth Range Estimation Configuration Object

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