Home Assistant Unofficial Reference 2024.12.1
light.py
Go to the documentation of this file.
1 """Support for lights."""
2 
3 from __future__ import annotations
4 
5 from typing import Any
6 
7 from aiocomelit import ComelitSerialBridgeObject
8 from aiocomelit.const import LIGHT, STATE_OFF, STATE_ON
9 
10 from homeassistant.components.light import ColorMode, LightEntity
11 from homeassistant.config_entries import ConfigEntry
12 from homeassistant.core import HomeAssistant
13 from homeassistant.helpers.entity_platform import AddEntitiesCallback
14 from homeassistant.helpers.update_coordinator import CoordinatorEntity
15 
16 from .const import DOMAIN
17 from .coordinator import ComelitSerialBridge
18 
19 
21  hass: HomeAssistant,
22  config_entry: ConfigEntry,
23  async_add_entities: AddEntitiesCallback,
24 ) -> None:
25  """Set up Comelit lights."""
26 
27  coordinator: ComelitSerialBridge = hass.data[DOMAIN][config_entry.entry_id]
28 
30  ComelitLightEntity(coordinator, device, config_entry.entry_id)
31  for device in coordinator.data[LIGHT].values()
32  )
33 
34 
35 class ComelitLightEntity(CoordinatorEntity[ComelitSerialBridge], LightEntity):
36  """Light device."""
37 
38  _attr_color_mode = ColorMode.ONOFF
39  _attr_has_entity_name = True
40  _attr_name = None
41  _attr_supported_color_modes = {ColorMode.ONOFF}
42 
43  def __init__(
44  self,
45  coordinator: ComelitSerialBridge,
46  device: ComelitSerialBridgeObject,
47  config_entry_entry_id: str,
48  ) -> None:
49  """Init light entity."""
50  self._api_api = coordinator.api
51  self._device_device_device = device
52  super().__init__(coordinator)
53  # Use config_entry.entry_id as base for unique_id
54  # because no serial number or mac is available
55  self._attr_unique_id_attr_unique_id = f"{config_entry_entry_id}-{device.index}"
56  self._attr_device_info_attr_device_info = coordinator.platform_device_info(device, device.type)
57 
58  async def _light_set_state(self, state: int) -> None:
59  """Set desired light state."""
60  await self.coordinator.api.set_device_status(LIGHT, self._device_device_device.index, state)
61  await self.coordinator.async_request_refresh()
62 
63  async def async_turn_on(self, **kwargs: Any) -> None:
64  """Turn the light on."""
65  await self._light_set_state_light_set_state(STATE_ON)
66 
67  async def async_turn_off(self, **kwargs: Any) -> None:
68  """Turn the light off."""
69  await self._light_set_state_light_set_state(STATE_OFF)
70 
71  @property
72  def is_on(self) -> bool:
73  """Return True if light is on."""
74  return self.coordinator.data[LIGHT][self._device_device_device.index].status == STATE_ON
None __init__(self, ComelitSerialBridge coordinator, ComelitSerialBridgeObject device, str config_entry_entry_id)
Definition: light.py:48
None async_setup_entry(HomeAssistant hass, ConfigEntry config_entry, AddEntitiesCallback async_add_entities)
Definition: light.py:24