ha(H3): превью шаблона с конверсиями; climate и сущности

- config flow: шаг preview (шаблон A/B/F, диапазон/шаг уставки, линейные коэффициенты num/den/offset, текст-превью по данным trial: hvac/fan/ swing/capabilities/текущая температура) - coordinator: push-driven DataUpdateCoordinator (снимок кэша, доступность online/recovering, первичный GET-батч, один batch_commit на действие) - overrides.py: ConversionSet (ручные линейные конверсии и диапазон поверх таблиц ядра, применяются в HA) - entity.py: DeviceInfo/unique_id/доступность, capabilities-фильтры - climate: hvac/fan/swing/vertical+horizontal swing/preset ECO-BOOST, уставка 16-30 °C (шаг по шаблону), current_temperature - sensor: room_temperature, error_code, connection_state (диагностика) - binary_sensor: connectivity + флаги op_status (PROTOCOL §8.4) - switch: 8 флагов-свойств; select: положения заслонок 0..N-1 - тесты: превью/конверсии/ошибки диапазона, сущности против mock_ac (снимок, команды, capabilities-фильтр, ручная конверсия), ConversionSet - mock_ac: --set NAME=VALUE (0b/0x) для сценариев - план: demand_control отложен (семантика не зафиксирована)
2026-09-29 12:44:34 +03:00
parent 29f62b639c
commit 3e0b6b3653
21 changed files with 1974 additions and 87 deletions
@@ -0,0 +1,70 @@
+"""Базовая сущность fglair: DeviceInfo, значения из координатора."""
+from __future__ import annotations
+
+from typing import Optional
+
+from homeassistant.helpers.device_registry import DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity
+
+from pyfglair import Prop, Value
+
+from .const import CONF_DSN, CONF_MODEL, CONF_NAME, DOMAIN
+from .coordinator import FglairCoordinator
+
+
+class FglairEntity(CoordinatorEntity[FglairCoordinator]):
+    """Общий базис: unique_id = <dsn>_<key>, device_info — один прибор."""
+
+    _attr_has_entity_name = True
+
+    def __init__(
+        self,
+        coordinator: FglairCoordinator,
+        unique_suffix: str,
+        translation_key: str,
+    ) -> None:
+        super().__init__(coordinator)
+        data = coordinator.client.data
+        dsn = data[CONF_DSN]
+        self._attr_unique_id = f"{dsn}_{unique_suffix}"
+        self._attr_translation_key = translation_key
+        self._attr_device_info = DeviceInfo(
+            identifiers={(DOMAIN, dsn)},
+            name=data.get(CONF_NAME) or dsn,
+            manufacturer="Fujitsu General",
+            model=data.get(CONF_MODEL) or None,
+        )
+
+    @property
+    def available(self) -> bool:
+        return self.coordinator.data.available and super().available
+
+    def value(self, prop: Prop) -> Optional[Value]:
+        return self.coordinator.data.values.get(prop)
+
+    def raw_value(self, prop: Prop) -> Optional[int]:
+        value = self.value(prop)
+        return value.int_value if value is not None else None
+
+    def display_value(self, prop: Prop) -> Optional[int]:
+        """Значение свойства в единицах отображения (с ручной конверсией)."""
+        raw = self.raw_value(prop)
+        if raw is None:
+            return None
+        return self.coordinator.conversions.to_display(prop, raw)
+
+    def capabilities(self) -> Optional[int]:
+        return self.raw_value(Prop.DEVICE_CAPABILITIES)
+
+    def capability(self, bit: int) -> Optional[bool]:
+        caps = self.capabilities()
+        if caps is None:
+            return None
+        return bool(caps & (1 << bit))
+
+    def supports_capability(self, bit: Optional[int]) -> bool:
+        """None — считать поддержанным (capabilities ещё не пришли)."""
+        if bit is None:
+            return True
+        cap = self.capability(bit)
+        return True if cap is None else cap