Home Assistant Unofficial Reference 2024.12.1
number.py
Go to the documentation of this file.
1 """Support for Lektrico number entities."""
2 
3 from collections.abc import Callable, Coroutine
4 from dataclasses import dataclass
5 from typing import Any
6 
7 from lektricowifi import Device
8 
9 from homeassistant.components.number import NumberEntity, NumberEntityDescription
10 from homeassistant.const import (
11  ATTR_SERIAL_NUMBER,
12  CONF_TYPE,
13  PERCENTAGE,
14  EntityCategory,
15  UnitOfElectricCurrent,
16 )
17 from homeassistant.core import HomeAssistant
18 from homeassistant.helpers.entity_platform import AddEntitiesCallback
19 
20 from . import LektricoConfigEntry, LektricoDeviceDataUpdateCoordinator
21 from .entity import LektricoEntity
22 
23 
24 @dataclass(frozen=True, kw_only=True)
26  """Describes Lektrico number entity."""
27 
28  value_fn: Callable[[dict[str, Any]], int]
29  set_value_fn: Callable[[Device, int], Coroutine[Any, Any, dict[Any, Any]]]
30 
31 
32 NUMBERS: tuple[LektricoNumberEntityDescription, ...] = (
34  key="led_max_brightness",
35  translation_key="led_max_brightness",
36  entity_category=EntityCategory.CONFIG,
37  native_min_value=0,
38  native_max_value=100,
39  native_step=5,
40  native_unit_of_measurement=PERCENTAGE,
41  value_fn=lambda data: int(data["led_max_brightness"]),
42  set_value_fn=lambda data, value: data.set_led_max_brightness(value),
43  ),
45  key="dynamic_limit",
46  translation_key="dynamic_limit",
47  entity_category=EntityCategory.CONFIG,
48  native_min_value=0,
49  native_max_value=32,
50  native_step=1,
51  native_unit_of_measurement=UnitOfElectricCurrent.AMPERE,
52  value_fn=lambda data: int(data["dynamic_current"]),
53  set_value_fn=lambda data, value: data.set_dynamic_current(value),
54  ),
55 )
56 
57 
59  hass: HomeAssistant,
60  entry: LektricoConfigEntry,
61  async_add_entities: AddEntitiesCallback,
62 ) -> None:
63  """Set up Lektrico number entities based on a config entry."""
64  coordinator = entry.runtime_data
65 
68  description,
69  coordinator,
70  f"{entry.data[CONF_TYPE]}_{entry.data[ATTR_SERIAL_NUMBER]}",
71  )
72  for description in NUMBERS
73  )
74 
75 
77  """Defines a Lektrico number entity."""
78 
79  entity_description: LektricoNumberEntityDescription
80 
81  def __init__(
82  self,
83  description: LektricoNumberEntityDescription,
84  coordinator: LektricoDeviceDataUpdateCoordinator,
85  device_name: str,
86  ) -> None:
87  """Initialize Lektrico number."""
88  super().__init__(coordinator, device_name)
89  self.entity_descriptionentity_description = description
90  self._attr_unique_id_attr_unique_id = f"{coordinator.serial_number}_{description.key}"
91 
92  @property
93  def native_value(self) -> int | None:
94  """Return the state of the number."""
95  return self.entity_descriptionentity_description.value_fn(self.coordinator.data)
96 
97  async def async_set_native_value(self, value: float) -> None:
98  """Set the selected value."""
99  await self.entity_descriptionentity_description.set_value_fn(self.coordinator.device, int(value))
100  await self.coordinator.async_request_refresh()
None __init__(self, LektricoNumberEntityDescription description, LektricoDeviceDataUpdateCoordinator coordinator, str device_name)
Definition: number.py:86
None async_setup_entry(HomeAssistant hass, LektricoConfigEntry entry, AddEntitiesCallback async_add_entities)
Definition: number.py:62