252 lines
7.7 KiB
Python
252 lines
7.7 KiB
Python
"""Support for UV data from openuv.io."""
|
|
import asyncio
|
|
import logging
|
|
|
|
from pyopenuv import Client
|
|
from pyopenuv.errors import OpenUvError
|
|
import voluptuous as vol
|
|
|
|
from homeassistant.config_entries import SOURCE_IMPORT
|
|
from homeassistant.const import (
|
|
ATTR_ATTRIBUTION,
|
|
CONF_API_KEY,
|
|
CONF_BINARY_SENSORS,
|
|
CONF_ELEVATION,
|
|
CONF_LATITUDE,
|
|
CONF_LONGITUDE,
|
|
CONF_SENSORS,
|
|
)
|
|
from homeassistant.exceptions import ConfigEntryNotReady
|
|
from homeassistant.helpers import aiohttp_client, config_validation as cv
|
|
from homeassistant.helpers.dispatcher import async_dispatcher_send
|
|
from homeassistant.helpers.entity import Entity
|
|
from homeassistant.helpers.service import verify_domain_control
|
|
|
|
from .config_flow import configured_instances
|
|
from .const import DOMAIN
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
DATA_OPENUV_CLIENT = "data_client"
|
|
DATA_OPENUV_LISTENER = "data_listener"
|
|
DATA_PROTECTION_WINDOW = "protection_window"
|
|
DATA_UV = "uv"
|
|
|
|
DEFAULT_ATTRIBUTION = "Data provided by OpenUV"
|
|
|
|
NOTIFICATION_ID = "openuv_notification"
|
|
NOTIFICATION_TITLE = "OpenUV Component Setup"
|
|
|
|
TOPIC_UPDATE = f"{DOMAIN}_data_update"
|
|
|
|
TYPE_CURRENT_OZONE_LEVEL = "current_ozone_level"
|
|
TYPE_CURRENT_UV_INDEX = "current_uv_index"
|
|
TYPE_CURRENT_UV_LEVEL = "current_uv_level"
|
|
TYPE_MAX_UV_INDEX = "max_uv_index"
|
|
TYPE_PROTECTION_WINDOW = "uv_protection_window"
|
|
TYPE_SAFE_EXPOSURE_TIME_1 = "safe_exposure_time_type_1"
|
|
TYPE_SAFE_EXPOSURE_TIME_2 = "safe_exposure_time_type_2"
|
|
TYPE_SAFE_EXPOSURE_TIME_3 = "safe_exposure_time_type_3"
|
|
TYPE_SAFE_EXPOSURE_TIME_4 = "safe_exposure_time_type_4"
|
|
TYPE_SAFE_EXPOSURE_TIME_5 = "safe_exposure_time_type_5"
|
|
TYPE_SAFE_EXPOSURE_TIME_6 = "safe_exposure_time_type_6"
|
|
|
|
|
|
CONFIG_SCHEMA = vol.Schema(
|
|
{
|
|
DOMAIN: vol.Schema(
|
|
{
|
|
vol.Required(CONF_API_KEY): cv.string,
|
|
vol.Optional(CONF_ELEVATION): float,
|
|
vol.Optional(CONF_LATITUDE): cv.latitude,
|
|
vol.Optional(CONF_LONGITUDE): cv.longitude,
|
|
}
|
|
)
|
|
},
|
|
extra=vol.ALLOW_EXTRA,
|
|
)
|
|
|
|
|
|
async def async_setup(hass, config):
|
|
"""Set up the OpenUV component."""
|
|
hass.data[DOMAIN] = {}
|
|
hass.data[DOMAIN][DATA_OPENUV_CLIENT] = {}
|
|
hass.data[DOMAIN][DATA_OPENUV_LISTENER] = {}
|
|
|
|
if DOMAIN not in config:
|
|
return True
|
|
|
|
conf = config[DOMAIN]
|
|
|
|
identifier = "{0}, {1}".format(
|
|
conf.get(CONF_LATITUDE, hass.config.latitude),
|
|
conf.get(CONF_LONGITUDE, hass.config.longitude),
|
|
)
|
|
if identifier in configured_instances(hass):
|
|
return True
|
|
|
|
data = {CONF_API_KEY: conf[CONF_API_KEY]}
|
|
if CONF_LATITUDE in conf:
|
|
data[CONF_LATITUDE] = conf[CONF_LATITUDE]
|
|
if CONF_LONGITUDE in conf:
|
|
data[CONF_LONGITUDE] = conf[CONF_LONGITUDE]
|
|
if CONF_ELEVATION in conf:
|
|
data[CONF_ELEVATION] = conf[CONF_ELEVATION]
|
|
|
|
hass.async_create_task(
|
|
hass.config_entries.flow.async_init(
|
|
DOMAIN, context={"source": SOURCE_IMPORT}, data=data
|
|
)
|
|
)
|
|
|
|
return True
|
|
|
|
|
|
async def async_setup_entry(hass, config_entry):
|
|
"""Set up OpenUV as config entry."""
|
|
|
|
_verify_domain_control = verify_domain_control(hass, DOMAIN)
|
|
|
|
try:
|
|
websession = aiohttp_client.async_get_clientsession(hass)
|
|
openuv = OpenUV(
|
|
Client(
|
|
config_entry.data[CONF_API_KEY],
|
|
config_entry.data.get(CONF_LATITUDE, hass.config.latitude),
|
|
config_entry.data.get(CONF_LONGITUDE, hass.config.longitude),
|
|
websession,
|
|
altitude=config_entry.data.get(CONF_ELEVATION, hass.config.elevation),
|
|
)
|
|
)
|
|
await openuv.async_update()
|
|
hass.data[DOMAIN][DATA_OPENUV_CLIENT][config_entry.entry_id] = openuv
|
|
except OpenUvError as err:
|
|
_LOGGER.error("Config entry failed: %s", err)
|
|
raise ConfigEntryNotReady
|
|
|
|
for component in ("binary_sensor", "sensor"):
|
|
hass.async_create_task(
|
|
hass.config_entries.async_forward_entry_setup(config_entry, component)
|
|
)
|
|
|
|
@_verify_domain_control
|
|
async def update_data(service):
|
|
"""Refresh all OpenUV data."""
|
|
_LOGGER.debug("Refreshing all OpenUV data")
|
|
await openuv.async_update()
|
|
async_dispatcher_send(hass, TOPIC_UPDATE)
|
|
|
|
hass.services.async_register(DOMAIN, "update_data", update_data)
|
|
|
|
@_verify_domain_control
|
|
async def update_uv_index_data(service):
|
|
"""Refresh OpenUV UV index data."""
|
|
_LOGGER.debug("Refreshing OpenUV UV index data")
|
|
await openuv.async_update_uv_index_data()
|
|
async_dispatcher_send(hass, TOPIC_UPDATE)
|
|
|
|
hass.services.async_register(DOMAIN, "update_uv_index_data", update_uv_index_data)
|
|
|
|
@_verify_domain_control
|
|
async def update_protection_data(service):
|
|
"""Refresh OpenUV protection window data."""
|
|
_LOGGER.debug("Refreshing OpenUV protection window data")
|
|
await openuv.async_update_protection_data()
|
|
async_dispatcher_send(hass, TOPIC_UPDATE)
|
|
|
|
hass.services.async_register(
|
|
DOMAIN, "update_protection_data", update_protection_data
|
|
)
|
|
|
|
return True
|
|
|
|
|
|
async def async_unload_entry(hass, config_entry):
|
|
"""Unload an OpenUV config entry."""
|
|
hass.data[DOMAIN][DATA_OPENUV_CLIENT].pop(config_entry.entry_id)
|
|
|
|
tasks = [
|
|
hass.config_entries.async_forward_entry_unload(config_entry, component)
|
|
for component in ("binary_sensor", "sensor")
|
|
]
|
|
|
|
await asyncio.gather(*tasks)
|
|
|
|
return True
|
|
|
|
|
|
async def async_migrate_entry(hass, config_entry):
|
|
"""Migrate the config entry upon new versions."""
|
|
version = config_entry.version
|
|
data = {**config_entry.data}
|
|
|
|
_LOGGER.debug("Migrating from version %s", version)
|
|
|
|
# 1 -> 2: Remove unused condition data:
|
|
if version == 1:
|
|
data.pop(CONF_BINARY_SENSORS, None)
|
|
data.pop(CONF_SENSORS, None)
|
|
version = config_entry.version = 2
|
|
hass.config_entries.async_update_entry(config_entry, data=data)
|
|
_LOGGER.debug("Migration to version %s successful", version)
|
|
|
|
return True
|
|
|
|
|
|
class OpenUV:
|
|
"""Define a generic OpenUV object."""
|
|
|
|
def __init__(self, client):
|
|
"""Initialize."""
|
|
self.client = client
|
|
self.data = {}
|
|
|
|
async def async_update_protection_data(self):
|
|
"""Update binary sensor (protection window) data."""
|
|
try:
|
|
resp = await self.client.uv_protection_window()
|
|
self.data[DATA_PROTECTION_WINDOW] = resp["result"]
|
|
except OpenUvError as err:
|
|
_LOGGER.error("Error during protection data update: %s", err)
|
|
self.data[DATA_PROTECTION_WINDOW] = {}
|
|
|
|
async def async_update_uv_index_data(self):
|
|
"""Update sensor (uv index, etc) data."""
|
|
try:
|
|
data = await self.client.uv_index()
|
|
self.data[DATA_UV] = data
|
|
except OpenUvError as err:
|
|
_LOGGER.error("Error during uv index data update: %s", err)
|
|
self.data[DATA_UV] = {}
|
|
|
|
async def async_update(self):
|
|
"""Update sensor/binary sensor data."""
|
|
tasks = [self.async_update_protection_data(), self.async_update_uv_index_data()]
|
|
await asyncio.gather(*tasks)
|
|
|
|
|
|
class OpenUvEntity(Entity):
|
|
"""Define a generic OpenUV entity."""
|
|
|
|
def __init__(self, openuv):
|
|
"""Initialize."""
|
|
self._attrs = {ATTR_ATTRIBUTION: DEFAULT_ATTRIBUTION}
|
|
self._available = True
|
|
self._name = None
|
|
self.openuv = openuv
|
|
|
|
@property
|
|
def available(self) -> bool:
|
|
"""Return True if entity is available."""
|
|
return self._available
|
|
|
|
@property
|
|
def device_state_attributes(self):
|
|
"""Return the state attributes."""
|
|
return self._attrs
|
|
|
|
@property
|
|
def name(self):
|
|
"""Return the name of the entity."""
|
|
return self._name
|