Intégration Overkiz pour Gladys Assistant
Contrôlez vos appareils Overkiz (Somfy TaHoma, Connexoon, Cozytouch...).
Publiée par cicoub13
- Appareils
- Version 1.1.0
- Nécessite Gladys >=4.84.0
- ★ 0
Contrôlez vos appareils Overkiz depuis Gladys Assistant : les box Somfy TaHoma, TaHoma Switch, Connexoon, Atlantic Cozytouch, Rexel Energeasy Connect, Hitachi Hi Kumo et Bouygues Flexom sont supportées via l'API cloud Overkiz.
Fonctionnalités
- Volets et ouvrants : volets roulants, stores, screens, stores vénitiens, rideaux, pergolas, portes de garage, portails et fenêtres — ouvrir, fermer, stopper et régler la position.
- Lampes : marche/arrêt et luminosité.
- Interrupteurs et prises : marche/arrêt.
- Capteurs : température, humidité, luminosité, contact (ouverture), présence (mouvement), fumée, fuite d'eau, CO2, puissance/consommation électrique et niveau de batterie.
Les états sont rafraîchis en quasi temps réel via l'API d'événements Overkiz : un volet actionné depuis une télécommande physique est reflété dans Gladys en quelques secondes.
Ce qui n'est pas encore supporté
- Chauffage et eau chaude : radiateurs, planchers chauffants, chauffe-eau et pompes à chaleur (
HeatingSystem,WaterHeatingSystem) ne sont pas encore convertis en appareils Gladys. Les box Atlantic Cozytouch, Thermor, Sauter et Hitachi Hi Kumo se connectent bien, mais l'essentiel de leurs appareils n'apparaîtra pas encore dans la découverte. - Serrures, alarmes et ventilation (
DoorLock,Alarm,AirFlow). - Sur les prises et modules mesurant la consommation, Overkiz publie souvent la puissance sur un sous-appareil distinct : il apparaît alors comme un appareil séparé dans la découverte, portant le même nom que son parent.
Prérequis
- Une box Overkiz (Somfy TaHoma, TaHoma Switch, Connexoon, Cozytouch...) déjà configurée avec l'application du fabricant.
- L'email et le mot de passe de votre compte fabricant (les mêmes identifiants que dans l'application TaHoma / Cozytouch).
Configuration
- Installez l'intégration depuis le store Gladys.
- Ouvrez l'onglet Configuration.
- Choisissez le Serveur correspondant à votre box (Somfy Europe pour TaHoma / TaHoma Switch / Connexoon en Europe).
- Saisissez l'email et le mot de passe de votre compte, puis enregistrez.
- Utilisez le bouton Tester la connexion pour vérifier vos identifiants.
- Ouvrez l'onglet Découverte, lancez un scan, et créez les appareils souhaités dans Gladys.
Dépannage
- Connexion impossible : vérifiez le serveur sélectionné et vos identifiants en vous connectant à l'application du fabricant. Somfy peut verrouiller temporairement le compte après trop de tentatives échouées.
- Un appareil est absent : seuls les types d'appareils listés ci-dessus sont supportés. Relancez un scan depuis l'onglet Découverte après avoir ajouté un appareil à votre box.
- Les états semblent figés : la période d'interrogation des événements peut être réduite dans l'onglet Configuration (10 s minimum). Attention, le cloud Overkiz limite les interrogations trop agressives.
Paramètres de configuration
Voici les paramètres demandés par Overkiz dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte Overkiz | section | Non | Connectez-vous avec les identifiants de votre box Overkiz. Choisissez le serveur correspondant à votre box, puis saisissez l'email et le mot de passe de votre compte fournisseur. Les volets, lampes, interrupteurs et capteurs sont supportés ; les appareils de chauffage et d'eau chaude ne le sont pas encore. |
| Serveur (type de box) | select | Oui | |
| Email / identifiant | string | Oui | |
| Mot de passe | secret | Oui | |
| Période d'interrogation des événements (s) | number | Non | Fréquence de récupération des événements depuis le cloud Overkiz, en secondes. |
Comment installer Overkiz dans Gladys
- Dans Gladys, ouvrez Intégrations : Overkiz 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/cicoub13/gladys-overkiz:1.1.0), 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/cicoub13/gladys-overkiz.
Overkiz nécessite Gladys >=4.84.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
Overkiz 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 cicoub13, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation