Security & safety

TTLock

jbergler/hass-ttlock · vv0.17.1

HACSCloud polling

Home Assistant integration for TTLock locks

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`switch`	Switch or outlet
`lock`	Lock	Needs its own HomeKit Bridge in accessory mode
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)

1 report below say how a device from this integration behaves in the Home app.

What people report

TTLock-compatible locks from many brands work via the TTLock cloud, with newer Bluetooth local reads. HomeKit lock-operator info did not surface in Apple Home.

Works8

Device	In Home Assistant	In Apple Home	What they said	Source
Catchface, Raykube, Simpled locks	Works Cloud		Listed as supported Saved copy Supported devices: Catchface Smart Lock; Cielsa Dawn Fingerprint Digital Doorknob; E-Lok 9 series; Raykube locks; Simpled locks; TOTOWISER locks; YRHAND locks. Excerpt saved from the README on 2026-10-23.	README
Cielsa Dawn Fingerprint Digital Doorknob	Works Cloud		Works with some load bugs Saved copy Supported devices: Catchface Smart Lock; Cielsa Dawn Fingerprint Digital Doorknob; E-Lok 9 series; Raykube locks; Simpled locks; TOTOWISER locks; YRHAND locks. Excerpt saved from the README on 2026-10-23.	README
E-Lok 9 series	Works Cloud		Listed as supported Saved copy Supported devices: Catchface Smart Lock; Cielsa Dawn Fingerprint Digital Doorknob; E-Lok 9 series; Raykube locks; Simpled locks; TOTOWISER locks; YRHAND locks. Excerpt saved from the README on 2026-10-23.	README
TOTOWISER fingerprint lock	Works Cloud		Installs easily Saved copy Supported devices: Catchface Smart Lock; Cielsa Dawn Fingerprint Digital Doorknob; E-Lok 9 series; Raykube locks; Simpled locks; TOTOWISER locks; YRHAND locks. Excerpt saved from the README on 2026-10-23.	README
TTLock Bluetooth locks	Works Local		Lock state read locally over BLE with cloud fallback Saved copy … from discussion #325. Stacked on #331 (`ble_protocol.py`), the diff shows both commits until #331 lands; only `254fad7` is new here. ## What A lock in Bluetooth range now answers the coordinator's fast tier locally. `QUERY_LOCK_STATUS` returns lock, battery and door state, is encrypted with the AES key `lock/detail` already returns, and needs no authenticated session. The cloud path is untouched and remains the fallback whenever the local read isn't possible: bluetooth not set up, lock not heard, credentials unusable, connect/write failure, or no reply. - `ble.py`: … Excerpt saved from GitHub on 2026-10-23.	PR #332 · 2026-09
TTLock exposed to HomeKit	Works Cloud	Partly in Home Last operator and trigger not shown in Home app	Locks update in HA; lock/unlock events shown in HomeKit Saved copy I have connected my ttlock device to ha using this integration perfectly all the settings are complete and webhook url is working fine. I exposed my lock to homekit. Now when i unlock the door i see last operator and last trigger in ha ui i also get the door has been locked unlocked in homekit but it wont show me the name of how unlocked the door in the iphone like it does in ha. I have both sensors exposed to homekit but i cant find them anywhere. Any help. Excerpt saved from GitHub on 2026-10-23.	Discussion #110 · 2024-05
TTLock SN9182-B_PV53	Works Cloud		Remote unlock must be enabled in TTLock app Saved copy Describe the bug I installed a new ttlock compatible lock, when I click on unlocked I have an error pop up. Failed to call service lock/unlock. API returned: errorcode': -4043, 'errmsg': The function is not supported for this lock: Unlock: give me the error and the popup and not unlock Lock: No error, no popup and work after 3-4 seconds SN9182-B_PV53 ### To Reproduce Steps to reproduce the behavior: 1. Go to entitie lock.porte_avant 2. Click on unlock 3. See error: Failed to call service lock/unlock. API returned: errorcode': -4043, 'errmsg': The function is not supported for this lock: I … Excerpt saved from GitHub on 2026-10-23.	Issue #46 · 2023-05
YRHAND DQ lock	Works Cloud		Unlocks within 1-2 seconds with G2 gateway Saved copy Lock sold as: Brand: YRHAND Model: DQ In TTLock App: Lock Number: RXDQ_39883c In Home Assistant integration under device info: SN417-T2_PV53 I'm using the G2 Gateway I can unlock it through home assistant (works almost instantly with only a 1-2 second delay). However, I do not get a status (which would be very useful because I could automatically turn on the lights as soon as somebody unlocks the door). Not sure if I don't see the status/history because I couldn't completely follow the installation instructions: I got stuck on the last two step. (Once the integration is working, go to System … Excerpt saved from GitHub on 2026-10-23.	Issue #1 · 2023-04

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Cloud polling

Goes through the maker’s cloud, asking it for updates every so often. Needs the internet and an account.

Details

Installs (analytics)	1,339 (0.19%)
GitHub stars	157
Latest version	v0.17.1 (2026-10-22)
Set up in the UI	Yes
Maintainers	@jbergler
License	MIT

Devices listed in its README

Catchface Smart Lock
Cielsa Dawn Fingerprint Digital Doorknob
E-Lok 9 series
Raykube locks
Simpled locks
TOTOWISER locks
YRHAND locks

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/jbergler/hass-ttlock
Source code: https://github.com/jbergler/hass-ttlock
Issues: https://github.com/jbergler/hass-ttlock/issues
HACS: https://hacs.xyz