Return-Path: From: Vijaykumar Dadmode To: "'Ganir, Chen'" CC: "linux-bluetooth@vger.kernel.org" Subject: RE: Proposal for GATT Client Dbus API. Date: Mon, 7 Nov 2011 13:35:22 +0000 Message-ID: References: <7769C83744F2C34A841232EF77AEA20C01DCC8DD1C@dnce01.ent.ti.com> In-Reply-To: Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Sender: linux-bluetooth-owner@vger.kernel.org List-ID: 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. + + void SetCharacteristicValue(variant value, string method, uint16 offset, uint16 timeout) + + 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. + + void ReadResponse(object characteristic, uint8 status, variant value) + + Value read and status code for Read Characteristic Value attribute operation. + + void WriteResponse(object characteristic, uint8 status) + + Status code for Write Characteristic Value attribute opeartion. Member of the CSR plc group of companies. CSR plc registered in England and Wales, registered number 4187346, registered office Churchill House, Cambridge Business Park, Cowley Road, Cambridge, CB4 0WZ, United Kingdom More information can be found at www.csr.com. Follow CSR on Twitter at http://twitter.com/CSR_PLC and read our blog at www.csr.com/blog