Add your Yeelock to Home Assistant locally with BLE.
- Lock & Unlock anytime, you don't need your phone to be within range of your lock anymore
- Automatic re-lock, can re-lock automatically after a few seconds
- Works offline, operates locally using BLE with push notifications
- Supports Remote Adapters ("Bluetooth Proxies"), to extend range of your Yeelock
| Locked | Unlocked |
|---|---|
- It is strongly recommended to save the QR code somewhere safe.
- If you lose the QR Code that came with your Yeelock, you will never be able to set-up your Yeelock in the app again.
- If you lose your Yeelock account details, or otherwise have issues with your Yeelock account, and you do not have your QR Code, you should assume that you will never be able to control your device again. You may be able to contact support to transfer your device over to another account but I would not count on it.
- Assume that if the QR code was lost that your device may become worthless.
You Home Assistant installation will need at least one Bluetooth adapter. Your Yeelock should be within range of your Bluetooth adapter as this integration relies on Bluetooth.
If your Yeelock is not without reach of your Bluetooth adapter, Remote Adapters (such as ESPHome's Bluetooth Proxy) are supported and can extend the range of your Yeelock greatly.
- Yeelock Cabinet Lock E (Orange Stripe) / 易锁宝蓝牙抽屉柜锁E (Model: M02)
Possibly others - let me know if you find one that works.
- Install HACS, if you did not already
- Install the Yeelock integration
- Restart Home Assistant
Copy all files in the custom_components/yeelock folder to your Home Assistant folder config/custom_components/yeelock.
- Setup your Yeelock first in the Yeelock app. You will need the QR code that came in the box to do this.
- Once the integration is installed & you have restarted Home Assistant, your Yeelock will be detected & shown automatically on the
Devices and servicespage. - You will need to input your email (login) and Yeelock account password.
- To use the automatic re-lock, tap the button underneath the lock / unlock toggle.
- Signing in to this integration may sign you out of the Yeelock app automatically. We have no control over this, so you may need to sign back in to the Yeelock app afterwards. You can continue to also use the Yeelock app if you would prefer, too.
- Autodiscovery did not work and
No devices found on the networkafter trying to manually add integration, when using ESPHome proxy: make sure that you don't haveactive: false(defaults totrue) underesp32_ble_trackersection. Passive scanning doesn't detect device names (so autodiscovery won't work), but also connecting to lock will not be possible.
Your support is welcomed.
- Add battery level sensor
- Add option to unlock automatically if battery gets too low
- aso824/yeehack, who provided a sample Python framework for communicating with the Yeelock device
- jdobosz and his post in this thread, for documenting how the Yeelock protocol works
- cnrd/yeelock, for general observations on the Yeelock protocol packets