Characteristics
The table below contains a list of allowed characteristics. This will be extended over time. The philosophy has been to keep the app-adaptor API simple, so, for example, temperature is always in degrees Celsius and is a floating-point number. Apps and adaptors can easily make any conversions that are required for their own purposes.
Characteristic | Unit/Type | Description |
---|---|---|
temperature | Celcius/float | Temperature |
humidity | Percent/float | Relative humidity |
pressure | Bar/float | Atmospheric pressure |
luminance | Lux/float | Luminance |
battery | Percent/float | Battery status as a percentage of fully-charged |
binary_sensor | -/string | Can take the values “on” and “off” |
switch | -/string | Can take the values “on” and “off” |
connected | -/Boolean | Indicates whether a device is currently connected |
voltage | Volt/float | Voltage |
current | Ampere/float | Current |
power | Watt/float | Power |
energy | KJ/float | Energy |
buttons | -/dict | The states of a group of buttons in the form: { "1": "string", "2": "string" } The string can take the values "on" or "off". There may be one or more buttons. |
Updated less than a minute ago