Configuring Yale Access Bluetooth Integration

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.

One easy way to fix this is to create a new/second home in the Apple Home app and add the lock to that new home. Push updates should occur as intended after the lock is added.

Alternatively, call the homeassistant.update_entity service to force the integration to update the lock state.

1 Like

Apple-free home… hmmm.

1 Like

Disable the Yale access integration for the lock, pair it with HomeKit controller, disable the HomeKit controller integration for the lock, reenable the Yale access integration for the lock

OK, I’ll give that a try. Thanks.

With the Yale Access Bluetooth integration disabled I get this when trying to add the Homekit Controller integration

Note that I currently have the Bluetooth integration disabled, with Bluetooth only operating through esphome Bluetooth proxy

I’m in the same boat as you. Cloud integration works, but not as fast and sadly not local. The BT integration is way too slow and unreliable for me to use. I have the YRD-226, not sure if it’s home kit capable bc it doesn’t show up, even after completely removing and disabling the integration.

Yes, it’s not good.
I had a door open event take 30+ seconds to reflect through cloud the other day, and the BT integration doesn’t show it opened at all.
With Yale BT disabled nothing happens with Homekit Controller integration, it never sees anything.

I have an old Android phone that I rooted. I tried installing the Yale client and enabled auto-unlock; after leaving/returning home several times over the past couple days, the local bluetooth key is still not being stored on the device. In fact, the /data/data/com.august.luna folder is not being created.

Hey I was having the same issue as you but I finally got this to integrated into Home Assistant via just Bluetooth without entering in any account information.
(Update: after a few hours it stopped working see below)

My problem was I was using an old rooted phone with Lineage OS 19 which is Android 12. It appears that the /data/data folder is restricted even from rooted devices starting with Android 11. So it may look like the /data/data/com.august.luna folder and PeripheralInfoCache.xml file aren’t created by the Auto Unlock procedure but they are.

I used a different old rooted phone and followed the process in the Yale Lock Documentation to (finally) get the file.

Update: The first lock I had set this up on had it’s Bluetooth radio fail after 3 days and I had to return it and go through the entire process of getting the .xml and keys again. This time I found an app that works (with root) to view the /data/data/ in Lineage OS 19 and it allowed me to copy the .xml file to a folder where I could copy it to my PC. Its called Total Commander. This also meant I could use the latest version of Yale Access to generate the .xml file instead of a clunky old version.

Update 2: It looks like after a few hours (or maybe uses of the integration) the Offline Key Changes and all the integrations stop working. Home Assistant even prompted me to enter the new Key.
Sadly, after everything, I just had to set up the August Integration here which requires signing in with my Yale Account- but at least then the Yale Bluetooth Integration worked locally without the need to gather the offline key manually, use Homekit or purchase/use a Wi-fi module. Lets hope it keeps the keys up to date like the Documentation says at it stays integrated.

I purchased the Yale Assure SL in Australia this week and managed to connect it to Home Assistant quite easily. After auto unlock triggered once, I was able to add it in Home Assistant and the offline key populated automatically.

A few hours later the lock stopped working - it just became unavailable and although Home Assistant kept trying to reload it wasn’t successful.

I removed the lock thinking I would re-add and it might work again but now when I try to add through Yale Access Bluetooth I get the error “No devices found on the network”.

The lock and bluetooth receiver are both in the same location so signal shouldn’t be an issue.

Could Home Assistant be remembering the lock somewhere so won’t add it as new since it already cached the device? Or does anyone have any ideas?

Thanks in advance for your help.

I experienced this same behavior. You mentioned that the locked “auto unlocked” once. Is anyone still using the Official Yale App and/or the Bluetooth Proximity features of the Yale app on their phone or are they only using the Yale Lock in Home Assistant?

I found that if I used the official app it would constantly rotate the offline key and then Home Assistant wouldn’t be able to access it anymore. Once I uninstalled the Yale app from my phone and ONLY used Home Assistant for all functions it stopped going unavailable.

I only used the official app to do the initial setup of the Lock (i.e. initial firmware update, calibrate locking/unlocking, calibrate Doorsense, set an auto-lock timer, but I skipped the setup of the Bluetooth proximity lock as I presumed that would need the official app).

