Intégration domotique Somfy Protect, gratuite et open source
Pilotez votre alarme Somfy Protect et suivez capteurs, caméras et alertes dans Gladys.
Publiée par prohand
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez votre alarme Somfy Protect depuis Gladys : activez-la, désactivez-la, voyez ce que remontent ses détecteurs et caméras, et réagissez aux alarmes dans vos scènes.
Somfy Protect est un service cloud : l'intégration parle aux serveurs Somfy, exactement comme l'application Somfy Protect. Une connexion Internet est nécessaire, Somfy ne propose pas d'accès local.
Ce que vous obtenez
| Dans Somfy Protect | Dans Gladys |
|---|---|
| Chaque site (système d'alarme) | Un appareil « Somfy Protect site » : niveau de sécurité + alarme en cours |
| Détecteur de mouvement | Mouvement (1 pendant 30 s à chaque détection), pile, température |
| IntelliTag | Détection (1 pendant 30 s), pile, température |
| Badge | Présence (1 = à la maison), pile |
| Détecteur de fumée | Fumée, pile |
| Caméra intérieure, Somfy One | Image de la caméra, interrupteur « Caméra active » (cache) |
| Serrure | Verrou (1 = verrouillé) |
| Visiophone | Sonnette |
| Sirène, Link, répéteur | Pile, température, arrachement, quand l'appareil les remonte |
Le niveau de sécurité est une liste à trois choix, affichés en anglais par Gladys : Disarmed (désactivée), Partial (partielle) et Armed (totale). Le changer dans Gladys le change dans Somfy Protect.
Chaque appareil porte un badge Cloud. Il passe à Injoignable quand le cloud Somfy ne répond pas, ou quand le Link a perdu le contact avec l'appareil. Le badge du site prend un point orange quand les événements en temps réel sont coupés.
Installation
- Dans Gladys, ouvrez Intégrations, cherchez Somfy Protect et installez-la.
- Dans l'écran Configuration, saisissez l'e-mail et le mot de passe de votre compte Somfy Protect, puis enregistrez.
- Appuyez sur Tester la connexion : vos sites et appareils s'affichent.
- Ouvrez l'onglet Découverte et créez les appareils voulus.
Conseil : créez un utilisateur dédié dans l'application Somfy Protect (Réglages, Utilisateurs) pour Gladys. Votre propre compte reste privé, et vous pouvez supprimer cet utilisateur à tout moment.
Réglages
| Réglage | Par défaut | Rôle |
|---|---|---|
| Intervalle de rafraîchissement (s) | 120 | Fréquence de lecture des piles, températures et états (60 à 3600) |
| Événements en temps réel | activé | Alarmes, changements de niveau et détections arrivent en une seconde. Requis par les déclencheurs |
| Intervalle des captures caméra (s) | 0 | Envoie une image des caméras toutes les N secondes. 0 = seulement sur demande |
| Journaux détaillés (debug) | désactivé | Journalise chaque requête et événement, pour diagnostiquer un problème |
Scènes
Déclencheurs
- Alarme Somfy Protect déclenchée : alarme intrusion, panique ou incendie. Filtrez sur le site et le type. Variables : nom du site, type, nom de l'appareil qui a détecté.
- Alarme Somfy Protect terminée : l'alarme s'est arrêtée.
- Niveau de sécurité Somfy Protect modifié : filtrez sur le nouveau niveau.
Les états des appareils (mouvement, présence, fumée, niveau de sécurité...) fonctionnent aussi avec le déclencheur standard État d'un appareil.
Actions
- Changer le niveau de sécurité Somfy Protect
- Arrêter l'alarme Somfy Protect
- Ouvrir ou fermer le cache d'une caméra
- Prendre une photo avec une caméra Somfy Protect : placez-la avant l'action Envoyer l'image d'une caméra pour recevoir une image récente.
Exemple : « quand l'alarme se déclenche, prendre une photo avec la caméra du salon, puis me l'envoyer ».
Widget du tableau de bord
Ajoutez le widget Alarme Somfy Protect à un tableau de bord. Il affiche le niveau de sécurité, l'alarme, les appareils injoignables ou à pile faible, et des boutons pour activer le site.
Les boutons Désactiver et Arrêter l'alarme n'apparaissent que si le réglage du widget Autoriser la désactivation est coché. Laissez-le décoché sur un tableau de bord accessible à tous (une tablette dans l'entrée, par exemple). Chaque bouton demande une confirmation.
Dépannage
- « Somfy Protect a refusé le compte » : vérifiez d'abord l'e-mail et le mot de passe dans l'application Somfy Protect.
- « Somfy Protect limite les requêtes » : Somfy bloque les comptes qui se connectent trop souvent. Attendez le nombre de secondes indiqué, l'intégration réessaie seule. Évitez d'enregistrer la configuration plusieurs fois de suite.
- Pas d'événements en temps réel : vérifiez que le conteneur peut joindre
websocket.myfox.iosur le port 443. Les états se rafraîchissent quand même à l'intervalle choisi. - Pas d'image de caméra : le cache de la caméra est fermé, ou la caméra est hors ligne.
- Activez les Journaux détaillés, reproduisez le problème, puis lisez les logs de l'intégration. Mots de passe et jetons n'y sont jamais écrits.
Vie privée et sécurité
- Votre mot de passe n'est envoyé qu'à Somfy. Gladys le stocke comme secret.
- L'intégration garde un jeton de rafraîchissement Somfy dans son volume privé
/data, pour ne pas se reconnecter à chaque redémarrage. - Cette intégration n'est ni faite ni supportée par Somfy. Elle utilise les mêmes serveurs que l'application Somfy Protect.
Paramètres de configuration
Voici les paramètres demandés par Somfy Protect dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Pour commencer | section | Non | Somfy Protect est un service cloud : l'intégration se connecte avec l'e-mail et le mot de passe de votre compte de l'application Somfy Protect, puis lit votre alarme, ses détecteurs et ses caméras. Créez un utilisateur dédié dans l'application (Réglages, Utilisateurs) si vous préférez ne pas partager votre propre compte. |
| E-mail Somfy Protect | string | Oui | L'e-mail avec lequel vous vous connectez à l'application Somfy Protect. |
| Mot de passe | secret | Oui | Le mot de passe de ce compte. Il n'est envoyé qu'à Somfy, jamais écrit dans les logs. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de lecture du cloud Somfy pour les piles, températures et états, en secondes. Les alarmes et détections arrivent en temps réel, quelle que soit cette valeur. |
| Événements en temps réel | boolean | Non | Reçoit les alarmes, changements de niveau et détections en une seconde, comme l'application Somfy Protect. Nécessaire aux déclencheurs de scènes. |
| Intervalle des captures caméra (s) | number | Non | Envoie une image des caméras au tableau de bord toutes les N secondes (60 minimum). 0 ne prend d'image que sur demande : vue en direct du tableau de bord, action de scène. |
| Journaux détaillés (debug) | boolean | Non | Journalise chaque requête et chaque événement du cloud Somfy. Activez-le pour diagnostiquer un problème, puis désactivez-le : c'est verbeux. Les mots de passe et jetons ne sont jamais journalisés. |
Comment installer Somfy Protect dans Gladys
- Dans Gladys, ouvrez Intégrations : Somfy Protect apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/prohand/gladys-somfyprotect: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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/prohand/gladys-somfyprotect.
Somfy Protect nécessite Gladys >=5.1.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
Somfy Protect 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.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation