2011-02-08 19:38:31

by Elvis Pfutzenreuter

[permalink] [raw]
Subject: [PATCH] [RFC] Add generic descriptor support to Attribute API

This patch proposes extensions to Attribute API, giving access to all
characteristic descriptors (beyond 'Description' and 'Format').
---
doc/attribute-api.txt | 25 +++++++++++++++++++++++++
1 files changed, 25 insertions(+), 0 deletions(-)

diff --git a/doc/attribute-api.txt b/doc/attribute-api.txt
index 23808e6..eff49b2 100644
--- a/doc/attribute-api.txt
+++ b/doc/attribute-api.txt
@@ -104,6 +104,13 @@ Methods dict GetProperties()

Possible Errors: org.bluez.Error.InvalidArguments

+ void SetDescriptorValue(object descriptor, array{byte} value)
+
+ Sets descriptor value, provided that it is writable.
+
+ Possible Errors: org.bluez.Error.InvalidArguments
+ org.bluez.Error.NotAuthorized
+
Properties string UUID [readonly]

UUID128 of this characteristic.
@@ -143,6 +150,24 @@ Properties string UUID [readonly]
Friendly representation of the Characteristic Value
based on the format attribute.

+ dict Descriptors [readonly]
+
+ List of descriptors for this characteristic.
+
+ This list contains only the descriptors not already
+ covered by other properties (v.g. Description, Format).
+
+ Each descriptor is mapped to an unique object path,
+ which is the key for the dict.
+
+ Each dict value is, in turn, a dict with at least
+ the following keys:
+
+ {
+ "UUID": string (descriptor UUID),
+ "Value": array of bytes (raw descriptor value)
+ }
+

Characteristic Watcher hierarchy
===============================
--
1.7.1