144 lines
4.2 KiB
Python
144 lines
4.2 KiB
Python
"""
|
|
Adds support for Nest thermostats.
|
|
"""
|
|
import logging
|
|
|
|
from homeassistant.components.thermostat import ThermostatDevice
|
|
from homeassistant.helpers.temperature import convert
|
|
from homeassistant.const import (CONF_USERNAME, CONF_PASSWORD, TEMP_CELCIUS)
|
|
|
|
REQUIREMENTS = ['python-nest>=2.4.0']
|
|
|
|
|
|
# pylint: disable=unused-argument
|
|
def setup_platform(hass, config, add_devices, discovery_info=None):
|
|
""" Sets up the nest thermostat. """
|
|
logger = logging.getLogger(__name__)
|
|
|
|
username = config.get(CONF_USERNAME)
|
|
password = config.get(CONF_PASSWORD)
|
|
|
|
if username is None or password is None:
|
|
logger.error("Missing required configuration items %s or %s",
|
|
CONF_USERNAME, CONF_PASSWORD)
|
|
return
|
|
|
|
try:
|
|
import nest
|
|
except ImportError:
|
|
logger.exception(
|
|
"Error while importing dependency nest. "
|
|
"Did you maybe not install the python-nest dependency?")
|
|
|
|
return
|
|
|
|
napi = nest.Nest(username, password)
|
|
|
|
add_devices([
|
|
NestThermostat(structure, device)
|
|
for structure in napi.structures
|
|
for device in structure.devices
|
|
])
|
|
|
|
|
|
class NestThermostat(ThermostatDevice):
|
|
""" Represents a Nest thermostat within Home Assistant. """
|
|
|
|
def __init__(self, structure, device):
|
|
self.structure = structure
|
|
self.device = device
|
|
|
|
@property
|
|
def name(self):
|
|
""" Returns the name of the nest, if any. """
|
|
location = self.device.where
|
|
name = self.device.name
|
|
if location is None:
|
|
return name
|
|
else:
|
|
if name == '':
|
|
return location.capitalize()
|
|
else:
|
|
return location.capitalize() + '(' + name + ')'
|
|
|
|
@property
|
|
def unit_of_measurement(self):
|
|
""" Returns the unit of measurement. """
|
|
return TEMP_CELCIUS
|
|
|
|
@property
|
|
def device_state_attributes(self):
|
|
""" Returns device specific state attributes. """
|
|
# Move these to Thermostat Device and make them global
|
|
return {
|
|
"humidity": self.device.humidity,
|
|
"target_humidity": self.device.target_humidity,
|
|
"fan": self.device.fan,
|
|
"mode": self.device.mode
|
|
}
|
|
|
|
@property
|
|
def current_temperature(self):
|
|
""" Returns the current temperature. """
|
|
return round(self.device.temperature, 1)
|
|
|
|
@property
|
|
def target_temperature(self):
|
|
""" Returns the temperature we try to reach. """
|
|
target = self.device.target
|
|
|
|
if isinstance(target, tuple):
|
|
low, high = target
|
|
|
|
if self.current_temperature < low:
|
|
temp = low
|
|
elif self.current_temperature > high:
|
|
temp = high
|
|
else:
|
|
temp = (low + high)/2
|
|
else:
|
|
temp = target
|
|
|
|
return round(temp, 1)
|
|
|
|
@property
|
|
def is_away_mode_on(self):
|
|
""" Returns if away mode is on. """
|
|
return self.structure.away
|
|
|
|
def set_temperature(self, temperature):
|
|
""" Set new target temperature ensuring it is in proper units """
|
|
temperature = convert(temperature, self.hass.config.temperature_unit,
|
|
self.unit_of_measurement)
|
|
self.device.target = temperature
|
|
|
|
def turn_away_mode_on(self):
|
|
""" Turns away on. """
|
|
self.structure.away = True
|
|
|
|
def turn_away_mode_off(self):
|
|
""" Turns away off. """
|
|
self.structure.away = False
|
|
|
|
@property
|
|
def min_temp(self):
|
|
""" Identifies min_temp in Nest API or defaults if not available. """
|
|
temp = self.device.away_temperature.low
|
|
if temp is None:
|
|
return super().min_temp
|
|
else:
|
|
return round(self.hass.config.temperature(temp, TEMP_CELCIUS)[0])
|
|
|
|
@property
|
|
def max_temp(self):
|
|
""" Identifies mxn_temp in Nest API or defaults if not available. """
|
|
temp = self.device.away_temperature.high
|
|
if temp is None:
|
|
return super().max_temp
|
|
else:
|
|
return round(self.hass.config.temperature(temp, TEMP_CELCIUS)[0])
|
|
|
|
def update(self):
|
|
""" Python-nest has its own mechanism for staying up to date. """
|
|
pass
|