Intégration domotique Ondilo ICO, gratuite et open source
Analyseurs Ondilo ICO de piscine et spa : température, pH, redox, sel et recommandations.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.2
- Nécessite Gladys >=5.1.0
- ★ 0
L'Ondilo ICO flotte dans votre piscine ou votre spa et mesure l'eau toutes les heures. Cette intégration amène ces mesures dans Gladys, avec les recommandations de l'application Ondilo, grâce à l'API client officielle d'Ondilo. Non officielle, sans lien avec Ondilo.
Version de développement (0.1). Réalisée d'après la documentation de l'API Ondilo et testée avec des réponses simulées, pas encore avec un vrai ICO. Vos retours sont les bienvenus sur le dépôt GitHub.
Ce que vous obtenez
Un appareil Gladys par piscine ou spa de votre compte Ondilo (piscines partagées comprises), avec :
| Mesure Ondilo | Dans Gladys |
|---|---|
| Température de l'eau | capteur de température, °C |
| pH | capteur de pH |
| Redox (ORP) | capteur redox, mV |
| Sel (piscines au sel) | capteur en ppm : Ondilo donne des mg/L, même valeur (4000 ppm = 4 g/L) |
| Minéraux dissous, TDS (autres piscines) | capteur en ppm |
| Batterie de l'ICO | batterie, % |
| Signal de l'ICO | signal, % |
| Recommandations en cours | texte : leurs titres, ou « — » s'il n'y en a aucune |
Chaque mesure est enregistrée à l'heure où l'ICO l'a prise, pas à l'heure où Gladys l'a lue : les graphiques montrent le vrai rythme des mesures. Les mesures que l'ICO déclare invalides (hors de l'eau…) sont ignorées.
Le badge de l'appareil indique cloud ; un point orange signale l'absence de
mesure depuis plus de 3 heures (batterie, ICO hors de l'eau, hivernage), et
injoignable qu'Ondilo ne répond pas ou a refusé l'autorisation.
Installation
- Installez l'intégration depuis le store de Gladys.
- Dans l'onglet Configuration, cliquez sur Connecter à côté de « Compte Ondilo ».
- La page d'Ondilo s'ouvre : identifiez-vous avec l'e-mail et le mot de passe de votre compte Ondilo (ceux de l'application ICO), puis cliquez sur Autoriser. Gladys ne voit jamais votre mot de passe, et il n'y a aucune application à créer chez Ondilo.
- De retour dans Gladys, l'état indique « Connecté à Ondilo : 1 piscine ou spa ».
- Ouvrez l'onglet Découverte et ajoutez vos piscines et spas.
Les dernières mesures arrivent dès qu'un appareil est ajouté.
Fréquence de lecture
L'ICO mesure une fois par heure, et Ondilo autorise 30 requêtes par heure et par compte. L'intégration :
- lit les mesures de chaque piscine 65 minutes après sa dernière mesure, donc juste après la suivante (environ une requête par piscine et par heure) ;
- lit les recommandations à chaque nouvelle mesure (au plus une fois par heure, au moins toutes les 6 heures), et la liste des piscines toutes les 6 heures ;
- n'envoie jamais plus de 20 requêtes par heure, et laisse un tiers du quota à l'application Ondilo et à vos autres outils ;
- quand l'ICO reste muet (hivernage, batterie), réessaie 20 minutes plus tard, puis toutes les heures.
Pour une piscine, cela fait environ 2 requêtes par heure. Le bouton Actualiser maintenant lit tout d'un coup et affiche un résumé (au plus toutes les 5 minutes).
Scènes
- Les mesures fonctionnent avec le déclencheur « Changement d'état d'un appareil », par exemple « pH au-dessus de 7,6 → m'envoyer un message ».
- Le déclencheur Nouvelle recommandation Ondilo lance une scène quand
Ondilo publie une recommandation (ajuster le pH, nettoyer le filtre…), pour
une piscine ou pour toutes. Ses détails sont disponibles dans les actions
suivantes :
{{triggerEvent.data.title}},message,deadline,pool_name. Chaque recommandation ne déclenche qu'une fois ; celles déjà présentes quand le compte est lié ne sont pas annoncées.
Options
| Option | Défaut | Rôle |
|---|---|---|
| Langue des noms des fonctionnalités | Français | noms des fonctionnalités des piscines ajoutées désormais |
Les recommandations gardent la langue de votre compte Ondilo.
Limites
- Le sel et le TDS sont affichés en ppm (= mg/L) avec une icône générique : Gladys n'a pas encore de catégorie pour ces mesures.
Dépannage
- « Ondilo a refusé l'autorisation enregistrée » : le mot de passe du compte Ondilo a changé, ou l'accès a été révoqué. Cliquez à nouveau sur Connecter.
- « Ondilo est injoignable » : Ondilo ou votre accès Internet est en panne. L'intégration réessaie après 5, 15, 30 puis 60 minutes.
- « le quota de requêtes est atteint » : un autre outil interroge beaucoup le même compte Ondilo. L'intégration fait une pause d'une heure.
- Ondilo affiche une erreur sur l'adresse de redirection quand vous cliquez sur Connecter : ouvrez un ticket sur le dépôt GitHub avec le message.
- Le sel ne correspond pas à l'application : l'application Ondilo peut afficher des g/L, Gladys affiche des ppm (mg/L) : 4200 ppm = 4,2 g/L.
Confidentialité
Vous vous identifiez sur la page d'Ondilo elle-même : votre mot de passe ne
passe jamais par Gladys. Gladys conserve les jetons d'accès fournis par Ondilo
(jamais affichés dans l'interface) et l'intégration ne parle qu'à
interop.ondilo.com. ICO et Ondilo sont des marques d'Ondilo ; cette
intégration est sans lien avec Ondilo.
Paramètres de configuration
Voici les paramètres demandés par Ondilo ICO dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos piscines et spas Ondilo ICO | section | Non | Amène les mesures de vos analyseurs Ondilo ICO dans Gladys : température de l'eau, pH, redox (ORP), sel ou minéraux dissous (TDS), batterie et signal de chaque piscine ou spa, ainsi que les recommandations en cours de l'application Ondilo. Cliquez sur « Connecter » ci-dessous et identifiez-vous avec l'e-mail et le mot de passe de votre compte Ondilo (celui de l'application ICO) : aucune application à créer, aucune clé à copier. L'ICO mesure une fois par heure et Ondilo autorise 30 requêtes par heure et par compte : l'intégration lit chaque piscine environ une fois par heure, juste après sa nouvelle mesure, et laisse un tiers du quota à l'application Ondilo. Ajoutez ensuite vos piscines et spas depuis l'onglet Découverte. Non officiel, sans lien avec Ondilo. |
| Compte Ondilo | oauth2 | Non | |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms des fonctionnalités des piscines ajoutées désormais (température de l'eau, sel...). Les recommandations gardent la langue de votre compte Ondilo. |
Comment installer Ondilo ICO dans Gladys
- Dans Gladys, ouvrez Intégrations : Ondilo ICO 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/lm1lc3n7/gladys-ondilo:0.1.2), 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/LM1LC3N7/gladys-ondilo.
Ondilo ICO 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
Ondilo ICO 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 LM1LC3N7, 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