Intégration externe - Diagral e-ONE

cover-diagral

Salut tout le monde !

Série « maison à la française », épisode alarme : la Diagral e-ONE, c’est l’alarme sans fil qu’on croise dans un paquet de maisons, souvent posée par l’ancien propriétaire avec son petit boîtier dans l’entrée. Elle arrive dans Gladys, avec ses déclenchements, ses mises en marche et ses piles qui faiblissent.

Ce que ça fait

  • Un appareil « Alarme », avec :
    • l’état : Arrêt, Temporisation de sortie, Marche totale, Marche partielle, Marche présence ;
    • les groupes en marche ;
    • les anomalies en clair : piles faibles, autoprotection, défaut de liaison… ;
    • avec Gladys Plus et l’option « Alarmes en temps réel » cochée, « Alarme en cours » au moment d’un déclenchement.
  • Trois déclencheurs : « Alarme Diagral déclenchée », « Diagral mise en marche ou arrêtée » (avec qui l’a fait), « Anomalie Diagral signalée ».
  • Une action « Mettre en marche ou arrêter Diagral ».
  • Un widget : l’état, les anomalies, et les boutons Marche totale, Partielle, Présence et Arrêt (l’arrêt demande confirmation).
  • En français, anglais, allemand et espagnol.

La mise en marche depuis Gladys est désactivée par défaut : à vous de choisir dans la configuration entre rien, marche seulement, ou marche et arrêt. Et l’état n’est jamais un interrupteur : aucun assistant vocal ne peut désarmer la maison sur un malentendu.

Le truc sympa

Intrusion → toutes les lumières allumées, et un message avec le détecteur et la photo de la caméra
Le dernier occupant part → marche totale
Anomalie « piles » → « Piles à changer : détecteur du garage »

Installation

:warning: Gladys 5.1 minimum, et Gladys Plus pour les déclenchements en temps réel.

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-diagral: Diagral e-ONE alarm systems for Gladys Assistant · GitHub

  1. Il faut une alarme Diagral e-ONE (box DIAG56AAX ou centrale DIAG99AGX) et le compte de l’appli Diagral.
  2. Dans Gladys : l’e-mail et le mot de passe, le numéro de série de la box (sur l’étiquette à l’intérieur) et votre code d’accès. Choisissez ce que Gladys a le droit de faire (rien, par défaut).
  3. Pour les déclenchements en direct (Gladys Plus) : collez une clé Open API dans le bloc webhooks et cochez « Alarmes en temps réel ». Lisez bien l’avertissement juste en dessous avant de le faire.

Petites réserves honnêtes

  • Sans Gladys Plus, pas de déclenchement : le cloud Diagral n’a pas d’historique, une intrusion n’arrive que par le webhook. Sans lui, l’intégration relit l’état toutes les 5 minutes (réglable) et « Alarme en cours » reste vide plutôt que d’afficher un faux « tout va bien ».
  • Un seul webhook par box chez Diagral : si un autre logiciel (Home Assistant, Jeedom…) en a déjà inscrit un, l’option « Alarmes en temps réel » le remplace, et il ne recevra plus rien. C’est pour ça qu’elle est décochée par défaut : sans elle, l’intégration ne touche jamais au webhook existant.
  • Pas d’état des détecteurs (porte ouverte, mouvement) : l’API ne donne que leurs anomalies.
  • Développée sans l’alarme. J’ai vérifié depuis chez moi que la connexion au vrai cloud Diagral va jusqu’au bout et refuse proprement un faux compte, mais personne ne l’a encore utilisée avec un vrai compte : si vous êtes équipé d’une alarme Diagral, vos retours m’intéressent beaucoup. Le passage par Gladys Plus n’a pas été testé de bout en bout.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à Diagral ni à Hager.

Dépôt : GitHub - guim31/gladys-diagral: Diagral e-ONE alarm systems for Gladys Assistant · GitHub