Home Assistant Unofficial Reference 2024.12.1
button.py
Go to the documentation of this file.
1 """Support for Magic home button."""
2 
3 from __future__ import annotations
4 
5 from flux_led.aio import AIOWifiLedBulb
6 from flux_led.protocol import RemoteConfig
7 
8 from homeassistant import config_entries
10  ButtonDeviceClass,
11  ButtonEntity,
12  ButtonEntityDescription,
13 )
14 from homeassistant.const import EntityCategory
15 from homeassistant.core import HomeAssistant
16 from homeassistant.helpers.entity_platform import AddEntitiesCallback
17 
18 from .const import DOMAIN
19 from .coordinator import FluxLedUpdateCoordinator
20 from .entity import FluxBaseEntity
21 
22 _RESTART_KEY = "restart"
23 _UNPAIR_REMOTES_KEY = "unpair_remotes"
24 
25 RESTART_BUTTON_DESCRIPTION = ButtonEntityDescription(
26  key=_RESTART_KEY,
27  device_class=ButtonDeviceClass.RESTART,
28 )
29 UNPAIR_REMOTES_DESCRIPTION = ButtonEntityDescription(
30  key=_UNPAIR_REMOTES_KEY,
31  translation_key="unpair_remotes",
32 )
33 
34 
36  hass: HomeAssistant,
38  async_add_entities: AddEntitiesCallback,
39 ) -> None:
40  """Set up Magic Home button based on a config entry."""
41  coordinator: FluxLedUpdateCoordinator = hass.data[DOMAIN][entry.entry_id]
42  device = coordinator.device
43  entities: list[FluxButton] = [
44  FluxButton(coordinator.device, entry, RESTART_BUTTON_DESCRIPTION)
45  ]
46  if device.paired_remotes is not None:
47  entities.append(
48  FluxButton(coordinator.device, entry, UNPAIR_REMOTES_DESCRIPTION)
49  )
50 
51  async_add_entities(entities)
52 
53 
55  """Representation of a Flux button."""
56 
57  _attr_entity_category = EntityCategory.CONFIG
58 
59  def __init__(
60  self,
61  device: AIOWifiLedBulb,
63  description: ButtonEntityDescription,
64  ) -> None:
65  """Initialize the button."""
66  self.entity_descriptionentity_description = description
67  super().__init__(device, entry)
68  base_unique_id = entry.unique_id or entry.entry_id
69  self._attr_unique_id_attr_unique_id = f"{base_unique_id}_{description.key}"
70 
71  async def async_press(self) -> None:
72  """Send out a command."""
73  if self.entity_descriptionentity_description.key == _RESTART_KEY:
74  await self._device.async_reboot()
75  else:
76  await self._device.async_unpair_remotes()
77  await self._device.async_config_remotes(RemoteConfig.OPEN)
None __init__(self, AIOWifiLedBulb device, config_entries.ConfigEntry entry, ButtonEntityDescription description)
Definition: button.py:64
None async_setup_entry(HomeAssistant hass, config_entries.ConfigEntry entry, AddEntitiesCallback async_add_entities)
Definition: button.py:39