light.py

Go to the documentation of this file.

"""Support for Lutron lights."""
 
from __future__ import annotations
 
from collections.abc import Mapping
from typing import Any
 
from pylutron import Output
 
from homeassistant.components.light import (
    ATTR_BRIGHTNESS,
    ATTR_FLASH,
    ATTR_TRANSITION,
    ColorMode,
    LightEntity,
    LightEntityFeature,
)
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback
 
from . import DOMAIN, LutronData
from .entity import LutronDevice
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    config_entry: ConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up the Lutron light platform.
 
    Adds dimmers from the Main Repeater associated with the config_entry as
    light entities.
    """
    entry_data: LutronData = hass.data[DOMAIN][config_entry.entry_id]
 
    async_add_entities(
        (
            LutronLight(area_name, device, entry_data.client)
            for area_name, device in entry_data.lights
        ),
        True,
    )
 
 
def to_lutron_level(level):
    """Convert the given Home Assistant light level (0-255) to Lutron (0.0-100.0)."""
    return float((level * 100) / 255)
 
 
def to_hass_level(level):
    """Convert the given Lutron (0.0-100.0) light level to Home Assistant (0-255)."""
    return int((level * 255) / 100)
 
 
class LutronLight(LutronDevice, LightEntity):
    """Representation of a Lutron Light, including dimmable."""
 
    _attr_color_mode = ColorMode.BRIGHTNESS
    _attr_supported_color_modes = {ColorMode.BRIGHTNESS}
    _attr_supported_features = LightEntityFeature.TRANSITION | LightEntityFeature.FLASH
    _lutron_device: Output
    _prev_brightness: int | None = None
    _attr_name = None
 
    def turn_on(self, **kwargs: Any) -> None:
        """Turn the light on."""
        if flash := kwargs.get(ATTR_FLASH):
            self._lutron_device_lutron_device.flash(0.5 if flash == "short" else 1.5)
        else:
            if ATTR_BRIGHTNESS in kwargs and self._lutron_device_lutron_device.is_dimmable:
                brightness = kwargs[ATTR_BRIGHTNESS]
            elif self._prev_brightness_prev_brightness == 0:
                brightness = 255 / 2
            else:
                brightness = self._prev_brightness_prev_brightness
            self._prev_brightness_prev_brightness = brightness
            args = {"new_level": to_lutron_level(brightness)}
            if ATTR_TRANSITION in kwargs:
                args["fade_time_seconds"] = kwargs[ATTR_TRANSITION]
            self._lutron_device_lutron_device.set_level(**args)
 
    def turn_off(self, **kwargs: Any) -> None:
        """Turn the light off."""
        args = {"new_level": 0}
        if ATTR_TRANSITION in kwargs:
            args["fade_time_seconds"] = kwargs[ATTR_TRANSITION]
        self._lutron_device_lutron_device.set_level(**args)
 
    @property
    def extra_state_attributes(self) -> Mapping[str, Any] | None:
        """Return the state attributes."""
        return {"lutron_integration_id": self._lutron_device_lutron_device.id}
 
    def _request_state(self) -> None:
        """Request the state from the device."""
        _ = self._lutron_device_lutron_device.level
 
    def _update_attrs(self) -> None:
        """Update the state attributes."""
        level = self._lutron_device_lutron_device.last_level()
        self._attr_is_on_attr_is_on = level > 0
        hass_level = to_hass_level(level)
        self._attr_brightness_attr_brightness = hass_level
        if self._prev_brightness_prev_brightness is None or hass_level != 0:
            self._prev_brightness_prev_brightness = hass_level