Return-Path: From: Andrzej Kaczmarek To: CC: Andrzej Kaczmarek Subject: [PATCH v2 05/15] thermometer: Update API document Date: Mon, 1 Oct 2012 11:23:47 +0200 Message-ID: <1349083437-23528-6-git-send-email-andrzej.kaczmarek@tieto.com> In-Reply-To: <1349083437-23528-1-git-send-email-andrzej.kaczmarek@tieto.com> References: <1349083437-23528-1-git-send-email-andrzej.kaczmarek@tieto.com> MIME-Version: 1.0 Content-Type: text/plain Sender: linux-bluetooth-owner@vger.kernel.org List-ID: This patch updates Thermometer API document to reflect changes in Thermometer interface and introduction of ThermometerManager interface and fixes minor formatiing inconsistencies. --- doc/thermometer-api.txt | 60 +++++++++++++++++++++++++------------------------ 1 file changed, 31 insertions(+), 29 deletions(-) diff --git a/doc/thermometer-api.txt b/doc/thermometer-api.txt index 2271270..1828811 100644 --- a/doc/thermometer-api.txt +++ b/doc/thermometer-api.txt @@ -1,30 +1,16 @@ BlueZ D-Bus Thermometer API description -**************************************** +*************************************** Santiago Carot-Nemesio -Health Thermometer Profile hierarchy -===================================== +Health Thermometer Manager hierarchy +==================================== Service org.bluez -Interface org.bluez.Thermometer -Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX - - -Methods void SetProperty(string name, variant value) - - Changes the value of the specified property. Only - read-write properties can be changed. On success - this will emit a PropertyChanged signal. +Interface org.bluez.ThermometerManager +Object path [variable prefix]/{hci0,hci1,...} - Possible Errors: org.bluez.Error.InvalidArguments - - dict GetProperties() - - Returns all properties for the interface. See the - Properties section for the available properties. - - RegisterWatcher(object agent) +Methods RegisterWatcher(object agent) Registers a watcher to monitor scanned measurements. This agent will be notified about final temperature @@ -36,30 +22,45 @@ Methods void SetProperty(string name, variant value) Unregisters a watcher. - Final and intermediate temperatures won't be notified to - this agent any more. - - Possible Errors: org.bluez.Error.InvalidArguments - org.bluez.Error.NotFound - EnableIntermediateMeasurement(object agent) Enables intermediate measurement notifications for this - agent if the thermometer supports it. + agent. Intermediate measurements will be enabled only + for thermometers which support it. Possible Errors: org.bluez.Error.InvalidArguments - org.bluez.Error.NotSupported DisableIntermediateMeasurement(object agent) Disables intermediate measurement notifications for this - agent. It will disable notifications in the thermometer + agent. It will disable notifications in thermometers when the last agent removes the watcher for intermediate measurements. Possible Errors: org.bluez.Error.InvalidArguments org.bluez.Error.NotFound +Health Thermometer Profile hierarchy +==================================== + +Service org.bluez +Interface org.bluez.Thermometer +Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX + + +Methods void SetProperty(string name, variant value) + + Changes the value of the specified property. Only + read-write properties can be changed. On success + this will emit a PropertyChanged signal. + + Possible Errors: org.bluez.Error.InvalidArguments + + dict GetProperties() + + Returns all properties for the interface. See the + Properties section for the available properties. + Signals PropertyChanged(string name, variant value) This signal indicates a changed value of the given @@ -91,6 +92,7 @@ Properties boolean Intermediate [readonly] Health Thermometer Watcher hierarchy ==================================== + Service unique name Interface org.bluez.ThermometerWatcher Object path freely definable -- 1.7.11.3