OSDN Git Service

doc/gatt-api: New API properties and methods for the GATT D-Bus API.
authorArman Uguray <armansito@chromium.org>
Mon, 11 Aug 2014 20:37:07 +0000 (13:37 -0700)
committerMarcel Holtmann <marcel@holtmann.org>
Sat, 30 Aug 2014 16:48:53 +0000 (18:48 +0200)
commit103004c6bbd9541c5305e2cd845b7193285a0052
treedff7a1ac1f9024d09d2ba349d7b4a0db8caf336e
parent944343c9026979ea37859fe62d6460905ef83e31
doc/gatt-api: New API properties and methods for the GATT D-Bus API.

This patch introduces the following new properties to the GattService1
interface:

  Device: A remote-service-only property that contains the D-Bus object
  path of the associated device.

  Primary: Reflects whether or not a services is primary or secondary.

This patch also introduces new methods to GattCharacteristic1 and
GattDescriptor1 for reading and writing the corresponding attribute
values and a new signal for being notified of received notifications and
indications.

The "Value" D-Bus property is removed from both interfaces
and replaced with asynchronous ReadValue and WriteValue functions. This
is due to the fact that DBus.Properties.Get is synchronous and without
an asynchronous way of issuing a GATT value read request, there are
cases where a single read and cache based approach becomes limiting
(e.g. when a characteristic allows reads but no notifications) and
relying on the PropertyChanged signal to retrieve the value of a read
request asynchonously as well as to signal notifications/indications
makes for a vague API.
doc/gatt-api.txt