323 lines
9.9 KiB
Python
323 lines
9.9 KiB
Python
"""Support for deCONZ lights."""
|
|
from __future__ import annotations
|
|
|
|
from typing import Any, Generic, TypedDict, TypeVar
|
|
|
|
from pydeconz.group import Group
|
|
from pydeconz.light import (
|
|
ALERT_LONG,
|
|
ALERT_SHORT,
|
|
EFFECT_COLOR_LOOP,
|
|
EFFECT_NONE,
|
|
Light,
|
|
LightResources,
|
|
)
|
|
|
|
from homeassistant.components.light import (
|
|
ATTR_BRIGHTNESS,
|
|
ATTR_COLOR_TEMP,
|
|
ATTR_EFFECT,
|
|
ATTR_FLASH,
|
|
ATTR_HS_COLOR,
|
|
ATTR_TRANSITION,
|
|
ATTR_XY_COLOR,
|
|
COLOR_MODE_BRIGHTNESS,
|
|
COLOR_MODE_COLOR_TEMP,
|
|
COLOR_MODE_HS,
|
|
COLOR_MODE_ONOFF,
|
|
COLOR_MODE_XY,
|
|
DOMAIN,
|
|
EFFECT_COLORLOOP,
|
|
FLASH_LONG,
|
|
FLASH_SHORT,
|
|
LightEntity,
|
|
LightEntityFeature,
|
|
)
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.dispatcher import async_dispatcher_connect
|
|
from homeassistant.helpers.entity import DeviceInfo
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
from homeassistant.util.color import color_hs_to_xy
|
|
|
|
from .const import DOMAIN as DECONZ_DOMAIN, POWER_PLUGS
|
|
from .deconz_device import DeconzDevice
|
|
from .gateway import DeconzGateway, get_gateway_from_config_entry
|
|
|
|
DECONZ_GROUP = "is_deconz_group"
|
|
EFFECT_TO_DECONZ = {EFFECT_COLORLOOP: EFFECT_COLOR_LOOP, "None": EFFECT_NONE}
|
|
FLASH_TO_DECONZ = {FLASH_SHORT: ALERT_SHORT, FLASH_LONG: ALERT_LONG}
|
|
|
|
_L = TypeVar("_L", Group, Light)
|
|
|
|
|
|
class SetStateAttributes(TypedDict, total=False):
|
|
"""Attributes available with set state call."""
|
|
|
|
alert: str
|
|
brightness: int
|
|
color_temperature: int
|
|
effect: str
|
|
hue: int
|
|
on: bool
|
|
saturation: int
|
|
transition_time: int
|
|
xy: tuple[float, float]
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up the deCONZ lights and groups from a config entry."""
|
|
gateway = get_gateway_from_config_entry(hass, config_entry)
|
|
gateway.entities[DOMAIN] = set()
|
|
|
|
@callback
|
|
def async_add_light(lights: list[LightResources] | None = None) -> None:
|
|
"""Add light from deCONZ."""
|
|
entities = []
|
|
|
|
if lights is None:
|
|
lights = gateway.api.lights.values()
|
|
|
|
for light in lights:
|
|
if (
|
|
isinstance(light, Light)
|
|
and light.type not in POWER_PLUGS
|
|
and light.unique_id not in gateway.entities[DOMAIN]
|
|
):
|
|
entities.append(DeconzLight(light, gateway))
|
|
|
|
if entities:
|
|
async_add_entities(entities)
|
|
|
|
config_entry.async_on_unload(
|
|
async_dispatcher_connect(
|
|
hass,
|
|
gateway.signal_new_light,
|
|
async_add_light,
|
|
)
|
|
)
|
|
|
|
@callback
|
|
def async_add_group(groups: list[Group] | None = None) -> None:
|
|
"""Add group from deCONZ."""
|
|
if not gateway.option_allow_deconz_groups:
|
|
return
|
|
|
|
entities = []
|
|
|
|
if groups is None:
|
|
groups = list(gateway.api.groups.values())
|
|
|
|
for group in groups:
|
|
if not group.lights:
|
|
continue
|
|
|
|
known_groups = set(gateway.entities[DOMAIN])
|
|
new_group = DeconzGroup(group, gateway)
|
|
if new_group.unique_id not in known_groups:
|
|
entities.append(new_group)
|
|
|
|
if entities:
|
|
async_add_entities(entities)
|
|
|
|
config_entry.async_on_unload(
|
|
async_dispatcher_connect(
|
|
hass,
|
|
gateway.signal_new_group,
|
|
async_add_group,
|
|
)
|
|
)
|
|
|
|
async_add_light()
|
|
async_add_group()
|
|
|
|
|
|
class DeconzBaseLight(Generic[_L], DeconzDevice, LightEntity):
|
|
"""Representation of a deCONZ light."""
|
|
|
|
TYPE = DOMAIN
|
|
|
|
_device: _L
|
|
|
|
def __init__(self, device: _L, gateway: DeconzGateway) -> None:
|
|
"""Set up light."""
|
|
super().__init__(device, gateway)
|
|
|
|
self._attr_supported_color_modes: set[str] = set()
|
|
|
|
if device.color_temp is not None:
|
|
self._attr_supported_color_modes.add(COLOR_MODE_COLOR_TEMP)
|
|
|
|
if device.hue is not None and device.saturation is not None:
|
|
self._attr_supported_color_modes.add(COLOR_MODE_HS)
|
|
|
|
if device.xy is not None:
|
|
self._attr_supported_color_modes.add(COLOR_MODE_XY)
|
|
|
|
if not self._attr_supported_color_modes and device.brightness is not None:
|
|
self._attr_supported_color_modes.add(COLOR_MODE_BRIGHTNESS)
|
|
|
|
if not self._attr_supported_color_modes:
|
|
self._attr_supported_color_modes.add(COLOR_MODE_ONOFF)
|
|
|
|
if device.brightness is not None:
|
|
self._attr_supported_features |= LightEntityFeature.FLASH
|
|
self._attr_supported_features |= LightEntityFeature.TRANSITION
|
|
|
|
if device.effect is not None:
|
|
self._attr_supported_features |= LightEntityFeature.EFFECT
|
|
self._attr_effect_list = [EFFECT_COLORLOOP]
|
|
|
|
@property
|
|
def color_mode(self) -> str | None:
|
|
"""Return the color mode of the light."""
|
|
if self._device.color_mode == "ct":
|
|
color_mode = COLOR_MODE_COLOR_TEMP
|
|
elif self._device.color_mode == "hs":
|
|
color_mode = COLOR_MODE_HS
|
|
elif self._device.color_mode == "xy":
|
|
color_mode = COLOR_MODE_XY
|
|
elif self._device.brightness is not None:
|
|
color_mode = COLOR_MODE_BRIGHTNESS
|
|
else:
|
|
color_mode = COLOR_MODE_ONOFF
|
|
return color_mode
|
|
|
|
@property
|
|
def brightness(self) -> int | None:
|
|
"""Return the brightness of this light between 0..255."""
|
|
return self._device.brightness # type: ignore[no-any-return]
|
|
|
|
@property
|
|
def color_temp(self) -> int | None:
|
|
"""Return the CT color value."""
|
|
return self._device.color_temp # type: ignore[no-any-return]
|
|
|
|
@property
|
|
def hs_color(self) -> tuple[float, float] | None:
|
|
"""Return the hs color value."""
|
|
if (hue := self._device.hue) and (sat := self._device.saturation):
|
|
return (hue / 65535 * 360, sat / 255 * 100)
|
|
return None
|
|
|
|
@property
|
|
def xy_color(self) -> tuple[float, float] | None:
|
|
"""Return the XY color value."""
|
|
return self._device.xy # type: ignore[no-any-return]
|
|
|
|
@property
|
|
def is_on(self) -> bool | None:
|
|
"""Return true if light is on."""
|
|
return self._device.state # type: ignore[no-any-return]
|
|
|
|
async def async_turn_on(self, **kwargs: Any) -> None:
|
|
"""Turn on light."""
|
|
data: SetStateAttributes = {"on": True}
|
|
|
|
if ATTR_BRIGHTNESS in kwargs:
|
|
data["brightness"] = kwargs[ATTR_BRIGHTNESS]
|
|
|
|
if ATTR_COLOR_TEMP in kwargs:
|
|
data["color_temperature"] = kwargs[ATTR_COLOR_TEMP]
|
|
|
|
if ATTR_HS_COLOR in kwargs:
|
|
if COLOR_MODE_XY in self._attr_supported_color_modes:
|
|
data["xy"] = color_hs_to_xy(*kwargs[ATTR_HS_COLOR])
|
|
else:
|
|
data["hue"] = int(kwargs[ATTR_HS_COLOR][0] / 360 * 65535)
|
|
data["saturation"] = int(kwargs[ATTR_HS_COLOR][1] / 100 * 255)
|
|
|
|
if ATTR_XY_COLOR in kwargs:
|
|
data["xy"] = kwargs[ATTR_XY_COLOR]
|
|
|
|
if ATTR_TRANSITION in kwargs:
|
|
data["transition_time"] = int(kwargs[ATTR_TRANSITION] * 10)
|
|
elif "IKEA" in self._device.manufacturer:
|
|
data["transition_time"] = 0
|
|
|
|
if ATTR_FLASH in kwargs and kwargs[ATTR_FLASH] in FLASH_TO_DECONZ:
|
|
data["alert"] = FLASH_TO_DECONZ[kwargs[ATTR_FLASH]]
|
|
del data["on"]
|
|
|
|
if ATTR_EFFECT in kwargs and kwargs[ATTR_EFFECT] in EFFECT_TO_DECONZ:
|
|
data["effect"] = EFFECT_TO_DECONZ[kwargs[ATTR_EFFECT]]
|
|
|
|
await self._device.set_state(**data)
|
|
|
|
async def async_turn_off(self, **kwargs: Any) -> None:
|
|
"""Turn off light."""
|
|
if not self._device.state:
|
|
return
|
|
|
|
data: SetStateAttributes = {"on": False}
|
|
|
|
if ATTR_TRANSITION in kwargs:
|
|
data["brightness"] = 0
|
|
data["transition_time"] = int(kwargs[ATTR_TRANSITION] * 10)
|
|
|
|
if ATTR_FLASH in kwargs and kwargs[ATTR_FLASH] in FLASH_TO_DECONZ:
|
|
data["alert"] = FLASH_TO_DECONZ[kwargs[ATTR_FLASH]]
|
|
del data["on"]
|
|
|
|
await self._device.set_state(**data)
|
|
|
|
@property
|
|
def extra_state_attributes(self) -> dict[str, bool]:
|
|
"""Return the device state attributes."""
|
|
return {DECONZ_GROUP: isinstance(self._device, Group)}
|
|
|
|
|
|
class DeconzLight(DeconzBaseLight[Light]):
|
|
"""Representation of a deCONZ light."""
|
|
|
|
_device: Light
|
|
|
|
@property
|
|
def max_mireds(self) -> int:
|
|
"""Return the warmest color_temp that this light supports."""
|
|
return self._device.max_color_temp or super().max_mireds
|
|
|
|
@property
|
|
def min_mireds(self) -> int:
|
|
"""Return the coldest color_temp that this light supports."""
|
|
return self._device.min_color_temp or super().min_mireds
|
|
|
|
|
|
class DeconzGroup(DeconzBaseLight[Group]):
|
|
"""Representation of a deCONZ group."""
|
|
|
|
_device: Group
|
|
|
|
def __init__(self, device: Group, gateway: DeconzGateway) -> None:
|
|
"""Set up group and create an unique id."""
|
|
self._unique_id = f"{gateway.bridgeid}-{device.deconz_id}"
|
|
super().__init__(device, gateway)
|
|
|
|
@property
|
|
def unique_id(self) -> str:
|
|
"""Return a unique identifier for this device."""
|
|
return self._unique_id
|
|
|
|
@property
|
|
def device_info(self) -> DeviceInfo:
|
|
"""Return a device description for device registry."""
|
|
return DeviceInfo(
|
|
identifiers={(DECONZ_DOMAIN, self.unique_id)},
|
|
manufacturer="Dresden Elektronik",
|
|
model="deCONZ group",
|
|
name=self._device.name,
|
|
via_device=(DECONZ_DOMAIN, self.gateway.api.config.bridge_id),
|
|
)
|
|
|
|
@property
|
|
def extra_state_attributes(self) -> dict[str, bool]:
|
|
"""Return the device state attributes."""
|
|
attributes = dict(super().extra_state_attributes)
|
|
attributes["all_on"] = self._device.all_on
|
|
|
|
return attributes
|