Add support for enocean window handle FA 10 00 (Hoppe) (#11499)

* home assistant documentation change for PR29968

Add documentation description for home assistant PR 29968 https://github.com/home-assistant/home-assistant/pull/29968 to describe window handle setup in configuration.yaml file

* ✏️ Tweak

* Update source/_integrations/enocean.markdown

accepted review improvement proposal

Co-Authored-By: Franck Nijhof <frenck@frenck.nl>

Co-authored-by: Klaas Schoute <klaas_schoute@hotmail.com>
Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
rhadamantys 2019-12-25 15:29:58 +01:00 committed by Franck Nijhof
parent 721c4af635
commit 7eeba4bd8d

View File

@ -19,7 +19,7 @@ The `enocean` integration adds support for some of these devices. You will need
There is currently support for the following device types within Home Assistant:
- [Binary Sensor](#binary-sensor) - Wall switches
- [Sensor](#sensor) - Power meters, temperature sensors and humidity sensors
- [Sensor](#sensor) - Power meters, temperature sensors, humidity sensors and window handles
- [Light](#light) - Dimmers
- [Switch](#switch)
@ -32,7 +32,7 @@ The following devices have been confirmed to work out of the box:
- Omnio WS-CH-102-L-rw battery-less wall switch
- Permundo PSC234 (switch and power monitor)
- EnOcean STM-330 temperature sensor
- Hoppe SecuSignal window handle from Somfy
If you own a device not listed here, please check whether your device can talk in one of the listed [EnOcean Equipment Profiles](https://www.enocean-alliance.org/what-is-enocean/specifications/) (EEP).
If it does, it will most likely work.
@ -160,6 +160,7 @@ The EnOcean sensor platform currently supports the following device types:
* [power sensor](#power-sensor)
* [humidity sensor](#humidity-sensor)
* [temperature sensor](#temperature-sensor)
* [window handle](#window-handle)
To use your EnOcean device, you first have to set up your [EnOcean hub](#hub) and then add the following to your `configuration.yaml` file:
@ -188,7 +189,6 @@ device_class:
default: powersensor
{% endconfiguration %}
### Power sensor
This has been tested with a Permundo PSC234 switch, but any device sending EEP **A5-12-01** messages will work.
@ -204,7 +204,6 @@ sensor:
device_class: powersensor
```
### Humidity sensor
The following [EnOcean Equipment Profiles](https://www.enocean-alliance.org/what-is-enocean/specifications/) are supported:
@ -298,6 +297,29 @@ sensor:
range_max: 250
```
### Window handle
As of now, the Hoppe SecuSignal window handle from Somfy has been successfully tested. However, any mechanical window handle that follows the EnOcean RPS telegram spec F6 10 00 (Hoppe AG) is supported.
To configure a window handle, add the following code to your `configuration.yaml`:
```yaml
# Example configuration.yaml entry for window handle EEP F6-10-00
sensor:
- name: Living Room Window Handle
platform: enocean
id: [0xDE,0xAD,0xBE,0xEF]
device_class: windowhandle
```
The configuration does not have any optional parameters.
The window handle sensor can have the following states:
- **closed**: The window handle is in closed position (typically down, or 6 o'clock)
- **open**: The window handle is in open position (typically left or right, or 3 o'clock or 9 o'clock)
- **tilt**: The window handle is in tilt position (typically up or 12 o'clock)
## Switch
An EnOcean switch can take many forms. Currently, only a few types have been tested: Permundo PSC234 and Nod On SIN-2-1-01.