async def test_process(self):
"""Test process telegram."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx, group_address=GroupAddress("1/2/3"))
telegram = Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTArray((0x64, 0x65, 0x66))),
)
await remote_value.process(telegram)
assert remote_value.value == (100, 101, 102)
def test_set(self):
"""Test setting value."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx,
group_address=GroupAddress("1/2/3"))
self.loop.run_until_complete(remote_value.set((100, 101, 102)))
self.assertEqual(xknx.telegrams.qsize(), 1)
telegram = xknx.telegrams.get_nowait()
self.assertEqual(
telegram,
Telegram(GroupAddress("1/2/3"),
payload=DPTArray((0x64, 0x65, 0x66))),
)
self.loop.run_until_complete(remote_value.set((100, 101, 104)))
self.assertEqual(xknx.telegrams.qsize(), 1)
telegram = xknx.telegrams.get_nowait()
self.assertEqual(
telegram,
Telegram(GroupAddress("1/2/3"),
payload=DPTArray((0x64, 0x65, 0x68))),
)
async def test_to_process_error(self):
"""Test process errornous telegram."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx, group_address=GroupAddress("1/2/3"))
with pytest.raises(CouldNotParseTelegram):
telegram = Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTBinary(1)),
)
await remote_value.process(telegram)
with pytest.raises(CouldNotParseTelegram):
telegram = Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTArray((0x64, 0x65, 0x66, 0x67))),
)
await remote_value.process(telegram)
async def test_set(self):
"""Test setting value."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx, group_address=GroupAddress("1/2/3"))
await remote_value.set((100, 101, 102))
assert xknx.telegrams.qsize() == 1
telegram = xknx.telegrams.get_nowait()
assert telegram == Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTArray((0x64, 0x65, 0x66))),
)
await remote_value.set((100, 101, 104))
assert xknx.telegrams.qsize() == 1
telegram = xknx.telegrams.get_nowait()
assert telegram == Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTArray((0x64, 0x65, 0x68))),
)
async def test_to_process_error(self):
"""Test process errornous telegram."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx,
group_address=GroupAddress("1/2/3"))
telegram = Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTBinary(1)),
)
assert await remote_value.process(telegram) is False
telegram = Telegram(
destination_address=GroupAddress("1/2/3"),
payload=GroupValueWrite(DPTArray((0x64, 0x65, 0x66, 0x67))),
)
assert await remote_value.process(telegram) is False
assert remote_value.value is None
def test_to_knx_error(self):
"""Test to_knx function with wrong parametern."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx)
with self.assertRaises(ConversionError):
remote_value.to_knx((100, 101, 102, 103))
with self.assertRaises(ConversionError):
remote_value.to_knx((100, 101, 256))
with self.assertRaises(ConversionError):
remote_value.to_knx((100, -101, 102))
with self.assertRaises(ConversionError):
remote_value.to_knx(("100", 101, 102))
with self.assertRaises(ConversionError):
remote_value.to_knx("100, 101, 102")
def test_from_knx(self):
"""Test from_knx function with normal operation."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx)
self.assertEqual(remote_value.from_knx(DPTArray((0x64, 0x65, 0x66))),
(100, 101, 102))
def __init__(
self,
xknx: XKNX,
name: str,
group_address_switch: GroupAddressesType | None = None,
group_address_switch_state: GroupAddressesType | None = None,
group_address_brightness: GroupAddressesType | None = None,
group_address_brightness_state: GroupAddressesType | None = None,
group_address_color: GroupAddressesType | None = None,
group_address_color_state: GroupAddressesType | None = None,
group_address_rgbw: GroupAddressesType | None = None,
group_address_rgbw_state: GroupAddressesType | None = None,
group_address_tunable_white: GroupAddressesType | None = None,
group_address_tunable_white_state: GroupAddressesType | None = None,
group_address_color_temperature: GroupAddressesType | None = None,
group_address_color_temperature_state: GroupAddressesType
| None = None,
group_address_switch_red: GroupAddressesType | None = None,
group_address_switch_red_state: GroupAddressesType | None = None,
group_address_brightness_red: GroupAddressesType | None = None,
group_address_brightness_red_state: GroupAddressesType | None = None,
group_address_switch_green: GroupAddressesType | None = None,
group_address_switch_green_state: GroupAddressesType | None = None,
group_address_brightness_green: GroupAddressesType | None = None,
group_address_brightness_green_state: GroupAddressesType | None = None,
group_address_switch_blue: GroupAddressesType | None = None,
group_address_switch_blue_state: GroupAddressesType | None = None,
group_address_brightness_blue: GroupAddressesType | None = None,
group_address_brightness_blue_state: GroupAddressesType | None = None,
group_address_switch_white: GroupAddressesType | None = None,
group_address_switch_white_state: GroupAddressesType | None = None,
group_address_brightness_white: GroupAddressesType | None = None,
group_address_brightness_white_state: GroupAddressesType | None = None,
min_kelvin: int | None = None,
max_kelvin: int | None = None,
device_updated_cb: DeviceCallbackType | None = None,
):
"""Initialize Light class."""
super().__init__(xknx, name, device_updated_cb)
self.switch = RemoteValueSwitch(
xknx,
group_address_switch,
group_address_switch_state,
device_name=self.name,
feature_name="State",
after_update_cb=self.after_update,
)
self.brightness = RemoteValueScaling(
xknx,
group_address_brightness,
group_address_brightness_state,
device_name=self.name,
feature_name="Brightness",
after_update_cb=self.after_update,
range_from=0,
range_to=255,
)
self.color = RemoteValueColorRGB(
xknx,
group_address_color,
group_address_color_state,
device_name=self.name,
after_update_cb=self.after_update,
)
self.rgbw = RemoteValueColorRGBW(
xknx,
group_address_rgbw,
group_address_rgbw_state,
device_name=self.name,
after_update_cb=self.after_update,
)
self.tunable_white = RemoteValueScaling(
xknx,
group_address_tunable_white,
group_address_tunable_white_state,
device_name=self.name,
feature_name="Tunable white",
after_update_cb=self.after_update,
range_from=0,
range_to=255,
)
self.color_temperature = RemoteValueDpt2ByteUnsigned(
xknx,
group_address_color_temperature,
group_address_color_temperature_state,
device_name=self.name,
feature_name="Color temperature",
after_update_cb=self.after_update,
)
self.red = _SwitchAndBrightness(
xknx,
self.name,
"red",
group_address_switch_red,
group_address_switch_red_state,
group_address_brightness_red,
group_address_brightness_red_state,
self.after_update,
)
self.green = _SwitchAndBrightness(
xknx,
self.name,
"green",
group_address_switch_green,
group_address_switch_green_state,
group_address_brightness_green,
group_address_brightness_green_state,
self.after_update,
)
self.blue = _SwitchAndBrightness(
xknx,
self.name,
"blue",
group_address_switch_blue,
group_address_switch_blue_state,
group_address_brightness_blue,
group_address_brightness_blue_state,
self.after_update,
)
self.white = _SwitchAndBrightness(
xknx,
self.name,
"white",
group_address_switch_white,
group_address_switch_white_state,
group_address_brightness_white,
group_address_brightness_white_state,
self.after_update,
)
self.min_kelvin = min_kelvin
self.max_kelvin = max_kelvin
def test_to_knx(self):
"""Test to_knx function with normal operation."""
xknx = XKNX()
remote_value = RemoteValueColorRGB(xknx)
assert remote_value.to_knx((100, 101, 102)) == DPTArray((0x64, 0x65, 0x66))
assert remote_value.to_knx([100, 101, 102]) == DPTArray((0x64, 0x65, 0x66))
def __init__(
self,
xknx,
name,
addr,
sw_cb=None,
#
val_cb=None,
val_dim_cb=None,
#
clr_rgb_cb=None,
clr_rgb_dim=None,
#
clr_r_cb=None,
clr_r_dim_cb=None,
clr_r_sw_cb=None,
#
clr_g_cb=None,
clr_g_dim_cb=None,
clr_g_sw_cb=None,
#
clr_b_cb=None,
clr_b_dim_cb=None,
clr_b_sw_cb=None,
#
clr_cct_cb=None,
clr_cct_dim_cb=None,
#
clr_h_cb=None,
clr_h_dim_cb=None,
#
clr_s_cb=None,
clr_s_dim_cb=None,
):
"""Initialize Group class."""
# pylint: disable=too-many-arguments
super().__init__(xknx, name)
self.xknx = xknx
self.sw = RV_SWITCH(xknx, addr["SW"], None, self.name, sw_cb)
self.sw_stat = RV_SWITCH(xknx, addr["SW_STAT"], None, self.name)
self.val = RV_SCALE(
xknx,
addr["VAL"],
None,
self.name,
val_cb,
0,
255,
)
self.val_dim = RV_DIM(xknx, addr["VAL_DIM"], None, self.name,
val_dim_cb)
self.val_stat = RV_SCALE(xknx, addr["VAL_STAT"], None, self.name, None,
0, 255)
#
self.clr_xyy = RV_XYY(xknx, addr["CLR_xyY"], None, self.name)
self.clr_xyy_stat = RV_XYY(xknx, addr["CLR_xyY_STAT"], None, self.name)
self.clr_cct_abs = RV_ABS(xknx, addr["CLR_CCT_ABS"], None, self.name)
#
self.clr_rgb = RV_RGB(xknx, addr["CLR_RGB"], None, self.name,
clr_rgb_cb)
self.clr_rgb_dim = RV_DIM(xknx, addr["CLR_RGB_DIM"], None, self.name,
val_dim_cb)
self.clr_rgb_stat = RV_RGB(xknx, addr["CLR_RGB_STAT"], None, self.name)
#
self.clr_r = RV_SCALE(xknx, addr["CLR_R"], None, self.name, clr_r_cb,
0, 255)
self.clr_r_dim = RV_DIM(xknx, addr["CLR_R_DIM"], None, self.name,
clr_r_dim_cb)
self.clr_r_stat = RV_SCALE(xknx, addr["CLR_R_STAT"], None, self.name,
None, 0, 255)
self.clr_r_sw = RV_SWITCH(xknx, addr["CLR_R_SW"], None, self.name,
clr_r_sw_cb)
self.clr_r_sw_stat = RV_SWITCH(xknx, addr["CLR_R_SW_STAT"], None,
self.name)
#
self.clr_g = RV_SCALE(xknx, addr["CLR_G"], None, self.name, clr_g_cb,
0, 255)
self.clr_g_dim = RV_DIM(xknx, addr["CLR_G_DIM"], None, self.name,
clr_g_dim_cb)
self.clr_g_stat = RV_SCALE(xknx, addr["CLR_G_STAT"], None, self.name,
None, 0, 255)
self.clr_g_sw = RV_SWITCH(xknx, addr["CLR_G_SW"], None, self.name,
clr_g_sw_cb)
self.clr_g_sw_stat = RV_SWITCH(xknx, addr["CLR_G_SW_STAT"], None,
self.name)
#
self.clr_b = RV_SCALE(xknx, addr["CLR_B"], None, self.name, clr_b_cb,
0, 255)
self.clr_b_dim = RV_DIM(xknx, addr["CLR_B_DIM"], None, self.name,
clr_b_dim_cb)
self.clr_b_stat = RV_SCALE(xknx, addr["CLR_B_STAT"], None, self.name,
None, 0, 255)
self.clr_b_sw = RV_SWITCH(xknx, addr["CLR_B_SW"], None, self.name,
clr_b_sw_cb)
self.clr_b_sw_stat = RV_SWITCH(xknx, addr["CLR_B_SW_STAT"], None,
self.name)
#
self.clr_cct = RV_SCALE(xknx, addr["CLR_CCT"], None, self.name,
clr_cct_cb, 0, 255)
self.clr_cct_dim = RV_DIM(xknx, addr["CLR_CCT_DIM"], None, self.name,
clr_cct_dim_cb)
self.clr_cct_stat = RV_SCALE(xknx, addr["CLR_CCT_STAT"], None,
self.name, None, 0, 255)
#
self.clr_h = RV_SCALE(
xknx,
addr["CLR_H"],
None,
self.name,
clr_h_cb,
0,
360,
)
self.clr_h_dim = RV_DIM(xknx, addr["CLR_H_DIM"], None, self.name,
clr_h_dim_cb)
self.clr_h_stat = RV_SCALE(
xknx,
addr["CLR_H_STAT"],
None,
self.name,
None,
0,
360,
)
#
self.clr_s = RV_SCALE(xknx, addr["CLR_S"], None, self.name, clr_s_cb,
0, 255)
self.clr_s_dim = RV_DIM(xknx, addr["CLR_S_DIM"], None, self.name,
clr_s_dim_cb)
self.clr_s_stat = RV_SCALE(xknx, addr["CLR_S_STAT"], None, self.name,
None, 0, 255)
class Group(Device):
"""Class for managing a light."""
# pylint: disable=too-many-locals
def __init__(
self,
xknx,
name,
addr,
sw_cb=None,
#
val_cb=None,
val_dim_cb=None,
#
clr_rgb_cb=None,
clr_rgb_dim=None,
#
clr_r_cb=None,
clr_r_dim_cb=None,
clr_r_sw_cb=None,
#
clr_g_cb=None,
clr_g_dim_cb=None,
clr_g_sw_cb=None,
#
clr_b_cb=None,
clr_b_dim_cb=None,
clr_b_sw_cb=None,
#
clr_cct_cb=None,
clr_cct_dim_cb=None,
#
clr_h_cb=None,
clr_h_dim_cb=None,
#
clr_s_cb=None,
clr_s_dim_cb=None,
):
"""Initialize Group class."""
# pylint: disable=too-many-arguments
super().__init__(xknx, name)
self.xknx = xknx
self.sw = RV_SWITCH(xknx, addr["SW"], None, self.name, sw_cb)
self.sw_stat = RV_SWITCH(xknx, addr["SW_STAT"], None, self.name)
self.val = RV_SCALE(
xknx,
addr["VAL"],
None,
self.name,
val_cb,
0,
255,
)
self.val_dim = RV_DIM(xknx, addr["VAL_DIM"], None, self.name,
val_dim_cb)
self.val_stat = RV_SCALE(xknx, addr["VAL_STAT"], None, self.name, None,
0, 255)
#
self.clr_xyy = RV_XYY(xknx, addr["CLR_xyY"], None, self.name)
self.clr_xyy_stat = RV_XYY(xknx, addr["CLR_xyY_STAT"], None, self.name)
self.clr_cct_abs = RV_ABS(xknx, addr["CLR_CCT_ABS"], None, self.name)
#
self.clr_rgb = RV_RGB(xknx, addr["CLR_RGB"], None, self.name,
clr_rgb_cb)
self.clr_rgb_dim = RV_DIM(xknx, addr["CLR_RGB_DIM"], None, self.name,
val_dim_cb)
self.clr_rgb_stat = RV_RGB(xknx, addr["CLR_RGB_STAT"], None, self.name)
#
self.clr_r = RV_SCALE(xknx, addr["CLR_R"], None, self.name, clr_r_cb,
0, 255)
self.clr_r_dim = RV_DIM(xknx, addr["CLR_R_DIM"], None, self.name,
clr_r_dim_cb)
self.clr_r_stat = RV_SCALE(xknx, addr["CLR_R_STAT"], None, self.name,
None, 0, 255)
self.clr_r_sw = RV_SWITCH(xknx, addr["CLR_R_SW"], None, self.name,
clr_r_sw_cb)
self.clr_r_sw_stat = RV_SWITCH(xknx, addr["CLR_R_SW_STAT"], None,
self.name)
#
self.clr_g = RV_SCALE(xknx, addr["CLR_G"], None, self.name, clr_g_cb,
0, 255)
self.clr_g_dim = RV_DIM(xknx, addr["CLR_G_DIM"], None, self.name,
clr_g_dim_cb)
self.clr_g_stat = RV_SCALE(xknx, addr["CLR_G_STAT"], None, self.name,
None, 0, 255)
self.clr_g_sw = RV_SWITCH(xknx, addr["CLR_G_SW"], None, self.name,
clr_g_sw_cb)
self.clr_g_sw_stat = RV_SWITCH(xknx, addr["CLR_G_SW_STAT"], None,
self.name)
#
self.clr_b = RV_SCALE(xknx, addr["CLR_B"], None, self.name, clr_b_cb,
0, 255)
self.clr_b_dim = RV_DIM(xknx, addr["CLR_B_DIM"], None, self.name,
clr_b_dim_cb)
self.clr_b_stat = RV_SCALE(xknx, addr["CLR_B_STAT"], None, self.name,
None, 0, 255)
self.clr_b_sw = RV_SWITCH(xknx, addr["CLR_B_SW"], None, self.name,
clr_b_sw_cb)
self.clr_b_sw_stat = RV_SWITCH(xknx, addr["CLR_B_SW_STAT"], None,
self.name)
#
self.clr_cct = RV_SCALE(xknx, addr["CLR_CCT"], None, self.name,
clr_cct_cb, 0, 255)
self.clr_cct_dim = RV_DIM(xknx, addr["CLR_CCT_DIM"], None, self.name,
clr_cct_dim_cb)
self.clr_cct_stat = RV_SCALE(xknx, addr["CLR_CCT_STAT"], None,
self.name, None, 0, 255)
#
self.clr_h = RV_SCALE(
xknx,
addr["CLR_H"],
None,
self.name,
clr_h_cb,
0,
360,
)
self.clr_h_dim = RV_DIM(xknx, addr["CLR_H_DIM"], None, self.name,
clr_h_dim_cb)
self.clr_h_stat = RV_SCALE(
xknx,
addr["CLR_H_STAT"],
None,
self.name,
None,
0,
360,
)
#
self.clr_s = RV_SCALE(xknx, addr["CLR_S"], None, self.name, clr_s_cb,
0, 255)
self.clr_s_dim = RV_DIM(xknx, addr["CLR_S_DIM"], None, self.name,
clr_s_dim_cb)
self.clr_s_stat = RV_SCALE(xknx, addr["CLR_S_STAT"], None, self.name,
None, 0, 255)
def update(self, addresses):
self.sw.group_addresses = addresses["SW"]
self.sw_stat.group_addresses = addresses["SW_STAT"]
#
self.val.group_addresses = addresses["VAL"]
self.val_dim.group_addresses = addresses["VAL_DIM"]
self.val_stat.group_addresses = addresses["VAL_STAT"]
#
self.clr_xyy.group_addresses = addresses["CLR_xyY"]
self.clr_xyy_stat.group_addresses = addresses["CLR_xyY_STAT"]
self.clr_cct_abs.group_addresses = addresses["CLR_CCT_ABS"]
#
self.clr_rgb.group_addresses = addresses["CLR_RGB"]
self.clr_rgb_dim.group_addresses = addresses["CLR_RGB"]
self.clr_rgb_stat.group_addresses = addresses["CLR_RGB_STAT"]
#
self.clr_r.group_addresses = addresses["CLR_R"]
self.clr_r_dim.group_addresses = addresses["CLR_R_DIM"]
self.clr_r_stat.group_addresses = addresses["CLR_R_STAT"]
self.clr_r_sw.group_addresses = addresses["CLR_R_SW"]
self.clr_r_sw_stat.group_addresses = addresses["CLR_R_SW_STAT"]
#
self.clr_g.group_addresses = addresses["CLR_G"]
self.clr_g_dim.group_addresses = addresses["CLR_G_DIM"]
self.clr_g_stat.group_addresses = addresses["CLR_G_STAT"]
self.clr_g_sw.group_addresses = addresses["CLR_G_SW"]
self.clr_g_sw_stat.group_addresses = addresses["CLR_G_SW_STAT"]
#
self.clr_b.group_addresses = addresses["CLR_B"]
self.clr_b_dim.group_addresses = addresses["CLR_B_DIM"]
self.clr_b_stat.group_addresses = addresses["CLR_B_STAT"]
self.clr_b_sw.group_addresses = addresses["CLR_B_SW"]
self.clr_b_sw_stat.group_addresses = addresses["CLR_B_SW_STAT"]
#
self.clr_cct.group_addresses = addresses["CLR_CCT"]
self.clr_cct_dim.group_addresses = addresses["CLR_CCT_DIM"]
self.clr_cct_stat.group_addresses = addresses["CLR_CCT_STAT"]
#
self.clr_h.group_addresses = addresses["CLR_H"]
self.clr_h_dim.group_addresses = addresses["CLR_H_DIM"]
self.clr_h_stat.group_addresses = addresses["CLR_H_STAT"]
#
self.clr_s.group_addresses = addresses["CLR_S"]
self.clr_s_dim.group_addresses = addresses["CLR_S_DIM"]
self.clr_s_stat.group_addresses = addresses["CLR_S_STAT"]
@property
def supports_dimming(self):
return self.dimming_val.initialized
@property
def supports_brightness(self):
return self.brightness.initialized
@property
def supports_color(self):
return self.color_rgb.initialized
@property
def supports_color_xyY(self):
return self.color_xyY.initialized
def has_group_address(self, group_address):
"""Test if device has given group address. Not used for Status"""
return (
self.sw.has_group_address(group_address)
or self.val.has_group_address(group_address) # noqa W503
or self.val_dim.has_group_address(group_address) # noqa W503
#
or self.clr_xyy.has_group_address(group_address) # noqa W503
or self.clr_cct_abs.has_group_address(group_address) # noqa W503
#
or self.clr_rgb.has_group_address(group_address) # noqa W503
or self.clr_rgb_dim.has_group_address(group_address) # noqa W503
#
or self.clr_r.has_group_address(group_address) # noqa W503
or self.clr_r_dim.has_group_address(group_address) # noqa W503
or self.clr_r_sw.has_group_address(group_address) # noqa W503
#
or self.clr_g.has_group_address(group_address) # noqa W503
or self.clr_g_dim.has_group_address(group_address) # noqa W503
or self.clr_g_sw.has_group_address(group_address) # noqa W503
#
or self.clr_b.has_group_address(group_address) # noqa W503
or self.clr_b_dim.has_group_address(group_address) # noqa W503
or self.clr_b_sw.has_group_address(group_address) # noqa W503
#
or self.clr_h.has_group_address(group_address) # noqa W503
or self.clr_h_dim.has_group_address(group_address) # noqa W503
#
or self.clr_s.has_group_address(group_address) # noqa W503
or self.clr_s_dim.has_group_address(group_address) # noqa W503
#
or self.clr_cct.has_group_address(group_address) # noqa W503
or self.clr_cct_dim.has_group_address(group_address) # noqa W503
)
def __repr__(self):
"""Return object as readable string."""
return (
f"KNX_Group(name={self.name}, sw:{self.sw.group_address}"
f", sw_stat: {self.sw_stat.group_address}"
f", val_dim:{self.val_dim.group_address}, val:{self.val.group_address}"
f", clr_xyy: {self.clr_xyy.group_address}, clr_rgb: {self.clr_rgb.group_address}"
f", clr_rgb_stat:{self.clr_rgb_stat.group_address}")
async def process_group_write(self, telegram):
"""Process incoming GROUP WRITE telegram."""
await self.sw.process(telegram)
await self.val_dim.process(telegram)
await self.val.process(telegram)
#
# await self.clr_xyy.process(telegram)
#
await self.clr_rgb.process(telegram)
await self.clr_rgb_dim.process(telegram)
#
await self.clr_r.process(telegram)
await self.clr_r_dim.process(telegram)
await self.clr_r_sw.process(telegram)
#
await self.clr_g.process(telegram)
await self.clr_g_dim.process(telegram)
await self.clr_g_sw.process(telegram)
#
await self.clr_b.process(telegram)
await self.clr_b_dim.process(telegram)
await self.clr_b_sw.process(telegram)
#
await self.clr_h.process(telegram)
await self.clr_h_dim.process(telegram)
#
await self.clr_s.process(telegram)
await self.clr_s_dim.process(telegram)
#
await self.clr_cct.process(telegram)
await self.clr_cct_dim.process(telegram)
def __eq__(self, other):
"""Equal operator."""
return self.__dict__ == other.__dict__
def __init__(self,
xknx,
name,
group_address_switch=None,
group_address_switch_state=None,
group_address_brightness=None,
group_address_brightness_state=None,
group_address_color=None,
group_address_color_state=None,
group_address_rgbw=None,
group_address_rgbw_state=None,
group_address_tunable_white=None,
group_address_tunable_white_state=None,
group_address_color_temperature=None,
group_address_color_temperature_state=None,
min_kelvin=None,
max_kelvin=None,
device_updated_cb=None):
"""Initialize Light class."""
# pylint: disable=too-many-arguments
super().__init__(xknx, name, device_updated_cb)
self.switch = RemoteValueSwitch(xknx,
group_address_switch,
group_address_switch_state,
device_name=self.name,
feature_name="State",
after_update_cb=self.after_update)
self.brightness = RemoteValueScaling(xknx,
group_address_brightness,
group_address_brightness_state,
device_name=self.name,
feature_name="Brightness",
after_update_cb=self.after_update,
range_from=0,
range_to=255)
self.color = RemoteValueColorRGB(xknx,
group_address_color,
group_address_color_state,
device_name=self.name,
after_update_cb=self.after_update)
self.rgbw = RemoteValueColorRGBW(xknx,
group_address_rgbw,
group_address_rgbw_state,
device_name=self.name,
after_update_cb=self.after_update)
self.tunable_white = RemoteValueScaling(
xknx,
group_address_tunable_white,
group_address_tunable_white_state,
device_name=self.name,
feature_name="Tunable white",
after_update_cb=self.after_update,
range_from=0,
range_to=255)
self.color_temperature = RemoteValueDpt2ByteUnsigned(
xknx,
group_address_color_temperature,
group_address_color_temperature_state,
device_name=self.name,
feature_name="Color temperature",
after_update_cb=self.after_update)
self.min_kelvin = min_kelvin
self.max_kelvin = max_kelvin
class Light(Device):
"""Class for managing a light."""
# pylint: disable=too-many-locals
DEFAULT_MIN_KELVIN = 2700 # 370 mireds
DEFAULT_MAX_KELVIN = 6000 # 166 mireds
def __init__(self,
xknx,
name,
group_address_switch=None,
group_address_switch_state=None,
group_address_brightness=None,
group_address_brightness_state=None,
group_address_color=None,
group_address_color_state=None,
group_address_rgbw=None,
group_address_rgbw_state=None,
group_address_tunable_white=None,
group_address_tunable_white_state=None,
group_address_color_temperature=None,
group_address_color_temperature_state=None,
min_kelvin=None,
max_kelvin=None,
device_updated_cb=None):
"""Initialize Light class."""
# pylint: disable=too-many-arguments
super().__init__(xknx, name, device_updated_cb)
self.switch = RemoteValueSwitch(xknx,
group_address_switch,
group_address_switch_state,
device_name=self.name,
feature_name="State",
after_update_cb=self.after_update)
self.brightness = RemoteValueScaling(xknx,
group_address_brightness,
group_address_brightness_state,
device_name=self.name,
feature_name="Brightness",
after_update_cb=self.after_update,
range_from=0,
range_to=255)
self.color = RemoteValueColorRGB(xknx,
group_address_color,
group_address_color_state,
device_name=self.name,
after_update_cb=self.after_update)
self.rgbw = RemoteValueColorRGBW(xknx,
group_address_rgbw,
group_address_rgbw_state,
device_name=self.name,
after_update_cb=self.after_update)
self.tunable_white = RemoteValueScaling(
xknx,
group_address_tunable_white,
group_address_tunable_white_state,
device_name=self.name,
feature_name="Tunable white",
after_update_cb=self.after_update,
range_from=0,
range_to=255)
self.color_temperature = RemoteValueDpt2ByteUnsigned(
xknx,
group_address_color_temperature,
group_address_color_temperature_state,
device_name=self.name,
feature_name="Color temperature",
after_update_cb=self.after_update)
self.min_kelvin = min_kelvin
self.max_kelvin = max_kelvin
def _iter_remote_values(self):
"""Iterate the devices RemoteValue classes."""
yield from (self.switch, self.brightness, self.color, self.rgbw,
self.tunable_white, self.color_temperature)
@property
def supports_brightness(self):
"""Return if light supports brightness."""
return self.brightness.initialized
@property
def supports_color(self):
"""Return if light supports color."""
return self.color.initialized
@property
def supports_rgbw(self):
"""Return if light supports RGBW."""
return self.rgbw.initialized
@property
def supports_tunable_white(self):
"""Return if light supports tunable white / relative color temperature."""
return self.tunable_white.initialized
@property
def supports_color_temperature(self):
"""Return if light supports absolute color temperature."""
return self.color_temperature.initialized
@classmethod
def from_config(cls, xknx, name, config):
"""Initialize object from configuration structure."""
group_address_switch = \
config.get('group_address_switch')
group_address_switch_state = \
config.get('group_address_switch_state')
group_address_brightness = \
config.get('group_address_brightness')
group_address_brightness_state = \
config.get('group_address_brightness_state')
group_address_color = \
config.get('group_address_color')
group_address_color_state = \
config.get('group_address_color_state')
group_address_rgbw = \
config.get('group_address_rgbw')
group_address_rgbw_state = \
config.get('group_address_rgbw_state')
group_address_tunable_white = \
config.get('group_address_tunable_white')
group_address_tunable_white_state = \
config.get('group_address_tunable_white_state')
group_address_color_temperature = \
config.get('group_address_color_temperature')
group_address_color_temperature_state = \
config.get('group_address_color_temperature_state')
min_kelvin = \
config.get('min_kelvin', Light.DEFAULT_MIN_KELVIN)
max_kelvin = \
config.get('max_kelvin', Light.DEFAULT_MAX_KELVIN)
return cls(
xknx,
name,
group_address_switch=group_address_switch,
group_address_switch_state=group_address_switch_state,
group_address_brightness=group_address_brightness,
group_address_brightness_state=group_address_brightness_state,
group_address_color=group_address_color,
group_address_color_state=group_address_color_state,
group_address_rgbw=group_address_rgbw,
group_address_rgbw_state=group_address_rgbw_state,
group_address_tunable_white=group_address_tunable_white,
group_address_tunable_white_state=group_address_tunable_white_state,
group_address_color_temperature=group_address_color_temperature,
group_address_color_temperature_state=
group_address_color_temperature_state,
min_kelvin=min_kelvin,
max_kelvin=max_kelvin)
def __str__(self):
"""Return object as readable string."""
str_brightness = '' if not self.supports_brightness else \
' brightness="{0}"'.format(
self.brightness.group_addr_str())
str_color = '' if not self.supports_color else \
' color="{0}"'.format(
self.color.group_addr_str())
str_rgbw = '' if not self.supports_rgbw else \
' rgbw="{0}"'.format(
self.rgbw.group_addr_str())
str_tunable_white = '' if not self.supports_tunable_white else \
' tunable white="{0}"'.format(
self.tunable_white.group_addr_str())
str_color_temperature = '' if not self.supports_color_temperature else \
' color temperature="{0}"'.format(
self.color_temperature.group_addr_str())
return '<Light name="{0}" ' \
'switch="{1}"{2}{3}{4}{5}{6} />' \
.format(
self.name,
self.switch.group_addr_str(),
str_brightness,
str_color,
str_rgbw,
str_tunable_white,
str_color_temperature)
@property
def state(self):
"""Return the current switch state of the device."""
# None will return False
return bool(self.switch.value)
async def set_on(self):
"""Switch light on."""
await self.switch.on()
async def set_off(self):
"""Switch light off."""
await self.switch.off()
@property
def current_brightness(self):
"""Return current brightness of light."""
return self.brightness.value
async def set_brightness(self, brightness):
"""Set brightness of light."""
if not self.supports_brightness:
self.xknx.logger.warning("Dimming not supported for device %s",
self.get_name())
return
await self.brightness.set(brightness)
@property
def current_color(self):
"""
Return current color of light.
If the device supports RGBW, get the current RGB+White values instead.
"""
if self.supports_rgbw:
if not self.rgbw.value:
return None, None
return self.rgbw.value[:3], self.rgbw.value[3]
return self.color.value, None
async def set_color(self, color, white=None):
"""
Set color of a light device.
If also the white value is given and the device supports RGBW,
set all four values.
"""
if white is not None:
if self.supports_rgbw:
await self.rgbw.set(list(color) + [white])
return
self.xknx.logger.warning("RGBW not supported for device %s",
self.get_name())
else:
if self.supports_color:
await self.color.set(color)
return
self.xknx.logger.warning("Colors not supported for device %s",
self.get_name())
@property
def current_tunable_white(self):
"""Return current relative color temperature of light."""
return self.tunable_white.value
async def set_tunable_white(self, tunable_white):
"""Set relative color temperature of light."""
if not self.supports_tunable_white:
self.xknx.logger.warning(
"Tunable white not supported for device %s", self.get_name())
return
await self.tunable_white.set(tunable_white)
@property
def current_color_temperature(self):
"""Return current absolute color temperature of light."""
return self.color_temperature.value
async def set_color_temperature(self, color_temperature):
"""Set absolute color temperature of light."""
if not self.supports_color_temperature:
self.xknx.logger.warning(
"Absolute Color Temperature not supported for device %s",
self.get_name())
return
await self.color_temperature.set(color_temperature)
async def do(self, action):
"""Execute 'do' commands."""
if action == "on":
await self.set_on()
elif action == "off":
await self.set_off()
elif action.startswith("brightness:"):
await self.set_brightness(int(action[11:]))
elif action.startswith("tunable_white:"):
await self.set_tunable_white(int(action[14:]))
elif action.startswith("color_temperature:"):
await self.set_color_temperature(int(action[18:]))
else:
self.xknx.logger.warning(
"Could not understand action %s for device %s", action,
self.get_name())
async def process_group_write(self, telegram):
"""Process incoming GROUP WRITE telegram."""
for remote_value in self._iter_remote_values():
await remote_value.process(telegram)
def __eq__(self, other):
"""Equal operator."""
return self.__dict__ == other.__dict__