"""Support for NuHeat thermostats.""" from datetime import timedelta import logging from nuheat.config import SCHEDULE_HOLD, SCHEDULE_RUN, SCHEDULE_TEMPORARY_HOLD from nuheat.util import ( celsius_to_nuheat, fahrenheit_to_nuheat, nuheat_to_celsius, nuheat_to_fahrenheit, ) from homeassistant.components.climate import ClimateDevice from homeassistant.components.climate.const import ( ATTR_HVAC_MODE, CURRENT_HVAC_HEAT, CURRENT_HVAC_IDLE, HVAC_MODE_AUTO, HVAC_MODE_HEAT, SUPPORT_PRESET_MODE, SUPPORT_TARGET_TEMPERATURE, ) from homeassistant.const import ATTR_TEMPERATURE, TEMP_CELSIUS, TEMP_FAHRENHEIT from homeassistant.helpers import event as event_helper from homeassistant.util import Throttle from .const import DOMAIN, MANUFACTURER, NUHEAT_API_STATE_SHIFT_DELAY _LOGGER = logging.getLogger(__name__) MIN_TIME_BETWEEN_UPDATES = timedelta(minutes=5) # The device does not have an off function. # To turn it off set to min_temp and PRESET_PERMANENT_HOLD OPERATION_LIST = [HVAC_MODE_AUTO, HVAC_MODE_HEAT] PRESET_RUN = "Run Schedule" PRESET_TEMPORARY_HOLD = "Temporary Hold" PRESET_PERMANENT_HOLD = "Permanent Hold" PRESET_MODES = [PRESET_RUN, PRESET_TEMPORARY_HOLD, PRESET_PERMANENT_HOLD] PRESET_MODE_TO_SCHEDULE_MODE_MAP = { PRESET_RUN: SCHEDULE_RUN, PRESET_TEMPORARY_HOLD: SCHEDULE_TEMPORARY_HOLD, PRESET_PERMANENT_HOLD: SCHEDULE_HOLD, } SCHEDULE_MODE_TO_PRESET_MODE_MAP = { value: key for key, value in PRESET_MODE_TO_SCHEDULE_MODE_MAP.items() } SUPPORT_FLAGS = SUPPORT_TARGET_TEMPERATURE | SUPPORT_PRESET_MODE async def async_setup_entry(hass, config_entry, async_add_entities): """Set up the NuHeat thermostat(s).""" api, serial_number = hass.data[DOMAIN][config_entry.entry_id] temperature_unit = hass.config.units.temperature_unit thermostat = await hass.async_add_executor_job(api.get_thermostat, serial_number) entity = NuHeatThermostat(thermostat, temperature_unit) # No longer need a service as set_hvac_mode to auto does this # since climate 1.0 has been implemented async_add_entities([entity], True) class NuHeatThermostat(ClimateDevice): """Representation of a NuHeat Thermostat.""" def __init__(self, thermostat, temperature_unit): """Initialize the thermostat.""" self._thermostat = thermostat self._temperature_unit = temperature_unit self._schedule_mode = None self._target_temperature = None self._force_update = False @property def name(self): """Return the name of the thermostat.""" return self._thermostat.room @property def supported_features(self): """Return the list of supported features.""" return SUPPORT_FLAGS @property def temperature_unit(self): """Return the unit of measurement.""" if self._temperature_unit == "C": return TEMP_CELSIUS return TEMP_FAHRENHEIT @property def current_temperature(self): """Return the current temperature.""" if self._temperature_unit == "C": return self._thermostat.celsius return self._thermostat.fahrenheit @property def unique_id(self): """Return the unique id.""" return self._thermostat.serial_number @property def available(self): """Return the unique id.""" return self._thermostat.online def set_hvac_mode(self, hvac_mode): """Set the system mode.""" if hvac_mode == HVAC_MODE_AUTO: self._set_schedule_mode(SCHEDULE_RUN) elif hvac_mode == HVAC_MODE_HEAT: self._set_schedule_mode(SCHEDULE_HOLD) @property def hvac_mode(self): """Return current setting heat or auto.""" if self._schedule_mode in (SCHEDULE_TEMPORARY_HOLD, SCHEDULE_HOLD): return HVAC_MODE_HEAT return HVAC_MODE_AUTO @property def hvac_action(self): """Return current operation heat or idle.""" return CURRENT_HVAC_HEAT if self._thermostat.heating else CURRENT_HVAC_IDLE @property def min_temp(self): """Return the minimum supported temperature for the thermostat.""" if self._temperature_unit == "C": return self._thermostat.min_celsius return self._thermostat.min_fahrenheit @property def max_temp(self): """Return the maximum supported temperature for the thermostat.""" if self._temperature_unit == "C": return self._thermostat.max_celsius return self._thermostat.max_fahrenheit @property def target_temperature(self): """Return the currently programmed temperature.""" if self._temperature_unit == "C": return nuheat_to_celsius(self._target_temperature) return nuheat_to_fahrenheit(self._target_temperature) @property def preset_mode(self): """Return current preset mode.""" return SCHEDULE_MODE_TO_PRESET_MODE_MAP.get(self._schedule_mode, PRESET_RUN) @property def preset_modes(self): """Return available preset modes.""" return PRESET_MODES @property def hvac_modes(self): """Return list of possible operation modes.""" return OPERATION_LIST def set_preset_mode(self, preset_mode): """Update the hold mode of the thermostat.""" self._set_schedule_mode( PRESET_MODE_TO_SCHEDULE_MODE_MAP.get(preset_mode, SCHEDULE_RUN) ) def _set_schedule_mode(self, schedule_mode): """Set a schedule mode.""" self._schedule_mode = schedule_mode # Changing the property here does the actual set self._thermostat.schedule_mode = schedule_mode self._schedule_update() def set_temperature(self, **kwargs): """Set a new target temperature.""" self._set_temperature_and_mode( kwargs.get(ATTR_TEMPERATURE), hvac_mode=kwargs.get(ATTR_HVAC_MODE) ) def _set_temperature_and_mode(self, temperature, hvac_mode=None, preset_mode=None): """Set temperature and hvac mode at the same time.""" if self._temperature_unit == "C": target_temperature = celsius_to_nuheat(temperature) else: target_temperature = fahrenheit_to_nuheat(temperature) # If they set a temperature without changing the mode # to heat, we behave like the device does locally # and set a temp hold. target_schedule_mode = SCHEDULE_TEMPORARY_HOLD if preset_mode: target_schedule_mode = PRESET_MODE_TO_SCHEDULE_MODE_MAP.get( preset_mode, SCHEDULE_RUN ) elif self._schedule_mode == SCHEDULE_HOLD or ( hvac_mode and hvac_mode == HVAC_MODE_HEAT ): target_schedule_mode = SCHEDULE_HOLD _LOGGER.debug( "Setting NuHeat thermostat temperature to %s %s and schedule mode: %s", temperature, self.temperature_unit, target_schedule_mode, ) self._thermostat.set_target_temperature( target_temperature, target_schedule_mode ) self._schedule_mode = target_schedule_mode self._target_temperature = target_temperature self._schedule_update() def _schedule_update(self): if not self.hass: return # Update the new state self.schedule_update_ha_state(False) # nuheat has a delay switching state # so we schedule a poll of the api # in the future to make sure the change actually # took effect event_helper.call_later( self.hass, NUHEAT_API_STATE_SHIFT_DELAY, self._schedule_force_refresh ) def _schedule_force_refresh(self, _): self._force_update = True self.schedule_update_ha_state(True) def update(self): """Get the latest state from the thermostat.""" if self._force_update: self._throttled_update(no_throttle=True) self._force_update = False else: self._throttled_update() @Throttle(MIN_TIME_BETWEEN_UPDATES) def _throttled_update(self, **kwargs): """Get the latest state from the thermostat with a throttle.""" self._thermostat.get_data() self._schedule_mode = self._thermostat.schedule_mode self._target_temperature = self._thermostat.target_temperature @property def device_info(self): """Return the device_info of the device.""" return { "identifiers": {(DOMAIN, self._thermostat.serial_number)}, "name": self._thermostat.room, "model": "nVent Signature", "manufacturer": MANUFACTURER, }