Home Assistant Unofficial Reference 2024.12.1
switch.py
Go to the documentation of this file.
1 """Support for switches."""
2 
3 from __future__ import annotations
4 
5 from typing import Any
6 
7 from aiocomelit import ComelitSerialBridgeObject
8 from aiocomelit.const import IRRIGATION, OTHER, STATE_OFF, STATE_ON
9 
10 from homeassistant.components.switch import SwitchDeviceClass, SwitchEntity
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 switches."""
26 
27  coordinator: ComelitSerialBridge = hass.data[DOMAIN][config_entry.entry_id]
28 
29  entities: list[ComelitSwitchEntity] = []
30  entities.extend(
31  ComelitSwitchEntity(coordinator, device, config_entry.entry_id)
32  for device in coordinator.data[IRRIGATION].values()
33  )
34  entities.extend(
35  ComelitSwitchEntity(coordinator, device, config_entry.entry_id)
36  for device in coordinator.data[OTHER].values()
37  )
38  async_add_entities(entities)
39 
40 
41 class ComelitSwitchEntity(CoordinatorEntity[ComelitSerialBridge], SwitchEntity):
42  """Switch device."""
43 
44  _attr_has_entity_name = True
45  _attr_name = None
46 
47  def __init__(
48  self,
49  coordinator: ComelitSerialBridge,
50  device: ComelitSerialBridgeObject,
51  config_entry_entry_id: str,
52  ) -> None:
53  """Init switch entity."""
54  self._api_api = coordinator.api
55  self._device_device_device = device
56  super().__init__(coordinator)
57  # Use config_entry.entry_id as base for unique_id
58  # because no serial number or mac is available
59  self._attr_unique_id_attr_unique_id = f"{config_entry_entry_id}-{device.type}-{device.index}"
60  self._attr_device_info_attr_device_info = coordinator.platform_device_info(device, device.type)
61  if device.type == OTHER:
62  self._attr_device_class_attr_device_class = SwitchDeviceClass.OUTLET
63 
64  async def _switch_set_state(self, state: int) -> None:
65  """Set desired switch state."""
66  await self.coordinator.api.set_device_status(
67  self._device_device_device.type, self._device_device_device.index, state
68  )
69  await self.coordinator.async_request_refresh()
70 
71  async def async_turn_on(self, **kwargs: Any) -> None:
72  """Turn the switch on."""
73  await self._switch_set_state_switch_set_state(STATE_ON)
74 
75  async def async_turn_off(self, **kwargs: Any) -> None:
76  """Turn the switch off."""
77  await self._switch_set_state_switch_set_state(STATE_OFF)
78 
79  @property
80  def is_on(self) -> bool:
81  """Return True if switch is on."""
82  return (
83  self.coordinator.data[self._device_device_device.type][self._device_device_device.index].status
84  == STATE_ON
85  )
None __init__(self, ComelitSerialBridge coordinator, ComelitSerialBridgeObject device, str config_entry_entry_id)
Definition: switch.py:52
None async_setup_entry(HomeAssistant hass, ConfigEntry config_entry, AddEntitiesCallback async_add_entities)
Definition: switch.py:24