"""Support for AVM FRITZ!SmartHome thermostat devices.""" from __future__ import annotations from typing import Any from homeassistant.components.climate import ( ATTR_HVAC_MODE, PRESET_COMFORT, PRESET_ECO, ClimateEntity, ClimateEntityFeature, HVACMode, ) from homeassistant.config_entries import ConfigEntry from homeassistant.const import ( ATTR_BATTERY_LEVEL, ATTR_TEMPERATURE, PRECISION_HALVES, UnitOfTemperature, ) from homeassistant.core import HomeAssistant from homeassistant.helpers.entity_platform import AddEntitiesCallback from . import FritzboxDataUpdateCoordinator, FritzBoxDeviceEntity from .const import ( ATTR_STATE_BATTERY_LOW, ATTR_STATE_HOLIDAY_MODE, ATTR_STATE_SUMMER_MODE, ATTR_STATE_WINDOW_OPEN, CONF_COORDINATOR, DOMAIN as FRITZBOX_DOMAIN, ) from .model import ClimateExtraAttributes OPERATION_LIST = [HVACMode.HEAT, HVACMode.OFF] MIN_TEMPERATURE = 8 MAX_TEMPERATURE = 28 PRESET_MANUAL = "manual" # special temperatures for on/off in Fritz!Box API (modified by pyfritzhome) ON_API_TEMPERATURE = 127.0 OFF_API_TEMPERATURE = 126.5 ON_REPORT_SET_TEMPERATURE = 30.0 OFF_REPORT_SET_TEMPERATURE = 0.0 async def async_setup_entry( hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback ) -> None: """Set up the FRITZ!SmartHome thermostat from ConfigEntry.""" coordinator: FritzboxDataUpdateCoordinator = hass.data[FRITZBOX_DOMAIN][ entry.entry_id ][CONF_COORDINATOR] async_add_entities( [ FritzboxThermostat(coordinator, ain) for ain, device in coordinator.data.devices.items() if device.has_thermostat ] ) class FritzboxThermostat(FritzBoxDeviceEntity, ClimateEntity): """The thermostat class for FRITZ!SmartHome thermostats.""" _attr_precision = PRECISION_HALVES _attr_supported_features = ( ClimateEntityFeature.TARGET_TEMPERATURE | ClimateEntityFeature.PRESET_MODE ) _attr_temperature_unit = UnitOfTemperature.CELSIUS @property def current_temperature(self) -> float: """Return the current temperature.""" if self.data.has_temperature_sensor and self.data.temperature is not None: return self.data.temperature # type: ignore [no-any-return] return self.data.actual_temperature # type: ignore [no-any-return] @property def target_temperature(self) -> float: """Return the temperature we try to reach.""" if self.data.target_temperature == ON_API_TEMPERATURE: return ON_REPORT_SET_TEMPERATURE if self.data.target_temperature == OFF_API_TEMPERATURE: return OFF_REPORT_SET_TEMPERATURE return self.data.target_temperature # type: ignore [no-any-return] async def async_set_temperature(self, **kwargs: Any) -> None: """Set new target temperature.""" if kwargs.get(ATTR_HVAC_MODE) is not None: hvac_mode = kwargs[ATTR_HVAC_MODE] await self.async_set_hvac_mode(hvac_mode) elif kwargs.get(ATTR_TEMPERATURE) is not None: temperature = kwargs[ATTR_TEMPERATURE] await self.hass.async_add_executor_job( self.data.set_target_temperature, temperature ) await self.coordinator.async_refresh() @property def hvac_mode(self) -> str: """Return the current operation mode.""" if self.data.target_temperature in ( OFF_REPORT_SET_TEMPERATURE, OFF_API_TEMPERATURE, ): return HVACMode.OFF return HVACMode.HEAT @property def hvac_modes(self) -> list[HVACMode]: """Return the list of available operation modes.""" return OPERATION_LIST async def async_set_hvac_mode(self, hvac_mode: HVACMode) -> None: """Set new operation mode.""" if hvac_mode == HVACMode.OFF: await self.async_set_temperature(temperature=OFF_REPORT_SET_TEMPERATURE) else: await self.async_set_temperature(temperature=self.data.comfort_temperature) @property def preset_mode(self) -> str | None: """Return current preset mode.""" if self.data.target_temperature == self.data.comfort_temperature: return PRESET_COMFORT if self.data.target_temperature == self.data.eco_temperature: return PRESET_ECO return None @property def preset_modes(self) -> list[str]: """Return supported preset modes.""" return [PRESET_ECO, PRESET_COMFORT] async def async_set_preset_mode(self, preset_mode: str) -> None: """Set preset mode.""" if preset_mode == PRESET_COMFORT: await self.async_set_temperature(temperature=self.data.comfort_temperature) elif preset_mode == PRESET_ECO: await self.async_set_temperature(temperature=self.data.eco_temperature) @property def min_temp(self) -> int: """Return the minimum temperature.""" return MIN_TEMPERATURE @property def max_temp(self) -> int: """Return the maximum temperature.""" return MAX_TEMPERATURE @property def extra_state_attributes(self) -> ClimateExtraAttributes: """Return the device specific state attributes.""" attrs: ClimateExtraAttributes = { ATTR_STATE_BATTERY_LOW: self.data.battery_low, } # the following attributes are available since fritzos 7 if self.data.battery_level is not None: attrs[ATTR_BATTERY_LEVEL] = self.data.battery_level if self.data.holiday_active is not None: attrs[ATTR_STATE_HOLIDAY_MODE] = self.data.holiday_active if self.data.summer_active is not None: attrs[ATTR_STATE_SUMMER_MODE] = self.data.summer_active if self.data.window_open is not None: attrs[ATTR_STATE_WINDOW_OPEN] = self.data.window_open return attrs