bluetoothPathLoss

Estimate path loss between Bluetooth BR/EDR or LE devices

Since R2022b

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.

Examples

Estimate Path Loss Between Two Bluetooth Devices in Office Environment

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

Estimate Path Loss Between a Bluetooth Transmitter and Two Receivers in Home Environment

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

distance — Distance between Bluetooth BR/EDR or LE devices

nonnegative scalar | row vector of nonnegative values

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

cfgPathLoss — Bluetooth BR/EDR or LE path loss configuration

bluetoothPathLossConfig object

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

Output Arguments

pathLoss — Estimated path loss

scalar | row vector

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