lock.py 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133
  1. """
  2. Setup for different kinds of Tuya lock devices
  3. """
  4. from homeassistant.components.lock import LockEntity
  5. from .device import TuyaLocalDevice
  6. from .helpers.config import async_tuya_setup_platform
  7. from .helpers.device_config import TuyaEntityConfig
  8. from .helpers.mixin import TuyaLocalEntity
  9. async def async_setup_entry(hass, config_entry, async_add_entities):
  10. config = {**config_entry.data, **config_entry.options}
  11. await async_tuya_setup_platform(
  12. hass,
  13. async_add_entities,
  14. config,
  15. "lock",
  16. TuyaLocalLock,
  17. )
  18. class TuyaLocalLock(TuyaLocalEntity, LockEntity):
  19. """Representation of a Tuya Wi-Fi connected lock."""
  20. def __init__(self, device: TuyaLocalDevice, config: TuyaEntityConfig):
  21. """
  22. Initialise the lock.
  23. Args:
  24. device (TuyaLocalDevice): The device API instance.
  25. config (TuyaEntityConfig): The configuration for this entity.
  26. """
  27. super().__init__()
  28. dps_map = self._init_begin(device, config)
  29. self._lock_dp = dps_map.pop("lock", None)
  30. self._unlock_fp_dp = dps_map.pop("unlock_fingerprint", None)
  31. self._unlock_pw_dp = dps_map.pop("unlock_password", None)
  32. self._unlock_tmppw_dp = dps_map.pop("unlock_temp_pwd", None)
  33. self._unlock_dynpw_dp = dps_map.pop("unlock_dynamic_pwd", None)
  34. self._unlock_offlinepw_dp = dps_map.pop("unlock_offline_pwd", None)
  35. self._unlock_card_dp = dps_map.pop("unlock_card", None)
  36. self._unlock_app_dp = dps_map.pop("unlock_app", None)
  37. self._unlock_key_dp = dps_map.pop("unlock_key", None)
  38. self._unlock_ble_dp = dps_map.pop("unlock_ble", None)
  39. self._unlock_voice_dp = dps_map.pop("unlock_voice", None)
  40. self._req_unlock_dp = dps_map.pop("request_unlock", None)
  41. self._approve_unlock_dp = dps_map.pop("approve_unlock", None)
  42. self._req_intercom_dp = dps_map.pop("request_intercom", None)
  43. self._approve_intercom_dp = dps_map.pop("approve_intercom", None)
  44. self._jam_dp = dps_map.pop("jammed", None)
  45. self._init_end(dps_map)
  46. @property
  47. def is_locked(self):
  48. """Return the a boolean representing whether the lock is locked."""
  49. lock = None
  50. if self._lock_dp:
  51. lock = self._lock_dp.get_value(self._device)
  52. else:
  53. for d in (
  54. self._unlock_card_dp,
  55. self._unlock_dynpw_dp,
  56. self._unlock_fp_dp,
  57. self._unlock_offlinepw_dp,
  58. self._unlock_pw_dp,
  59. self._unlock_tmppw_dp,
  60. self._unlock_app_dp,
  61. self._unlock_key_dp,
  62. self._unlock_ble_dp,
  63. self._unlock_voice_dp,
  64. ):
  65. if d:
  66. if d.get_value(self._device):
  67. lock = False
  68. elif lock is None:
  69. lock = True
  70. return lock
  71. @property
  72. def is_jammed(self):
  73. if self._jam_dp:
  74. return self._jam_dp.get_value(self._device)
  75. def unlocker_id(self, dp, type):
  76. if dp:
  77. unlock = dp.get_value(self._device)
  78. if unlock:
  79. if unlock is True:
  80. return f"{type}"
  81. else:
  82. return f"{type} #{unlock}"
  83. @property
  84. def changed_by(self):
  85. for dp, desc in {
  86. self._unlock_app_dp: "App",
  87. self._unlock_ble_dp: "Bluetooth",
  88. self._unlock_card_dp: "Card",
  89. self._unlock_dynpw_dp: "Dynamic Password",
  90. self._unlock_fp_dp: "Finger",
  91. self._unlock_key_dp: "Key",
  92. self._unlock_offlinepw_dp: "Offline Password",
  93. self._unlock_pw_dp: "Password",
  94. self._unlock_tmppw_dp: "Temporary Password",
  95. self._unlock_voice_dp: "Voice",
  96. }.items():
  97. by = self.unlocker_id(dp, desc)
  98. if by:
  99. return by
  100. async def async_lock(self, **kwargs):
  101. """Lock the lock."""
  102. if self._lock_dp:
  103. await self._lock_dp.async_set_value(self._device, True)
  104. else:
  105. raise NotImplementedError()
  106. async def async_unlock(self, **kwargs):
  107. """Unlock the lock."""
  108. if self._lock_dp:
  109. await self._lock_dp.async_set_value(self._device, False)
  110. elif self._approve_unlock_dp:
  111. if self._req_unlock_dp and not self._req_unlock_dp.get_value(self._device):
  112. raise TimeoutError()
  113. await self._approve_unlock_dp.async_set_value(self._device, True)
  114. elif self._approve_intercom_dp:
  115. if self._req_intercom_dp and not self._req_intercom_dp.get_value(
  116. self._device
  117. ):
  118. raise TimeoutError()
  119. await self._approve_intercom_dp.async_set_value(self._device, True)
  120. else:
  121. raise NotImplementedError()