EnOcean Binary Sensor


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.

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 variables:

  • id (Required): The ID of the device. This is the 4 bytes long number written on the dimmer.
  • name (Optional): An identifier for the switch in the frontend.
  • device_class (Optional): The type/class of the sensor to set the icon in the frontend.

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.

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: "{% if trigger.event.data.onoff %} light.turn_on {% else %} light.turn_off {%endif %}"
      data_template:
        entity_id: "{% if trigger.event.data.which == 1 %} light.hall_left {% else %} light.hall_right {%endif %}"