429 lines
15 KiB
Python
429 lines
15 KiB
Python
"""Support for Z-Wave lights."""
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
from typing import Any
|
|
|
|
from zwave_js_server.client import Client as ZwaveClient
|
|
from zwave_js_server.const import (
|
|
TARGET_VALUE_PROPERTY,
|
|
TRANSITION_DURATION_OPTION,
|
|
CommandClass,
|
|
)
|
|
from zwave_js_server.const.command_class.color_switch import (
|
|
COLOR_SWITCH_COMBINED_AMBER,
|
|
COLOR_SWITCH_COMBINED_BLUE,
|
|
COLOR_SWITCH_COMBINED_COLD_WHITE,
|
|
COLOR_SWITCH_COMBINED_CYAN,
|
|
COLOR_SWITCH_COMBINED_GREEN,
|
|
COLOR_SWITCH_COMBINED_PURPLE,
|
|
COLOR_SWITCH_COMBINED_RED,
|
|
COLOR_SWITCH_COMBINED_WARM_WHITE,
|
|
CURRENT_COLOR_PROPERTY,
|
|
TARGET_COLOR_PROPERTY,
|
|
ColorComponent,
|
|
)
|
|
|
|
from homeassistant.components.light import (
|
|
ATTR_BRIGHTNESS,
|
|
ATTR_COLOR_TEMP,
|
|
ATTR_HS_COLOR,
|
|
ATTR_RGBW_COLOR,
|
|
ATTR_TRANSITION,
|
|
COLOR_MODE_BRIGHTNESS,
|
|
COLOR_MODE_COLOR_TEMP,
|
|
COLOR_MODE_HS,
|
|
COLOR_MODE_RGBW,
|
|
DOMAIN as LIGHT_DOMAIN,
|
|
SUPPORT_TRANSITION,
|
|
LightEntity,
|
|
)
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.dispatcher import async_dispatcher_connect
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
import homeassistant.util.color as color_util
|
|
|
|
from .const import DATA_CLIENT, DOMAIN
|
|
from .discovery import ZwaveDiscoveryInfo
|
|
from .entity import ZWaveBaseEntity
|
|
|
|
LOGGER = logging.getLogger(__name__)
|
|
|
|
MULTI_COLOR_MAP = {
|
|
ColorComponent.WARM_WHITE: COLOR_SWITCH_COMBINED_WARM_WHITE,
|
|
ColorComponent.COLD_WHITE: COLOR_SWITCH_COMBINED_COLD_WHITE,
|
|
ColorComponent.RED: COLOR_SWITCH_COMBINED_RED,
|
|
ColorComponent.GREEN: COLOR_SWITCH_COMBINED_GREEN,
|
|
ColorComponent.BLUE: COLOR_SWITCH_COMBINED_BLUE,
|
|
ColorComponent.AMBER: COLOR_SWITCH_COMBINED_AMBER,
|
|
ColorComponent.CYAN: COLOR_SWITCH_COMBINED_CYAN,
|
|
ColorComponent.PURPLE: COLOR_SWITCH_COMBINED_PURPLE,
|
|
}
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up Z-Wave Light from Config Entry."""
|
|
client: ZwaveClient = hass.data[DOMAIN][config_entry.entry_id][DATA_CLIENT]
|
|
|
|
@callback
|
|
def async_add_light(info: ZwaveDiscoveryInfo) -> None:
|
|
"""Add Z-Wave Light."""
|
|
|
|
light = ZwaveLight(config_entry, client, info)
|
|
async_add_entities([light])
|
|
|
|
config_entry.async_on_unload(
|
|
async_dispatcher_connect(
|
|
hass,
|
|
f"{DOMAIN}_{config_entry.entry_id}_add_{LIGHT_DOMAIN}",
|
|
async_add_light,
|
|
)
|
|
)
|
|
|
|
|
|
def byte_to_zwave_brightness(value: int) -> int:
|
|
"""Convert brightness in 0-255 scale to 0-99 scale.
|
|
|
|
`value` -- (int) Brightness byte value from 0-255.
|
|
"""
|
|
if value > 0:
|
|
return max(1, round((value / 255) * 99))
|
|
return 0
|
|
|
|
|
|
class ZwaveLight(ZWaveBaseEntity, LightEntity):
|
|
"""Representation of a Z-Wave light."""
|
|
|
|
def __init__(
|
|
self, config_entry: ConfigEntry, client: ZwaveClient, info: ZwaveDiscoveryInfo
|
|
) -> None:
|
|
"""Initialize the light."""
|
|
super().__init__(config_entry, client, info)
|
|
self._supports_color = False
|
|
self._supports_rgbw = False
|
|
self._supports_color_temp = False
|
|
self._hs_color: tuple[float, float] | None = None
|
|
self._rgbw_color: tuple[int, int, int, int] | None = None
|
|
self._color_mode: str | None = None
|
|
self._color_temp: int | None = None
|
|
self._min_mireds = 153 # 6500K as a safe default
|
|
self._max_mireds = 370 # 2700K as a safe default
|
|
self._warm_white = self.get_zwave_value(
|
|
TARGET_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.WARM_WHITE,
|
|
)
|
|
self._cold_white = self.get_zwave_value(
|
|
TARGET_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.COLD_WHITE,
|
|
)
|
|
self._supported_color_modes = set()
|
|
|
|
# get additional (optional) values and set features
|
|
self._target_brightness = self.get_zwave_value(
|
|
TARGET_VALUE_PROPERTY, add_to_watched_value_ids=False
|
|
)
|
|
self._target_color = self.get_zwave_value(
|
|
TARGET_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
add_to_watched_value_ids=False,
|
|
)
|
|
|
|
self._calculate_color_values()
|
|
if self._supports_rgbw:
|
|
self._supported_color_modes.add(COLOR_MODE_RGBW)
|
|
elif self._supports_color:
|
|
self._supported_color_modes.add(COLOR_MODE_HS)
|
|
if self._supports_color_temp:
|
|
self._supported_color_modes.add(COLOR_MODE_COLOR_TEMP)
|
|
if not self._supported_color_modes:
|
|
self._supported_color_modes.add(COLOR_MODE_BRIGHTNESS)
|
|
|
|
# Entity class attributes
|
|
self._attr_supported_features = 0
|
|
self.supports_brightness_transition = bool(
|
|
self._target_brightness is not None
|
|
and TRANSITION_DURATION_OPTION
|
|
in self._target_brightness.metadata.value_change_options
|
|
)
|
|
self.supports_color_transition = bool(
|
|
self._target_color is not None
|
|
and TRANSITION_DURATION_OPTION
|
|
in self._target_color.metadata.value_change_options
|
|
)
|
|
|
|
if self.supports_brightness_transition or self.supports_color_transition:
|
|
self._attr_supported_features |= SUPPORT_TRANSITION
|
|
|
|
@callback
|
|
def on_value_update(self) -> None:
|
|
"""Call when a watched value is added or updated."""
|
|
self._calculate_color_values()
|
|
|
|
@property
|
|
def brightness(self) -> int:
|
|
"""Return the brightness of this light between 0..255.
|
|
|
|
Z-Wave multilevel switches use a range of [0, 99] to control brightness.
|
|
"""
|
|
if self.info.primary_value.value is not None:
|
|
return round((self.info.primary_value.value / 99) * 255)
|
|
return 0
|
|
|
|
@property
|
|
def color_mode(self) -> str | None:
|
|
"""Return the color mode of the light."""
|
|
return self._color_mode
|
|
|
|
@property
|
|
def is_on(self) -> bool:
|
|
"""Return true if device is on (brightness above 0)."""
|
|
return self.brightness > 0
|
|
|
|
@property
|
|
def hs_color(self) -> tuple[float, float] | None:
|
|
"""Return the hs color."""
|
|
return self._hs_color
|
|
|
|
@property
|
|
def rgbw_color(self) -> tuple[int, int, int, int] | None:
|
|
"""Return the hs color."""
|
|
return self._rgbw_color
|
|
|
|
@property
|
|
def color_temp(self) -> int | None:
|
|
"""Return the color temperature."""
|
|
return self._color_temp
|
|
|
|
@property
|
|
def min_mireds(self) -> int:
|
|
"""Return the coldest color_temp that this light supports."""
|
|
return self._min_mireds
|
|
|
|
@property
|
|
def max_mireds(self) -> int:
|
|
"""Return the warmest color_temp that this light supports."""
|
|
return self._max_mireds
|
|
|
|
@property
|
|
def supported_color_modes(self) -> set | None:
|
|
"""Flag supported features."""
|
|
return self._supported_color_modes
|
|
|
|
async def async_turn_on(self, **kwargs: Any) -> None:
|
|
"""Turn the device on."""
|
|
|
|
transition = kwargs.get(ATTR_TRANSITION)
|
|
|
|
# RGB/HS color
|
|
hs_color = kwargs.get(ATTR_HS_COLOR)
|
|
if hs_color is not None and self._supports_color:
|
|
red, green, blue = color_util.color_hs_to_RGB(*hs_color)
|
|
colors = {
|
|
ColorComponent.RED: red,
|
|
ColorComponent.GREEN: green,
|
|
ColorComponent.BLUE: blue,
|
|
}
|
|
if self._supports_color_temp:
|
|
# turn of white leds when setting rgb
|
|
colors[ColorComponent.WARM_WHITE] = 0
|
|
colors[ColorComponent.COLD_WHITE] = 0
|
|
await self._async_set_colors(colors, transition)
|
|
|
|
# Color temperature
|
|
color_temp = kwargs.get(ATTR_COLOR_TEMP)
|
|
if color_temp is not None and self._supports_color_temp:
|
|
# Limit color temp to min/max values
|
|
cold = max(
|
|
0,
|
|
min(
|
|
255,
|
|
round(
|
|
(self._max_mireds - color_temp)
|
|
/ (self._max_mireds - self._min_mireds)
|
|
* 255
|
|
),
|
|
),
|
|
)
|
|
warm = 255 - cold
|
|
await self._async_set_colors(
|
|
{
|
|
# turn off color leds when setting color temperature
|
|
ColorComponent.RED: 0,
|
|
ColorComponent.GREEN: 0,
|
|
ColorComponent.BLUE: 0,
|
|
ColorComponent.WARM_WHITE: warm,
|
|
ColorComponent.COLD_WHITE: cold,
|
|
},
|
|
transition,
|
|
)
|
|
|
|
# RGBW
|
|
rgbw = kwargs.get(ATTR_RGBW_COLOR)
|
|
if rgbw is not None and self._supports_rgbw:
|
|
rgbw_channels = {
|
|
ColorComponent.RED: rgbw[0],
|
|
ColorComponent.GREEN: rgbw[1],
|
|
ColorComponent.BLUE: rgbw[2],
|
|
}
|
|
if self._warm_white:
|
|
rgbw_channels[ColorComponent.WARM_WHITE] = rgbw[3]
|
|
|
|
if self._cold_white:
|
|
rgbw_channels[ColorComponent.COLD_WHITE] = rgbw[3]
|
|
await self._async_set_colors(rgbw_channels, transition)
|
|
|
|
# set brightness
|
|
await self._async_set_brightness(kwargs.get(ATTR_BRIGHTNESS), transition)
|
|
|
|
async def async_turn_off(self, **kwargs: Any) -> None:
|
|
"""Turn the light off."""
|
|
await self._async_set_brightness(0, kwargs.get(ATTR_TRANSITION))
|
|
|
|
async def _async_set_colors(
|
|
self, colors: dict[ColorComponent, int], transition: float | None = None
|
|
) -> None:
|
|
"""Set (multiple) defined colors to given value(s)."""
|
|
# prefer the (new) combined color property
|
|
# https://github.com/zwave-js/node-zwave-js/pull/1782
|
|
combined_color_val = self.get_zwave_value(
|
|
"targetColor",
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=None,
|
|
)
|
|
zwave_transition = None
|
|
|
|
if self.supports_color_transition:
|
|
if transition is not None:
|
|
zwave_transition = {TRANSITION_DURATION_OPTION: f"{int(transition)}s"}
|
|
else:
|
|
zwave_transition = {TRANSITION_DURATION_OPTION: "default"}
|
|
|
|
colors_dict = {}
|
|
for color, value in colors.items():
|
|
color_name = MULTI_COLOR_MAP[color]
|
|
colors_dict[color_name] = value
|
|
# set updated color object
|
|
await self.info.node.async_set_value(
|
|
combined_color_val, colors_dict, zwave_transition
|
|
)
|
|
|
|
async def _async_set_brightness(
|
|
self, brightness: int | None, transition: float | None = None
|
|
) -> None:
|
|
"""Set new brightness to light."""
|
|
if brightness is None:
|
|
# Level 255 means to set it to previous value.
|
|
zwave_brightness = 255
|
|
else:
|
|
# Zwave multilevel switches use a range of [0, 99] to control brightness.
|
|
zwave_brightness = byte_to_zwave_brightness(brightness)
|
|
|
|
# set transition value before sending new brightness
|
|
zwave_transition = None
|
|
if self.supports_brightness_transition:
|
|
if transition is not None:
|
|
zwave_transition = {TRANSITION_DURATION_OPTION: f"{int(transition)}s"}
|
|
else:
|
|
zwave_transition = {TRANSITION_DURATION_OPTION: "default"}
|
|
|
|
# setting a value requires setting targetValue
|
|
await self.info.node.async_set_value(
|
|
self._target_brightness, zwave_brightness, zwave_transition
|
|
)
|
|
|
|
@callback
|
|
def _calculate_color_values(self) -> None:
|
|
"""Calculate light colors."""
|
|
# NOTE: We lookup all values here (instead of relying on the multicolor one)
|
|
# to find out what colors are supported
|
|
# as this is a simple lookup by key, this not heavy
|
|
red_val = self.get_zwave_value(
|
|
CURRENT_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.RED.value,
|
|
)
|
|
green_val = self.get_zwave_value(
|
|
CURRENT_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.GREEN.value,
|
|
)
|
|
blue_val = self.get_zwave_value(
|
|
CURRENT_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.BLUE.value,
|
|
)
|
|
ww_val = self.get_zwave_value(
|
|
CURRENT_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.WARM_WHITE.value,
|
|
)
|
|
cw_val = self.get_zwave_value(
|
|
CURRENT_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=ColorComponent.COLD_WHITE.value,
|
|
)
|
|
# prefer the (new) combined color property
|
|
# https://github.com/zwave-js/node-zwave-js/pull/1782
|
|
combined_color_val = self.get_zwave_value(
|
|
CURRENT_COLOR_PROPERTY,
|
|
CommandClass.SWITCH_COLOR,
|
|
value_property_key=None,
|
|
)
|
|
if combined_color_val and isinstance(combined_color_val.value, dict):
|
|
multi_color = combined_color_val.value
|
|
else:
|
|
multi_color = {}
|
|
|
|
# Default: Brightness (no color)
|
|
self._color_mode = COLOR_MODE_BRIGHTNESS
|
|
|
|
# RGB support
|
|
if red_val and green_val and blue_val:
|
|
# prefer values from the multicolor property
|
|
red = multi_color.get(COLOR_SWITCH_COMBINED_RED, red_val.value)
|
|
green = multi_color.get(COLOR_SWITCH_COMBINED_GREEN, green_val.value)
|
|
blue = multi_color.get(COLOR_SWITCH_COMBINED_BLUE, blue_val.value)
|
|
self._supports_color = True
|
|
if None not in (red, green, blue):
|
|
# convert to HS
|
|
self._hs_color = color_util.color_RGB_to_hs(red, green, blue)
|
|
# Light supports color, set color mode to hs
|
|
self._color_mode = COLOR_MODE_HS
|
|
|
|
# color temperature support
|
|
if ww_val and cw_val:
|
|
self._supports_color_temp = True
|
|
warm_white = multi_color.get(COLOR_SWITCH_COMBINED_WARM_WHITE, ww_val.value)
|
|
cold_white = multi_color.get(COLOR_SWITCH_COMBINED_COLD_WHITE, cw_val.value)
|
|
# Calculate color temps based on whites
|
|
if cold_white or warm_white:
|
|
self._color_temp = round(
|
|
self._max_mireds
|
|
- ((cold_white / 255) * (self._max_mireds - self._min_mireds))
|
|
)
|
|
# White channels turned on, set color mode to color_temp
|
|
self._color_mode = COLOR_MODE_COLOR_TEMP
|
|
else:
|
|
self._color_temp = None
|
|
# only one white channel (warm white) = rgbw support
|
|
elif red_val and green_val and blue_val and ww_val:
|
|
self._supports_rgbw = True
|
|
white = multi_color.get(COLOR_SWITCH_COMBINED_WARM_WHITE, ww_val.value)
|
|
self._rgbw_color = (red, green, blue, white)
|
|
# Light supports rgbw, set color mode to rgbw
|
|
self._color_mode = COLOR_MODE_RGBW
|
|
# only one white channel (cool white) = rgbw support
|
|
elif cw_val:
|
|
self._supports_rgbw = True
|
|
white = multi_color.get(COLOR_SWITCH_COMBINED_COLD_WHITE, cw_val.value)
|
|
self._rgbw_color = (red, green, blue, white)
|
|
# Light supports rgbw, set color mode to rgbw
|
|
self._color_mode = COLOR_MODE_RGBW
|