binary_sensor.py

Go to the documentation of this file.

"""Support for AlarmDecoder zone states- represented as binary sensors."""
 
import logging
 
from homeassistant.components.binary_sensor import BinarySensorEntity
from homeassistant.core import HomeAssistant
from homeassistant.helpers.dispatcher import async_dispatcher_connect
from homeassistant.helpers.entity_platform import AddEntitiesCallback
 
from . import AlarmDecoderConfigEntry
from .const import (
    CONF_RELAY_ADDR,
    CONF_RELAY_CHAN,
    CONF_ZONE_LOOP,
    CONF_ZONE_NAME,
    CONF_ZONE_NUMBER,
    CONF_ZONE_RFID,
    CONF_ZONE_TYPE,
    DEFAULT_ZONE_OPTIONS,
    OPTIONS_ZONES,
    SIGNAL_REL_MESSAGE,
    SIGNAL_RFX_MESSAGE,
    SIGNAL_ZONE_FAULT,
    SIGNAL_ZONE_RESTORE,
)
from .entity import AlarmDecoderEntity
 
_LOGGER = logging.getLogger(__name__)
 
ATTR_RF_BIT0 = "rf_bit0"
ATTR_RF_LOW_BAT = "rf_low_battery"
ATTR_RF_SUPERVISED = "rf_supervised"
ATTR_RF_BIT3 = "rf_bit3"
ATTR_RF_LOOP3 = "rf_loop3"
ATTR_RF_LOOP2 = "rf_loop2"
ATTR_RF_LOOP4 = "rf_loop4"
ATTR_RF_LOOP1 = "rf_loop1"
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    entry: AlarmDecoderConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up for AlarmDecoder sensor."""
 
    client = entry.runtime_data.client
    zones = entry.options.get(OPTIONS_ZONES, DEFAULT_ZONE_OPTIONS)
 
    entities = []
    for zone_num in zones:
        zone_info = zones[zone_num]
        zone_type = zone_info[CONF_ZONE_TYPE]
        zone_name = zone_info[CONF_ZONE_NAME]
        zone_rfid = zone_info.get(CONF_ZONE_RFID)
        zone_loop = zone_info.get(CONF_ZONE_LOOP)
        relay_addr = zone_info.get(CONF_RELAY_ADDR)
        relay_chan = zone_info.get(CONF_RELAY_CHAN)
        entity = AlarmDecoderBinarySensor(
            client,
            zone_num,
            zone_name,
            zone_type,
            zone_rfid,
            zone_loop,
            relay_addr,
            relay_chan,
        )
        entities.append(entity)
 
    async_add_entities(entities)
 
 
class AlarmDecoderBinarySensor(AlarmDecoderEntity, BinarySensorEntity):
    """Representation of an AlarmDecoder binary sensor."""
 
    _attr_should_poll = False
 
    def __init__(
        self,
        client,
        zone_number,
        zone_name,
        zone_type,
        zone_rfid,
        zone_loop,
        relay_addr,
        relay_chan,
    ):
        """Initialize the binary_sensor."""
        super().__init__(client)
        self._attr_unique_id_attr_unique_id = f"{client.serial_number}-zone-{zone_number}"
        self._zone_number_zone_number = int(zone_number)
        self._zone_type_zone_type = zone_type
        self._attr_name_attr_name = zone_name
        self._attr_is_on_attr_is_on = False
        self._rfid_rfid = zone_rfid
        self._loop_loop = zone_loop
        self._relay_addr_relay_addr = relay_addr
        self._relay_chan_relay_chan = relay_chan
        self._attr_device_class_attr_device_class = zone_type
        self._attr_extra_state_attributes_attr_extra_state_attributes = {
            CONF_ZONE_NUMBER: self._zone_number_zone_number,
        }
 
    async def async_added_to_hass(self) -> None:
        """Register callbacks."""
        self.async_on_removeasync_on_remove(
            async_dispatcher_connect(self.hasshass, SIGNAL_ZONE_FAULT, self._fault_callback_fault_callback)
        )
 
        self.async_on_removeasync_on_remove(
            async_dispatcher_connect(
                self.hasshass, SIGNAL_ZONE_RESTORE, self._restore_callback_restore_callback
            )
        )
 
        self.async_on_removeasync_on_remove(
            async_dispatcher_connect(
                self.hasshass, SIGNAL_RFX_MESSAGE, self._rfx_message_callback_rfx_message_callback
            )
        )
 
        self.async_on_removeasync_on_remove(
            async_dispatcher_connect(
                self.hasshass, SIGNAL_REL_MESSAGE, self._rel_message_callback_rel_message_callback
            )
        )
 
    def _fault_callback(self, zone):
        """Update the zone's state, if needed."""
        if zone is None or int(zone) == self._zone_number_zone_number:
            self._attr_is_on_attr_is_on = True
            self.schedule_update_ha_stateschedule_update_ha_state()
 
    def _restore_callback(self, zone):
        """Update the zone's state, if needed."""
        if zone is None or (int(zone) == self._zone_number_zone_number and not self._loop_loop):
            self._attr_is_on_attr_is_on = False
            self.schedule_update_ha_stateschedule_update_ha_state()
 
    def _rfx_message_callback(self, message):
        """Update RF state."""
        if self._rfid_rfid and message and message.serial_number == self._rfid_rfid:
            rfstate = message.value
            if self._loop_loop:
                self._attr_is_on_attr_is_on = bool(message.loop[self._loop_loop - 1])
            attr = {CONF_ZONE_NUMBER: self._zone_number_zone_number}
            if self._rfid_rfid and rfstate is not None:
                attr[ATTR_RF_BIT0] = bool(rfstate & 0x01)
                attr[ATTR_RF_LOW_BAT] = bool(rfstate & 0x02)
                attr[ATTR_RF_SUPERVISED] = bool(rfstate & 0x04)
                attr[ATTR_RF_BIT3] = bool(rfstate & 0x08)
                attr[ATTR_RF_LOOP3] = bool(rfstate & 0x10)
                attr[ATTR_RF_LOOP2] = bool(rfstate & 0x20)
                attr[ATTR_RF_LOOP4] = bool(rfstate & 0x40)
                attr[ATTR_RF_LOOP1] = bool(rfstate & 0x80)
            self._attr_extra_state_attributes_attr_extra_state_attributes = attr
            self.schedule_update_ha_stateschedule_update_ha_state()
 
    def _rel_message_callback(self, message):
        """Update relay / expander state."""
 
        if self._relay_addr_relay_addr == message.address and self._relay_chan_relay_chan == message.channel:
            _LOGGER.debug(
                "%s %d:%d value:%d",
                "Relay" if message.type == message.RELAY else "ZoneExpander",
                message.address,
                message.channel,
                message.value,
            )
            self._attr_is_on_attr_is_on = bool(message.value)
            self.schedule_update_ha_stateschedule_update_ha_state()