Main Content

bluetoothPathLoss

Estimate path loss between Bluetooth BR/EDR or LE devices

Since R2022b

collapse all in page

    Syntax

    pathLoss = bluetoothPathLoss(distance,cfgPathLoss)

    Description

    pathLoss = bluetoothPathLoss(distance,cfgPathLoss) estimates the path loss between Bluetooth® basic rate/enhanced data rate (BR/EDR) or low energy (LE) devices for the given path loss estimation configuration, cfgPathLoss. Input distance specifies the distance between the Bluetooth devices.

    example

    Examples

    collapse all

    Open Live Script

    Create a default Bluetooth path loss estimation configuration object. Set the signal propagation environment to "Office".

    cfgPathLoss = bluetoothPathLossConfig;
cfgPathLoss.Environment = "Office";

    Specify the transmitter and receiver antenna gains in dBi.

    cfgPathLoss.TransmitterAntennaGain = 5;
cfgPathLoss.ReceiverAntennaGain = 10;

    Specify the distance between the two Bluetooth devices, in meters.

    distance = 50;

    Estimate the path loss in dB.

    pathLoss = bluetoothPathLoss(distance,cfgPathLoss)
    pathLoss = 
146.5998
    Open Live Script

    Create a Bluetooth path loss estimation configuration object for a home environment. 

    cfgPathLoss = bluetoothPathLossConfig(Environment="Home");

    Specify the distance between a Bluetooth transmitter and each of two Bluetooth receivers, in meters.

    distance = [20 30];

    Estimate the path loss in dB.

    pathLoss = bluetoothPathLoss(distance,cfgPathLoss)
    pathLoss = 1×2

   77.5839   94.8555

    Input Arguments

    collapse all

    Distance between Bluetooth BR/EDR or LE devices, specified as a nonnegative scalar or a row vector of nonnegative values. Units are in meters.

    Data Types: double

    Bluetooth BR/EDR or LE path loss configuration, specified as a bluetoothPathLossConfig object.

    Output Arguments

    collapse all

    Estimated path loss, returned as a scalar or a row vector. Units are in dB.

    Data Types: double

    References

    [1] Bluetooth Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed March 22, 2022. https://www.bluetooth.com/.

    [2] Bluetooth Core Specification 5.3. Bluetooth Special Interest Group (SIG), Accessed March 22, 2022. https://www.bluetooth.com/.

    Extended Capabilities

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

    Version History

    Introduced in R2022b

    See Also

    Functions

    Objects