294 lines
9.2 KiB
Python
294 lines
9.2 KiB
Python
"""Support for NuHeat thermostats."""
|
|
from datetime import datetime, timedelta
|
|
import logging
|
|
import time
|
|
|
|
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 ClimateEntity
|
|
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,
|
|
NUHEAT_DATETIME_FORMAT,
|
|
NUHEAT_KEY_HOLD_SET_POINT_DATE_TIME,
|
|
NUHEAT_KEY_SCHEDULE_MODE,
|
|
NUHEAT_KEY_SET_POINT_TEMP,
|
|
TEMP_HOLD_TIME_SEC,
|
|
)
|
|
|
|
_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(ClimateEntity):
|
|
"""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,
|
|
)
|
|
|
|
target_temperature = max(
|
|
min(self._thermostat.max_temperature, target_temperature),
|
|
self._thermostat.min_temperature,
|
|
)
|
|
|
|
request = {
|
|
NUHEAT_KEY_SET_POINT_TEMP: target_temperature,
|
|
NUHEAT_KEY_SCHEDULE_MODE: target_schedule_mode,
|
|
}
|
|
|
|
if target_schedule_mode == SCHEDULE_TEMPORARY_HOLD:
|
|
request[NUHEAT_KEY_HOLD_SET_POINT_DATE_TIME] = datetime.fromtimestamp(
|
|
time.time() + TEMP_HOLD_TIME_SEC
|
|
).strftime(NUHEAT_DATETIME_FORMAT)
|
|
|
|
self._thermostat.set_data(request)
|
|
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,
|
|
}
|