lock.py

Go to the documentation of this file.

"""Support for Freedompro lock."""
 
import json
from typing import Any
 
from pyfreedompro import put_state
 
from homeassistant.components.lock import LockEntity
from homeassistant.config_entries import ConfigEntry
from homeassistant.const import CONF_API_KEY
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers import aiohttp_client
from homeassistant.helpers.device_registry import DeviceInfo
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.update_coordinator import CoordinatorEntity
 
from .const import DOMAIN
from .coordinator import FreedomproDataUpdateCoordinator
 
 
async def async_setup_entry(
    hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
) -> None:
    """Set up Freedompro lock."""
    api_key: str = entry.data[CONF_API_KEY]
    coordinator: FreedomproDataUpdateCoordinator = hass.data[DOMAIN][entry.entry_id]
    async_add_entities(
        Device(hass, api_key, device, coordinator)
        for device in coordinator.data
        if device["type"] == "lock"
    )
 
 
class Device(CoordinatorEntity[FreedomproDataUpdateCoordinator], LockEntity):
    """Representation of a Freedompro lock."""
 
    _attr_has_entity_name = True
    _attr_name = None
 
    def __init__(
        self,
        hass: HomeAssistant,
        api_key: str,
        device: dict[str, Any],
        coordinator: FreedomproDataUpdateCoordinator,
    ) -> None:
        """Initialize the Freedompro lock."""
        super().__init__(coordinator)
        self._hass_hass_hass = hass
        self._session_session = aiohttp_client.async_get_clientsession(self._hass_hass_hass)
        self._api_key_api_key_api_key = api_key
        self._attr_unique_id_attr_unique_id = device["uid"]
        self._type_type = device["type"]
        self._characteristics_characteristics = device["characteristics"]
        self._attr_device_info_attr_device_info = DeviceInfo(
            identifiers={
                (DOMAIN, device["uid"]),
            },
            manufacturer="Freedompro",
            model=self._type_type,
            name=device["name"],
        )
 
    @callback
    def _handle_coordinator_update(self) -> None:
        """Handle updated data from the coordinator."""
        device = next(
            (
                device
                for device in self.coordinator.data
                if device["uid"] == self.unique_idunique_id
            ),
            None,
        )
        if device is not None and "state" in device:
            state = device["state"]
            if "lock" in state:
                if state["lock"] == 1:
                    self._attr_is_locked_attr_is_locked = True
                else:
                    self._attr_is_locked_attr_is_locked = False
        super()._handle_coordinator_update()
 
    async def async_added_to_hass(self) -> None:
        """When entity is added to hass."""
        await super().async_added_to_hass()
        self._handle_coordinator_update_handle_coordinator_update()
 
    async def async_lock(self, **kwargs: Any) -> None:
        """Async function to lock the lock."""
        payload = {"lock": 1}
        await put_state(
            self._session_session,
            self._api_key_api_key_api_key,
            self.unique_idunique_id,
            json.dumps(payload),
        )
        await self.coordinator.async_request_refresh()
 
    async def async_unlock(self, **kwargs: Any) -> None:
        """Async function to unlock the lock."""
        payload = {"lock": 0}
        await put_state(
            self._session_session,
            self._api_key_api_key_api_key,
            self.unique_idunique_id,
            json.dumps(payload),
        )
        await self.coordinator.async_request_refresh()