Home Assistant Unofficial Reference 2024.12.1
number.py
Go to the documentation of this file.
1 """The Nibe Heat Pump numbers."""
2 
3 from __future__ import annotations
4 
5 from nibe.coil import Coil, CoilData
6 
7 from homeassistant.components.number import ENTITY_ID_FORMAT, NumberEntity
8 from homeassistant.config_entries import ConfigEntry
9 from homeassistant.const import EntityCategory
10 from homeassistant.core import HomeAssistant
11 from homeassistant.helpers.entity_platform import AddEntitiesCallback
12 
13 from .const import DOMAIN
14 from .coordinator import CoilCoordinator
15 from .entity import CoilEntity
16 
17 
19  hass: HomeAssistant,
20  config_entry: ConfigEntry,
21  async_add_entities: AddEntitiesCallback,
22 ) -> None:
23  """Set up platform."""
24 
25  coordinator: CoilCoordinator = hass.data[DOMAIN][config_entry.entry_id]
26 
28  Number(coordinator, coil)
29  for coil in coordinator.coils
30  if coil.is_writable and not coil.mappings
31  )
32 
33 
34 def _get_numeric_limits(size: str):
35  """Calculate the integer limits of a signed or unsigned integer value."""
36  if size[0] == "u":
37  return (0, pow(2, int(size[1:])) - 1)
38  if size[0] == "s":
39  return (-pow(2, int(size[1:]) - 1), pow(2, int(size[1:]) - 1) - 1)
40  raise ValueError(f"Invalid size type specified {size}")
41 
42 
44  """Number entity."""
45 
46  _attr_entity_category = EntityCategory.CONFIG
47 
48  def __init__(self, coordinator: CoilCoordinator, coil: Coil) -> None:
49  """Initialize entity."""
50  super().__init__(coordinator, coil, ENTITY_ID_FORMAT)
51  if coil.min is None or coil.max is None:
52  (
53  self._attr_native_min_value_attr_native_min_value,
54  self._attr_native_max_value_attr_native_max_value,
55  ) = _get_numeric_limits(coil.size)
56  self._attr_native_min_value_attr_native_min_value /= coil.factor
57  self._attr_native_max_value_attr_native_max_value /= coil.factor
58  else:
59  self._attr_native_min_value_attr_native_min_value = float(coil.min)
60  self._attr_native_max_value_attr_native_max_value = float(coil.max)
61 
62  self._attr_native_step_attr_native_step = 1 / coil.factor
63  self._attr_native_unit_of_measurement_attr_native_unit_of_measurement = coil.unit
64 
65  def _async_read_coil(self, data: CoilData) -> None:
66  if data.value is None:
67  self._attr_native_value_attr_native_value = None
68  return
69 
70  try:
71  self._attr_native_value_attr_native_value = float(data.value) # type: ignore[arg-type]
72  except ValueError:
73  self._attr_native_value_attr_native_value = None
74 
75  async def async_set_native_value(self, value: float) -> None:
76  """Set new value."""
77  await self._async_write_coil_async_write_coil(value)
None async_set_native_value(self, float value)
Definition: number.py:75
None __init__(self, CoilCoordinator coordinator, Coil coil)
Definition: number.py:48
None _async_read_coil(self, CoilData data)
Definition: number.py:65
None async_setup_entry(HomeAssistant hass, ConfigEntry config_entry, AddEntitiesCallback async_add_entities)
Definition: number.py:22