mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-05 10:38:58 +00:00
1.5 KiB
1.5 KiB
layout, title, description, date, sidebar, comments, sharing, footer
| layout | title | description | date | sidebar | comments | sharing | footer |
|---|---|---|---|---|---|---|---|
| page | Binary Sensor | Instructions how to setup your binary sensors with Home Assistant. | 2015-11-20 14:00 | true | false | true | true |
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: off/low/open and on/high/closed.
Knowing that there are only two states allows Home Assistant to represent the sensor better in the frontend.
Most binary sensors support the SENSOR_CLASSES which let you specify the type of your sensor. The following types are supported:
- None: Generic on/off
- cold: On means cold (or too cold)
- connectivity: On means connection present, Off means no connection
- gas: CO, CO2, etc
- heat: On means hot (or too hot)
- light: Lightness threshold
- moisture: Specifically a wetness sensor
- motion: Motion sensor
- moving: On means moving, Off means stopped
- occupancy: On means occupied, Off means not occupied
- opening: Door, window, etc
- power: Power, over-current, etc
- safety: On means unsafe, Off means safe
- smoke: Smoke detector
- sound: On means sound detected, Off means no sound
- vibration: On means vibration detected, Off means no vibration
For analog sensors please check the component overview.