RE: Proposal for GATT Client Dbus API.

-----Original Message-----
From: Vijaykumar Dadmode [mailto:Vijaykumar.Dadmode@csr.com]
Sent: Monday, November 07, 2011 3:35 PM
To: Ganir, Chen
Cc: linux-bluetooth@vger.kernel.org
Subject: RE: Proposal for GATT Client Dbus API.

Hi Chen,
Below is the latest diff, with all the changes incorporated. Let me
know your view.

diff --git a/doc/attribute-api.txt b/doc/attribute-api.txt
index 98d7f30..9dd8222 100644
--- a/doc/attribute-api.txt
+++ b/doc/attribute-api.txt

@@ -110,6 +110,20 @@ Methods		dict GetProperties()
 			read-write properties can be changed. On success
 			this will emit a PropertyChanged signal.

+		void GetCharacteristicValue(uint16 timeout)
+
+			Read the value of the characteristic with timeout

value in seconds.
+			This will emit a ReadResponse signal with status
code.

+
+			Changes the value of the specified characteristic as
per the offset and method, with timeout value in seconds.
+			This will emit a WriteResponse signal with status
code.
+
+			Write the value of the characreristic, with any of
these specified method:
+			"WriteWithResponse", "SignedWriteWithoutResponse",
+			"WriteLongCharacteristicValue", "PrepareWrite",
"ExecuteWrite".
+
 			Possible Errors: org.bluez.Error.InvalidArguments

 Properties 	string UUID [readonly]

@@ -126,7 +140,41 @@ Properties 	string UUID [readonly]
 			Textual optional characteristic descriptor describing
 			the Characteristic Value.

+		boolean Broadcast [readwrite]
+
+		    	Indicates whether this characteristic is broadcasted

or not.
+		    	If GATT Server Characteristic Configuration
descriptor
+		    	is not available for this characteristic, or if the
characteristic
+		    	properties do not allow this, writing to this
property is not
+		    	allowed.
+
+		boolean Indicate [readwrite]
+
+		    	Indicates whether this characteristic is notified or
not.
+		    	If GATT Client Characteristic Configuration
descriptor
+		    	is not available for this characteristic, or if the
characteristic
+		    	properties do not allow this, writing to this
property is not
+		    	allowed.
+
+		boolean Notify [readwrite]
+
+		    	Indicates whether this characteristic is indicated or
not.
+		    	If GATT Client Characteristic Configuration
descriptor
+		    	is not available for this characteristic, or if the
characteristic
+		    	properties do not allow this, writing to this
property is not
+		    	allowed.
+
+		boolean Readable [readonly]
+
+		    	Indicates wether this characteristic value can be
read.
+
+		array{string} WriteMethods [readonly]
+
+			Write methods supported by the characteristic,
includes extended properties if defined, format defined by GATT spec.
+			Possible values:
+			{ "WriteWithoutResponse", "Write",
"AuthenticatedSignedWrite", "ReliableWrite", "WritableAuxiliaries"}
+

-		struct Format [readonly]
+		array{struct} Format [readonly]

 			Optional Characteristic descriptor which defines the
 			format of the Characteristic Value. For numeric

@@ -142,6 +190,11 @@ Properties 	string UUID [readonly]
 			  uint16 | Description: Description of the

characteristic defined
 			         | in a high layer profile.

+		array{object} CustomCharacteristicsDesc [readonly]
+
+			This list contains the user defined characteristics
descriptors owned by this
+			specific characteristics.
+
 		array{byte} Value [readwrite]

 			Raw value of the Characteristic Value attribute.

@@ -162,3 +215,11 @@ Object path	freely definable
 Methods		void ValueChanged(object characteristic, array{byte})

 			New raw value of the Characteristic Value attribute.