After the initial setup is done and I confirmed the lock was useable in Home Assistant I uninstalled the Yale app from my phone and all has been well. I’ll reinstall the official app every so often to do Firmware updates on the lock and it will inevitably need to be re-setup in Home Assistant shortly after.

I hid a NFC tag near my door so I can just unlock my phone and tap to unlock the lock. Not quite as convenient as Bluetooth proximity auto-unlock but it was sort of clunky anyways and, while unlikely, Bluetooth relay/repeater attacks are possible.

I do still have the Yale app on my phone and using it to auto unlock. I’ll have to do some further experimenting with my set up to see if I can get it to work.

I also suspect the bluetooth signal isn’t strong enough so might end up getting the zigbee module and using that to integrate into Home Assistant instead.

I was fiddling with my August Pro 3rd Gen and stumbled upon this thread. I am using the August Cloud integration at the moment, but my Connect device keeps disconnecting from the Wi-Fi randomly for some reason and I am hoping that Bluetooth will be more reliable (ironic I know). I currently have a Bluetooth dongle setup on my Home Assistant.

With the Bluetooth dongle setup, I was having issues getting the lock to be discovered by Home Assistant (The famous message “No devices found on the network”). I forgot I made tests in the past with a temporary Bluetooth dongle, to see how Bluetooth in Home Assistant was working prior to getting a dedicated dongle. Turns out I ignored the Yale integration once and even when it comes back up with a different dongle, well the integration doesn’t show anymore and even if you try to manually select “Yale Bluetooth” in the list, doesn’t seem to work.

So I hit “Show ignored integrations” in the filter under Settings → Devices & services at the top right of the Devices tab and lo and behold! My lock showed up and I was able to grab the offline key by reloading my already-setup August Cloud integration.

I am waiting to see if that is reliable before removing the August Cloud integration, especially with the previous posts mentioning it stopping after a few hours.

TL DR; while totally silly, I wasted hours trying to figure out why my August Pro would show up in the devices discovered, and I previously ignored the integration during tests in the past, which hid it from the list of discovered devices. Hope that can help someone in the thread!

How’s the reliability been? Also do you have “Always Connected” configured? I found usability to be much faster with that setting on. Granted it might be because I have a sub-par USB Bluetooth dongle…

Update: Thought I might as well share my own testing: Reliability when using the “Always Conencted” setting has been fantastic for me. Near instant functionality from Home Assistant.

As for battery life: When using Panasonic BK-3HCCA8BA Eneloop Pro Rechargeable batteries I was able to get very good battery life- almost 4 months even with the “Always Connected” Option configured. I don’t even let them get below 20%- I bet you could squeeze another month out of them if you let them go lower.

(Rechargeable Battery Voltage is different so they will appear to be 70% - 60% when fully charged rather than 100% and hover around 50% - 25% for much of their life).

Something to note about the Eneloop Pro batteries specifically is that they seem to be so dense that they effected my “Door Sense” calibration! If you swap between two sets of batteries like I do the batteries you might have to mix and match all 8 batteries to get two sets of 4 that actually showed the door “Closed” correctly.

Hi all.

I bought a Yale Unity Screen Door Lock yesterday and after reading some community posts, ended up doing these steps to set it up.

