Main Content

pathLoss

Compute path loss and received signal power

Since R2022a

collapse all in page

    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.

    example

    Examples

    collapse all

    Open Live Script

    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

    collapse all

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

    Output Arguments

    collapse all

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

    Data Types: double

    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

    See Also

    Objects