jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-27 11:16:54 +00:00
Code Issues Packages Projects Releases Wiki Activity

Cleaned up binary_sensor docs (#3039)

Browse Source
This commit is contained in:
Alok Saboo 2017-07-23 10:41:09 -04:00 committed by Fabian Affolter
parent d29eb9a396
commit 58e973dbd7
1 changed files with 18 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
source/_components/binary_sensor.markdown
View File

@ -1,7 +1,7 @@
--- ---
layout: page layout: page
title: "Binary Sensor" title: "Binary Sensor"
description: "Instructions how to setup your binary sensors with Home Assistant." description: "Instructions on how-to setup binary sensors with Home Assistant."
date: 2015-11-20 14:00 date: 2015-11-20 14:00
sidebar: true sidebar: true
comments: false comments: false
@ -9,27 +9,27 @@ sharing: true
footer: true footer: 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: **0/off/low/closed/false** and **1/on/high/open/true**. 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**.
Knowing that there are only two states allows Home Assistant to represent the sensor better in the frontend. 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.
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: 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 - **None**: Generic on/off
- **cold**: On means cold (or too cold) - **cold**: `On` means cold
- **connectivity**: On means connection present, Off means no connection - **connectivity**: `On` means connection present, `Off` means no connection
- **gas**: CO, CO2, etc - **gas**: `On` means gas detected
- **heat**: On means hot (or too hot) - **heat**: `On` means hot
- **light**: Lightness threshold - **light**: Lightness threshold
- **moisture**: Specifically a wetness sensor - **moisture**: `On` means wet
- **motion**: Motion sensor - **motion**: `On` means motion detected
- **moving**: On means moving, Off means stopped - **moving**: `On` means moving, `Off` means stopped
- **occupancy**: On means occupied, Off means not occupied - **occupancy**: `On` means occupied, `Off` means not occupied
- **opening**: Door, window, etc. On means open, Off means closed - **opening**: `On` means open, `Off` means closed
- **power**: Power, over-current, etc - **power**: Power, over-current, etc.
- **safety**: On means unsafe, Off means safe - **safety**: `On` means unsafe, `Off` means safe
- **smoke**: Smoke detector - **smoke**: `On` means smoke detected
- **sound**: On means sound detected, Off means no sound - **sound**: `On` means sound detected, `Off` means no sound
- **vibration**: On means vibration detected, Off means no vibration - **vibration**: `On` means vibration detected, `Off` means no vibration
For analog sensors please check the [component overview](https://home-assistant.io/components/#sensor). For analog sensors please check the [component overview](https://home-assistant.io/components/#sensor).