Issue #22 - Change preset to "security" when the Thermostat goes in security mode Issue #30 - When shutting of a thermostat after it has been in security mode, the thermostat can start up alone
512 lines
18 KiB
Python
512 lines
18 KiB
Python
"""Config flow for Versatile Thermostat integration."""
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
import copy
|
|
from collections.abc import Mapping
|
|
import voluptuous as vol
|
|
|
|
from typing import Any
|
|
|
|
from homeassistant.core import callback
|
|
from homeassistant.config_entries import (
|
|
ConfigEntry,
|
|
ConfigFlow as HAConfigFlow,
|
|
OptionsFlow,
|
|
)
|
|
|
|
# import homeassistant.helpers.entity_registry as entity_registry
|
|
from homeassistant.data_entry_flow import FlowHandler
|
|
from homeassistant.data_entry_flow import FlowResult
|
|
from homeassistant.exceptions import HomeAssistantError
|
|
|
|
import homeassistant.helpers.config_validation as cv
|
|
|
|
from .const import (
|
|
DOMAIN,
|
|
CONF_NAME,
|
|
CONF_HEATER,
|
|
CONF_TEMP_SENSOR,
|
|
CONF_EXTERNAL_TEMP_SENSOR,
|
|
CONF_POWER_SENSOR,
|
|
CONF_MAX_POWER_SENSOR,
|
|
CONF_WINDOW_SENSOR,
|
|
CONF_WINDOW_DELAY,
|
|
CONF_MOTION_SENSOR,
|
|
CONF_MOTION_DELAY,
|
|
CONF_MOTION_PRESET,
|
|
CONF_NO_MOTION_PRESET,
|
|
CONF_DEVICE_POWER,
|
|
CONF_CYCLE_MIN,
|
|
CONF_PRESET_POWER,
|
|
CONF_PRESETS,
|
|
CONF_PRESETS_AWAY,
|
|
CONF_PRESETS_SELECTIONABLE,
|
|
CONF_PROP_FUNCTION,
|
|
CONF_TPI_COEF_EXT,
|
|
CONF_TPI_COEF_INT,
|
|
CONF_PRESENCE_SENSOR,
|
|
PROPORTIONAL_FUNCTION_TPI,
|
|
CONF_SECURITY_DELAY_MIN,
|
|
CONF_MINIMAL_ACTIVATION_DELAY,
|
|
CONF_TEMP_MAX,
|
|
CONF_TEMP_MIN,
|
|
)
|
|
|
|
from .climate import VersatileThermostat
|
|
|
|
# from .climate import VersatileThermostat
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
# Not used but can be useful in other context
|
|
# def schema_defaults(schema, **defaults):
|
|
# """Create a new schema with default values filled in."""
|
|
# copy = schema.extend({})
|
|
# for field, field_type in copy.schema.items():
|
|
# if isinstance(field_type, vol.In):
|
|
# value = None
|
|
#
|
|
# if value in field_type.container:
|
|
# # field.default = vol.default_factory(value)
|
|
# field.description = {"suggested_value": value}
|
|
# continue
|
|
#
|
|
# if field.schema in defaults:
|
|
# # field.default = vol.default_factory(defaults[field])
|
|
# field.description = {"suggested_value": defaults[field]}
|
|
# return copy
|
|
#
|
|
|
|
|
|
def add_suggested_values_to_schema(
|
|
data_schema: vol.Schema, suggested_values: Mapping[str, Any]
|
|
) -> vol.Schema:
|
|
"""Make a copy of the schema, populated with suggested values.
|
|
|
|
For each schema marker matching items in `suggested_values`,
|
|
the `suggested_value` will be set. The existing `suggested_value` will
|
|
be left untouched if there is no matching item.
|
|
"""
|
|
schema = {}
|
|
for key, val in data_schema.schema.items():
|
|
new_key = key
|
|
if key in suggested_values and isinstance(key, vol.Marker):
|
|
# Copy the marker to not modify the flow schema
|
|
new_key = copy.copy(key)
|
|
new_key.description = {"suggested_value": suggested_values[key]}
|
|
schema[new_key] = val
|
|
_LOGGER.debug("add_suggested_values_to_schema: schema=%s", schema)
|
|
return vol.Schema(schema)
|
|
|
|
|
|
class VersatileThermostatBaseConfigFlow(FlowHandler):
|
|
"""The base Config flow class. Used to put some code in commons."""
|
|
|
|
VERSION = 1
|
|
_infos: dict
|
|
|
|
def __init__(self, infos) -> None:
|
|
super().__init__()
|
|
_LOGGER.debug("CTOR BaseConfigFlow infos: %s", infos)
|
|
self._infos = infos
|
|
self.STEP_USER_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Required(CONF_NAME): cv.string,
|
|
vol.Required(CONF_HEATER): cv.string,
|
|
vol.Required(CONF_TEMP_SENSOR): cv.string,
|
|
vol.Required(CONF_EXTERNAL_TEMP_SENSOR): cv.string,
|
|
vol.Required(CONF_CYCLE_MIN, default=5): cv.positive_int,
|
|
vol.Required(
|
|
CONF_PROP_FUNCTION, default=PROPORTIONAL_FUNCTION_TPI
|
|
): vol.In(
|
|
[
|
|
PROPORTIONAL_FUNCTION_TPI,
|
|
]
|
|
),
|
|
vol.Required(CONF_TEMP_MIN, default=7): vol.Coerce(float),
|
|
vol.Required(CONF_TEMP_MAX, default=35): vol.Coerce(float),
|
|
}
|
|
)
|
|
|
|
self.STEP_TPI_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Required(CONF_TPI_COEF_INT, default=0.6): vol.Coerce(float),
|
|
vol.Required(CONF_TPI_COEF_EXT, default=0.01): vol.Coerce(float),
|
|
}
|
|
)
|
|
|
|
self.STEP_PRESETS_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Optional(v, default=0.0): vol.Coerce(float)
|
|
for (k, v) in CONF_PRESETS.items()
|
|
}
|
|
)
|
|
|
|
self.STEP_WINDOW_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Optional(CONF_WINDOW_SENSOR): cv.string,
|
|
vol.Optional(CONF_WINDOW_DELAY, default=30): cv.positive_int,
|
|
}
|
|
)
|
|
|
|
self.STEP_MOTION_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Optional(CONF_MOTION_SENSOR): cv.string,
|
|
vol.Optional(CONF_MOTION_DELAY, default=30): cv.positive_int,
|
|
vol.Optional(CONF_MOTION_PRESET, default="comfort"): vol.In(
|
|
CONF_PRESETS_SELECTIONABLE
|
|
),
|
|
vol.Optional(CONF_NO_MOTION_PRESET, default="eco"): vol.In(
|
|
CONF_PRESETS_SELECTIONABLE
|
|
),
|
|
}
|
|
)
|
|
|
|
self.STEP_POWER_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Optional(CONF_POWER_SENSOR): cv.string,
|
|
vol.Optional(CONF_MAX_POWER_SENSOR): cv.string,
|
|
vol.Optional(CONF_DEVICE_POWER): vol.Coerce(float),
|
|
vol.Optional(CONF_PRESET_POWER): vol.Coerce(float),
|
|
}
|
|
)
|
|
|
|
self.STEP_PRESENCE_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Optional(CONF_PRESENCE_SENSOR): cv.string,
|
|
}
|
|
).extend(
|
|
{
|
|
vol.Optional(v, default=17): vol.Coerce(float)
|
|
for (k, v) in CONF_PRESETS_AWAY.items()
|
|
}
|
|
)
|
|
|
|
self.STEP_ADVANCED_DATA_SCHEMA = vol.Schema(
|
|
{
|
|
vol.Required(
|
|
CONF_MINIMAL_ACTIVATION_DELAY, default=10
|
|
): cv.positive_int,
|
|
vol.Required(CONF_SECURITY_DELAY_MIN, default=60): cv.positive_int,
|
|
}
|
|
)
|
|
|
|
async def validate_input(self, data: dict) -> dict[str]:
|
|
"""Validate the user input allows us to connect.
|
|
|
|
Data has the keys from STEP_*_DATA_SCHEMA with values provided by the user.
|
|
"""
|
|
|
|
# check the heater_entity_id
|
|
for conf in [
|
|
CONF_HEATER,
|
|
CONF_TEMP_SENSOR,
|
|
CONF_EXTERNAL_TEMP_SENSOR,
|
|
CONF_WINDOW_SENSOR,
|
|
CONF_MOTION_SENSOR,
|
|
CONF_POWER_SENSOR,
|
|
CONF_MAX_POWER_SENSOR,
|
|
CONF_PRESENCE_SENSOR,
|
|
]:
|
|
d = data.get(conf, None) # pylint: disable=invalid-name
|
|
if d is not None and self.hass.states.get(d) is None:
|
|
_LOGGER.error(
|
|
"Entity id %s doesn't have any state. We cannot use it in the Versatile Thermostat configuration", # pylint: disable=line-too-long
|
|
d,
|
|
)
|
|
raise UnknownEntity(conf)
|
|
|
|
def merge_user_input(self, data_schema: vol.Schema, user_input: dict):
|
|
"""For each schema entry not in user_input, set or remove values in infos"""
|
|
self._infos.update(user_input)
|
|
for key, _ in data_schema.schema.items():
|
|
if key not in user_input and isinstance(key, vol.Marker):
|
|
_LOGGER.debug(
|
|
"add_empty_values_to_user_input: %s is not in user_input", key
|
|
)
|
|
if key in self._infos:
|
|
self._infos.pop(key)
|
|
# else: This don't work but I don't know why. _infos seems broken after this (Not serializable exactly)
|
|
# self._infos[key] = user_input[key]
|
|
|
|
_LOGGER.debug("merge_user_input: infos is now %s", self._infos)
|
|
|
|
async def generic_step(self, step_id, data_schema, user_input, next_step_function):
|
|
"""A generic method step"""
|
|
_LOGGER.debug(
|
|
"Into ConfigFlow.async_step_%s user_input=%s", step_id, user_input
|
|
)
|
|
|
|
defaults = self._infos.copy()
|
|
errors = {}
|
|
|
|
if user_input is not None:
|
|
defaults.update(user_input or {})
|
|
try:
|
|
await self.validate_input(user_input)
|
|
except UnknownEntity as err:
|
|
errors[str(err)] = "unknown_entity"
|
|
except Exception: # pylint: disable=broad-except
|
|
_LOGGER.exception("Unexpected exception")
|
|
errors["base"] = "unknown"
|
|
else:
|
|
self.merge_user_input(data_schema, user_input)
|
|
_LOGGER.debug("_info is now: %s", self._infos)
|
|
return await next_step_function()
|
|
|
|
# ds = schema_defaults(data_schema, **defaults) # pylint: disable=invalid-name
|
|
ds = add_suggested_values_to_schema(
|
|
data_schema=data_schema, suggested_values=defaults
|
|
) # pylint: disable=invalid-name
|
|
|
|
return self.async_show_form(step_id=step_id, data_schema=ds, errors=errors)
|
|
|
|
async def async_step_user(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_user user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"user", self.STEP_USER_DATA_SCHEMA, user_input, self.async_step_tpi
|
|
)
|
|
|
|
async def async_step_tpi(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_tpi user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"tpi", self.STEP_TPI_DATA_SCHEMA, user_input, self.async_step_presets
|
|
)
|
|
|
|
async def async_step_presets(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the presets flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_presets user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"presets", self.STEP_PRESETS_DATA_SCHEMA, user_input, self.async_step_window
|
|
)
|
|
|
|
async def async_step_window(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the window sensor flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_window user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"window", self.STEP_WINDOW_DATA_SCHEMA, user_input, self.async_step_motion
|
|
)
|
|
|
|
async def async_step_motion(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the window and motion sensor flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_motion user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"motion", self.STEP_MOTION_DATA_SCHEMA, user_input, self.async_step_power
|
|
)
|
|
|
|
async def async_step_power(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the power management flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_power user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"power",
|
|
self.STEP_POWER_DATA_SCHEMA,
|
|
user_input,
|
|
self.async_step_presence,
|
|
)
|
|
|
|
async def async_step_presence(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the presence management flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_presence user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"presence",
|
|
self.STEP_PRESENCE_DATA_SCHEMA,
|
|
user_input,
|
|
self.async_step_advanced,
|
|
)
|
|
|
|
async def async_step_advanced(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the advanced parameter flow steps"""
|
|
_LOGGER.debug("Into ConfigFlow.async_step_advanced user_input=%s", user_input)
|
|
|
|
return await self.generic_step(
|
|
"advanced",
|
|
self.STEP_ADVANCED_DATA_SCHEMA,
|
|
user_input,
|
|
self.async_finalize, # pylint: disable=no-member
|
|
)
|
|
|
|
|
|
class VersatileThermostatConfigFlow(
|
|
VersatileThermostatBaseConfigFlow, HAConfigFlow, domain=DOMAIN
|
|
):
|
|
"""Handle a config flow for Versatile Thermostat."""
|
|
|
|
def __init__(self) -> None:
|
|
# self._info = dict()
|
|
super().__init__(dict())
|
|
_LOGGER.debug("CTOR ConfigFlow")
|
|
|
|
@staticmethod
|
|
@callback
|
|
def async_get_options_flow(config_entry: ConfigEntry):
|
|
"""Get options flow for this handler"""
|
|
return VersatileThermostatOptionsFlowHandler(config_entry)
|
|
|
|
async def async_finalize(self):
|
|
"""Finalization of the ConfigEntry creation"""
|
|
_LOGGER.debug("ConfigFlow.async_finalize")
|
|
return self.async_create_entry(title=self._infos[CONF_NAME], data=self._infos)
|
|
|
|
|
|
class UnknownEntity(HomeAssistantError):
|
|
"""Error to indicate there is an unknown entity_id given."""
|
|
|
|
|
|
class VersatileThermostatOptionsFlowHandler(
|
|
VersatileThermostatBaseConfigFlow, OptionsFlow
|
|
):
|
|
"""Handle options flow for Versatile Thermostat integration."""
|
|
|
|
def __init__(self, config_entry: ConfigEntry):
|
|
"""Initialize options flow."""
|
|
super().__init__(config_entry.data.copy())
|
|
self.config_entry = config_entry
|
|
_LOGGER.debug(
|
|
"CTOR VersatileThermostatOptionsFlowHandler info: %s, entry_id: %s",
|
|
self._infos,
|
|
config_entry.entry_id,
|
|
)
|
|
|
|
async def async_step_init(self, user_input=None):
|
|
"""Manage basic options."""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_init user_input =%s",
|
|
user_input,
|
|
)
|
|
|
|
return await self.async_step_user()
|
|
|
|
async def async_step_user(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_user user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"user", self.STEP_USER_DATA_SCHEMA, user_input, self.async_step_tpi
|
|
)
|
|
|
|
async def async_step_tpi(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the tpi flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_tpi user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"tpi", self.STEP_TPI_DATA_SCHEMA, user_input, self.async_step_presets
|
|
)
|
|
|
|
async def async_step_presets(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the presets flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_presets user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"presets", self.STEP_PRESETS_DATA_SCHEMA, user_input, self.async_step_window
|
|
)
|
|
|
|
async def async_step_window(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the window sensor flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_window user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"window", self.STEP_WINDOW_DATA_SCHEMA, user_input, self.async_step_motion
|
|
)
|
|
|
|
async def async_step_motion(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the window and motion sensor flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_motion user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"motion", self.STEP_MOTION_DATA_SCHEMA, user_input, self.async_step_power
|
|
)
|
|
|
|
async def async_step_power(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the power management flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_power user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"power",
|
|
self.STEP_POWER_DATA_SCHEMA,
|
|
user_input,
|
|
self.async_step_presence,
|
|
)
|
|
|
|
async def async_step_presence(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the presence management flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_presence user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"presence",
|
|
self.STEP_PRESENCE_DATA_SCHEMA,
|
|
user_input,
|
|
self.async_step_advanced,
|
|
)
|
|
|
|
async def async_step_advanced(self, user_input: dict | None = None) -> FlowResult:
|
|
"""Handle the advanced flow steps"""
|
|
_LOGGER.debug(
|
|
"Into OptionsFlowHandler.async_step_advanced user_input=%s", user_input
|
|
)
|
|
|
|
return await self.generic_step(
|
|
"advanced",
|
|
self.STEP_ADVANCED_DATA_SCHEMA,
|
|
user_input,
|
|
self.async_end,
|
|
)
|
|
|
|
async def async_end(self):
|
|
"""Finalization of the ConfigEntry creation"""
|
|
_LOGGER.debug(
|
|
"CTOR ConfigFlow.async_finalize - updating entry with: %s", self._infos
|
|
)
|
|
# Find eventual existing entity to update it
|
|
# removing entities from registry (they will be recreated)
|
|
# ent_reg = entity_registry.async_get(self.hass)
|
|
|
|
# reg_entities = {
|
|
# ent.unique_id: ent.entity_id
|
|
# for ent in entity_registry.async_entries_for_config_entry(
|
|
# ent_reg, self.config_entry.entry_id
|
|
# )
|
|
# }
|
|
#
|
|
# for entry in entity_registry.async_entries_for_config_entry(
|
|
# ent_reg, self.config_entry.entry_id
|
|
# ):
|
|
# entity: VersatileThermostat = ent_reg.async_get(entry.entity_id)
|
|
# entity.async_registry_entry_updated(self._infos)
|
|
|
|
_LOGGER.debug(
|
|
"We have found entities to update: %s", self.config_entry.entry_id
|
|
)
|
|
await VersatileThermostat.update_entity(self.config_entry.entry_id, self._infos)
|
|
|
|
# for entity_id in reg_entities.values():
|
|
# _LOGGER.info("Recreating entity %s due to configuration change", entity_id)
|
|
# ent_reg.async_remove(entity_id)
|
|
#
|
|
self.hass.config_entries.async_update_entry(self.config_entry, data=self._infos)
|
|
return self.async_create_entry(title=None, data=None)
|