Add August Bluetooth as a supported brand of Yale Access Bluetooth (#23732)

Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
J. Nick Koston 2022-08-15 07:55:21 -10:00 committed by GitHub
parent e9a1544d09
commit 4655ce3d64
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 50 additions and 10 deletions

View File

@ -0,0 +1,28 @@
---
title: August Bluetooth
description: Instructions on how to integrate August Bluetooth locks into Home Assistant.
ha_category:
- Binary Sensor
- Lock
- Sensor
ha_bluetooth: true
ha_release: 2022.9
ha_iot_class: Local Push
ha_codeowners:
- '@bdraco'
ha_domain: august_ble
ha_config_flow: true
ha_platforms:
- binary_sensor
- lock
- sensor
ha_integration_type: integration
ha_supporting_domain: yalexs_ble
ha_supporting_integration: Yale Access Bluetooth
---
Integrates [August](https://august.com/) locks over Bluetooth into Home Assistant.
Following Assa Abloy, Yale's parent company, purchasing August in 2017, most newer devices use the Yale Access branding.
{% include integrations/supported_brand.md %}

View File

@ -29,17 +29,20 @@ Devices must have a Yale Access module installed to function with this integrati
## Supported devices
- YRD216
- YRL216
- YRD226
- YRL226
- YRD256
- YRD216 (Yale Assure Lock Keypad with Physical Key)
- YRL216 (Yale Assure Door Lever Lock with Push Button Keypad)
- YRD226 (Yale Assure Lock Touchscreen Deadbolt with Physical Key)
- YRL226 (Yale Assure Door Lever Lock Keypad)
- YRD256 (Yale Assure Lock Keypad)
- ASL-05 (August WiFi Smart Lock - Gen 4)
- ASL-03 (August Smart Lock Pro - Gen 3)
- ASL-02 (August Smart Lock Pro - Gen 2)
## Limited support devices
These devices do not send updates, but can be locked and unlocked.
- Conexis L1
- MD-04I (Yale Conexis L1)
## Push updates
@ -51,17 +54,26 @@ Alternatively, call the `homeassistant.update_entity` service to force the integ
The lock must be calibrated in the Yale Access App for the door sensors to function correctly. If the door sensor has an unknown state or is not updating, try recalibrating the lock in the app.
## 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 offline key and slot number are required to operate the lock. These credentials can be found in multiple places depending on the lock brand and model.
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.
### Yale Access or August Cloud
### iOS
The [August](/integrations/august) integration will automatically provision the offline key if the configured account has the key loaded. You may need to create or use a non-primary existing account with owner-level access to the lock, as not all accounts will have the key loaded.
Most Yale branded locks can use the August cloud to obtain the keys. Accessing the August cloud to receive the key may not work unless the lock was purchased in a market that sells under both brands.
### iOS - Yale Access App or August App
The iOS app will only save the offline key to your device's filesystem if Auto-Unlock has been enabled and used at least once. Auto-Unlock can be disabled once the key has been loaded.
- 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
### Android - Yale Access App or August App
The Android app will only save the offline key to your device's filesystem if Auto-Unlock has been enabled and used at least once. Auto-Unlock can be disabled once the key has been loaded.
Root access is required to read the `key` and `slot` stored in `/data/data/com.august.luna/shared_prefs/PeripheralInfoCache.xml`