Files
fgl-aircon/custom_components/fglair/entity.py
T
petr.polezhaev d1c02d7c4b ha(ux): мастер из трёх страниц, feature-модель и capabilities-фильтрация
- config flow: template (A/B/F с пояснениями, значения с устройства,
  определение по oem_model; для неизвестных моделей — пробинг A/B/F тремя
  короткими сессиями) -> capabilities (23 тумблера с описаниями, дефолты
  из device_capabilities/num_dir/ответов) -> limits (диапазон/шаг, ручная
  конверсия); каждая страница с пометкой «значения определены
  автоматически, можно пропустить»
- features.py: FeatureSet/LiveValues/device_default/resolve_features;
  entry.data["features"] хранит выбор пользователя; reconfigure
  предзаполняет; YAML-import получает дефолты
- сущности создаются только для включённых фич: climate (режимы/скорости/
  swing/пресеты), switch, select заслонок (caps+num_dir), датчик комнаты;
  исправлено появление select без ламелей
- trial: caps/num_dir и presence-зонды (необязательные свойства), answered;
  координатор ждёт первые свойства перед созданием сущностей (feature-
  дефолты без гонки)
- атрибут description у сущностей (HA не поддерживает тултипы) + описания
  фич в мастере (en/ru)
- тесты: features, probing, обновлённые flow/entities/repairs; 57 components
2026-09-29 17:39:34 +03:00

78 lines
2.7 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,
entity_description,
)
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: Optional[str],
description_key: Optional[str] = None,
) -> None:
super().__init__(coordinator)
data = coordinator.client.data
dsn = data[CONF_DSN]
self._attr_unique_id = f"{dsn}_{unique_suffix}"
if translation_key is not None:
self._attr_translation_key = translation_key
self._description_key = description_key or 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
@property
def extra_state_attributes(self) -> Optional[dict]:
"""HA не поддерживает тултипы сущностей: краткое описание видно в
атрибутах (More info → Атрибуты)."""
if self._description_key is None:
return None
text = entity_description(self.hass.config.language, self._description_key)
return {"description": text} if text else None
def feature_enabled(self, key: str) -> bool:
return self.coordinator.features.enabled(key)
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)