binary_sensor.py

Go to the documentation of this file.

"""Support for EnOcean binary sensors."""
 
from __future__ import annotations
 
from enocean.utils import combine_hex
import voluptuous as vol
 
from homeassistant.components.binary_sensor import (
    DEVICE_CLASSES_SCHEMA,
    PLATFORM_SCHEMA as BINARY_SENSOR_PLATFORM_SCHEMA,
    BinarySensorDeviceClass,
    BinarySensorEntity,
)
from homeassistant.const import CONF_DEVICE_CLASS, CONF_ID, CONF_NAME
from homeassistant.core import HomeAssistant
import homeassistant.helpers.config_validation as cv
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
 
from .entity import EnOceanEntity
 
DEFAULT_NAME = "EnOcean binary sensor"
DEPENDENCIES = ["enocean"]
EVENT_BUTTON_PRESSED = "button_pressed"
 
PLATFORM_SCHEMA = BINARY_SENSOR_PLATFORM_SCHEMA.extend(
    {
        vol.Required(CONF_ID): vol.All(cv.ensure_list, [vol.Coerce(int)]),
        vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string,
        vol.Optional(CONF_DEVICE_CLASS): DEVICE_CLASSES_SCHEMA,
    }
)
 
 
def setup_platform(
    hass: HomeAssistant,
    config: ConfigType,
    add_entities: AddEntitiesCallback,
    discovery_info: DiscoveryInfoType | None = None,
) -> None:
    """Set up the Binary Sensor platform for EnOcean."""
    dev_id: list[int] = config[CONF_ID]
    dev_name: str = config[CONF_NAME]
    device_class: BinarySensorDeviceClass | None = config.get(CONF_DEVICE_CLASS)
 
    add_entities([EnOceanBinarySensor(dev_id, dev_name, device_class)])
 
 
class EnOceanBinarySensor(EnOceanEntity, BinarySensorEntity):
    """Representation of EnOcean binary sensors such as wall switches.
 
    Supported EEPs (EnOcean Equipment Profiles):
    - F6-02-01 (Light and Blind Control - Application Style 2)
    - F6-02-02 (Light and Blind Control - Application Style 1)
    """
 
    def __init__(
        self,
        dev_id: list[int],
        dev_name: str,
        device_class: BinarySensorDeviceClass | None,
    ) -> None:
        """Initialize the EnOcean binary sensor."""
        super().__init__(dev_id)
        self._attr_device_class_attr_device_class = device_class
        self.whichwhich = -1
        self.onoffonoff = -1
        self._attr_unique_id_attr_unique_id = f"{combine_hex(dev_id)}-{device_class}"
        self._attr_name_attr_name = dev_name
 
    def value_changed(self, packet):
        """Fire an event with the data that have changed.
 
        This method is called when there is an incoming packet associated
        with this platform.
 
        Example packet data:
        - 2nd button pressed
            ['0xf6', '0x10', '0x00', '0x2d', '0xcf', '0x45', '0x30']
        - button released
            ['0xf6', '0x00', '0x00', '0x2d', '0xcf', '0x45', '0x20']
        """
        # Energy Bow
        pushed = None
 
        if packet.data[6] == 0x30:
            pushed = 1
        elif packet.data[6] == 0x20:
            pushed = 0
 
        self.schedule_update_ha_stateschedule_update_ha_state()
 
        action = packet.data[1]
        if action == 0x70:
            self.whichwhich = 0
            self.onoffonoff = 0
        elif action == 0x50:
            self.whichwhich = 0
            self.onoffonoff = 1
        elif action == 0x30:
            self.whichwhich = 1
            self.onoffonoff = 0
        elif action == 0x10:
            self.whichwhich = 1
            self.onoffonoff = 1
        elif action == 0x37:
            self.whichwhich = 10
            self.onoffonoff = 0
        elif action == 0x15:
            self.whichwhich = 10
            self.onoffonoff = 1
        self.hasshass.bus.fire(
            EVENT_BUTTON_PRESSED,
            {
                "id": self.dev_iddev_id,
                "pushed": pushed,
                "which": self.whichwhich,
                "onoff": self.onoffonoff,
            },
        )