bluetoothPathLossConfig
Description
The bluetoothPathLossConfig
object specifies parameters for the
bluetoothPathLoss
function. Use the bluetoothPathLoss
function to estimate the path loss between Bluetooth® basic rate/enhanced data rate (BR/EDR) or low energy (LE)
devices.
Creation
Description
creates a default Bluetooth BR/EDR or LE path loss estimation configuration object.cfgPathLoss
= bluetoothPathLossConfig
sets properties by using one or more
name-value arguments. For example, cfgPathLoss
= bluetoothPathLossConfig(Name=Value
)Environment="Home"
sets the signal
propagation environment to home.
Properties
Environment
— Signal propagation environment
"Outdoor"
(default) | "Home"
| "Industrial"
| "Office"
Signal propagation environment, specified as "Home"
,
"Industrial"
, "Office"
, or
"Outdoor"
.
Data Types: char
| string
TransmitterAntennaGain
— Transmitter antenna gain
0
(default) | scalar or a row vector of values in the range [–10, 10]
Transmitter antenna gain, specified as a scalar or a row vector of values in the range [–10, 10]. Units are in dBi.
Data Types: double
ReceiverAntennaGain
— Receiver antenna gain
0
(default) | scalar or a row vector of values in the range [–10, 10]
Receiver antenna gain, specified as a scalar or a row vector of values in the range [–10, 10]. Units are in dBi.
Data Types: double
TransmitterCableLoss
— Transmitter cable loss
0
(default) | nonnegative scalar or a row vector
Transmitter cable loss, specified as a nonnegative scalar or a row vector. Units are in dB.
Data Types: double
ReceiverCableLoss
— Receiver cable loss
0
(default) | nonnegative scalar or a row vector
Receiver cable loss, specified as a nonnegative scalar or a row vector. Units are in dB.
Data Types: double
TransmitterAntennaHeight
— Transmitter antenna height
1
(default) | positive scalar or a row vector
Transmitter antenna height, specified as a positive scalar or a row vector. 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 or a row vector
Receiver antenna height, specified as a positive scalar or a row vector. Units are in meters.
Dependencies
To enable this property, set the Environment property to "Outdoor"
.
Data Types: double
PathLossExponent
— Path loss exponent of the specified environment
2.2
(default) | positive scalar
Path loss exponent of the specified environment, specified as a positive scalar.
Dependencies
To enable this property, set the Environment property to "Industrial"
.
Data Types: double
StandardDeviation
— Standard deviation
2.667
(default) | nonnegative scalar
Standard deviation, specified as a nonnegative scalar. Units are in dB.
Dependencies
To enable this property, set the Environment property to "Industrial"
or
"Outdoor"
.
Data Types: double
RandomStream
— Random number source
"Global stream"
(default) | "mt19937ar with seed"
Random number source, specified as "Global stream"
or
"mt19937ar with seed"
.
"Global stream"
— The object generates a normally distributed random number by using the current global random number stream."mt19937ar with seed"
— The object generates a normally distributed random number by using the mt19937ar algorithm.
Data Types: char
| string
Seed
— Initial seed for mt19937ar
73
(default) | nonnegative scalar
Initial seed for mt19937ar, specified as a nonnegative scalar.
Dependencies
To enable this property, set the RandomStream property to "mt19937ar with
seed"
.
Data Types: double
PathLossModel
— Path loss model of the specified environment
'TwoRayGroundReflection'
| 'LogNormalShadowing'
| 'NISTPAP02Task6'
This property is read-only.
Path loss model of the specified environment, returned as
'TwoRayGroundReflection'
, 'LogNormalShadowing'
,
or 'NISTPAP02Task6'
.
If you set the Environment property to
"Outdoor"
, this property returns the'TwoRayGroundReflection'
value.If you set the
Environment
property to"Industrial"
, this property returns the'LogNormalShadowing'
value.If you set the
Environment
property to"Home"
or"Office"
, this property returns the'NISTPAP02Task6'
value.
Data Types: char
Examples
Create Bluetooth Path Loss Estimation Configuration Objects
Create a default Bluetooth path loss estimation configuration object. By default, the object specifies an outdoor environment.
cfgPathLossOutdoor = bluetoothPathLossConfig;
Specify the transmitter and receiver antenna heights, in meters.
cfgPathLossOutdoor.TransmitterAntennaHeight = 2; cfgPathLossOutdoor.ReceiverAntennaHeight = 3;
Specify the standard deviation, in dB.
cfgPathLossOutdoor.StandardDeviation = 1.6667
cfgPathLossOutdoor = bluetoothPathLossConfig with properties: Environment: 'Outdoor' TransmitterAntennaGain: 0 ReceiverAntennaGain: 0 TransmitterCableLoss: 0 ReceiverCableLoss: 0 TransmitterAntennaHeight: 2 ReceiverAntennaHeight: 3 StandardDeviation: 1.6667 RandomStream: 'Global stream' Read-only properties: PathLossModel: 'TwoRayGroundReflection'
Create a Bluetooth path loss estimation configuration object for an industrial environment, specifying the path loss exponent as 2
and standard deviation as 0
dB. A path loss exponent value of 2
and a standard deviation of 0
dB signifies that the Bluetooth signal propagates in free space.
cfgPathLossIndustrial = bluetoothPathLossConfig(Environment="Industrial", ... PathLossExponent=2,StandardDeviation=0)
cfgPathLossIndustrial = bluetoothPathLossConfig with properties: Environment: 'Industrial' TransmitterAntennaGain: 0 ReceiverAntennaGain: 0 TransmitterCableLoss: 0 ReceiverCableLoss: 0 PathLossExponent: 2 StandardDeviation: 0 RandomStream: 'Global stream' Read-only properties: PathLossModel: 'LogNormalShadowing'
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
Abrir ejemplo
Tiene una versión modificada de este ejemplo. ¿Desea abrir este ejemplo con sus modificaciones?
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
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)