From e599084f8efb3c75e1b0444b05359b5dac9b6de5 Mon Sep 17 00:00:00 2001 From: klaasnicolaas Date: Mon, 3 Jun 2019 20:19:46 +0200 Subject: [PATCH] :rewind: Put the device classes back --- source/_components/binary_sensor.markdown | 34 ++++++++++++++++++++++- source/_components/cover.markdown | 15 ++++++++++ source/_components/sensor.markdown | 15 ++++++++++ 3 files changed, 63 insertions(+), 1 deletion(-) diff --git a/source/_components/binary_sensor.markdown b/source/_components/binary_sensor.markdown index 6206478e09c..2d83527eed8 100644 --- a/source/_components/binary_sensor.markdown +++ b/source/_components/binary_sensor.markdown @@ -14,8 +14,40 @@ ha_qa_scale: internal ha_release: 0.9 --- -Binary sensors gather information about the state of devices which have a "digital" return value (either 1 or 0). These can be switches, contacts, pins, etc. These sensors only have two states: **0/off/low/closed/false** and **1/on/high/open/true**. Knowing that there are only two states allows Home Assistant to represent these sensors in a better way in the frontend according to their functionality. +Binary sensors gather information about the state of devices which have a "digital" return value (either 1 or 0). These can be switches, contacts, pins, etc. These sensors only have two states: **0/off/low/closed/false** and **1/on/high/open/true**. Knowing that there are only two states allows Home Assistant to represent these sensors in a better way in the frontend according to their functionality. + +### {% linkable_title Device Class %} + +The way these sensors are displayed in the frontend can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for binary sensors: + +- **None**: Generic on/off. This is the default and doesn't need to be set. +- **battery**: `On` means low, `Off` means normal +- **cold**: `On` means cold, `Off` means normal +- **connectivity**: `On` means connected, `Off` means disconnected +- **door**: `On` means open, `Off` means closed +- **garage_door**: `On` means open, `Off` means closed +- **gas**: `On` means gas detected, `Off` means no gas (clear) +- **heat**: `On` means hot, `Off` means normal +- **light**: `On` means light detected, `Off` means no light +- **lock**: `On` means open (unlocked), `Off` means closed (locked) +- **moisture**: `On` means moisture detected (wet), `Off` means no moisture (dry) +- **motion**: `On` means motion detected, `Off` means no motion (clear) +- **moving**: `On` means moving, `Off` means not moving (stopped) +- **occupancy**: `On` means occupied, `Off` means not occupied (clear) +- **opening**: `On` means open, `Off` means closed +- **plug**: `On` means device is plugged in, `Off` means device is unplugged +- **power**: `On` means power detected, `Off` means no power +- **presence**: `On` means home, `Off` means away +- **problem**: `On` means problem detected, `Off` means no problem (OK) +- **safety**: `On` means unsafe, `Off` means safe +- **smoke**: `On` means smoke detected, `Off` means no smoke (clear) +- **sound**: `On` means sound detected, `Off` means no sound (clear) +- **vibration**: `On` means vibration detected, `Off` means no vibration (clear) +- **window**: `On` means open, `Off` means closed + +For analog sensors please check the [component overview](/components/#sensor).

+Example of various device classes icons in `On` and `Off` state.

diff --git a/source/_components/cover.markdown b/source/_components/cover.markdown index 81b753f4314..90172534114 100644 --- a/source/_components/cover.markdown +++ b/source/_components/cover.markdown @@ -16,6 +16,21 @@ ha_release: 0.27 Home Assistant can give you an interface to control covers such as rollershutters, blinds, and garage doors. +## {% linkable_title Device Class %} + +The way these sensors are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for covers: + +- **None**: Generic cover. This is the default and doesn't need to be set. +- **awning**: Control of an awning, such as an exterior retractable window, door, or patio cover. +- **blind**: Control of blinds, which are linked slats that expand or collapse to cover an opening or may be tilted to partially covering an opening, such as window blinds. +- **curtain**: Control of curtains or drapes, which is often fabric hung above a window or door that can be drawn open. +- **damper**: Control of a mechanical damper that reduces airflow, sound, or light. +- **door**: Control of a door or gate that provides access to an area. +- **garage**: Control of a garage door that provides access to a garage. +- **shade**: Control of shades, which are a continuous plane of material or connected cells that expanded or collapsed over an opening, such as window shades. +- **shutter**: Control of shutters, which are linked slats that swing out/in to covering an opening or may be tilted to partially cover an opening, such as indoor or exterior window shutters. +- **window**: Control of a physical window that opens and closes or may tilt. + ## {% linkable_title Services %} ### {% linkable_title Cover control services %} diff --git a/source/_components/sensor.markdown b/source/_components/sensor.markdown index d28f8a51528..e7b677297c3 100644 --- a/source/_components/sensor.markdown +++ b/source/_components/sensor.markdown @@ -18,6 +18,21 @@ Sensors are gathering information about states and conditions. Home Assistant currently supports a wide range of sensors. They are able to display information which are provides by Home Assistant directly, are gathered from web services, and, of course, physical devices. +## {% linkable_title Device Class %} + +The way these sensors are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for sensors: + +- **None**: Generic sensor. This is the default and doesn't need to be set. +- **battery**: Percentage of battery that is left. +- **humidity**: Percentage of humidity in the air. +- **illuminance**: The current light level in lx or lm. +- **signal_strength**: Signal strength in dB or dBm. +- **temperature**: Temperature in °C or °F. +- **power**: Power in W or kW. +- **pressure**: Pressure in hPa or mbar. +- **timestamp**: Datetime object or timestamp string. +

+Example of various device class icons for sensors.