home-assistant.io/source/_components/binary_sensor.enocean.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	EnOcean Binary Sensor	Instructions on how to set up EnOcean binary sensors within Home Assistant.	2016-05-25 23:49	true	false	true	true	enocean.png	Binary Sensor	0.21	Local Push

This can typically be one of those batteryless wall switches. Tested with:

• Eltako FT55 which uses the EnOcean PTM 215 module
• TRIO2SYS Wall switches which uses the EnOcean PTM210 DB module

All switches using theses modules are expected to work. Other devices will most likely not work without changing the Home Assistant code.

{% linkable_title Configuration %}

To use your EnOcean device, you first have to set up your EnOcean hub and then add the following to your configuration.yaml file:

# Example configuration.yaml entry
binary_sensor:
  - platform: enocean
    id: [0x01,0x90,0x84,0x3C]

{% configuration %} id: description: The ID of the device. This is the 4 bytes long number written on the dimmer. required: true type: list name: description: An identifier for the switch in the frontend. required: false type: string default: EnOcean binary sensor device_class: description: The type/class of the sensor to set the icon in the frontend. required: false type: device_class {% endconfiguration %}

EnOcean binary sensors only generate 'button_pressed' events. The event data has following four fields:

• id: The ID of the device (see configuration).
• pushed: 1 for a button press, 0 for a button release.
• which: Always 0 when using the single rocket. 0 or 1 when using the dual rocket switch.
• onoff: 0 or 1 for either side of the rocket.

{% linkable_title Automation example %}

Sample automation to switch lights on and off:

# Example automation to turn lights on/off on button release
automation:
  - alias: hall light switches
    trigger:
      platform: event
      event_type: button_pressed
      event_data:
        id: [0xYY, 0xYY, 0xYY, 0xYY]
        pushed: 0
    action:
      service_template: "{% raw %}{% if trigger.event.data.onoff %} light.turn_on {% else %} light.turn_off {%endif %}{% endraw %}"
      data_template:
        entity_id: "{% raw %}{% if trigger.event.data.which == 1 %} light.hall_left {% else %} light.hall_right {%endif %}{% endraw %}"