| BlueZ D-Bus Thermometer API description |
| *************************************** |
| |
| Santiago Carot-Nemesio <sancane@gmail.com> |
| |
| Health Thermometer Manager hierarchy |
| ==================================== |
| |
| Service org.bluez |
| Interface org.bluez.ThermometerManager1 |
| Object path [variable prefix]/{hci0,hci1,...} |
| |
| Methods RegisterWatcher(object agent) |
| |
| Registers a watcher to monitor scanned measurements. |
| This agent will be notified about final temperature |
| measurements. |
| |
| Possible Errors: org.bluez.Error.InvalidArguments |
| |
| UnregisterWatcher(object agent) |
| |
| Unregisters a watcher. |
| |
| EnableIntermediateMeasurement(object agent) |
| |
| Enables intermediate measurement notifications |
| for this agent. Intermediate measurements will |
| be enabled only for thermometers which support it. |
| |
| Possible Errors: org.bluez.Error.InvalidArguments |
| |
| DisableIntermediateMeasurement(object agent) |
| |
| Disables intermediate measurement notifications |
| for this 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.Thermometer1 |
| Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX |
| |
| |
| Properties boolean Intermediate [readonly] |
| |
| True if the thermometer supports intermediate |
| measurement notifications. |
| |
| uint16 Interval (optional) [readwrite] |
| |
| The Measurement Interval defines the time (in |
| seconds) between measurements. This interval is |
| not related to the intermediate measurements and |
| must be defined into a valid range. Setting it |
| to zero means that no periodic measurements will |
| be taken. |
| |
| uint16 Maximum (optional) [readonly] |
| |
| Defines the maximum value allowed for the interval |
| between periodic measurements. |
| |
| uint16 Minimum (optional) [readonly] |
| |
| Defines the minimum value allowed for the interval |
| between periodic measurements. |
| |
| |
| Health Thermometer Watcher hierarchy |
| ==================================== |
| |
| Service unique name |
| Interface org.bluez.ThermometerWatcher1 |
| Object path freely definable |
| |
| Methods void MeasurementReceived(dict measurement) |
| |
| This callback gets called when a measurement has been |
| scanned in the thermometer. |
| |
| Measurement: |
| |
| int16 Exponent: |
| int32 Mantissa: |
| |
| Exponent and Mantissa values as |
| extracted from float value defined by |
| IEEE-11073-20601. |
| |
| Measurement value is calculated as |
| (Mantissa) * (10^Exponent) |
| |
| For special cases Exponent is |
| set to 0 and Mantissa is set to |
| one of following values: |
| |
| +(2^23 - 1) NaN (invalid or |
| missing data) |
| -(2^23) NRes |
| +(2^23 - 2) +Infinity |
| -(2^23 - 2) -Infinity |
| |
| string Unit: |
| |
| Possible values: "celsius" or |
| "fahrenheit" |
| |
| uint64 Time (optional): |
| |
| Time of measurement, if |
| supported by device. |
| Expressed in seconds since epoch. |
| |
| string Type (optional): |
| |
| Only present if measurement type |
| is known. |
| |
| Possible values: "armpit", "body", |
| "ear", "finger", "intestines", |
| "mouth", "rectum", "toe", |
| "tympanum" |
| |
| string Measurement: |
| |
| Possible values: "final" or |
| "intermediate" |
