home-assistant.io/source/_components/binary_sensor.pilight.markdown
clarkewd 77144721d7 Document allowing Pilight Binary Sensor to control reset_delay_sec through configuration (#2944)
* Document allowing Pilight Binary Sensor to control reset_delay_sec through configuration

* Minimize configuration sample
2017-07-06 21:11:54 +02:00

50 lines
1.8 KiB
Markdown

---
layout: page
title: "Pilight Binary Sensor"
description: "Instructions how to integrate pilight binary sensors within Home Assistant."
date: 2017-03-24 20:41
sidebar: true
comments: false
sharing: true
footer: true
logo: pilight.png
ha_category: Binary Sensor
ha_release: 0.44
ha_iot_class: "Local Polling"
---
This component implement the [pilight hub](https://github.com/home-assistant/home-assistant.github.io/source/_components/pilight.markdown) binary sensor functionality.
Two type of pilight binary sensor configuration available. A normal sensor which send the on and off state cyclical and a trigger sensor which send only a trigger when an event happend (for example lots of cheap PIR motion detector) (see example configuration below).
```yaml
# Example configuration.yml entry
binary_sensor:
- platform: pilight
variable: 'state'
```
Configuration variables:
- **variable** (*Required*): The variable name in the data stream that defines the sensor value.
- **payload** (*Required*): Message payload identifiers. Only if all identifiers are matched the sensor value is set.
- **name** (*Optional*): Name of the sensor.
- **payload_on** (*Optional*): Variable `on` value. The component will recognize this as logical '1'.
- **payload_off** (*Optional*): Variable `off` value. The component will recognize this as logical '0'.
- **disarm_after_trigger:** (*Optional*): Configure sensor as trigger type.
- **reset_delay_sec** (*Optional*): Seconds before the sensor is disarmed if `disarm_after_trigger` is set to true. Default is 30 seconds.
A full configuration example could look like this:
```yaml
# Example configuration.yml entry
binary_sensor:
- platform: pilight
name: 'Motion'
variable: 'state'
payload:
unitcode: 371399
payload_on: 'closed'
disarm_after_trigger: True
reset_delay_sec: 30
```