pathLoss

Compute path loss and received signal power

Since R2022a

Syntax

[pl,rxPower] = pathLoss(cfgRange)

Description

[pl,rxPower] = pathLoss(cfgRange) returns the path loss, pl, in dB and received power, rxPower, in dBm for the specified Bluetooth^® basic rate/enhanced data rate (BR/EDR) or low energy (LE) range estimation configuration object, cfgRange.

Examples

Compute Path Loss and Received Power Between Two Bluetooth BR Devices

Create a Bluetooth BR/EDR or LE range estimation configuration, specifying the physical layer (PHY) transmission mode as "BR", transmitter output power as 10, and receiver sensitivity as -72.

cfgRange = bluetoothRangeConfig(Mode="BR",TransmitterPower=10,ReceiverSensitivity=-72)

cfgRange = 
  bluetoothRangeConfig with properties:

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

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

Compute path loss and received power between two Bluetooth BR devices.

[pl,rxPower] = pathLoss(cfgRange)

pl = 64.5000

rxPower = -57

Input Arguments

cfgRange — Bluetooth BR/EDR or LE range estimation configuration parameters

bluetoothRangeConfig object

Bluetooth BR/EDR or LE range estimation configuration parameters, specified as a bluetoothRangeConfig object.

Output Arguments

pl — Path loss between two Bluetooth BR/EDR or LE devices

scalar

Path loss between two Bluetooth BR/EDR or LE devices, returned as a scalar. Units are in dB.

Data Types: double

rxPower — Received signal power between two Bluetooth BR/EDR or LE devices

scalar

Received signal power between two Bluetooth BR/EDR or LE devices, returned as a scalar. Units are in dBm.

Data Types: double

References

[1] Bluetooth Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed November 12, 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