korg/bluez
0
0
Fork 0
mirror of https://git.kernel.org/pub/scm/bluetooth/bluez.git synced 2025-01-19 10:05:09 +08:00
Code Issues Packages Projects Releases Wiki Activity

Proximity API simplification

Browse Source 
Delegates the Immediate Alert Level control to the caller(client).
Immediate Alert Service is shared between Path Loss and Find Me.

Three signal level states are defined: "good", "regular" and "weak".
Meaning that at least two thresholds are necessary to implement a
proper state transition. "unknown" will be returned if the link is not
active. For Path Loss, the logic to trigger the writting operation of
the Immediate Alert Level characteristic needs to be implemented in
the client. SignalLevel can be only one of the inputs to define when
and which value to write in the characteristic.
This commit is contained in:
Claudio Takahasi 2011-07-19 19:36:30 -03:00 committed by Johan Hedberg
parent 4528e82b65
commit b3ccd8541f
1 changed files with 6 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/proximity-api.txt
View File

@ -30,29 +30,11 @@ Signals PropertyChanged(string name, variant value)
property.
Properties
uint8 PathLoss[readonly]
If Tx Power Service is available, this property value
will be reported on regular intervals when the peer is
connected. Range: 0 - 100. The number is a relative
value to represent inaccurately the signal strength,
where 0 represents out of range and 100 close to the
reporter.
string SignalLevel[readonly]
string Threshold [readwrite]
Persistent property. Trigger for immediate alert.
Values: "low", "medium", "high". Enabled only if Tx
Power and Immediate Alert services are available in
the reporter. Controls when the immediate alert is
triggered in the reporter.
boolean ThresholdAlert[readonly]
Alert indicating that threshold has been reached or the
path loss returned to a value below the threshold. It is
up to the implementation catch this property value and
emit a sound in the proximity monitor.
Alert indicating that a threshold has been reached.
Possible values: "unknown", "good", "regular", "weak"
string LinkLossAlertLevel [readwrite]
@ -60,16 +42,10 @@ Properties
proximity reporter for link loss scenario. Values:
"none", "mild", "high".
string PathLossAlertLevel [readwrite]
string ImmediateAlertLevel [readwrite]
Persistent property. Alert level for path loss scenario.
It's a LOCAL property value written in the Alert Level of
the Immediate Alert service when the threshold alert is
triggered. Values: "none", "mild", "high".
string FindMeAlertLevel [readwrite]
Alert level to be written in the Find Me Target.
Alert level to be written in the Immediate Alert Level.
Property shared between Path Loss and Find Me.
Values: "none", "mild", "high". Default value is
"none". Applications can disable the alert setting
the value to "none". If the "Target" is not found,