[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