Home Assistant Unofficial Reference 2024.12.1
light.py
Go to the documentation of this file.
1 """Support for Insteon lights via PowerLinc Modem."""
2 
3 from typing import Any
4 
5 from pyinsteon.config import ON_LEVEL
6 from pyinsteon.device_types.device_base import Device as InsteonDevice
7 
8 from homeassistant.components.light import ATTR_BRIGHTNESS, ColorMode, LightEntity
9 from homeassistant.config_entries import ConfigEntry
10 from homeassistant.const import Platform
11 from homeassistant.core import HomeAssistant, callback
12 from homeassistant.helpers.dispatcher import async_dispatcher_connect
13 from homeassistant.helpers.entity_platform import AddEntitiesCallback
14 
15 from .const import SIGNAL_ADD_ENTITIES
16 from .entity import InsteonEntity
17 from .utils import async_add_insteon_devices, async_add_insteon_entities
18 
19 MAX_BRIGHTNESS = 255
20 
21 
23  hass: HomeAssistant,
24  config_entry: ConfigEntry,
25  async_add_entities: AddEntitiesCallback,
26 ) -> None:
27  """Set up the Insteon lights from a config entry."""
28 
29  @callback
30  def async_add_insteon_light_entities(discovery_info=None):
31  """Add the Insteon entities for the platform."""
33  hass,
34  Platform.LIGHT,
35  InsteonDimmerEntity,
36  async_add_entities,
37  discovery_info,
38  )
39 
40  signal = f"{SIGNAL_ADD_ENTITIES}_{Platform.LIGHT}"
41  async_dispatcher_connect(hass, signal, async_add_insteon_light_entities)
43  hass,
44  Platform.LIGHT,
45  InsteonDimmerEntity,
46  async_add_entities,
47  )
48 
49 
51  """A Class for an Insteon light entity."""
52 
53  _attr_color_mode = ColorMode.BRIGHTNESS
54  _attr_supported_color_modes = {ColorMode.BRIGHTNESS}
55 
56  def __init__(self, device: InsteonDevice, group: int) -> None:
57  """Init the InsteonDimmerEntity entity."""
58  super().__init__(device=device, group=group)
59  if not self._insteon_device_group_insteon_device_group.is_dimmable:
60  self._attr_color_mode_attr_color_mode = ColorMode.ONOFF
61  self._attr_supported_color_modes_attr_supported_color_modes_attr_supported_color_modes = {ColorMode.ONOFF}
62 
63  @property
64  def brightness(self):
65  """Return the brightness of this light between 0..255."""
66  return self._insteon_device_group_insteon_device_group.value
67 
68  @property
69  def is_on(self) -> bool:
70  """Return the boolean response if the node is on."""
71  return bool(self.brightnessbrightnessbrightness)
72 
73  async def async_turn_on(self, **kwargs: Any) -> None:
74  """Turn light on."""
75  brightness: int | None = None
76  if ATTR_BRIGHTNESS in kwargs:
77  brightness = int(kwargs[ATTR_BRIGHTNESS])
78  elif self._insteon_device_group_insteon_device_group.group == 1:
79  brightness = self.get_device_propertyget_device_property(ON_LEVEL)
80  if brightness:
81  await self._insteon_device_insteon_device.async_on(
82  on_level=brightness, group=self._insteon_device_group_insteon_device_group.group
83  )
84  else:
85  await self._insteon_device_insteon_device.async_on(group=self._insteon_device_group_insteon_device_group.group)
86 
87  async def async_turn_off(self, **kwargs: Any) -> None:
88  """Turn light off."""
89  await self._insteon_device_insteon_device.async_off(self._insteon_device_group_insteon_device_group.group)
None __init__(self, InsteonDevice device, int group)
Definition: light.py:56
None async_setup_entry(HomeAssistant hass, ConfigEntry config_entry, AddEntitiesCallback async_add_entities)
Definition: light.py:26
None async_add_insteon_devices(HomeAssistant hass, Platform platform, type[InsteonEntity] entity_type, AddEntitiesCallback async_add_entities)
Definition: utils.py:436
None async_add_insteon_entities(HomeAssistant hass, Platform platform, type[InsteonEntity] entity_type, AddEntitiesCallback async_add_entities, dict[str, Any] discovery_info)
Definition: utils.py:420
Callable[[], None] async_dispatcher_connect(HomeAssistant hass, str signal, Callable[..., Any] target)
Definition: dispatcher.py:103