By the way, as the name suggests, it’s for screen door (mesh or flyscreen door) - at least it was my case!

  1. Installed the physical lock - was an easy one to one replacement for me. No drilling, cutting, hammering etc etc.
    1.1. The difficult part was being careful with top cable not be pinched by the lock parts.
  2. Inserted the batteries.
  3. Installed the Yale Home app on Android
    3.1. Made a [primary] user (as owner) and added the lock to the app.
    3.2. App started updating the lock without giving me another option.
    3.3. [Fault] It got stuck in update loop forever (from 0% to 100% over and over)
    3.4. Removed the batteries and reinstalled them - same annoying update loop behaviour.
    3.5. Found the reset button on the lock (in the upper battery box). While the batteries were in, pressed the reset button (on the physical lock) for a couple of seconds to reset.
    3.6. Opened the app again and it updated again (twice this time) and finally it started working on the app.
    3.7. Added two more users (both as owners). [Optional] Also added the provided key-tags to two of the existing accounts.
  4. Started Home Assistant Yale Access Bluetooth integration → No Device Found.
    4.1. Even though my HA Bluetooth dongle was less than 8-10 meters away from the lock it couldn’t find it.
  5. Flashed an ESP32 with Bluetooth Proxy.
    5.1. And put the proxy close to the lock (around 2-3 meters away).
    5.2. Immediately the lock popped up (auto-discover) in HA integration page. I left it as it is, since it was asking for a key.
  6. Added August integration to HA with these options:
  • Yale Home
  • user: email of one of the accounts that I added on step 3.7.
  • and also entered the password!
    6.1. Note that I didn’t install the August app (on my phone) at all. Just simply added the integration.
    6.2. Based on the HA documentations, this August integration is supposed to get the key from the lock automatically.
    6.3. Now that August integration is installed, no device or entity will pop up there. Only shows the email that I provided.
  1. Back to Yale Access Bluetooth (which was auto discovered in step 5.2.)
    7.1. This time it didn’t ask for a key - I suppose internally it talked to August integration and got the key from there.
    7.2. Finally the lock is added to HA.
    7.3. It shows a lock entity (locked/unlocked), a door open/close sensor, battery % and voltage, and signal strength.
    7.4. The same as my other lock (from another brand), unfortunately, the access log that is shown on the Yale Home app (saying who opened the door and with a tag or app etc.) is not integrated to HA.
    7.5. With my ESP32 (Wemos d1-mini-pro) which has a small onboard antenna (not that the others have any better on-board antennas), signal strength is -97dB being 2 meters away, which is awfully low. I should mention that there’s a wooden front-door between the screen door and the ESP32. But I expected more. I think the lock’s BT transmitter is very weak unfortunately. When I open the front-door (not the front-screen-door) the signal boosts +3dB which is still low.
    7.6. The lock is very responsive and quickly updates its status on HA. Even when I open/close the door physically or lock the door with physical button on the lock.
  2. I have to see if the bluetooth connection is always on or not so I could manage the lock battery. On the Yale integration (by pressing the configure button) it shows that by default it is not always connected. Which is a good news since everything is working fast.

I hope it helps someone.
If anything else happened after using it for a while, I will try to update this post.

1 Like

your post reinvigorated my will to re-attempt this.
Somewhere along the way, I made a mistake. In short, I think I signed up using August mobile app and connected with the HASS integration. I cant get the key to be passed on to the integration.
I did a fresh start tonight with yale account and yale app, then used the august integration following your steps. Voila! it worked, but then the connection was still rather hit and miss.
I followed your steps again by dusting off one of the esp32 board and turned it into bluetooth proxy, this was a surprise! sure enough as you said, i think the bluetooth signal of the lock is very weak. Luckily, I have a power outlet near the front door.
Problem solved, fingers crossed for now at least.

it is very responsive too!

Thanks heaps mate!

1 Like

I’m glad it worked for you as well.

hi all,

looking to get a yale unity security screen door lock.
just wanted to ask if I set it up once, does the security key every change , if i dont touch the yale app ever again? like when the batteries run out would the thing reset itself, then you need to pair it again manually and set it all up again for offline BT access?

I would like to get this lock set up offine only. so would it work with homekit offline?
someone was saying this device is homekit bluetooth only… so im guessing the wifi is only for initial set up.??

Just wanted to know how stable this set up will be? with the bluetooth proxy or bluetooth device?

If you never open the app, the app can’t change the key.

If you want to avoid the key being changed, create another owner account, login, operate the lock once, than use that owner account for HA after logging out on the app and switching back to the primary owner account.

They are most stable with proxies

Thank you for your help.

With esphome bluetooth proxy, is it able to get lock status updates?
ie if i manually open the lock from the inside, will this status update in home assistant??

Im located in Sweden so can not use the August app since it wont allow me to add any new devices. (Only US/Canda is allowed.)

I have the lock connect to Yale Home. HA is asking me for a 32-hex code and I cant find it anywhere. I tried extracting with iphone backup extractor but nothing ive found from there works.

Can anyone help out please?