|
1 | 1 | --- |
2 | 2 | layout: page |
3 | 3 | title: "Binary Sensor" |
4 | | -description: "Instructions how to setup your binary sensors with Home Assistant." |
| 4 | +description: "Instructions on how-to setup binary sensors with Home Assistant." |
5 | 5 | date: 2015-11-20 14:00 |
6 | 6 | sidebar: true |
7 | 7 | comments: false |
8 | 8 | sharing: true |
9 | 9 | footer: true |
10 | 10 | --- |
11 | 11 |
|
12 | | -Binary sensors are gathering information about state of switches, contacts, pins, and alike. The return value of those sensors is usually digital (1/0). This means that those sensors knows only two states: **0/off/low/closed/false** and **1/on/high/open/true**. |
| 12 | +Binary sensors gather information about state of switches, contacts, pins, and alike. The return value of those sensors is usually digital (1/0). This means that those sensors knows only two states: **0/off/low/closed/false** and **1/on/high/open/true**. |
13 | 13 |
|
14 | | -Knowing that there are only two states allows Home Assistant to represent the sensor better in the frontend. |
| 14 | +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. |
15 | 15 |
|
16 | | -The display style of each entity can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for binary sensors: |
| 16 | +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: |
17 | 17 |
|
18 | 18 | - **None**: Generic on/off |
19 | | -- **cold**: On means cold (or too cold) |
20 | | -- **connectivity**: On means connection present, Off means no connection |
21 | | -- **gas**: CO, CO2, etc |
22 | | -- **heat**: On means hot (or too hot) |
| 19 | +- **cold**: `On` means cold |
| 20 | +- **connectivity**: `On` means connection present, `Off` means no connection |
| 21 | +- **gas**: `On` means gas detected |
| 22 | +- **heat**: `On` means hot |
23 | 23 | - **light**: Lightness threshold |
24 | | -- **moisture**: Specifically a wetness sensor |
25 | | -- **motion**: Motion sensor |
26 | | -- **moving**: On means moving, Off means stopped |
27 | | -- **occupancy**: On means occupied, Off means not occupied |
28 | | -- **opening**: Door, window, etc. On means open, Off means closed |
29 | | -- **power**: Power, over-current, etc |
30 | | -- **safety**: On means unsafe, Off means safe |
31 | | -- **smoke**: Smoke detector |
32 | | -- **sound**: On means sound detected, Off means no sound |
33 | | -- **vibration**: On means vibration detected, Off means no vibration |
| 24 | +- **moisture**: `On` means wet |
| 25 | +- **motion**: `On` means motion detected |
| 26 | +- **moving**: `On` means moving, `Off` means stopped |
| 27 | +- **occupancy**: `On` means occupied, `Off` means not occupied |
| 28 | +- **opening**: `On` means open, `Off` means closed |
| 29 | +- **power**: Power, over-current, etc. |
| 30 | +- **safety**: `On` means unsafe, `Off` means safe |
| 31 | +- **smoke**: `On` means smoke detected |
| 32 | +- **sound**: `On` means sound detected, `Off` means no sound |
| 33 | +- **vibration**: `On` means vibration detected, `Off` means no vibration |
34 | 34 |
|
35 | 35 | For analog sensors please check the [component overview](https://home-assistant.io/components/#sensor). |
0 commit comments