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-05-02 01:07:36 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_components/binary_sensor.markdown
Adam Mills b83f3855ee
Rename sensor_class to device_class
2017-02-10 19:10:24 -05:00

1.5 KiB
Raw Blame History

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: 0/off/low/open/false and 1/on/high/closed/true.

Knowing that there are only two states allows Home Assistant to represent the sensor better in the frontend.

Most binary sensors support the device_class: 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.