mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-06 02:58:57 +00:00
36 lines
1.7 KiB
Markdown
36 lines
1.7 KiB
Markdown
---
|
|
layout: page
|
|
title: "Binary Sensor"
|
|
description: "Instructions on how-to setup binary sensors with Home Assistant."
|
|
date: 2015-11-20 14:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: 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 these sensors in a better way in the frontend according to their functionality.
|
|
|
|
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.
|
|
- **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**: `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).
|