Integration in Home Assistant

Die DoorLine Key lässt sich über ihre offenen Schnittstellen mit Home Assistant verbinden — auf drei Wegen, die sich ergänzen und kombinieren lassen.

Weg	Zweck
Webhook je Benutzer	Home Assistant erfährt, dass ein bestimmter Benutzer Zutritt hatte, und startet eine Automation.
Externe Code-Auswertung	Home Assistant verwaltet zusätzliche Codes selbst und entscheidet über den Zutritt.
Geräte-API	Home Assistant schaltet die Relais, die Tastenbeleuchtung und den Signalgeber und fragt Zustände ab.

Voraussetzungen: ein laufendes Home-Assistant-System und eine DoorLine Key, die im selben Netzwerk erreichbar ist.

Weg 1 — Webhook je Benutzer

Damit meldet die Key jeden Zutritt an Home Assistant, ohne dass der Zutrittscode das Gerät verlässt.

In Home Assistant eine Automation mit dem Auslöser-Typ „Webhook" anlegen. Home Assistant erzeugt eine Webhook-Kennung.
In der Key unter „Einstellungen → Berechtigungen → Benutzer" beim gewünschten Benutzer die Aktion „HTTP-Request" ankreuzen und als Adresse eintragen: http://<ip-des-home-assistant>:8123/api/webhook/<webhook-kennung>
Speichern und den Zutrittscode am Tastenfeld prüfen.

Je Benutzer eine eigene Webhook-Kennung anlegen. So ist in Home Assistant unterscheidbar, welche Person Zutritt hatte.

Einzelheiten und weitere Beispiele: „HTTP-Aktionen (Webhooks)".

Weg 2 — Externe Code-Auswertung

Mit eingeschalteter externer Code-Auswertung gibt die Key jede Eingabe, die keinem lokalen Benutzer zugeordnet ist, als Ereignis über die Geräte-API weiter. Home Assistant kann diese Codes dann selbst prüfen und über den Zutritt entscheiden — zum Beispiel für Einmalcodes oder Codes mit eigenen Regeln.

Einzelheiten, Verhalten der weitergereichten Eingaben und die Sicherheitsfolgen: „Externe Code-Auswertung".

Weg 3 — Steuerung über die Geräte-API

Home Assistant kann die Key über HTTP-Kommandos steuern, zum Beispiel als rest_command. Damit lässt sich die Tür aus einer Automation, einem Dashboard oder einer Benachrichtigung heraus öffnen.

Typische Kommandos:

Zweck	Aufruf
Relais 1 für eine bestimmte Dauer einschalten	`http://doorline-key.local/api/cmd/io_out01_trigger?pin=…&duration=3000`
Relais 1 dauerhaft ein- oder ausschalten	`http://doorline-key.local/api/cmd/io_out01_set?pin=…&state=true`
Zustand des Schalteingangs abfragen	`http://doorline-key.local/api/io_in01?pin=…`
Piepton ausgeben	`http://doorline-key.local/api/cmd/hmi_beep_trigger?pin=…&duration=200`

Für Relais 2 die entsprechenden Endpunkte io_out02_trigger und io_out02_set verwenden. Die vollständige Liste steht auf der Seite „API" der Weboberfläche (siehe „REST- und WebSocket-API").

Der Parameter pin enthält das Passwort des Geräts im Klartext. Solche Aufrufe nur im lokalen Netz verwenden und die Zugangsdaten in Home Assistant als Geheimnis hinterlegen (secrets.yaml), nicht direkt in der Automation. Wer diese Adresse kennt, kann die Tür öffnen.

Anwendungsbeispiele

Anwendungsbeispiel	Umsetzung
Licht bei Zutritt in der Dunkelheit einschalten	Webhook je Benutzer als Auslöser, Bedingung „nach Sonnenuntergang", Aktion „Licht einschalten".
Anwesenheit erkennen	Webhook je Benutzer als Auslöser, Aktion „Person als anwesend markieren" — zum Beispiel um die Alarmanlage zu deaktivieren.
Benachrichtigung bei zu lange offener Tür	Reedkontakt am Schalteingang, HTTP-URLs für „geöffnet" und „geschlossen", Automation mit Wartezeit.
Tür aus der Home-Assistant-App öffnen	`rest_command` mit `io_out01_trigger`, eingebunden als Schaltfläche im Dashboard.
Einmalcode für einen Gast	Externe Code-Auswertung einschalten, Code in Home Assistant hinterlegen und nach der ersten Verwendung verwerfen.