light.py

Go to the documentation of this file.

"""WiZ integration light platform."""
 
from __future__ import annotations
 
from typing import Any
 
from pywizlight import PilotBuilder
from pywizlight.bulblibrary import BulbClass, BulbType, Features
from pywizlight.scenes import get_id_from_scene_name
 
from homeassistant.components.light import (
    ATTR_BRIGHTNESS,
    ATTR_COLOR_TEMP,
    ATTR_EFFECT,
    ATTR_RGBW_COLOR,
    ATTR_RGBWW_COLOR,
    ColorMode,
    LightEntity,
    LightEntityFeature,
    filter_supported_color_modes,
)
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.util.color import (
    color_temperature_kelvin_to_mired,
    color_temperature_mired_to_kelvin,
)
 
from . import WizConfigEntry
from .entity import WizToggleEntity
from .models import WizData
 
RGB_WHITE_CHANNELS_COLOR_MODE = {1: ColorMode.RGBW, 2: ColorMode.RGBWW}
 
 
def _async_pilot_builder(**kwargs: Any) -> PilotBuilder:
    """Create the PilotBuilder for turn on."""
    brightness = kwargs.get(ATTR_BRIGHTNESS)
 
    if ATTR_RGBWW_COLOR in kwargs:
        return PilotBuilder(brightness=brightness, rgbww=kwargs[ATTR_RGBWW_COLOR])
 
    if ATTR_RGBW_COLOR in kwargs:
        return PilotBuilder(brightness=brightness, rgbw=kwargs[ATTR_RGBW_COLOR])
 
    if ATTR_COLOR_TEMP in kwargs:
        return PilotBuilder(
            brightness=brightness,
            colortemp=color_temperature_mired_to_kelvin(kwargs[ATTR_COLOR_TEMP]),
        )
 
    if ATTR_EFFECT in kwargs:
        scene_id = get_id_from_scene_name(kwargs[ATTR_EFFECT])
        if scene_id == 1000:  # rhythm
            return PilotBuilder()
        return PilotBuilder(brightness=brightness, scene=scene_id)
 
    return PilotBuilder(brightness=brightness)
 
 
async def async_setup_entry(
    hass: HomeAssistant,
    entry: WizConfigEntry,
    async_add_entities: AddEntitiesCallback,
) -> None:
    """Set up the WiZ Platform from config_flow."""
    if entry.runtime_data.bulb.bulbtype.bulb_type != BulbClass.SOCKET:
        async_add_entities([WizBulbEntity(entry.runtime_data, entry.title)])
 
 
class WizBulbEntity(WizToggleEntity, LightEntity):
    """Representation of WiZ Light bulb."""
 
    _attr_name = None
    _fixed_color_mode: ColorMode | None = None
 
    def __init__(self, wiz_data: WizData, name: str) -> None:
        """Initialize an WiZLight."""
        super().__init__(wiz_data, name)
        bulb_type: BulbType = self._device_device.bulbtype
        features: Features = bulb_type.features
        color_modes = {ColorMode.ONOFF}
        if features.color:
            color_modes.add(RGB_WHITE_CHANNELS_COLOR_MODE[bulb_type.white_channels])
        if features.color_tmp:
            color_modes.add(ColorMode.COLOR_TEMP)
        if features.brightness:
            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._attr_color_mode_attr_color_mode = next(iter(self._attr_supported_color_modes_attr_supported_color_modes))
        self._attr_effect_list_attr_effect_list = wiz_data.scenes
        if bulb_type.bulb_type != BulbClass.DW:
            kelvin = bulb_type.kelvin_range
            self._attr_min_mireds_attr_min_mireds = color_temperature_kelvin_to_mired(kelvin.max)
            self._attr_max_mireds_attr_max_mireds = color_temperature_kelvin_to_mired(kelvin.min)
        if bulb_type.features.effect:
            self._attr_supported_features_attr_supported_features = LightEntityFeature.EFFECT
        self._async_update_attrs_async_update_attrs_async_update_attrs_async_update_attrs()
 
    @callback
    def _async_update_attrs(self) -> None:
        """Handle updating _attr values."""
        state = self._device_device.state
        color_modes = self.supported_color_modessupported_color_modes
        assert color_modes is not None
        if (brightness := state.get_brightness()) is not None:
            self._attr_brightness_attr_brightness = max(0, min(255, brightness))
        if ColorMode.COLOR_TEMP in color_modes and (
            color_temp := state.get_colortemp()
        ):
            self._attr_color_mode_attr_color_mode = ColorMode.COLOR_TEMP
            self._attr_color_temp_attr_color_temp = color_temperature_kelvin_to_mired(color_temp)
        elif (
            ColorMode.RGBWW in color_modes and (rgbww := state.get_rgbww()) is not None
        ):
            self._attr_rgbww_color_attr_rgbww_color = rgbww
            self._attr_color_mode_attr_color_mode = ColorMode.RGBWW
        elif ColorMode.RGBW in color_modes and (rgbw := state.get_rgbw()) is not None:
            self._attr_rgbw_color_attr_rgbw_color = rgbw
            self._attr_color_mode_attr_color_mode = ColorMode.RGBW
        self._attr_effect_attr_effect = state.get_scene()
        super()._async_update_attrs()
 
    async def async_turn_on(self, **kwargs: Any) -> None:
        """Instruct the light to turn on."""
        await self._device_device.turn_on(_async_pilot_builder(**kwargs))
        await self.coordinator.async_request_refresh()