mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-05 18:48:59 +00:00
19d267b572
* Updated all Zigbee configuration variable Updated style of all Zigbee documentation to follow new configuration variables description. Related to #6385. * Update binary_sensor.zigbee.markdown * Update zigbee.markdown ✏️ Tweak * Update switch.zigbee.markdown ✏️ Tweak * Update sensor.zigbee.markdown ✏️ Tweak * Update light.zigbee.markdown ✏️ Tweak * Update binary_sensor.zigbee.markdown ✏️ Tweak * Update zigbee.markdown ✏️ Second Tweak
47 lines
1.7 KiB
Markdown
47 lines
1.7 KiB
Markdown
---
|
|
layout: page
|
|
title: "ZigBee Binary Sensor"
|
|
description: "Instructions on how to set up ZigBee binary sensors within Home Assistant."
|
|
date: 2016-01-28 12:38
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: zigbee.png
|
|
ha_category: Binary Sensor
|
|
ha_release: 0.12
|
|
ha_iot_class: "Local Polling"
|
|
---
|
|
|
|
A `zigbee` binary sensor in this context is a device connected to one of the digital input pins on a [ZigBee](http://www.zigbee.org/) module. The states reported by such a device are limited to `on` or `off`. By default, a binary sensor is considered `on` when the ZigBee device's digital input pin is held 'high' and considered `off` when it is held `low`. This behavior can be inverted by setting the `on_state` configuration variable to `low`.
|
|
|
|
To enable a digital input pin as binary sensor in your installation, add the following lines to your `configuration.yaml`:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
binary_sensor:
|
|
- platform: zigbee
|
|
name: Hallway PIR Sensor
|
|
pin: 0
|
|
```
|
|
|
|
{% configuration %}
|
|
name:
|
|
description: The name you would like to give the binary sensor in Home Assistant.
|
|
required: true
|
|
type: string
|
|
pin:
|
|
description: The number identifying which pin to use.
|
|
required: true
|
|
type: integer
|
|
address:
|
|
description: The long 64-bit address of the remote ZigBee device whose digital input pin you'd like to sample. Do not include this variable if you want to sample the local ZigBee device's pins.
|
|
required: false
|
|
type: string
|
|
on_state:
|
|
description: Either `high` or `low`, depicting whether the binary sensor is considered `on` when the pin is `high` or `low`.
|
|
required: false
|
|
default: high
|
|
type: string
|
|
{% endconfiguration %}
|