- 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 отложен (семантика не зафиксирована)
71 lines
2.5 KiB
Python
71 lines
2.5 KiB
Python
"""Базовая сущность 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
|