Aller au contenu principal

Intégration domotique Sector Alarm, gratuite et open source

Intégration Sector Alarm pour Gladys Assistant

Armez et désarmez votre alarme Sector Alarm, pilotez serrures et prises, suivez ses capteurs.

Cette intégration relie Gladys à votre système d'alarme Sector Alarm : armer et désarmer la centrale, verrouiller et déverrouiller les serrures connectées, allumer et éteindre les prises connectées, et suivre les capteurs (portes et fenêtres, fumée, fuites d'eau, température, humidité).

Avant de commencer​

  • Gladys 5.3 ou plus récent est nécessaire.
  • Un compte Sector Alarm : l'e-mail et le mot de passe de l'application mobile Sector Alarm.
  • Gladys doit avoir accès à Internet. Sector Alarm n'a pas d'API locale : tout passe par le cloud Sector Alarm (mypagesapi.sectoralarm.net). C'est pourquoi l'intégration porte le tag cloud.

Configuration​

ChampQue mettre
E-mailL'e-mail de votre compte Sector Alarm.
Mot de passeSon mot de passe. Gardé comme secret, jamais écrit dans les journaux.
Code de la centraleLe code tapé sur le clavier. Facultatif, voir plus bas.
Identifiant de la centraleVide pour suivre toutes les centrales du compte. Sinon un identifiant, ou plusieurs séparés par des virgules.
Intervalle de rafraîchissement (s)Fréquence de lecture de Sector Alarm. 60 s par défaut, 30 s minimum. Sector Alarm limite les requêtes : descendre sous la minute apporte peu.

Enregistrez, puis cliquez sur Tester la connexion : la réponse liste les centrales trouvées, leur mode, si elles sont en ligne et combien d'accessoires elles ont. Ouvrez ensuite l'onglet Découverte de l'intégration et créez les appareils voulus.

Le code de la centrale​

Le code sert uniquement à :

  • désarmer l'alarme depuis Gladys (une scène, la carte de l'appareil) ;
  • verrouiller ou déverrouiller une serrure connectée ;
  • armer une centrale dont l'armement rapide est désactivé.

Sans code, Gladys peut quand même tout lire et armer une centrale dont l'armement rapide est activé. Laissez-le vide si vous ne voulez pas que Gladys puisse désarmer.

Appareils​

Appareil dans GladysFonctionnalitésValeurs
Centrale (une par centrale)Mode de l'alarme (une liste : Désarmée, Partielle, Armée)disarmed, partial, armed
Serrure connectéeVerrou (pilotable), Batterie faible1 = verrouillée, 0 = déverrouillée
Prise connectéeAlimentation (pilotable)1 = allumée, 0 = éteinte
Détecteur d'ouvertureOuverture, Batterie faible1 = fermé, 0 = ouvert
Détecteur de fuméeFumée, souvent Température1 = fumée détectée
Détecteur de fuiteFuite d'eau1 = fuite détectée
Température / humiditéTempérature (°C), Humidité (%)

Le mode « partiel » n'apparaît que sur une centrale qui le permet. Chaque appareil affiche un badge cloud ; il passe à injoignable quand la centrale est hors ligne ou que Sector Alarm ne répond pas.

Gladys n'interroge pas les appareils un par un : l'intégration lit chaque centrale en entier, à l'intervalle choisi, et n'envoie à Gladys que les valeurs qui ont changé. Après un ordre, la centrale est relue quelques secondes plus tard pour le confirmer.

Widget du tableau de bord​

Ajoutez le widget Sector Alarm à un tableau de bord. Il affiche :

  • le mode de l'alarme (rouge armée, orange partielle, vert désarmée) ;
  • la connexion de la centrale ;
  • les portes et fenêtres ouvertes, les serrures déverrouillées ;
  • une alerte fumée ou fuite d'eau.

Ses boutons : Armer et Partiel (avec confirmation), Désarmer, Actualiser.

Sécurité. Un tableau de bord peut être accroché au mur, et n'importe qui peut appuyer dessus. Le bouton Désarmer n'utilise donc jamais le code de la configuration : il ouvre un petit formulaire où le code doit être tapé à chaque fois.

Avec plusieurs centrales, choisissez celle à afficher dans les réglages du widget.

Scènes​

Déclencheurs​

DéclencheurCléFiltresVariables
Le mode de l'alarme changealarm_mode_changedCentrale, Nouveau modemode, previous_mode, panel_name, user, channel
Une centrale se déconnecte ou revientpanel_connection_changedCentrale, Connexionstate (offline / online), panel_name
Une serrure connectée est actionnéelock_operatedSerrure, Ce qui s'est passéaction (lock / unlock / lock_failed), lock_name, user, channel

