Home Assistant Unofficial Reference 2024.12.1
lock.py
Go to the documentation of this file.
1 """Support for deCONZ locks."""
2 
3 from __future__ import annotations
4 
5 from typing import Any
6 
7 from pydeconz.models.event import EventType
8 from pydeconz.models.light.lock import Lock
9 from pydeconz.models.sensor.door_lock import DoorLock
10 
11 from homeassistant.components.lock import DOMAIN as LOCK_DOMAIN, LockEntity
12 from homeassistant.config_entries import ConfigEntry
13 from homeassistant.core import HomeAssistant, callback
14 from homeassistant.helpers.entity_platform import AddEntitiesCallback
15 
16 from .entity import DeconzDevice
17 from .hub import DeconzHub
18 
19 
21  hass: HomeAssistant,
22  config_entry: ConfigEntry,
23  async_add_entities: AddEntitiesCallback,
24 ) -> None:
25  """Set up locks for deCONZ component."""
26  hub = DeconzHub.get_hub(hass, config_entry)
27  hub.entities[LOCK_DOMAIN] = set()
28 
29  @callback
30  def async_add_lock_from_light(_: EventType, lock_id: str) -> None:
31  """Add lock from deCONZ."""
32  lock = hub.api.lights.locks[lock_id]
33  async_add_entities([DeconzLock(lock, hub)])
34 
35  hub.register_platform_add_device_callback(
36  async_add_lock_from_light,
37  hub.api.lights.locks,
38  )
39 
40  @callback
41  def async_add_lock_from_sensor(_: EventType, lock_id: str) -> None:
42  """Add lock from deCONZ."""
43  lock = hub.api.sensors.door_lock[lock_id]
44  async_add_entities([DeconzLock(lock, hub)])
45 
46  hub.register_platform_add_device_callback(
47  async_add_lock_from_sensor,
48  hub.api.sensors.door_lock,
49  always_ignore_clip_sensors=True,
50  )
51 
52 
53 class DeconzLock(DeconzDevice[DoorLock | Lock], LockEntity):
54  """Representation of a deCONZ lock."""
55 
56  TYPE = LOCK_DOMAIN
57 
58  @property
59  def is_locked(self) -> bool:
60  """Return true if lock is on."""
61  return self._device.is_locked
62 
63  async def async_lock(self, **kwargs: Any) -> None:
64  """Lock the lock."""
65  if isinstance(self._device, DoorLock):
66  await self.hub.api.sensors.door_lock.set_config(
67  id=self._device.resource_id,
68  lock=True,
69  )
70  else:
71  await self.hub.api.lights.locks.set_state(
72  id=self._device.resource_id,
73  lock=True,
74  )
75 
76  async def async_unlock(self, **kwargs: Any) -> None:
77  """Unlock the lock."""
78  if isinstance(self._device, DoorLock):
79  await self.hub.api.sensors.door_lock.set_config(
80  id=self._device.resource_id,
81  lock=False,
82  )
83  else:
84  await self.hub.api.lights.locks.set_state(
85  id=self._device.resource_id,
86  lock=False,
87  )
None async_unlock(self, **Any kwargs)
Definition: lock.py:76
None async_lock(self, **Any kwargs)
Definition: lock.py:63
None async_setup_entry(HomeAssistant hass, ConfigEntry config_entry, AddEntitiesCallback async_add_entities)
Definition: lock.py:24