From 58e973dbd7e382f1121c7055ee920a1b0ea83633 Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Sun, 23 Jul 2017 10:41:09 -0400 Subject: [PATCH] Cleaned up binary_sensor docs (#3039) --- source/_components/binary_sensor.markdown | 36 +++++++++++------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/source/_components/binary_sensor.markdown b/source/_components/binary_sensor.markdown index 25d5e31f559..a2cc7ee8518 100644 --- a/source/_components/binary_sensor.markdown +++ b/source/_components/binary_sensor.markdown @@ -1,7 +1,7 @@ --- layout: page 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 sidebar: true comments: false @@ -9,27 +9,27 @@ sharing: 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 -- **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) +- **cold**: `On` means cold +- **connectivity**: `On` means connection present, `Off` means no connection +- **gas**: `On` means gas detected +- **heat**: `On` means 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. On means open, Off means closed -- **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 +- **moisture**: `On` means wet +- **motion**: `On` means motion detected +- **moving**: `On` means moving, `Off` means stopped +- **occupancy**: `On` means occupied, `Off` means not occupied +- **opening**: `On` means open, `Off` means closed +- **power**: Power, over-current, etc. +- **safety**: `On` means unsafe, `Off` means safe +- **smoke**: `On` means smoke detected +- **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](https://home-assistant.io/components/#sensor).