Main Content

pathLoss

Compute path loss and received signal power

    Description

    example

    [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

    collapse all

    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