mirror of
https://github.com/home-assistant/core
synced 2024-09-03 08:14:07 +02:00
68 lines
2.2 KiB
Python
68 lines
2.2 KiB
Python
"""Support for AVM FRITZ!Box update platform."""
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
from typing import Any
|
|
|
|
from homeassistant.components.update import UpdateEntity, UpdateEntityFeature
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from .common import AvmWrapper, FritzBoxBaseEntity
|
|
from .const import DOMAIN
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
|
|
) -> None:
|
|
"""Set up AVM FRITZ!Box update entities."""
|
|
_LOGGER.debug("Setting up AVM FRITZ!Box update entities")
|
|
avm_wrapper: AvmWrapper = hass.data[DOMAIN][entry.entry_id]
|
|
|
|
entities = [FritzBoxUpdateEntity(avm_wrapper, entry.title)]
|
|
|
|
async_add_entities(entities)
|
|
|
|
|
|
class FritzBoxUpdateEntity(FritzBoxBaseEntity, UpdateEntity):
|
|
"""Mixin for update entity specific attributes."""
|
|
|
|
_attr_supported_features = UpdateEntityFeature.INSTALL
|
|
_attr_title = "FRITZ!OS"
|
|
|
|
def __init__(
|
|
self,
|
|
avm_wrapper: AvmWrapper,
|
|
device_friendly_name: str,
|
|
) -> None:
|
|
"""Init FRITZ!Box connectivity class."""
|
|
self._attr_name = f"{device_friendly_name} FRITZ!OS"
|
|
self._attr_unique_id = f"{avm_wrapper.unique_id}-update"
|
|
super().__init__(avm_wrapper, device_friendly_name)
|
|
|
|
@property
|
|
def installed_version(self) -> str | None:
|
|
"""Version currently in use."""
|
|
return self._avm_wrapper.current_firmware
|
|
|
|
@property
|
|
def latest_version(self) -> str | None:
|
|
"""Latest version available for install."""
|
|
if self._avm_wrapper.update_available:
|
|
return self._avm_wrapper.latest_firmware
|
|
return self._avm_wrapper.current_firmware
|
|
|
|
@property
|
|
def release_url(self) -> str | None:
|
|
"""URL to the full release notes of the latest version available."""
|
|
return self._avm_wrapper.release_url
|
|
|
|
async def async_install(
|
|
self, version: str | None, backup: bool, **kwargs: Any
|
|
) -> None:
|
|
"""Install an update."""
|
|
await self._avm_wrapper.async_trigger_firmware_update()
|