bluetoothRangeConfig
Description
The bluetoothRangeConfig
object parameterizes the bluetoothRange
function for estimating the range between two Bluetooth® basic rate/enhanced data rate (BR/EDR) or low energy (LE)
devices.
Creation
Description
creates a
default Bluetooth BR/EDR or LE range estimation configuration object.cfgRange
= bluetoothRangeConfig
sets properties by using one or more
optional name-value arguments. For example,
cfgRange
= bluetoothRangeConfig(Name=Value
)bluetoothRangeConfig(Environment="Home")
sets the signal propagation
environment to Home.
Properties
Environment
— Signal propagation environment
"Outdoor"
(default) | "Industrial"
| "Home"
| "Office"
Signal propagation environment, specified as "Outdoor"
,
"Industrial"
, "Home"
, or
"Office"
.
Data Types: char
| string
SignalPowerType
— Type of received signal power
"ReceiverSensitivity"
(default) | "ReceivedSignalPower"
Type of received signal power, specified as "ReceiverSensitivity"
or "ReceivedSignalPower"
Data Types: char
| string
ReceivedSignalPower
— Received signal power
-79
(default) | negative scalar
Received signal power, specified as a negative scalar. Units are in dBm.
Dependencies
To enable this property, set the SignalPowerType property to
"ReceivedSignalPower"
.
Data Types: double
Mode
— PHY transmission mode
"LE1M"
(default) | "LE2M"
| "LE500K"
| "LE125K"
| "BR"
| "EDR2M"
| "EDR3M"
Physical layer (PHY) transmission mode, specified as "LE1M"
,
"LE2M"
, "LE500K"
, "LE125K"
,
"BR"
, "EDR2M"
, or
"EDR3M"
.
Data Types: char
| string
ReceiverSensitivity
— Minimum signal strength that receiver can detect
-94
(default) | negative scalar
Minimum signal strength that receiver can detect, specified as a negative scalar. Units are in dBm. This table shows the valid range of values of this property corresponding to the Mode property.
Mode Value | ReceiverSensitivity Range |
---|---|
| [-110, -70] |
"LE125K" | [-110, -82] |
"LE500K" | [-110, -75] |
Dependencies
To enable this property, set the SignalPowerType property to
"ReceiverSensitivity"
.
Data Types: double
LinkMargin
— Link margin
15
(default) | nonnegative scalar
Link margin, specified as nonnegative scalar. Units are in dB. This property specifies the difference between the minimum expected power received at the receiver's end, and receiver sensitivity.
Dependencies
To enable this property, set the SignalPowerType property to
"ReceiverSensitivity"
.
Data Types: double
TransmitterPower
— Transmitter output power
0
(default) | scalar in the range [-20, 20]
Transmitter output power, specified as a scalar in the range [-20, 20]. Units are in dBm.
Data Types: double
TransmitterAntennaGain
— Transmitter antenna gain
0
(default) | scalar in the range [-10, 10]
Transmitter antenna gain, specified as a scalar in the range [-10, 10]. Units are in dBi.
Data Types: double
ReceiverAntennaGain
— Receiver antenna gain
0
(default) | scalar in the range [-10, 10]
Receiver antenna gain, specified as a scalar in the range [-10, 10]. Units are in dBi.
Data Types: double
TransmitterCableLoss
— Transmitter cable loss
1.25
(default) | nonnegative scalar
Transmitter cable loss, specified as a nonnegative scalar. Units are in dB.
Data Types: double
TransmitterAntennaHeight
— Transmitter antenna height
1
(default) | positive scalar
Transmitter antenna height, specified as a positive scalar. Units are in meters.
Dependencies
To enable this property, set the Environment property to "Outdoor"
.
Data Types: double
ReceiverAntennaHeight
— Receiver antenna height
1
(default) | positive scalar
Receiver antenna height, specified as a positive scalar. Units are in meters.
Dependencies
To enable this property, set the Environment property to "Outdoor"
.
Data Types: double
PathLossExponent
— Path loss exponent
2.2
(default) | positive scalar
Path loss exponent, specified as a positive scalar. This property denotes the rate at which the received signal strength decreases as a function of the distance between the transmitter and receiver.
Dependencies
To enable this property, set the Environment property to "Industrial"
.
Data Types: double
StandardDeviation
— Standard deviation
2.667
(default) | positive scalar
Standard deviation, specified as a positive scalar. Units are in dB.
Dependencies
To enable this property, set the Environment property to "Industrial"
.
Data Types: double
FSPLDistance
— Distance estimated by using free space path loss model
positive scalar
This property is read-only.
Distance estimated by using free space path loss model, returned as a positive scalar. Units are in meters.
Data Types: double
PathLossModel
— Path loss model based on specified environment
"TwoRayGroundReflection"
| "LogNormalShadowing"
| "NISTPAP02Task6"
This property is read-only.
Path loss model based on the specified environment, returned as
"TwoRayGroundReflection"
, "LogNormalShadowing"
,
or "NISTPAP02Task6"
. This table shows how this property depends on
the Environment property.
Environment Value | PathLossModel Value |
---|---|
|
|
"Outdoor" |
|
"Industrial" |
|
Data Types: char
| string
Object Functions
Specific to This Object
pathLoss | Compute path loss and received signal power |
Examples
Create Bluetooth Range Estimation Configuration Object
Create a default Bluetooth BR/EDR or LE range estimation configuration object.
cfgRange1 = bluetoothRangeConfig
cfgRange1 = bluetoothRangeConfig with properties: Environment: 'Outdoor' SignalPowerType: 'ReceiverSensitivity' Mode: 'LE1M' ReceiverSensitivity: -94 LinkMargin: 15 TransmitterPower: 0 TransmitterAntennaGain: 0 ReceiverAntennaGain: 0 TransmitterCableLoss: 1.2500 ReceiverCableLoss: 1.2500 TransmitterAntennaHeight: 1 ReceiverAntennaHeight: 1 Read-only properties: FSPLDistance: 65.3645 PathLossModel: 'TwoRayGroundReflection'
Set the PHY transmission mode to "EDR2M
".
cfgRange1.Mode = "EDR2M";
Set an industrial environment for signal propagation and specify the path loss exponent.
cfgRange1.Environment = "Industrial";
cfgRange1.PathLossExponent = 3
cfgRange1 = bluetoothRangeConfig with properties: Environment: 'Industrial' SignalPowerType: 'ReceiverSensitivity' Mode: 'EDR2M' ReceiverSensitivity: -94 LinkMargin: 15 TransmitterPower: 0 TransmitterAntennaGain: 0 ReceiverAntennaGain: 0 TransmitterCableLoss: 1.2500 ReceiverCableLoss: 1.2500 PathLossExponent: 3 StandardDeviation: 2.6670 Read-only properties: FSPLDistance: 65.3645 PathLossModel: 'LogNormalShadowing'
Now, create another Bluetooth BR/EDR or LE range estimation configuration object, specifying the PHY transmission mode and receiver sensitivity as "LE500K
" and -80
, respectively. Specify the antenna height of transmitter and receiver.
cfgRange2 = bluetoothRangeConfig(Mode="LE500K",ReceiverSensitivity=-80,TransmitterAntennaHeight=1.5,ReceiverAntennaHeight=1.5)
cfgRange2 = bluetoothRangeConfig with properties: Environment: 'Outdoor' SignalPowerType: 'ReceiverSensitivity' Mode: 'LE500K' ReceiverSensitivity: -80 LinkMargin: 15 TransmitterPower: 0 TransmitterAntennaGain: 0 ReceiverAntennaGain: 0 TransmitterCableLoss: 1.2500 ReceiverCableLoss: 1.2500 TransmitterAntennaHeight: 1.5000 ReceiverAntennaHeight: 1.5000 Read-only properties: FSPLDistance: 13.0419 PathLossModel: 'TwoRayGroundReflection'
References
[1] Bluetooth Technology Website. “Bluetooth Technology Website | The Official Website of Bluetooth Technology.” Accessed November 22, 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
Functions
Objects
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)