user et channel viennent du journal d'événements Sector Alarm (qui, et avec quoi : clavier, appli, badge…) ; ils sont vides quand le journal ne le dit pas.

Les déclencheurs partent sur les changements vus entre deux lectures, d'où qu'ils viennent (clavier, appli, badge ou Gladys). Rien ne part à la première lecture après un démarrage : l'historique n'est pas une nouveauté. Un changement qui va et vient entre deux lectures peut être manqué : baissez l'intervalle si c'est important.

Exemples :

  • Quand l'alarme est désarmée, si personne n'est à la maison, m'envoyer une notification avec {{triggerEvent.data.user}}.
  • Quand la centrale se déconnecte, envoyer un message.
  • Quand la porte d'entrée est déverrouillée, allumer la lumière de l'entrée.

Actions​

ActionCléChampsSorties
Changer le mode de l'alarmeset_alarm_modeCentrale, Modeapplied (oui/non), mode, error
Relire Sector Alarm maintenantrefresh_nowCentrale (facultatif)mode, online

set_alarm_mode utilise le code de la centrale de la configuration. Un ordre refusé n'arrête pas la scène : testez applied dans une condition, et utilisez error dans une notification. Exemple : à 23 h, armer l'alarme en partiel ; si applied vaut non, m'envoyer error.

Les actions standard de Gladys pilotent aussi les appareils : le mode de l'alarme, les serrures et les prises se règlent avec Contrôler un appareil.

Boutons de l'écran de configuration​

  • Tester la connexion : se reconnecte et lit chaque centrale.
  • Actualiser maintenant : relit Sector Alarm sans attendre.

En cas de problème​

Ce que vous voyezQue faire
« Sector Alarm refuse l'e-mail ou le mot de passe »Vérifiez-les dans l'application Sector Alarm, puis enregistrez de nouveau.
« Sector Alarm demande de ralentir »Sector Alarm limite les requêtes. L'intégration espace ses lectures, puis revient à la normale. Augmentez l'intervalle.
« Sector Alarm est injoignable »Vérifiez l'accès à Internet de Gladys.
« Le code de la centrale est nécessaire… »Renseignez le code, ou n'armez qu'avec l'armement rapide.
Un capteur manqueCliquez sur Actualiser maintenant, puis regardez l'onglet Découverte : un nouvel accessoire y apparaît.
Le mode ne bouge plus pendant une coupureC'est voulu : une centrale hors ligne se dit « armée » quoi qu'il arrive, Gladys garde donc le dernier mode connu.

Vie privée​

Votre e-mail, votre mot de passe et votre code restent dans Gladys, comme secrets, et ne sont envoyés qu'à Sector Alarm (mypagesapi.sectoralarm.net). L'intégration n'utilise aucun autre service.

Cette intégration n'est ni faite ni soutenue par Sector Alarm. Elle utilise la même API que l'application Sector Alarm, qui peut changer sans préavis.

Paramètres de configuration​

Voici les paramètres demandés par Sector Alarm dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Pour commencersectionNonSector Alarm n'a pas d'API locale : l'intégration passe par le cloud Sector Alarm avec le compte de l'application Sector Alarm. Renseignez son e-mail et son mot de passe ; les centrales, serrures, prises et capteurs du compte apparaissent ensuite dans la Découverte. Le code de la centrale ne sert qu'à désarmer, à piloter les serrures, et à armer une centrale dont l'armement rapide est désactivé.
E-mailstringOuiL'e-mail avec lequel vous vous connectez à l'application Sector Alarm.
Mot de passesecretOuiLe mot de passe de ce compte Sector Alarm. Il n'est jamais écrit dans les journaux.
Code de la centralesecretNonLe code que vous tapez sur le clavier. Nécessaire pour désarmer depuis Gladys, verrouiller ou déverrouiller une porte, et armer une centrale dont l'armement rapide est désactivé. Laissé vide, Gladys peut seulement armer (avec l'armement rapide). Le widget du tableau de bord ne s'en sert jamais pour désarmer : il demande le code à chaque fois.
Identifiant de la centralestringNonLaissez vide pour suivre toutes les centrales du compte. Pour n'en suivre que certaines, tapez leurs identifiants séparés par des virgules : « Tester la connexion » les liste.
Intervalle de rafraîchissement (s)numberNonFréquence de lecture du cloud Sector Alarm, en secondes (30 minimum). Sector Alarm limite le nombre de requêtes : descendre sous la minute apporte peu et risque un ralentissement.

Comment installer Sector Alarm dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Sector Alarm apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/prohand/gladys-sectoralarm:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-sectoralarm.

Sector Alarm nécessite Gladys >=5.3.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Sector Alarm est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par prohand, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