DoorLine Snap & Cam – Home Assistant Integration (HACS)

Die DoorLine Snap und Cam können über ein benutzerdefiniertes Repository via HACS in Home Assistant eingebunden werden:

Installation & Kopplung:

In Home Assistant HACS öffnen und über das Dreipunkt-Menü Benutzerdefinierte Repositories aufrufen.
Folgenden Repository-Link als Typ Integration hinzufügen:[https://github.com/Telegartner-Elektronik/doorlinesnap-ha](https://github.com/Telegartner-Elektronik/doorlinesnap-ha)
Die Integration herunterladen und Home Assistant bei Bedarf neu starten.
Unter Einstellungen > Geräte & Dienste > Integration hinzufügen nach DoorLine Snap suchen.
Als Host doorline-snap.local (oder die IP-Adresse) und die Geräte-PIN eingeben.
Nach erfolgreicher Kopplung stehen bis zu 22 Entitäten (Sensoren für Tastendruck, Helligkeit, System-Uptime sowie Schalter für die Relaiskontakte) bereit.

Kamerabild im Dashboard:

Zur Einbindung des Live-Bildes eine Webseite-Karte anlegen und als URL http://<IP-Adresse>/auto/full (Aktualisierung alle 2 Sekunden) hinterlegen. Alternativ über die Bildüberblick-Karte die Kamera-Entität direkt auswählen (Aktualisierung ca. alle 10 Sekunden).

Synonyme / Suchbegriffe: REST API, HTTP GET, Endpunkte, JSON, io_out, curl, Smart Home Steuerung, API Aktionen

Die DoorLine Snap / Cam nimmt eingehende HTTP-GET-Requests nach folgendem Schema entgegen:

http://<IP-Adresse>/api/<Endpoint>?pin=<PIN>&<Parameter>=<Wert>

Wichtige Steuerbefehle (Aktionen auslösen):

Relais 1 kurz anziehen (Türöffner/Gong):http://<IP>/api/cmd/io_out01_trigger?pin=<PIN>&duration=2000(Dauer in Millisekunden: 500 bis 60000)
Relais 2 dauerhaft ein-/ausschalten:Einschalten: http://<IP>/api/cmd/io_out02_set?pin=<PIN>&state=trueAusschalten: http://<IP>/api/cmd/io_out02_set?pin=<PIN>&state=false
Signalton am Gerät erzeugen (Piep):http://<IP>/api/cmd/hmi_beep_trigger?pin=<PIN>&duration=500&frequency=1200
Tastenbeleuchtung umschalten (Snap):http://<IP>/api/cmd/hmi_backlight_trigger?pin=<PIN>&duration=5000

Wichtige Abfragen (JSON-Response, HTTP 200):

.../api/io_in01?pin=<PIN>: Status Schalteingang (true = geschlossen, false = offen)
.../api/io_sensor_light?pin=<PIN>: Grober Helligkeitswert in Lux (0 bis ca. 60 Lux)
.../api/wlan_rssi?pin=<PIN>: WLAN-Empfangsstärke in dBm
.../api/sys_uptime?pin=<PIN>: System-Laufzeit in Sekunden

(Hinweis: Zwischen aufeinanderfolgenden API-Abfragen muss eine Pause von mindestens einer Sekunde eingehalten werden.)

Synonyme / Suchbegriffe: Home Assistant, HACS, Smart Home einbinden, Entitäten, Automation Klingel, Dashboard Cam