Over dit item
TTLock BLE is een integratie waarmee je TTLock-slimme sloten via Bluetooth bedient vanuit Home Assistant. Vergrendel- en ontgrendelcommando's, statusopvragingen en batterijmetingen lopen via de Bluetooth-verbinding van het slot, en de TTLock-cloud wordt tijdens de installatie slechts één keer benaderd om de slotsleutels te downloaden. Toetsenbordaanslagen, vingerafdrukscans, kaartzwaaien, mechanische sleutelomdraaiingen en automatische vergrendelingen komen binnen als Home Assistant-gebeurtenissen. Het voegt een slot, een Bluetooth-verbindingssensor, sensoren voor batterij, klokafwijking en laatst gezien, en een geluidsschakelaar toe. De positie van de grendel en het batterijniveau worden uit de advertenties van het slot gelezen zonder een verbinding te openen, en met een optie kan een permanente sessie openblijven voor snellere commando's ten koste van de batterij. Sloten kunnen worden toegevoegd door in te loggen met een TTLock-account, indien nodig met een code die per e-mail wordt verstuurd, of door handmatig een slotsleutel in te voeren zonder account.
Automatische samenvatting van de README en de code van roquerodrigo/ha-ttlock-ble, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op
Ondersteunt
Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.
Levert
- Sloten
- Schakelaars
- Sensoren
Instellen
Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.
Een slotsleutel handmatig invoeren
- MAC-adres van het slot
- AES-sleutel
- Ontgrendelsleutel
- Beheerderscode (optioneel)
- Naam (optioneel)
- Protocoltype
- Protocolversie
- Scène
- Groeps-ID
- Organisatie-ID
Ook gevraagd bij het wijzigen van de verbinding.
TTLock BLE instellen
- E-mailadres
- Wachtwoord
Ook gevraagd bij het opnieuw inloggen en het wijzigen van de verbinding.
Je TTLock-account verifiëren
- Verificatiecode
Na het instellen
- Permanente verbindingHoud een BLE-sessie open en open die opnieuw zodra de verbinding wegvalt. Uit: het slot wordt alleen verbonden om een commando uit te voeren of om records te lezen die het zelf meldt; status en batterij komen uit de advertenties, die helemaal geen sessie kosten. Aan: commando's worden direct beantwoord, ten koste van de batterij van het slot.
Teksten uit de code van roquerodrigo/ha-ttlock-ble. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.
Entiteiten
- Binaire sensorenBluetooth-verbinding
- GebeurtenissenLogboek
- SlotenSlot
- SensorenBatterij, Klokafwijking, Laatst gezien
- SchakelaarsGeluid
Probleemoplossing
- DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
Uit de README
Local control of TTLock smart locks over Bluetooth, for Home Assistant. Lock / unlock, battery level and real-time push events flow over BLE — no cloud round-trip on every operation. Built on the sibling Python SDK ttlock-ble.
- Local BLE control — lock, unlock, and state queries run over the lock's BLE link; the TTLock cloud is only contacted once at setup to download per-lock keys.
- Real-time push events — keypad presses, fingerprint reads, IC-card swipes, mechanical key turns, and auto-lock fires arrive as Home Assistant events the moment the lock emits them.
- Battery sensor — diagnostic entity refreshed by every poll and every push, no extra BLE traffic.
- Clock alignment — the lock's own clock, which stamps every operation-log record, is compared against local time once a day on a session something else already opened, and corrected when it has…
- Bluetooth discovery — a lock in range of any radio Home Assistant manages shows up on its own as a discovered device; the address and the frame header come off the advertisement, so only the keys…
- 2FA-aware config flow — handles TTLock's "new device" verification by emailing a one-time code and prompting for it.
- Works without a cloud account — a lock initialised locally can be added by entering its key directly, no TTLock account involved at any point.
- Passive state tracking — the bolt position and battery level are read from the lock's own BLE advertisements, with no connection and no battery cost. This is what catches an auto-lock or an…
Te zien in Vulpo
“Snel wisselen”-kaart, Slot-kaart, Grafiek-kaart, Apple Watch, Bedieningspaneel.Informatie
- Installaties
- 133 die analysegegevens delen
- GitHub-sterren
- 37
- Verbinding
- Werkt lokaal
- Onderhoud
- Bijgewerkt in de afgelopen 6 maanden
- Versie
- v3.10.0,
- Categorie
- Beveiliging en veiligheid, Sloten en toegang
- Soort
- Marketplace-integratie
- Vereist
- Vereist de Marketplace (HACS op 2026.10 en ouder)
- Domein
ttlock_ble- Problemen
- Probleem melden
