Commit Graph

8 Commits

Author SHA1 Message Date
Marcel Holtmann
0bcca78995 doc: Remove more copyright statements from API specifications 2012-12-21 18:44:24 +01:00
Luiz Augusto von Dentz
4750e35620 proximity: Append version to Proximity interfaces 2012-12-14 11:24:28 +02:00
Andrzej Kaczmarek
f0981d3d26 doc: Update proximity API document 2012-11-30 15:25:05 +02:00
Michal Labedzki
4aae0e2981 doc: Fix typo
This patch fix simple typo in documentation of API.
2012-06-28 13:14:10 +03:00
Claudio Takahasi
f78ed180ee proximity-api: Add Link Loss Alert for Proximity Reporter API
PropertyChanged signal for LinkLossAlertLevel property is emitted when a
given remote device writes a new value for the Alert Level
characteristic in the local Link Loss service. Each platform is free to
define the actions for the detected signal.
2012-01-23 12:59:47 +02:00
Claudio Takahasi
5261599a9d proximity-api: Add Proximity Reporter API
Adds API for Immediate Alert Service(IAS) abstraction. IAS is used
by Proximity Monitors and Find Me Locators to notify the user that
reporter/target has been found. This new interface combines Proximity
Reporter and Find Me Target in the same API providing the flexibility
to implement external applications to control alerts(including per
device alerts).

This abstraction allows the development of platform specific
applications to control Immediate Alert coming from Proximity Monitor
and Find Me Locator. This provides flexibility to define different level
and tone for each device. Use case: watch finding a mobile phone.
2012-01-23 12:59:31 +02:00
Claudio Takahasi
b3ccd8541f Proximity API simplification
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.
2011-08-02 16:48:49 +03:00
Claudio Takahasi
9897721d7f Add Proximity API
Covers the Proximity Monitor for Link Loss, Tx Power and Immediate
Alert services. This first proposal considers that the connections
will be managed by the bluetoothd core based on the registered
connection callbacks.

Only one instance of Immediate Alert service is allowed, "Alert Level"
characteristic of this service is used by Find Me and Path Loss. Note
that "Alert Level" for Path Loss is a LOCAL property written in the
Immediate Alert service when the threshold is reached. For Find Me
the user/application needs to actively enable the alert in the Immediate
Alert service. Link Loss has it's own instance of Alert Level
characteristic.
2011-07-09 18:31:31 +03:00