276 lines
9.2 KiB
Python
276 lines
9.2 KiB
Python
"""Update entities for Reolink devices."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
from datetime import datetime
|
|
from typing import Any
|
|
|
|
from reolink_aio.exceptions import ReolinkError
|
|
from reolink_aio.software_version import NewSoftwareVersion
|
|
|
|
from homeassistant.components.update import (
|
|
UpdateDeviceClass,
|
|
UpdateEntity,
|
|
UpdateEntityDescription,
|
|
UpdateEntityFeature,
|
|
)
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import CALLBACK_TYPE, HomeAssistant
|
|
from homeassistant.exceptions import HomeAssistantError
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
from homeassistant.helpers.event import async_call_later
|
|
|
|
from . import ReolinkData
|
|
from .const import DOMAIN
|
|
from .entity import (
|
|
ReolinkChannelCoordinatorEntity,
|
|
ReolinkChannelEntityDescription,
|
|
ReolinkHostCoordinatorEntity,
|
|
ReolinkHostEntityDescription,
|
|
)
|
|
|
|
POLL_AFTER_INSTALL = 120
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class ReolinkUpdateEntityDescription(
|
|
UpdateEntityDescription,
|
|
ReolinkChannelEntityDescription,
|
|
):
|
|
"""A class that describes update entities."""
|
|
|
|
|
|
@dataclass(frozen=True, kw_only=True)
|
|
class ReolinkHostUpdateEntityDescription(
|
|
UpdateEntityDescription,
|
|
ReolinkHostEntityDescription,
|
|
):
|
|
"""A class that describes host update entities."""
|
|
|
|
|
|
UPDATE_ENTITIES = (
|
|
ReolinkUpdateEntityDescription(
|
|
key="firmware",
|
|
supported=lambda api, ch: api.supported(ch, "firmware"),
|
|
device_class=UpdateDeviceClass.FIRMWARE,
|
|
),
|
|
)
|
|
|
|
HOST_UPDATE_ENTITIES = (
|
|
ReolinkHostUpdateEntityDescription(
|
|
key="firmware",
|
|
supported=lambda api: api.supported(None, "firmware"),
|
|
device_class=UpdateDeviceClass.FIRMWARE,
|
|
),
|
|
)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up update entities for Reolink component."""
|
|
reolink_data: ReolinkData = hass.data[DOMAIN][config_entry.entry_id]
|
|
|
|
entities: list[ReolinkUpdateEntity | ReolinkHostUpdateEntity] = [
|
|
ReolinkUpdateEntity(reolink_data, channel, entity_description)
|
|
for entity_description in UPDATE_ENTITIES
|
|
for channel in reolink_data.host.api.channels
|
|
if entity_description.supported(reolink_data.host.api, channel)
|
|
]
|
|
entities.extend(
|
|
[
|
|
ReolinkHostUpdateEntity(reolink_data, entity_description)
|
|
for entity_description in HOST_UPDATE_ENTITIES
|
|
if entity_description.supported(reolink_data.host.api)
|
|
]
|
|
)
|
|
async_add_entities(entities)
|
|
|
|
|
|
class ReolinkUpdateEntity(
|
|
ReolinkChannelCoordinatorEntity,
|
|
UpdateEntity,
|
|
):
|
|
"""Base update entity class for Reolink IP cameras."""
|
|
|
|
entity_description: ReolinkUpdateEntityDescription
|
|
_attr_release_url = "https://reolink.com/download-center/"
|
|
|
|
def __init__(
|
|
self,
|
|
reolink_data: ReolinkData,
|
|
channel: int,
|
|
entity_description: ReolinkUpdateEntityDescription,
|
|
) -> None:
|
|
"""Initialize Reolink update entity."""
|
|
self.entity_description = entity_description
|
|
super().__init__(reolink_data, channel, reolink_data.firmware_coordinator)
|
|
self._cancel_update: CALLBACK_TYPE | None = None
|
|
|
|
@property
|
|
def installed_version(self) -> str | None:
|
|
"""Version currently in use."""
|
|
return self._host.api.camera_sw_version(self._channel)
|
|
|
|
@property
|
|
def latest_version(self) -> str | None:
|
|
"""Latest version available for install."""
|
|
new_firmware = self._host.api.firmware_update_available(self._channel)
|
|
if not new_firmware:
|
|
return self.installed_version
|
|
|
|
if isinstance(new_firmware, str):
|
|
return new_firmware
|
|
|
|
return new_firmware.version_string
|
|
|
|
@property
|
|
def supported_features(self) -> UpdateEntityFeature:
|
|
"""Flag supported features."""
|
|
supported_features = UpdateEntityFeature.INSTALL
|
|
new_firmware = self._host.api.firmware_update_available(self._channel)
|
|
if isinstance(new_firmware, NewSoftwareVersion):
|
|
supported_features |= UpdateEntityFeature.RELEASE_NOTES
|
|
return supported_features
|
|
|
|
async def async_release_notes(self) -> str | None:
|
|
"""Return the release notes."""
|
|
new_firmware = self._host.api.firmware_update_available(self._channel)
|
|
if not isinstance(new_firmware, NewSoftwareVersion):
|
|
return None
|
|
|
|
return (
|
|
"If the install button fails, download this"
|
|
f" [firmware zip file]({new_firmware.download_url})."
|
|
" Then, follow the installation guide (PDF in the zip file).\n\n"
|
|
f"## Release notes\n\n{new_firmware.release_notes}"
|
|
)
|
|
|
|
async def async_install(
|
|
self, version: str | None, backup: bool, **kwargs: Any
|
|
) -> None:
|
|
"""Install the latest firmware version."""
|
|
try:
|
|
await self._host.api.update_firmware(self._channel)
|
|
except ReolinkError as err:
|
|
raise HomeAssistantError(
|
|
f"Error trying to update Reolink firmware: {err}"
|
|
) from err
|
|
finally:
|
|
self.async_write_ha_state()
|
|
self._cancel_update = async_call_later(
|
|
self.hass, POLL_AFTER_INSTALL, self._async_update_future
|
|
)
|
|
|
|
async def _async_update_future(self, now: datetime | None = None) -> None:
|
|
"""Request update."""
|
|
await self.async_update()
|
|
|
|
async def async_added_to_hass(self) -> None:
|
|
"""Entity created."""
|
|
await super().async_added_to_hass()
|
|
self._host.firmware_ch_list.append(self._channel)
|
|
|
|
async def async_will_remove_from_hass(self) -> None:
|
|
"""Entity removed."""
|
|
await super().async_will_remove_from_hass()
|
|
if self._channel in self._host.firmware_ch_list:
|
|
self._host.firmware_ch_list.remove(self._channel)
|
|
if self._cancel_update is not None:
|
|
self._cancel_update()
|
|
|
|
|
|
class ReolinkHostUpdateEntity(
|
|
ReolinkHostCoordinatorEntity,
|
|
UpdateEntity,
|
|
):
|
|
"""Update entity class for Reolink Host."""
|
|
|
|
entity_description: ReolinkHostUpdateEntityDescription
|
|
_attr_release_url = "https://reolink.com/download-center/"
|
|
|
|
def __init__(
|
|
self,
|
|
reolink_data: ReolinkData,
|
|
entity_description: ReolinkHostUpdateEntityDescription,
|
|
) -> None:
|
|
"""Initialize Reolink update entity."""
|
|
self.entity_description = entity_description
|
|
super().__init__(reolink_data, reolink_data.firmware_coordinator)
|
|
self._cancel_update: CALLBACK_TYPE | None = None
|
|
|
|
@property
|
|
def installed_version(self) -> str | None:
|
|
"""Version currently in use."""
|
|
return self._host.api.sw_version
|
|
|
|
@property
|
|
def latest_version(self) -> str | None:
|
|
"""Latest version available for install."""
|
|
new_firmware = self._host.api.firmware_update_available()
|
|
if not new_firmware:
|
|
return self.installed_version
|
|
|
|
if isinstance(new_firmware, str):
|
|
return new_firmware
|
|
|
|
return new_firmware.version_string
|
|
|
|
@property
|
|
def supported_features(self) -> UpdateEntityFeature:
|
|
"""Flag supported features."""
|
|
supported_features = UpdateEntityFeature.INSTALL
|
|
new_firmware = self._host.api.firmware_update_available()
|
|
if isinstance(new_firmware, NewSoftwareVersion):
|
|
supported_features |= UpdateEntityFeature.RELEASE_NOTES
|
|
return supported_features
|
|
|
|
async def async_release_notes(self) -> str | None:
|
|
"""Return the release notes."""
|
|
new_firmware = self._host.api.firmware_update_available()
|
|
if not isinstance(new_firmware, NewSoftwareVersion):
|
|
return None
|
|
|
|
return (
|
|
"If the install button fails, download this"
|
|
f" [firmware zip file]({new_firmware.download_url})."
|
|
" Then, follow the installation guide (PDF in the zip file).\n\n"
|
|
f"## Release notes\n\n{new_firmware.release_notes}"
|
|
)
|
|
|
|
async def async_install(
|
|
self, version: str | None, backup: bool, **kwargs: Any
|
|
) -> None:
|
|
"""Install the latest firmware version."""
|
|
try:
|
|
await self._host.api.update_firmware()
|
|
except ReolinkError as err:
|
|
raise HomeAssistantError(
|
|
f"Error trying to update Reolink firmware: {err}"
|
|
) from err
|
|
finally:
|
|
self.async_write_ha_state()
|
|
self._cancel_update = async_call_later(
|
|
self.hass, POLL_AFTER_INSTALL, self._async_update_future
|
|
)
|
|
|
|
async def _async_update_future(self, now: datetime | None = None) -> None:
|
|
"""Request update."""
|
|
await self.async_update()
|
|
|
|
async def async_added_to_hass(self) -> None:
|
|
"""Entity created."""
|
|
await super().async_added_to_hass()
|
|
self._host.firmware_ch_list.append(None)
|
|
|
|
async def async_will_remove_from_hass(self) -> None:
|
|
"""Entity removed."""
|
|
await super().async_will_remove_from_hass()
|
|
if None in self._host.firmware_ch_list:
|
|
self._host.firmware_ch_list.remove(None)
|
|
if self._cancel_update is not None:
|
|
self._cancel_update()
|