"""Support for Honeywell (US) Total Connect Comfort climate systems.""" from __future__ import annotations import datetime from typing import Any import somecomfort import voluptuous as vol from homeassistant.components.climate import PLATFORM_SCHEMA, ClimateEntity from homeassistant.components.climate.const import ( ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW, CURRENT_HVAC_COOL, CURRENT_HVAC_FAN, CURRENT_HVAC_HEAT, CURRENT_HVAC_IDLE, FAN_AUTO, FAN_DIFFUSE, FAN_ON, HVAC_MODE_COOL, HVAC_MODE_HEAT, HVAC_MODE_HEAT_COOL, HVAC_MODE_OFF, PRESET_AWAY, PRESET_NONE, SUPPORT_AUX_HEAT, SUPPORT_FAN_MODE, SUPPORT_PRESET_MODE, SUPPORT_TARGET_HUMIDITY, SUPPORT_TARGET_TEMPERATURE, SUPPORT_TARGET_TEMPERATURE_RANGE, ) from homeassistant.config_entries import SOURCE_IMPORT from homeassistant.const import ( ATTR_TEMPERATURE, CONF_PASSWORD, CONF_REGION, CONF_USERNAME, TEMP_CELSIUS, TEMP_FAHRENHEIT, ) import homeassistant.helpers.config_validation as cv import homeassistant.helpers.device_registry as dr from .const import ( _LOGGER, CONF_COOL_AWAY_TEMPERATURE, CONF_DEV_ID, CONF_HEAT_AWAY_TEMPERATURE, CONF_LOC_ID, DEFAULT_COOL_AWAY_TEMPERATURE, DEFAULT_HEAT_AWAY_TEMPERATURE, DOMAIN, ) ATTR_FAN_ACTION = "fan_action" ATTR_PERMANENT_HOLD = "permanent_hold" PLATFORM_SCHEMA = vol.All( cv.deprecated(CONF_REGION), PLATFORM_SCHEMA.extend( { vol.Required(CONF_USERNAME): cv.string, vol.Required(CONF_PASSWORD): cv.string, vol.Optional( CONF_COOL_AWAY_TEMPERATURE, default=DEFAULT_COOL_AWAY_TEMPERATURE ): vol.Coerce(int), vol.Optional( CONF_HEAT_AWAY_TEMPERATURE, default=DEFAULT_HEAT_AWAY_TEMPERATURE ): vol.Coerce(int), vol.Optional(CONF_REGION): cv.string, vol.Optional(CONF_DEV_ID): cv.string, vol.Optional(CONF_LOC_ID): cv.string, } ), ) HVAC_MODE_TO_HW_MODE = { "SwitchOffAllowed": {HVAC_MODE_OFF: "off"}, "SwitchAutoAllowed": {HVAC_MODE_HEAT_COOL: "auto"}, "SwitchCoolAllowed": {HVAC_MODE_COOL: "cool"}, "SwitchHeatAllowed": {HVAC_MODE_HEAT: "heat"}, } HW_MODE_TO_HVAC_MODE = { "off": HVAC_MODE_OFF, "emheat": HVAC_MODE_HEAT, "heat": HVAC_MODE_HEAT, "cool": HVAC_MODE_COOL, "auto": HVAC_MODE_HEAT_COOL, } HW_MODE_TO_HA_HVAC_ACTION = { "off": CURRENT_HVAC_IDLE, "fan": CURRENT_HVAC_FAN, "heat": CURRENT_HVAC_HEAT, "cool": CURRENT_HVAC_COOL, } FAN_MODE_TO_HW = { "fanModeOnAllowed": {FAN_ON: "on"}, "fanModeAutoAllowed": {FAN_AUTO: "auto"}, "fanModeCirculateAllowed": {FAN_DIFFUSE: "circulate"}, } HW_FAN_MODE_TO_HA = { "on": FAN_ON, "auto": FAN_AUTO, "circulate": FAN_DIFFUSE, "follow schedule": FAN_AUTO, } async def async_setup_entry(hass, config, async_add_entities, discovery_info=None): """Set up the Honeywell thermostat.""" cool_away_temp = config.data.get(CONF_COOL_AWAY_TEMPERATURE) heat_away_temp = config.data.get(CONF_HEAT_AWAY_TEMPERATURE) data = hass.data[DOMAIN][config.entry_id] async_add_entities([HoneywellUSThermostat(data, cool_away_temp, heat_away_temp)]) async def async_setup_platform(hass, config, add_entities, discovery_info=None): """Set up the Honeywell climate platform. Honeywell uses config flow for configuration now. If an entry exists in configuration.yaml, the import flow will attempt to import it and create a config entry. """ if config["platform"] == "honeywell": _LOGGER.warning( "Loading honeywell via platform config is deprecated; The configuration" " has been migrated to a config entry and can be safely removed" ) # No config entry exists and configuration.yaml config exists, trigger the import flow. if not hass.config_entries.async_entries(DOMAIN): await hass.config_entries.flow.async_init( DOMAIN, context={"source": SOURCE_IMPORT}, data=config ) class HoneywellUSThermostat(ClimateEntity): """Representation of a Honeywell US Thermostat.""" def __init__(self, data, cool_away_temp, heat_away_temp): """Initialize the thermostat.""" self._data = data self._cool_away_temp = cool_away_temp self._heat_away_temp = heat_away_temp self._away = False self._attr_unique_id = dr.format_mac(data.device.mac_address) self._attr_name = data.device.name self._attr_temperature_unit = ( TEMP_CELSIUS if data.device.temperature_unit == "C" else TEMP_FAHRENHEIT ) self._attr_preset_modes = [PRESET_NONE, PRESET_AWAY] self._attr_is_aux_heat = data.device.system_mode == "emheat" # not all honeywell HVACs support all modes mappings = [ v for k, v in HVAC_MODE_TO_HW_MODE.items() if data.device.raw_ui_data[k] ] self._hvac_mode_map = {k: v for d in mappings for k, v in d.items()} self._attr_hvac_modes = list(self._hvac_mode_map) self._attr_supported_features = ( SUPPORT_PRESET_MODE | SUPPORT_TARGET_TEMPERATURE | SUPPORT_TARGET_TEMPERATURE_RANGE ) if data.device._data["canControlHumidification"]: self._attr_supported_features |= SUPPORT_TARGET_HUMIDITY if data.device.raw_ui_data["SwitchEmergencyHeatAllowed"]: self._attr_supported_features |= SUPPORT_AUX_HEAT if not data.device._data["hasFan"]: return # not all honeywell fans support all modes mappings = [v for k, v in FAN_MODE_TO_HW.items() if data.device.raw_fan_data[k]] self._fan_mode_map = {k: v for d in mappings for k, v in d.items()} self._attr_fan_modes = list(self._fan_mode_map) self._attr_supported_features |= SUPPORT_FAN_MODE @property def _device(self): """Shortcut to access the device.""" return self._data.device @property def extra_state_attributes(self) -> dict[str, Any]: """Return the device specific state attributes.""" data = {} data[ATTR_FAN_ACTION] = "running" if self._device.fan_running else "idle" data[ATTR_PERMANENT_HOLD] = self._is_permanent_hold() if self._device.raw_dr_data: data["dr_phase"] = self._device.raw_dr_data.get("Phase") return data @property def min_temp(self) -> float: """Return the minimum temperature.""" if self.hvac_mode in [HVAC_MODE_COOL, HVAC_MODE_HEAT_COOL]: return self._device.raw_ui_data["CoolLowerSetptLimit"] if self.hvac_mode == HVAC_MODE_HEAT: return self._device.raw_ui_data["HeatLowerSetptLimit"] return None @property def max_temp(self) -> float: """Return the maximum temperature.""" if self.hvac_mode == HVAC_MODE_COOL: return self._device.raw_ui_data["CoolUpperSetptLimit"] if self.hvac_mode in [HVAC_MODE_HEAT, HVAC_MODE_HEAT_COOL]: return self._device.raw_ui_data["HeatUpperSetptLimit"] return None @property def current_humidity(self) -> int | None: """Return the current humidity.""" return self._device.current_humidity @property def hvac_mode(self) -> str: """Return hvac operation ie. heat, cool mode.""" return HW_MODE_TO_HVAC_MODE[self._device.system_mode] @property def hvac_action(self) -> str | None: """Return the current running hvac operation if supported.""" if self.hvac_mode == HVAC_MODE_OFF: return None return HW_MODE_TO_HA_HVAC_ACTION[self._device.equipment_output_status] @property def current_temperature(self) -> float | None: """Return the current temperature.""" return self._device.current_temperature @property def target_temperature(self) -> float | None: """Return the temperature we try to reach.""" if self.hvac_mode == HVAC_MODE_COOL: return self._device.setpoint_cool if self.hvac_mode == HVAC_MODE_HEAT: return self._device.setpoint_heat return None @property def target_temperature_high(self) -> float | None: """Return the highbound target temperature we try to reach.""" if self.hvac_mode == HVAC_MODE_HEAT_COOL: return self._device.setpoint_cool return None @property def target_temperature_low(self) -> float | None: """Return the lowbound target temperature we try to reach.""" if self.hvac_mode == HVAC_MODE_HEAT_COOL: return self._device.setpoint_heat return None @property def preset_mode(self) -> str | None: """Return the current preset mode, e.g., home, away, temp.""" return PRESET_AWAY if self._away else None @property def fan_mode(self) -> str | None: """Return the fan setting.""" return HW_FAN_MODE_TO_HA[self._device.fan_mode] def _is_permanent_hold(self) -> bool: heat_status = self._device.raw_ui_data.get("StatusHeat", 0) cool_status = self._device.raw_ui_data.get("StatusCool", 0) return heat_status == 2 or cool_status == 2 def _set_temperature(self, **kwargs) -> None: """Set new target temperature.""" temperature = kwargs.get(ATTR_TEMPERATURE) if temperature is None: return try: # Get current mode mode = self._device.system_mode # Set hold if this is not the case if getattr(self._device, f"hold_{mode}") is False: # Get next period key next_period_key = f"{mode.capitalize()}NextPeriod" # Get next period raw value next_period = self._device.raw_ui_data.get(next_period_key) # Get next period time hour, minute = divmod(next_period * 15, 60) # Set hold time setattr(self._device, f"hold_{mode}", datetime.time(hour, minute)) # Set temperature setattr(self._device, f"setpoint_{mode}", temperature) except somecomfort.SomeComfortError: _LOGGER.error("Temperature %.1f out of range", temperature) def set_temperature(self, **kwargs) -> None: """Set new target temperature.""" if {HVAC_MODE_COOL, HVAC_MODE_HEAT} & set(self._hvac_mode_map): self._set_temperature(**kwargs) try: if HVAC_MODE_HEAT_COOL in self._hvac_mode_map: temperature = kwargs.get(ATTR_TARGET_TEMP_HIGH) if temperature: self._device.setpoint_cool = temperature temperature = kwargs.get(ATTR_TARGET_TEMP_LOW) if temperature: self._device.setpoint_heat = temperature except somecomfort.SomeComfortError as err: _LOGGER.error("Invalid temperature %s: %s", temperature, err) def set_fan_mode(self, fan_mode: str) -> None: """Set new target fan mode.""" self._device.fan_mode = self._fan_mode_map[fan_mode] def set_hvac_mode(self, hvac_mode: str) -> None: """Set new target hvac mode.""" self._device.system_mode = self._hvac_mode_map[hvac_mode] def _turn_away_mode_on(self) -> None: """Turn away on. Somecomfort does have a proprietary away mode, but it doesn't really work the way it should. For example: If you set a temperature manually it doesn't get overwritten when away mode is switched on. """ self._away = True try: # Get current mode mode = self._device.system_mode except somecomfort.SomeComfortError: _LOGGER.error("Can not get system mode") return try: # Set permanent hold setattr(self._device, f"hold_{mode}", True) # Set temperature setattr( self._device, f"setpoint_{mode}", getattr(self, f"_{mode}_away_temp"), ) except somecomfort.SomeComfortError: _LOGGER.error( "Temperature %.1f out of range", getattr(self, f"_{mode}_away_temp") ) def _turn_away_mode_off(self) -> None: """Turn away off.""" self._away = False try: # Disabling all hold modes self._device.hold_cool = False self._device.hold_heat = False except somecomfort.SomeComfortError: _LOGGER.error("Can not stop hold mode") def set_preset_mode(self, preset_mode: str) -> None: """Set new preset mode.""" if preset_mode == PRESET_AWAY: self._turn_away_mode_on() else: self._turn_away_mode_off() def turn_aux_heat_on(self) -> None: """Turn auxiliary heater on.""" self._device.system_mode = "emheat" def turn_aux_heat_off(self) -> None: """Turn auxiliary heater off.""" if HVAC_MODE_HEAT in self.hvac_modes: self.set_hvac_mode(HVAC_MODE_HEAT) else: self.set_hvac_mode(HVAC_MODE_OFF) async def async_update(self): """Get the latest state from the service.""" await self._data.update()