mirror of https://github.com/home-assistant/core
339 lines
11 KiB
Python
339 lines
11 KiB
Python
"""Config flow for Broadlink devices."""
|
|
|
|
from collections.abc import Mapping
|
|
import errno
|
|
from functools import partial
|
|
import logging
|
|
import socket
|
|
from typing import Any
|
|
|
|
import broadlink as blk
|
|
from broadlink.exceptions import (
|
|
AuthenticationError,
|
|
BroadlinkException,
|
|
NetworkTimeoutError,
|
|
)
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.components import dhcp
|
|
from homeassistant.config_entries import (
|
|
SOURCE_IMPORT,
|
|
SOURCE_REAUTH,
|
|
ConfigFlow,
|
|
ConfigFlowResult,
|
|
)
|
|
from homeassistant.const import CONF_HOST, CONF_MAC, CONF_NAME, CONF_TIMEOUT, CONF_TYPE
|
|
from homeassistant.data_entry_flow import AbortFlow
|
|
from homeassistant.helpers import config_validation as cv
|
|
|
|
from .const import DEFAULT_PORT, DEFAULT_TIMEOUT, DEVICE_TYPES, DOMAIN
|
|
from .helpers import format_mac
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
class BroadlinkFlowHandler(ConfigFlow, domain=DOMAIN):
|
|
"""Handle a Broadlink config flow."""
|
|
|
|
VERSION = 1
|
|
|
|
device: blk.Device
|
|
|
|
async def async_set_device(
|
|
self, device: blk.Device, raise_on_progress: bool = True
|
|
) -> None:
|
|
"""Define a device for the config flow."""
|
|
if device.type not in DEVICE_TYPES:
|
|
_LOGGER.error(
|
|
(
|
|
"Unsupported device: %s. If it worked before, please open "
|
|
"an issue at https://github.com/home-assistant/core/issues"
|
|
),
|
|
hex(device.devtype),
|
|
)
|
|
raise AbortFlow("not_supported")
|
|
|
|
await self.async_set_unique_id(
|
|
device.mac.hex(), raise_on_progress=raise_on_progress
|
|
)
|
|
self.device = device
|
|
|
|
self.context["title_placeholders"] = {
|
|
"name": device.name,
|
|
"model": device.model,
|
|
"host": device.host[0],
|
|
}
|
|
|
|
async def async_step_dhcp(
|
|
self, discovery_info: dhcp.DhcpServiceInfo
|
|
) -> ConfigFlowResult:
|
|
"""Handle dhcp discovery."""
|
|
host = discovery_info.ip
|
|
unique_id = discovery_info.macaddress.lower().replace(":", "")
|
|
await self.async_set_unique_id(unique_id)
|
|
self._abort_if_unique_id_configured(updates={CONF_HOST: host})
|
|
|
|
try:
|
|
device = await self.hass.async_add_executor_job(blk.hello, host)
|
|
|
|
except NetworkTimeoutError:
|
|
return self.async_abort(reason="cannot_connect")
|
|
|
|
except OSError as err:
|
|
if err.errno == errno.ENETUNREACH:
|
|
return self.async_abort(reason="cannot_connect")
|
|
return self.async_abort(reason="unknown")
|
|
|
|
if device.type not in DEVICE_TYPES:
|
|
return self.async_abort(reason="not_supported")
|
|
|
|
await self.async_set_device(device)
|
|
return await self.async_step_auth()
|
|
|
|
async def async_step_user(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Handle a flow initiated by the user."""
|
|
errors = {}
|
|
|
|
if user_input is not None:
|
|
host = user_input[CONF_HOST]
|
|
timeout = user_input.get(CONF_TIMEOUT, DEFAULT_TIMEOUT)
|
|
|
|
try:
|
|
hello = partial(blk.hello, host, timeout=timeout)
|
|
device = await self.hass.async_add_executor_job(hello)
|
|
|
|
except NetworkTimeoutError:
|
|
errors["base"] = "cannot_connect"
|
|
err_msg = "Device not found"
|
|
|
|
except OSError as err:
|
|
if err.errno in {errno.EINVAL, socket.EAI_NONAME}:
|
|
errors["base"] = "invalid_host"
|
|
err_msg = "Invalid hostname or IP address"
|
|
elif err.errno == errno.ENETUNREACH:
|
|
errors["base"] = "cannot_connect"
|
|
err_msg = str(err)
|
|
else:
|
|
errors["base"] = "unknown"
|
|
err_msg = str(err)
|
|
|
|
else:
|
|
device.timeout = timeout
|
|
|
|
if self.source != SOURCE_REAUTH:
|
|
await self.async_set_device(device)
|
|
self._abort_if_unique_id_configured(
|
|
updates={CONF_HOST: device.host[0], CONF_TIMEOUT: timeout}
|
|
)
|
|
return await self.async_step_auth()
|
|
|
|
if device.mac == self.device.mac:
|
|
await self.async_set_device(device, raise_on_progress=False)
|
|
return await self.async_step_auth()
|
|
|
|
errors["base"] = "invalid_host"
|
|
err_msg = (
|
|
"This is not the device you are looking for. The MAC "
|
|
f"address must be {format_mac(self.device.mac)}"
|
|
)
|
|
|
|
_LOGGER.error("Failed to connect to the device at %s: %s", host, err_msg)
|
|
|
|
if self.source == SOURCE_IMPORT:
|
|
return self.async_abort(reason=errors["base"])
|
|
|
|
data_schema = {
|
|
vol.Required(CONF_HOST): str,
|
|
vol.Optional(CONF_TIMEOUT, default=DEFAULT_TIMEOUT): cv.positive_int,
|
|
}
|
|
return self.async_show_form(
|
|
step_id="user",
|
|
data_schema=vol.Schema(data_schema),
|
|
errors=errors,
|
|
)
|
|
|
|
async def async_step_auth(self) -> ConfigFlowResult:
|
|
"""Authenticate to the device."""
|
|
device = self.device
|
|
errors: dict[str, str] = {}
|
|
|
|
try:
|
|
await self.hass.async_add_executor_job(device.auth)
|
|
|
|
except AuthenticationError:
|
|
errors["base"] = "invalid_auth"
|
|
await self.async_set_unique_id(device.mac.hex())
|
|
return await self.async_step_reset(errors=errors)
|
|
|
|
except NetworkTimeoutError as err:
|
|
errors["base"] = "cannot_connect"
|
|
err_msg = str(err)
|
|
|
|
except BroadlinkException as err:
|
|
errors["base"] = "unknown"
|
|
err_msg = str(err)
|
|
|
|
except OSError as err:
|
|
if err.errno == errno.ENETUNREACH:
|
|
errors["base"] = "cannot_connect"
|
|
err_msg = str(err)
|
|
else:
|
|
errors["base"] = "unknown"
|
|
err_msg = str(err)
|
|
|
|
else:
|
|
await self.async_set_unique_id(device.mac.hex())
|
|
if self.source == SOURCE_IMPORT:
|
|
_LOGGER.warning(
|
|
(
|
|
"%s (%s at %s) is ready to be configured. Click "
|
|
"Configuration in the sidebar, click Integrations and "
|
|
"click Configure on the device to complete the setup"
|
|
),
|
|
device.name,
|
|
device.model,
|
|
device.host[0],
|
|
)
|
|
|
|
if device.is_locked:
|
|
return await self.async_step_unlock()
|
|
return await self.async_step_finish()
|
|
|
|
await self.async_set_unique_id(device.mac.hex())
|
|
_LOGGER.error(
|
|
"Failed to authenticate to the device at %s: %s", device.host[0], err_msg
|
|
)
|
|
return self.async_show_form(step_id="auth", errors=errors)
|
|
|
|
async def async_step_reset(
|
|
self,
|
|
user_input: dict[str, Any] | None = None,
|
|
errors: dict[str, str] | None = None,
|
|
) -> ConfigFlowResult:
|
|
"""Guide the user to unlock the device manually.
|
|
|
|
We are unable to authenticate because the device is locked.
|
|
The user needs to open the Broadlink app and unlock the device.
|
|
"""
|
|
device = self.device
|
|
|
|
if user_input is None:
|
|
return self.async_show_form(
|
|
step_id="reset",
|
|
errors=errors,
|
|
description_placeholders={
|
|
"name": device.name,
|
|
"model": device.model,
|
|
"host": device.host[0],
|
|
},
|
|
)
|
|
|
|
return await self.async_step_user(
|
|
{CONF_HOST: device.host[0], CONF_TIMEOUT: device.timeout}
|
|
)
|
|
|
|
async def async_step_unlock(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Unlock the device.
|
|
|
|
The authentication succeeded, but the device is locked.
|
|
We can offer an unlock to prevent authorization errors.
|
|
"""
|
|
device = self.device
|
|
errors = {}
|
|
|
|
if user_input is None:
|
|
pass
|
|
|
|
elif user_input["unlock"]:
|
|
try:
|
|
await self.hass.async_add_executor_job(device.set_lock, False)
|
|
|
|
except NetworkTimeoutError as err:
|
|
errors["base"] = "cannot_connect"
|
|
err_msg = str(err)
|
|
|
|
except BroadlinkException as err:
|
|
errors["base"] = "unknown"
|
|
err_msg = str(err)
|
|
|
|
except OSError as err:
|
|
if err.errno == errno.ENETUNREACH:
|
|
errors["base"] = "cannot_connect"
|
|
err_msg = str(err)
|
|
else:
|
|
errors["base"] = "unknown"
|
|
err_msg = str(err)
|
|
|
|
else:
|
|
return await self.async_step_finish()
|
|
|
|
_LOGGER.error(
|
|
"Failed to unlock the device at %s: %s", device.host[0], err_msg
|
|
)
|
|
|
|
else:
|
|
return await self.async_step_finish()
|
|
|
|
data_schema = {vol.Required("unlock", default=False): bool}
|
|
return self.async_show_form(
|
|
step_id="unlock",
|
|
errors=errors,
|
|
data_schema=vol.Schema(data_schema),
|
|
description_placeholders={
|
|
"name": device.name,
|
|
"model": device.model,
|
|
"host": device.host[0],
|
|
},
|
|
)
|
|
|
|
async def async_step_finish(
|
|
self, user_input: dict[str, Any] | None = None
|
|
) -> ConfigFlowResult:
|
|
"""Choose a name for the device and create config entry."""
|
|
device = self.device
|
|
errors: dict[str, str] = {}
|
|
|
|
# Abort reauthentication flow.
|
|
self._abort_if_unique_id_configured(
|
|
updates={CONF_HOST: device.host[0], CONF_TIMEOUT: device.timeout}
|
|
)
|
|
|
|
if user_input is not None:
|
|
return self.async_create_entry(
|
|
title=user_input[CONF_NAME],
|
|
data={
|
|
CONF_HOST: device.host[0],
|
|
CONF_MAC: device.mac.hex(),
|
|
CONF_TYPE: device.devtype,
|
|
CONF_TIMEOUT: device.timeout,
|
|
},
|
|
)
|
|
|
|
data_schema = {vol.Required(CONF_NAME, default=device.name): str}
|
|
return self.async_show_form(
|
|
step_id="finish", data_schema=vol.Schema(data_schema), errors=errors
|
|
)
|
|
|
|
async def async_step_import(self, import_data: dict[str, Any]) -> ConfigFlowResult:
|
|
"""Import a device."""
|
|
self._async_abort_entries_match({CONF_HOST: import_data[CONF_HOST]})
|
|
return await self.async_step_user(import_data)
|
|
|
|
async def async_step_reauth(
|
|
self, entry_data: Mapping[str, Any]
|
|
) -> ConfigFlowResult:
|
|
"""Reauthenticate to the device."""
|
|
device = blk.gendevice(
|
|
entry_data[CONF_TYPE],
|
|
(entry_data[CONF_HOST], DEFAULT_PORT),
|
|
bytes.fromhex(entry_data[CONF_MAC]),
|
|
name=entry_data[CONF_NAME],
|
|
)
|
|
device.timeout = entry_data[CONF_TIMEOUT]
|
|
await self.async_set_device(device)
|
|
return await self.async_step_reset()
|