[Modul] Tedee Smart Locks über Tedee Bridge – TedeeBridge / TedeeDevice

[50watt]

Ich habe ein FHEM-Modul zur lokalen Einbindung von Tedee Smart Locks über die Tedee Bridge erstellt und möchte es hier zum Testen zur Verfügung stellen.

Module

73_TedeeBridge.pm
74_TedeeDevice.pm

Aktuelle Version: v0.7.29

Die Kommunikation mit dem Schloss erfolgt über die lokale API der Tedee Bridge. Für die grundlegende Steuerung ist daher keine Tedee-Cloud-Kommunikation durch FHEM erforderlich.

Optional kann zusätzlich ein Tedee PersonalKey verwendet werden, um Activity-Informationen wie letzte Aktion, Benutzer und Zeitpunkt abzurufen.

Funktionen

- Bridge-Erkennung und Statusüberwachung
- Erkennung der an der Bridge registrierten Tedee-Geräte und automatische Anlage der TedeeDevice-Devices
- Statusabfrage des Schlosses
- lock / unlock / unlatch
- Callback-Unterstützung für Statusänderungen
- Batterie-, Firmware-, RSSI- und Verbindungsinformationen
- optional Activity-Daten über die Tedee Cloud
- englische und deutsche Commandref
- Installation und Updates über den FHEM-update-Mechanismus

Voraussetzungen

- Tedee Smart Lock
- Tedee Bridge mit aktivierter lokaler Bridge API
- Netzwerkverbindung zwischen FHEM und Bridge
- Perl 5.14 oder neuer

Auf einer normalen FHEM-Installation sollten keine zusätzlichen CPAN-Module erforderlich sein.

Installation

In der FHEM-Kommandozeile:

Code Auswählen Erweitern

update add https://raw.githubusercontent.com/50watt/fhem-tedee/main/controls_tedee.txt
update all
shutdown restart

Danach z.B.:

Code Auswählen Erweitern

define tedeeBridge1 TedeeBridge <IP-DER-BRIDGE>
set tedeeBridge1 token <LOCAL_BRIDGE_TOKEN>

Das weitere Setup erfolgt weitgehend automatisch.

Quellcode und Dokumentation

https://github.com/50watt/fhem-tedee

Teststatus

Das Modul läuft bei mir produktiv mit einer Tedee Bridge und einem Tedee Lock.

Die Unterstützung mehrerer Locks ist im Modul vorgesehen, wurde von mir mangels weiterer Geräte bisher aber nicht getestet.

Die Modulstruktur mit getrenntem Bridge- und Device-Modul ist an die bewährte Struktur der FHEM-Nuki-Module angelehnt. Die Implementierung der Tedee-Kommunikation wurde jedoch speziell für die Tedee Bridge API entwickelt.

Das Modul ist mit Unterstützung von KI entstanden. KI wurde insbesondere bei Implementierung, Refactoring und Dokumentation eingesetzt. Die Funktionalität wurde anschließend auf meiner FHEM-Installation mit realer Tedee-Hardware getestet.

Fehlerberichte und Verbesserungsvorschläge gerne hier im Thread oder über GitHub.

Viele Grüße
50watt

[OliS.]

Danke für das Modul. Funktioniert soweit alles.

Allerdings scheint es nicht möglich zu sein, ein Schloss lediglich aufzuschließen, ohne die Falle zu ziehen. Ich weiß, dass die API verschiedene Unlock Modes anbietet.
Mode 3 -> aufschließen
Mode 4 -> Falle ziehen

LG
Oli

[50watt]

Hallo Oli,

danke fürs Testen und für die Rückmeldung.

Ich denke, das Verhalten hängt mit der Konfiguration der Pull-Spring-/Türfallen-Funktion in der Tedee-App zusammen und nicht damit, dass die API grundsätzlich kein reines Aufschließen unterstützt.

Tedee unterscheidet tatsächlich zwischen normalem Entriegeln und dem zusätzlichen Ziehen der Falle. In der Tedee-Dokumentation wird das ausdrücklich beschrieben:

An Unlock-only widget never pulls the spring — whether it is used to unlock from a locked state or used on an already unlocked smart lock.

Quelle:
https://tedee.com/knowledge-base/mobile-widgets-android/

Umgekehrt beschreibt Tedee ,,Unlock and Pull" so:

When a widget is set up to Unlock and Pull, it unlocks and pulls a locked smart lock, or pulls the spring on an already unlocked smart lock.

Auch in der allgemeinen Dokumentation zur Pull-Spring-Funktion wird erklärt, dass diese separat in den Einstellungen des Schlosses aktiviert und konfiguriert wird:

The pull spring feature is enabled in your lock settings.

Quelle:
https://tedee.com/enau/knowledge-base/pull-spring/

Bei meinem Schloss ist in der Tedee-App die Option ,,Türfalle automatisch ziehen" deaktiviert. Damit kann ich die beiden Aktionen getrennt ausführen:

- unlock → Schloss nur aufsperren
- unlatch → Falle ziehen / Tür öffnen

Das entspricht auch der von dir genannten API-Unterscheidung zwischen Mode 3 und Mode 4.

Kannst du bitte prüfen, wie bei dir unter den Schloss-Einstellungen → Türfalle/Pull Spring insbesondere ,,Türfalle automatisch ziehen" konfiguriert ist?

Falls bei deaktiviertem automatischem Ziehen der Falle `set <device> unlock` trotzdem die Falle zieht, wäre das tatsächlich etwas, das wir uns im Modul bzw. beim an die Bridge gesendeten Unlock-Mode genauer ansehen sollten.

LG
50watt