light.py

Go to the documentation of this file.

"""Govee light local."""
 
from __future__ import annotations
 
import logging
from typing import Any
 
from govee_local_api import GoveeDevice, GoveeLightCapability
 
from homeassistant.components.light import (
    ATTR_BRIGHTNESS,
    ATTR_COLOR_TEMP_KELVIN,
    ATTR_RGB_COLOR,
    ColorMode,
    LightEntity,
    filter_supported_color_modes,
)
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.device_registry import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.update_coordinator import CoordinatorEntity
 
from .const import DOMAIN, MANUFACTURER
from .coordinator import GoveeLocalApiCoordinator, GoveeLocalConfigEntry
 
_LOGGER = logging.getLogger(__name__)
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    config_entry: GoveeLocalConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Govee light setup."""
 
    coordinator = config_entry.runtime_data
 
    def discovery_callback(device: GoveeDevice, is_new: bool) -> bool:
        if is_new:
            async_add_entities([GoveeLight(coordinator, device)])
        return True
 
    async_add_entities(
        GoveeLight(coordinator, device) for device in coordinator.devices
    )
 
    await coordinator.set_discovery_callback(discovery_callback)
 
 
class GoveeLight(CoordinatorEntity[GoveeLocalApiCoordinator], LightEntity):
    """Govee Light."""
 
    _attr_has_entity_name = True
    _attr_name = None
    _attr_supported_color_modes: set[ColorMode]
    _fixed_color_mode: ColorMode | None = None
 
    def __init__(
        self,
        coordinator: GoveeLocalApiCoordinator,
        device: GoveeDevice,
    ) -> None:
        """Govee Light constructor."""
 
        super().__init__(coordinator)
        self._device_device = device
        device.set_update_callback(self._update_callback_update_callback)
 
        self._attr_unique_id_attr_unique_id = device.fingerprint
 
        capabilities = device.capabilities
        color_modes = {ColorMode.ONOFF}
        if capabilities:
            if GoveeLightCapability.COLOR_RGB in capabilities:
                color_modes.add(ColorMode.RGB)
            if GoveeLightCapability.COLOR_KELVIN_TEMPERATURE in capabilities:
                color_modes.add(ColorMode.COLOR_TEMP)
                self._attr_max_color_temp_kelvin_attr_max_color_temp_kelvin = 9000
                self._attr_min_color_temp_kelvin_attr_min_color_temp_kelvin = 2000
            if GoveeLightCapability.BRIGHTNESS in capabilities:
                color_modes.add(ColorMode.BRIGHTNESS)
 
        self._attr_supported_color_modes_attr_supported_color_modes = filter_supported_color_modes(color_modes)
        if len(self._attr_supported_color_modes_attr_supported_color_modes) == 1:
            # If the light supports only a single color mode, set it now
            self._fixed_color_mode_fixed_color_mode = next(iter(self._attr_supported_color_modes_attr_supported_color_modes))
 
        self._attr_device_info_attr_device_info = DeviceInfo(
            identifiers={
                # Serial numbers are unique identifiers within a specific domain
                (DOMAIN, device.fingerprint)
            },
            name=device.sku,
            manufacturer=MANUFACTURER,
            model_id=device.sku,
            serial_number=device.fingerprint,
        )
 
    @property
    def is_on(self) -> bool:
        """Return true if device is on (brightness above 0)."""
        return self._device_device.on
 
    @property
    def brightness(self) -> int:
        """Return the brightness of this light between 0..255."""
        return int((self._device_device.brightness / 100.0) * 255.0)
 
    @property
    def color_temp_kelvin(self) -> int | None:
        """Return the color temperature in Kelvin."""
        return self._device_device.temperature_color
 
    @property
    def rgb_color(self) -> tuple[int, int, int] | None:
        """Return the rgb color."""
        return self._device_device.rgb_color
 
    @property
    def color_mode(self) -> ColorMode | str | None:
        """Return the color mode."""
        if self._fixed_color_mode_fixed_color_mode:
            # The light supports only a single color mode, return it
            return self._fixed_color_mode_fixed_color_mode
 
        # The light supports both color temperature and RGB, determine which
        # mode the light is in
        if (
            self._device_device.temperature_color is not None
            and self._device_device.temperature_color > 0
        ):
            return ColorMode.COLOR_TEMP
        return ColorMode.RGB
 
    async def async_turn_on(self, **kwargs: Any) -> None:
        """Turn the device on."""
        if not self.is_onis_onis_on or not kwargs:
            await self.coordinator.turn_on(self._device_device)
 
        if ATTR_BRIGHTNESS in kwargs:
            brightness: int = int((float(kwargs[ATTR_BRIGHTNESS]) / 255.0) * 100.0)
            await self.coordinator.set_brightness(self._device_device, brightness)
 
        if ATTR_RGB_COLOR in kwargs:
            self._attr_color_mode_attr_color_mode = ColorMode.RGB
            red, green, blue = kwargs[ATTR_RGB_COLOR]
            await self.coordinator.set_rgb_color(self._device_device, red, green, blue)
        elif ATTR_COLOR_TEMP_KELVIN in kwargs:
            self._attr_color_mode_attr_color_mode = ColorMode.COLOR_TEMP
            temperature: float = kwargs[ATTR_COLOR_TEMP_KELVIN]
            await self.coordinator.set_temperature(self._device_device, int(temperature))
        self.async_write_ha_stateasync_write_ha_state()
 
    async def async_turn_off(self, **kwargs: Any) -> None:
        """Turn the device off."""
        await self.coordinator.turn_off(self._device_device)
        self.async_write_ha_stateasync_write_ha_state()
 
    @callback
    def _update_callback(self, device: GoveeDevice) -> None:
        self.async_write_ha_stateasync_write_ha_state()