"""Support for deCONZ climate devices.""" from __future__ import annotations from typing import Any from pydeconz.models.event import EventType from pydeconz.models.sensor.thermostat import ( Thermostat, ThermostatFanMode, ThermostatMode, ThermostatPreset, ) from homeassistant.components.climate import ( DOMAIN, FAN_AUTO, FAN_HIGH, FAN_LOW, FAN_MEDIUM, FAN_OFF, FAN_ON, PRESET_BOOST, PRESET_COMFORT, PRESET_ECO, ClimateEntity, ClimateEntityFeature, HVACAction, HVACMode, ) from homeassistant.config_entries import ConfigEntry from homeassistant.const import ATTR_TEMPERATURE, UnitOfTemperature from homeassistant.core import HomeAssistant, callback from homeassistant.helpers.entity_platform import AddEntitiesCallback from .const import ATTR_LOCKED, ATTR_OFFSET, ATTR_VALVE from .deconz_device import DeconzDevice from .gateway import DeconzGateway, get_gateway_from_config_entry DECONZ_FAN_SMART = "smart" FAN_MODE_TO_DECONZ = { DECONZ_FAN_SMART: ThermostatFanMode.SMART, FAN_AUTO: ThermostatFanMode.AUTO, FAN_HIGH: ThermostatFanMode.HIGH, FAN_MEDIUM: ThermostatFanMode.MEDIUM, FAN_LOW: ThermostatFanMode.LOW, FAN_ON: ThermostatFanMode.ON, FAN_OFF: ThermostatFanMode.OFF, } DECONZ_TO_FAN_MODE = {value: key for key, value in FAN_MODE_TO_DECONZ.items()} HVAC_MODE_TO_DECONZ = { HVACMode.AUTO: ThermostatMode.AUTO, HVACMode.COOL: ThermostatMode.COOL, HVACMode.HEAT: ThermostatMode.HEAT, HVACMode.OFF: ThermostatMode.OFF, } DECONZ_PRESET_AUTO = "auto" DECONZ_PRESET_COMPLEX = "complex" DECONZ_PRESET_HOLIDAY = "holiday" DECONZ_PRESET_MANUAL = "manual" PRESET_MODE_TO_DECONZ = { DECONZ_PRESET_AUTO: ThermostatPreset.AUTO, PRESET_BOOST: ThermostatPreset.BOOST, PRESET_COMFORT: ThermostatPreset.COMFORT, DECONZ_PRESET_COMPLEX: ThermostatPreset.COMPLEX, PRESET_ECO: ThermostatPreset.ECO, DECONZ_PRESET_HOLIDAY: ThermostatPreset.HOLIDAY, DECONZ_PRESET_MANUAL: ThermostatPreset.MANUAL, } DECONZ_TO_PRESET_MODE = {value: key for key, value in PRESET_MODE_TO_DECONZ.items()} async def async_setup_entry( hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback, ) -> None: """Set up the deCONZ climate devices.""" gateway = get_gateway_from_config_entry(hass, config_entry) gateway.entities[DOMAIN] = set() @callback def async_add_climate(_: EventType, climate_id: str) -> None: """Add climate from deCONZ.""" climate = gateway.api.sensors.thermostat[climate_id] async_add_entities([DeconzThermostat(climate, gateway)]) gateway.register_platform_add_device_callback( async_add_climate, gateway.api.sensors.thermostat, ) class DeconzThermostat(DeconzDevice[Thermostat], ClimateEntity): """Representation of a deCONZ thermostat.""" TYPE = DOMAIN _attr_temperature_unit = UnitOfTemperature.CELSIUS def __init__(self, device: Thermostat, gateway: DeconzGateway) -> None: """Set up thermostat device.""" super().__init__(device, gateway) self._attr_hvac_modes = [ HVACMode.HEAT, HVACMode.OFF, ] if device.mode: self._attr_hvac_modes.append(HVACMode.AUTO) if "coolsetpoint" in device.raw["config"]: self._attr_hvac_modes.append(HVACMode.COOL) self._deconz_to_hvac_mode = { HVAC_MODE_TO_DECONZ[item]: item for item in self._attr_hvac_modes } self._attr_supported_features = ClimateEntityFeature.TARGET_TEMPERATURE if device.fan_mode: self._attr_supported_features |= ClimateEntityFeature.FAN_MODE self._attr_fan_modes = list(FAN_MODE_TO_DECONZ) if device.preset: self._attr_supported_features |= ClimateEntityFeature.PRESET_MODE self._attr_preset_modes = list(PRESET_MODE_TO_DECONZ) # Fan control @property def fan_mode(self) -> str: """Return fan operation.""" if self._device.fan_mode in DECONZ_TO_FAN_MODE: return DECONZ_TO_FAN_MODE[self._device.fan_mode] return FAN_ON if self._device.state_on else FAN_OFF async def async_set_fan_mode(self, fan_mode: str) -> None: """Set new target fan mode.""" if fan_mode not in FAN_MODE_TO_DECONZ: raise ValueError(f"Unsupported fan mode {fan_mode}") await self.gateway.api.sensors.thermostat.set_config( id=self._device.resource_id, fan_mode=FAN_MODE_TO_DECONZ[fan_mode], ) # HVAC control @property def hvac_mode(self) -> HVACMode: """Return hvac operation ie. heat, cool mode.""" if self._device.mode in self._deconz_to_hvac_mode: return self._deconz_to_hvac_mode[self._device.mode] return HVACMode.HEAT if self._device.state_on else HVACMode.OFF async def async_set_hvac_mode(self, hvac_mode: HVACMode) -> None: """Set new target hvac mode.""" if hvac_mode not in self._attr_hvac_modes: raise ValueError(f"Unsupported HVAC mode {hvac_mode}") if len(self._attr_hvac_modes) == 2: # Only allow turn on and off thermostat await self.gateway.api.sensors.thermostat.set_config( id=self._device.resource_id, on=hvac_mode != HVACMode.OFF, ) else: await self.gateway.api.sensors.thermostat.set_config( id=self._device.resource_id, mode=HVAC_MODE_TO_DECONZ[hvac_mode], ) @property def hvac_action(self) -> HVACAction: """Return current hvac operation ie. heat, cool. Preset 'BOOST' is interpreted as 'state_on'. """ if self._device.mode == ThermostatMode.OFF: return HVACAction.OFF if self._device.state_on or self._device.preset == ThermostatPreset.BOOST: if self._device.mode == ThermostatMode.COOL: return HVACAction.COOLING return HVACAction.HEATING return HVACAction.IDLE # Preset control @property def preset_mode(self) -> str | None: """Return preset mode.""" if self._device.preset in DECONZ_TO_PRESET_MODE: return DECONZ_TO_PRESET_MODE[self._device.preset] return None async def async_set_preset_mode(self, preset_mode: str) -> None: """Set new preset mode.""" if preset_mode not in PRESET_MODE_TO_DECONZ: raise ValueError(f"Unsupported preset mode {preset_mode}") await self.gateway.api.sensors.thermostat.set_config( id=self._device.resource_id, preset=PRESET_MODE_TO_DECONZ[preset_mode], ) # Temperature control @property def current_temperature(self) -> float: """Return the current temperature.""" return self._device.scaled_temperature @property def target_temperature(self) -> float | None: """Return the target temperature.""" if self._device.mode == ThermostatMode.COOL and self._device.cooling_setpoint: return self._device.scaled_cooling_setpoint if self._device.heating_setpoint: return self._device.scaled_heating_setpoint return None async def async_set_temperature(self, **kwargs: Any) -> None: """Set new target temperature.""" if ATTR_TEMPERATURE not in kwargs: raise ValueError(f"Expected attribute {ATTR_TEMPERATURE}") if self._device.mode == ThermostatMode.COOL: await self.gateway.api.sensors.thermostat.set_config( id=self._device.resource_id, cooling_setpoint=kwargs[ATTR_TEMPERATURE] * 100, ) else: await self.gateway.api.sensors.thermostat.set_config( id=self._device.resource_id, heating_setpoint=kwargs[ATTR_TEMPERATURE] * 100, ) @property def extra_state_attributes(self) -> dict[str, bool | int]: """Return the state attributes of the thermostat.""" attr = {} if self._device.offset is not None: attr[ATTR_OFFSET] = self._device.offset if self._device.valve is not None: attr[ATTR_VALVE] = self._device.valve if self._device.locked is not None: attr[ATTR_LOCKED] = self._device.locked return attr