138 lines
4.2 KiB
Python
138 lines
4.2 KiB
Python
"""The nexia integration base entity."""
|
|
|
|
from typing import TYPE_CHECKING
|
|
|
|
from nexia.thermostat import NexiaThermostat
|
|
from nexia.zone import NexiaThermostatZone
|
|
|
|
from homeassistant.const import (
|
|
ATTR_IDENTIFIERS,
|
|
ATTR_NAME,
|
|
ATTR_SUGGESTED_AREA,
|
|
ATTR_VIA_DEVICE,
|
|
)
|
|
from homeassistant.helpers.device_registry import DeviceInfo
|
|
from homeassistant.helpers.dispatcher import (
|
|
async_dispatcher_connect,
|
|
async_dispatcher_send,
|
|
)
|
|
from homeassistant.helpers.update_coordinator import CoordinatorEntity
|
|
|
|
from .const import (
|
|
ATTRIBUTION,
|
|
DOMAIN,
|
|
MANUFACTURER,
|
|
SIGNAL_THERMOSTAT_UPDATE,
|
|
SIGNAL_ZONE_UPDATE,
|
|
)
|
|
from .coordinator import NexiaDataUpdateCoordinator
|
|
|
|
|
|
class NexiaEntity(CoordinatorEntity[NexiaDataUpdateCoordinator]):
|
|
"""Base class for nexia entities."""
|
|
|
|
_attr_attribution = ATTRIBUTION
|
|
|
|
def __init__(self, coordinator: NexiaDataUpdateCoordinator, unique_id: str) -> None:
|
|
"""Initialize the entity."""
|
|
super().__init__(coordinator)
|
|
self._attr_unique_id = unique_id
|
|
|
|
|
|
class NexiaThermostatEntity(NexiaEntity):
|
|
"""Base class for nexia devices attached to a thermostat."""
|
|
|
|
_attr_has_entity_name = True
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: NexiaDataUpdateCoordinator,
|
|
thermostat: NexiaThermostat,
|
|
unique_id: str,
|
|
) -> None:
|
|
"""Initialize the entity."""
|
|
super().__init__(coordinator, unique_id)
|
|
self._thermostat = thermostat
|
|
thermostat_id = thermostat.thermostat_id
|
|
self._attr_device_info = DeviceInfo(
|
|
configuration_url=self.coordinator.nexia_home.root_url,
|
|
identifiers={(DOMAIN, thermostat_id)},
|
|
manufacturer=MANUFACTURER,
|
|
model=thermostat.get_model(),
|
|
name=thermostat.get_name(),
|
|
sw_version=thermostat.get_firmware(),
|
|
)
|
|
self._thermostat_signal = f"{SIGNAL_THERMOSTAT_UPDATE}-{thermostat_id}"
|
|
|
|
async def async_added_to_hass(self) -> None:
|
|
"""Listen for signals for services."""
|
|
await super().async_added_to_hass()
|
|
self.async_on_remove(
|
|
async_dispatcher_connect(
|
|
self.hass,
|
|
self._thermostat_signal,
|
|
self.async_write_ha_state,
|
|
)
|
|
)
|
|
|
|
def _signal_thermostat_update(self) -> None:
|
|
"""Signal a thermostat update.
|
|
|
|
Whenever the underlying library does an action against
|
|
a thermostat, the data for the thermostat and all
|
|
connected zone is updated.
|
|
|
|
Update all the zones on the thermostat.
|
|
"""
|
|
async_dispatcher_send(self.hass, self._thermostat_signal)
|
|
|
|
@property
|
|
def available(self) -> bool:
|
|
"""Return True if thermostat is available and data is available."""
|
|
return super().available and self._thermostat.is_online
|
|
|
|
|
|
class NexiaThermostatZoneEntity(NexiaThermostatEntity):
|
|
"""Base class for nexia devices attached to a thermostat."""
|
|
|
|
def __init__(
|
|
self,
|
|
coordinator: NexiaDataUpdateCoordinator,
|
|
zone: NexiaThermostatZone,
|
|
unique_id: str,
|
|
) -> None:
|
|
"""Initialize the entity."""
|
|
super().__init__(coordinator, zone.thermostat, unique_id)
|
|
self._zone = zone
|
|
zone_name = self._zone.get_name()
|
|
if TYPE_CHECKING:
|
|
assert self._attr_device_info is not None
|
|
self._attr_device_info |= {
|
|
ATTR_IDENTIFIERS: {(DOMAIN, zone.zone_id)},
|
|
ATTR_NAME: zone_name,
|
|
ATTR_SUGGESTED_AREA: zone_name,
|
|
ATTR_VIA_DEVICE: (DOMAIN, zone.thermostat.thermostat_id),
|
|
}
|
|
self._zone_signal = f"{SIGNAL_ZONE_UPDATE}-{zone.zone_id}"
|
|
|
|
async def async_added_to_hass(self) -> None:
|
|
"""Listen for signals for services."""
|
|
await super().async_added_to_hass()
|
|
self.async_on_remove(
|
|
async_dispatcher_connect(
|
|
self.hass,
|
|
self._zone_signal,
|
|
self.async_write_ha_state,
|
|
)
|
|
)
|
|
|
|
def _signal_zone_update(self) -> None:
|
|
"""Signal a zone update.
|
|
|
|
Whenever the underlying library does an action against
|
|
a zone, the data for the zone is updated.
|
|
|
|
Update a single zone.
|
|
"""
|
|
async_dispatcher_send(self.hass, self._zone_signal)
|