A module that is online but cut off from the control box keeps serving and publishing a full document of blank and default values. Read literally that is an idle spa: no temperatures, salt level 0, lights and jets off, and controls that accept a value and snap back. - The spa counts as reporting only while telemetry is fresh (something arrived in the last five minutes) and carries control-box data. Otherwise every entity is unavailable, and the reason is logged once per change. - The entry still loads in that state, so entities return on their own when the spa reports again. - A watchdog catches silence between updates, and reloads the entry when the broker connection stays down for three minutes. The broker is the only control path and its credentials rotate; paho reconnects with the old ones, so only a fresh sign-in recovers it. - Version 0.2.0. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
87 lines
2.9 KiB
Python
87 lines
2.9 KiB
Python
"""Climate entity: the spa's water heater setpoint + current temperature."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from homeassistant.components.climate import (
|
|
ClimateEntity,
|
|
ClimateEntityFeature,
|
|
HVACMode,
|
|
)
|
|
from homeassistant.const import ATTR_TEMPERATURE, UnitOfTemperature
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.helpers.device_registry import DeviceInfo
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from . import HotSpringConfigEntry
|
|
from .constants import DOMAIN, MANUFACTURER
|
|
from .coordinator import HotSpringCoordinator
|
|
from .entity import HotSpringEntity
|
|
|
|
# Hot Spot spas run 80-104 F.
|
|
MIN_TEMP_F = 80
|
|
MAX_TEMP_F = 104
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
entry: HotSpringConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
async_add_entities([HotSpringClimate(entry.runtime_data)])
|
|
|
|
|
|
class HotSpringClimate(HotSpringEntity, ClimateEntity):
|
|
_attr_has_entity_name = True
|
|
_attr_name = None # use the device name
|
|
_attr_hvac_modes = [HVACMode.HEAT]
|
|
_attr_hvac_mode = HVACMode.HEAT
|
|
_attr_supported_features = ClimateEntityFeature.TARGET_TEMPERATURE
|
|
_attr_target_temperature_step = 1
|
|
_enable_turn_on_off_backwards_compatibility = False
|
|
|
|
def __init__(self, coordinator: HotSpringCoordinator) -> None:
|
|
super().__init__(coordinator)
|
|
root = coordinator.spa_info.root_topic if coordinator.spa_info else "spa"
|
|
self._attr_unique_id = f"{root}_climate"
|
|
self._attr_device_info = DeviceInfo(
|
|
identifiers={(DOMAIN, root)},
|
|
manufacturer=MANUFACTURER,
|
|
name=coordinator.spa_info.name if coordinator.spa_info else "Hot Spring Spa",
|
|
model="Connected Spa",
|
|
)
|
|
|
|
@property
|
|
def _celsius(self) -> bool:
|
|
return (self.coordinator.spa and self.coordinator.spa.temperature_unit()) == "DegC"
|
|
|
|
@property
|
|
def temperature_unit(self) -> str:
|
|
return UnitOfTemperature.CELSIUS if self._celsius else UnitOfTemperature.FAHRENHEIT
|
|
|
|
@property
|
|
def min_temp(self) -> float:
|
|
return MIN_TEMP_F if not self._celsius else round((MIN_TEMP_F - 32) / 1.8)
|
|
|
|
@property
|
|
def max_temp(self) -> float:
|
|
return MAX_TEMP_F if not self._celsius else round((MAX_TEMP_F - 32) / 1.8)
|
|
|
|
@property
|
|
def current_temperature(self) -> float | None:
|
|
return self.coordinator.spa.current_temperature() if self.coordinator.spa else None
|
|
|
|
@property
|
|
def target_temperature(self) -> float | None:
|
|
return self.coordinator.spa.setpoint() if self.coordinator.spa else None
|
|
|
|
async def async_set_temperature(self, **kwargs) -> None:
|
|
temp = kwargs.get(ATTR_TEMPERATURE)
|
|
if temp is None:
|
|
return
|
|
# The spa expects an integer in its configured unit.
|
|
await self.coordinator.async_set_temperature(int(round(temp)))
|
|
|
|
@callback
|
|
def _handle_coordinator_update(self) -> None:
|
|
self.async_write_ha_state()
|