light.py

Go to the documentation of this file.

"""Support for Abode Security System lights."""
 
from __future__ import annotations
 
from math import ceil
from typing import Any
 
from jaraco.abode.devices.light import Light
 
from homeassistant.components.light import (
    ATTR_BRIGHTNESS,
    ATTR_COLOR_TEMP,
    ATTR_HS_COLOR,
    ColorMode,
    LightEntity,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.util.color import (
    color_temperature_kelvin_to_mired,
    color_temperature_mired_to_kelvin,
)
 
from . import AbodeSystem
from .const import DOMAIN
from .entity import AbodeDevice
 
 
async def async_setup_entry(
    hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
) -> None:
    """Set up Abode light devices."""
    data: AbodeSystem = hass.data[DOMAIN]
 
    async_add_entities(
        AbodeLight(data, device)
        for device in data.abode.get_devices(generic_type="light")
    )
 
 
class AbodeLight(AbodeDevice, LightEntity):
    """Representation of an Abode light."""
 
    _device: Light
    _attr_name = None
 
    def turn_on(self, **kwargs: Any) -> None:
        """Turn on the light."""
        if ATTR_COLOR_TEMP in kwargs and self._device_device.is_color_capable:
            self._device_device.set_color_temp(
                int(color_temperature_mired_to_kelvin(kwargs[ATTR_COLOR_TEMP]))
            )
            return
 
        if ATTR_HS_COLOR in kwargs and self._device_device.is_color_capable:
            self._device_device.set_color(kwargs[ATTR_HS_COLOR])
            return
 
        if ATTR_BRIGHTNESS in kwargs and self._device_device.is_dimmable:
            # Convert Home Assistant brightness (0-255) to Abode brightness (0-99)
            # If 100 is sent to Abode, response is 99 causing an error
            self._device_device.set_level(ceil(kwargs[ATTR_BRIGHTNESS] * 99 / 255.0))
            return
 
        self._device_device.switch_on()
 
    def turn_off(self, **kwargs: Any) -> None:
        """Turn off the light."""
        self._device_device.switch_off()
 
    @property
    def is_on(self) -> bool:
        """Return true if device is on."""
        return bool(self._device_device.is_on)
 
    @property
    def brightness(self) -> int | None:
        """Return the brightness of the light."""
        if self._device_device.is_dimmable and self._device_device.has_brightness:
            brightness = int(self._device_device.brightness)
            # Abode returns 100 during device initialization and device refresh
            # Convert Abode brightness (0-99) to Home Assistant brightness (0-255)
            return 255 if brightness == 100 else ceil(brightness * 255 / 99.0)
        return None
 
    @property
    def color_temp(self) -> int | None:
        """Return the color temp of the light."""
        if self._device_device.has_color:
            return color_temperature_kelvin_to_mired(self._device_device.color_temp)
        return None
 
    @property
    def hs_color(self) -> tuple[float, float] | None:
        """Return the color of the light."""
        _hs = None
        if self._device_device.has_color:
            _hs = self._device_device.color
        return _hs
 
    @property
    def color_mode(self) -> str | None:
        """Return the color mode of the light."""
        if self._device_device.is_dimmable and self._device_device.is_color_capable:
            if self.hs_colorhs_colorhs_color is not None:
                return ColorMode.HS
            return ColorMode.COLOR_TEMP
        if self._device_device.is_dimmable:
            return ColorMode.BRIGHTNESS
        return ColorMode.ONOFF
 
    @property
    def supported_color_modes(self) -> set[str] | None:
        """Flag supported color modes."""
        if self._device_device.is_dimmable and self._device_device.is_color_capable:
            return {ColorMode.COLOR_TEMP, ColorMode.HS}
        if self._device_device.is_dimmable:
            return {ColorMode.BRIGHTNESS}
        return {ColorMode.ONOFF}