[RFC] Health Thermometer Profile API

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



---
 doc/thermometer.txt |  101 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 101 insertions(+), 0 deletions(-)
 create mode 100644 doc/thermometer.txt

diff --git a/doc/thermometer.txt b/doc/thermometer.txt
new file mode 100644
index 0000000..9d74403
--- /dev/null
+++ b/doc/thermometer.txt
@@ -0,0 +1,101 @@
+BlueZ D-Bus Thermomether API description
+****************************************
+
+	Santiago Carot-Nemesio <sancane@xxxxxxxxx>
+
+Health Thermomether 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.
+
+		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
+			property.
+
+		MeasureReceived(dict measure)
+
+			This signal is emmited when a measure has been scanned
+			by the thermometer. The Time entry in the dict will be
+			only present if the device supports storing of data.
+			The Type entry is optional and it will be provided if
+			the measure type is non-static. For static measures the
+			property Type will be provided. The Value entry
+			corresponds to IEEE-11073 32-bit FLOAT.
+
+			Dict is defined as below:
+			{
+				"Value" : uint32,
+				"Unit" : ("Celsius" or "Fahrenheit")
+				"Time" : {
+						"Year" : uint16,
+						"Month" : uint8,
+						"Day" : uint8,
+						"Hours" : uint8,
+						"Minutes" : uint8,
+						"Seconds" : uint8
+					}
+				"Type" : uint8,
+				"Measurement" : ("Final", "Intermediate")
+			}
+
+Properties	boolean Enable [readwrite]
+
+			Switch notification of a measure on or off.
+
+		boolean Intermediate (optional) [readwrite]
+
+			Switch notification of intermediates measures on or off.
+
+		uint16 Interval (optional) [readwrite]
+
+			The Measurement Interval defines the time (in seconds)
+			between measurements. This interval is not related to
+			the intermediates measures and must be defined into
+			a valid range. Setting it to zero meaning that no
+			periodic measurements will be taken.
+
+		dict Range (optional) [readonly]
+
+			Defines the valid range for the interval between
+			periodic measurements.
+
+			Dict is defined as below:
+			{
+				"Minimum" : uint16,
+				"Maximum" : uint16,
+			}
+
+		uint8 Type (optional) [readonly]
+
+			Describes the type of the temperature measurement in
+			relation to the thermometer location. If this property
+			is present, the measure type won't be provided with the
+			measure received signal. The value corresponds to the
+			descriptions used in ISO/IEEE 11073-10408-2008.
+			Possible values:
+			0 -> Reserved for future use
+			1 -> Armpit
+			2 -> Body (general)
+			3 -> Ear (usually lobe)
+			4 -> Finger
+			5 -> Gastro-intestinal Tract
+			6 -> Mouth
+			7 -> Rectum
+			8 -> Toe
+			9 -> Tympanum (ear drum)
+			10-255 -> Reserved for future use
-- 
1.7.5.2

--
To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Bluez Devel]     [Linux Wireless Networking]     [Linux Wireless Personal Area Networking]     [Linux ATH6KL]     [Linux USB Devel]     [Linux Media Drivers]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Big List of Linux Books]

  Powered by Linux