Add Yale Access Bluetooth integration (#23641)

This commit is contained in:
J. Nick Koston 2022-08-10 11:24:42 -10:00 committed by GitHub
parent e6f5e59310
commit b173d36740
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -0,0 +1,59 @@
---
title: Yale Access Bluetooth
description: Instructions on how to integrate Yale Access Bluetooth devices into Home Assistant.
ha_category:
- Lock
ha_bluetooth: true
ha_release: 2022.9
ha_iot_class: Local Push
ha_codeowners:
- '@bdraco'
ha_domain: yalexs_ble
ha_config_flow: true
ha_platforms:
- lock
ha_integration_type: integration
---
Integrates [Yale Access](https://www.yalehome.com/us/en/products/smart-technology/yale-access) Bluetooth devices into Home Assistant.
{% include integrations/config_flow.md %}
The Yale Access Bluetooth integration will automatically discover devices once the [Bluetooth](/integrations/bluetooth) integration is enabled and functional.
Devices must have a Yale Access module installed to function with this integration if one is not already built-in.
## Supported devices
- YRD216
- YRL216
- YRD226
- YRL226
- YRD256
## Limited support devices
These devices do not send updates, but can be locked and unlocked.
- Conexis L1
## Push updates
Some locks only send push updates when they have an active HomeKit pairing. If your lock is not sending push updates, ensure it's paired with a HomeKit using an iOS device or the HomeKit controller integration. The lock cannot be paired via HomeKit Controller and the Yale Access Bluetooth integration on the same Home Assistant instance as they will both try to access the lock simultaneously and fail.
Alternatively, call the `homeassistant.update_entity` service to force the integration to update the lock state.
## Obtaining the offline key
The offline key and slot number are required to operate the lock. These credentials reside in the Yale Access app storage on iOS or Android devices with owner access to the lock.
The Yale Access app will only save the offline key to your device's filesystem if AutoUnlock has been enabled and used at least once.
### iOS
- Using [iMazing](https://imazing.com/) or [iPhone Backup Extractor](https://www.iphonebackupextractor.com/), find the backup files for the Yale Access app.
- Look in the `Library/Preferences` `.plist` files for the Yale Access app and find the one with the value of `key` and `slot` using `Xcode` or any binary `plist` viewer.
### Android
Root access is required to read the `key` and `slot` stored in `/data/data/com.august.luna/shared_prefs/PeripheralInfoCache.xml`