Externe Integration - Diagral e-ONE

cover-diagral

Hallo zusammen!

Serie « maison à la française », Folge Alarmanlage: Die Diagral e-ONE ist die drahtlose Alarmanlage, die man in vielen Häusern findet, oft installiert vom vorherigen Besitzer mit seinem kleinen Kästchen im Eingangsbereich. Sie kommt in Gladys, mit ihren Auslösungen, ihren Einschaltvorgängen und ihren schwächer werdenden Batterien.

Was es kann

  • Ein Gerät « Alarmanlage », mit:
    • dem Status: Aus, Verzögerung beim Verlassen, Vollalarm, Teilalarm, Anwesenheitsalarm;
    • den aktiven Gruppen;
    • den klaren Anomalien: schwache Batterien, Selbstschutz, Verbindungsfehler…;
    • mit Gladys Plus und der Option « Alarme in Echtzeit » aktiviert, « Alarm aktiv » zum Zeitpunkt einer Auslösung.
  • Drei Auslöser: « Diagral-Alarm ausgelöst », « Diagral ein- oder ausgeschaltet » (mit wem), « Diagral-Anomalie gemeldet ».
  • Eine Aktion « Diagral ein- oder ausschalten ».
  • Ein Widget: der Status, die Anomalien und die Buttons Vollalarm, Teilalarm, Anwesenheitsalarm und Aus (das Ausschalten erfordert Bestätigung).
  • Auf Französisch, Englisch, Deutsch und Spanisch.

Das Einschalten von Gladys aus ist standardmäßig deaktiviert: Sie können in der Konfiguration zwischen nichts, nur Einschalten oder Ein- und Ausschalten wählen. Und der Status ist nie ein Schalter: Kein Sprachassistent kann das Haus versehentlich entwaffnen.

Der coole Teil

Einbruch → alle Lichter an, und eine Nachricht mit dem Detektor und dem Foto der Kamera
Der letzte Bewohner geht → Vollalarm
Anomalie « Batterien » → « Batterien wechseln: Garagendetektor »

Installation

:warning: Gladys 5.1 mindestens, und Gladys Plus für Echtzeit-Auslösungen.

Sie kommt im Store beim nächsten Durchlauf des Indexers. In der Zwischenzeit: Integrationen → Von GitHub installieren, mit GitHub - guim31/gladys-diagral: Diagral e-ONE alarm systems for Gladys Assistant · GitHub

  1. Sie benötigen eine Diagral e-ONE-Alarmanlage (Box DIAG56AAX oder Zentrale DIAG99AGX) und das Konto der Diagral-App.
  2. In Gladys: die E-Mail und das Passwort, die Seriennummer der Box (auf dem Etikett innen) und Ihr Zugangscode. Wählen Sie aus, was Gladys tun darf (standardmäßig nichts).
  3. Für Echtzeit-Auslösungen (Gladys Plus): Fügen Sie einen Open API-Schlüssel in den Webhook-Block ein und aktivieren Sie « Alarme in Echtzeit ». Lesen Sie die Warnung direkt darunter sorgfältig, bevor Sie dies tun.

Kleine ehrliche Vorbehalte

  • Ohne Gladys Plus keine Auslösung: Der Diagral-Cloud hat keine Historie, ein Einbruch kommt nur über den Webhook. Ohne ihn liest die Integration den Status alle 5 Minuten (einstellbar) und « Alarm aktiv » bleibt leer, anstatt ein falsches « alles in Ordnung » anzuzeigen.
  • Nur ein Webhook pro Box bei Diagral: Wenn eine andere Software (Home Assistant, Jeedom…) bereits einen registriert hat, ersetzt die Option « Alarme in Echtzeit » diesen, und sie erhält nichts mehr. Deshalb ist sie standardmäßig deaktiviert: Ohne sie greift die Integration nie den bestehenden Webhook an.
  • Kein Status der Detektoren (Tür offen, Bewegung): Die API gibt nur deren Anomalien.
  • Entwickelt ohne die Alarmanlage. Ich habe von zu Hause aus überprüft, dass die Verbindung zum echten Diagral-Cloud bis zum Ende geht und ein falsches Konto korrekt ablehnt, aber niemand hat sie noch mit einem echten Konto verwendet: Wenn Sie eine Diagral-Alarmanlage haben, interessieren mich Ihre Rückmeldungen sehr. Der Weg über Gladys Plus wurde nicht von Anfang bis Ende getestet.

Wie die vorherigen, entwickelt mit Claude Code. Unabhängiges Projekt, nicht mit Diagral oder Hager verbunden.

Repository: GitHub - guim31/gladys-diagral: Diagral e-ONE alarm systems for Gladys Assistant · GitHub