2015-05-04 23:57:30

by Arman Uguray

Subject: [RFC BlueZ] doc/device-api: Add GattServices

This patch introduces the GattServices property that contains the object
paths of exported GattService1 objects. The purpose of this property is
to signal when all GATT services on a remote device have been
discovered.
---
doc/device-api.txt | 8 ++++++++
1 file changed, 8 insertions(+)

diff --git a/doc/device-api.txt b/doc/device-api.txt
index 20d6c65..a8076a2 100644
--- a/doc/device-api.txt
+++ b/doc/device-api.txt
@@ -211,3 +211,11 @@ Properties string Address [readonly]

Service advertisement data. Keys are the UUIDs in
string format followed by its byte array value.
+
+ array{object} GattServices [readonly, optional]
+
+ List of GATT service object paths. Each referenced
+ object exports the org.bluez.GattService1 interface and
+ represents a remote GATT service. This property will be
+ updated once all remote GATT services of this device
+ have been discovered and exported over D-Bus.
--
2.2.0.rc0.207.ga3a616c

2015-05-05 21:57:00

by Arman Uguray

Subject: Re: [RFC BlueZ] doc/device-api: Add GattServices

Hi,

> On Mon, May 4, 2015 at 4:57 PM, Arman Uguray <[email protected]> wrote:
> This patch introduces the GattServices property that contains the object
> paths of exported GattService1 objects. The purpose of this property is
> to signal when all GATT services on a remote device have been
> discovered.
> ---
> doc/device-api.txt | 8 ++++++++
> 1 file changed, 8 insertions(+)
>
> diff --git a/doc/device-api.txt b/doc/device-api.txt
> index 20d6c65..a8076a2 100644
> --- a/doc/device-api.txt
> +++ b/doc/device-api.txt
> @@ -211,3 +211,11 @@ Properties string Address [readonly]
>
> Service advertisement data. Keys are the UUIDs in
> string format followed by its byte array value.
> +
> + array{object} GattServices [readonly, optional]
> +
> + List of GATT service object paths. Each referenced
> + object exports the org.bluez.GattService1 interface and
> + represents a remote GATT service. This property will be
> + updated once all remote GATT services of this device
> + have been discovered and exported over D-Bus.
> --
> 2.2.0.rc0.207.ga3a616c
>

Since there have been no objections, I pushed this proposal. It's a
simple enough addition anyway, and it's consistent with the current
GATT API.

Thanks,
Arman