light.py

Go to the documentation of this file.

"""Zerproc light platform."""
 
from __future__ import annotations
 
from datetime import timedelta
import logging
from typing import Any
 
import pyzerproc
 
from homeassistant.components.light import (
    ATTR_BRIGHTNESS,
    ATTR_HS_COLOR,
    ColorMode,
    LightEntity,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.const import EVENT_HOMEASSISTANT_STOP
from homeassistant.core import Event, HomeAssistant
from homeassistant.helpers.device_registry import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.event import async_track_time_interval
import homeassistant.util.color as color_util
 
from .const import DATA_ADDRESSES, DATA_DISCOVERY_SUBSCRIPTION, DOMAIN
 
_LOGGER = logging.getLogger(__name__)
 
DISCOVERY_INTERVAL = timedelta(seconds=60)
 
 
async def discover_entities(hass: HomeAssistant) -> list[ZerprocLight]:
    """Attempt to discover new lights."""
    lights = await pyzerproc.discover()
 
    # Filter out already discovered lights
    new_lights = [
        light
        for light in lights
        if light.address not in hass.data[DOMAIN][DATA_ADDRESSES]
    ]
 
    entities = []
    for light in new_lights:
        hass.data[DOMAIN][DATA_ADDRESSES].add(light.address)
        entities.append(ZerprocLight(light))
 
    return entities
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    config_entry: ConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up Zerproc light devices."""
    warned = False
 
    async def discover(*args):
        """Wrap discovery to include params."""
        nonlocal warned
        try:
            entities = await discover_entities(hass)
            async_add_entities(entities, update_before_add=True)
            warned = False
        except pyzerproc.ZerprocException:
            if warned is False:
                _LOGGER.warning("Error discovering Zerproc lights", exc_info=True)
                warned = True
 
    # Initial discovery
    hass.async_create_task(discover())
 
    # Perform recurring discovery of new devices
    hass.data[DOMAIN][DATA_DISCOVERY_SUBSCRIPTION] = async_track_time_interval(
        hass, discover, DISCOVERY_INTERVAL
    )
 
 
class ZerprocLight(LightEntity):
    """Representation of a Zerproc Light."""
 
    _attr_color_mode = ColorMode.HS
    _attr_supported_color_modes = {ColorMode.HS}
    _attr_has_entity_name = True
    _attr_name = None
    _attr_translation_key = "light"
 
    def __init__(self, light) -> None:
        """Initialize a Zerproc light."""
        self._light_light = light
        self._attr_unique_id_attr_unique_id = light.address
        self._attr_device_info_attr_device_info = DeviceInfo(
            identifiers={(DOMAIN, light.address)},
            manufacturer="Zerproc",
            name=light.name,
        )
 
    async def async_added_to_hass(self) -> None:
        """Run when entity about to be added to hass."""
        self.async_on_removeasync_on_remove(
            self.hasshass.bus.async_listen_once(EVENT_HOMEASSISTANT_STOP, self._hass_stop_hass_stop)
        )
 
    async def _hass_stop(self, event: Event) -> None:
        """Run on EVENT_HOMEASSISTANT_STOP."""
        await self.async_will_remove_from_hassasync_will_remove_from_hassasync_will_remove_from_hass()
 
    async def async_will_remove_from_hass(self) -> None:
        """Run when entity will be removed from hass."""
        try:
            await self._light_light.disconnect()
        except pyzerproc.ZerprocException:
            _LOGGER.debug(
                "Exception disconnecting from %s", self._light_light.address, exc_info=True
            )
 
    async def async_turn_on(self, **kwargs: Any) -> None:
        """Instruct the light to turn on."""
        if ATTR_BRIGHTNESS in kwargs or ATTR_HS_COLOR in kwargs:
            default_hs = (0, 0) if self.hs_colorhs_color is None else self.hs_colorhs_color
            hue_sat = kwargs.get(ATTR_HS_COLOR, default_hs)
 
            default_brightness = 255 if self.brightnessbrightness is None else self.brightnessbrightness
            brightness = kwargs.get(ATTR_BRIGHTNESS, default_brightness)
 
            rgb = color_util.color_hsv_to_RGB(
                hue_sat[0], hue_sat[1], brightness / 255 * 100
            )
            await self._light_light.set_color(*rgb)
        else:
            await self._light_light.turn_on()
 
    async def async_turn_off(self, **kwargs: Any) -> None:
        """Instruct the light to turn off."""
        await self._light_light.turn_off()
 
    async def async_update(self) -> None:
        """Fetch new state data for this light."""
        try:
            if not self.availableavailable:
                await self._light_light.connect()
            state = await self._light_light.get_state()
        except pyzerproc.ZerprocException:
            if self.availableavailable:
                _LOGGER.warning("Unable to connect to %s", self._light_light.address)
            self._attr_available_attr_available = False
            return
        if not self.availableavailable:
            _LOGGER.warning("Reconnected to %s", self._light_light.address)
            self._attr_available_attr_available = True
        self._attr_is_on_attr_is_on = state.is_on
        hsv = color_util.color_RGB_to_hsv(*state.color)
        self._attr_hs_color_attr_hs_color = hsv[:2]
        self._attr_brightness_attr_brightness = int(round((hsv[2] / 100) * 255))