Connecter ICO à votre système domotique (Home assistant, Jeedom, eedomus)
Afin de vous offrir une flexibilité maximale, Ondilo met à disposition une API ouverte (Customer API) permettant de connecter votre analyseur d’eau connecté ICO à vos plateformes domotiques. Ce guide vous explique comment exploiter cette connectivité et configurer vos intégrations pas à pas.
Préalable important concernant vos identifiants
Avant toute configuration domotique, assurez-vous que votre ICO est correctement configuré et fonctionnel sur l’application mobile officielle ICO.
Attention :
Pour toutes les authentifications API et domotiques, vous devez utiliser l’adresse e-mail et le mot de passe associés à votre application mobile ICO.
Ces identifiants peuvent différer de ceux utilisés pour vous connecter à la boutique en ligne sur le site web Ondilo.com.
Intégration et configurations sur-mesure
Si vous souhaitez réaliser une intégration personnalisée ou développer votre propre script, vous pouvez vous appuyer sur notre documentation technique officielle. Notre API repose sur le protocole sécurisé OAuth2 et vous permet de requêter l’ensemble des données de l’eau de votre piscine ou spa (pH, température, Redox, salinité), et d’ICO (niveau de batterie, signal RSSI).
L’intégration Ondilo ICO est nativement supportée par Home Assistant. Elle crée automatiquement le ou les appareils, et les entités associées (mesures).
Étapes de configuration ICO sur Home Assistant
Connectez-vous à votre interface Home Assistant.
Allez dans le menu Paramètres > Appareils et services.
En bas à droite de l’écran, cliquez sur le bouton Ajouter l’intégration.
4. Dans la barre de recherche, tapez Ondilo ICO et sélectionnez-le.
5. Une fenêtre vous invite à renseigner les identifiants de votre application mobile ICO pour valider l’association.
L’intégration Home Assistant est très stable, mais l’architecture de la plateforme implique quelques points de vigilance.
Expiration de la session (Re-authentication required)
Symptôme : Les capteurs passent tous l’état Indisponible (Unavailable) et une notification apparaît dans Home Assistant demandant de se reconnecter.
Cause : Le jeton de sécurité (token) OAuth2 a expiré ou n’a pas pu être renouvelé automatiquement (souvent après une coupure internet prolongée ou une mise à jour majeure de Home Assistant Core).
Solution : Inutile de supprimer l’intégration. Cliquez simplement sur « Recharger » dans la page Appareils et services, et saisissez à nouveau vos identifiants de l’application ICO.
Particularité :
Entités désactivées par défaut
Selon la version de votre ICO (Chlore/Brome ou Sel), certaines entités comme le TDS (taux de sel) peuvent apparaître grisées ou désactivées nativement dans Home Assistant pour ne pas surcharger votre système. Dans la liste des entités, il suffit de cliquer sur « Entités désactivées », cliquer sur l’entité grisée, d’aller dans l’engrenage (paramètres) et appuyer sur le bouton Activer.
Intégration pas à pas sur Jeedom
Jeedom communique avec ICO via un plugin dédié développé pour la plateforme, permettant de lier facilement vos équipements.
Étapes de configuration ICO sur Jeedom
Connectez-vous à votre tableau de bord Jeedom.
Rendez-vous dans le menu Plugins > Gestion des plugins, puis cliquez sur Market.
Recherchez le mot-clé Ondilo (ou le tag plugin-ondilo) et installez le plugin.
Activez le plugin une fois le téléchargement terminé.
Accédez à la page de configuration du plugin, cliquez sur « Ajouter » pour créer votre équipement et saisissez vos identifiants Ondilo ICO pour synchroniser automatiquement vos données de piscine.
Jeedom offre un contrôle total, mais sa dépendance aux tâches planifiées internes peut parfois créer des blocages.
Graphiques qui s’arrêtent (Blocage du Cron)
Symptôme : La tuile affiche des valeurs anciennes de plusieurs jours, alors que l’application mobile ICO est parfaitement à jour.
Cause : Le moteur de planification de Jeedom (le système Cron) s’est arrêté ou le plugin a rencontré une erreur réseau lors d’une requête.
Solution : Rendez-vous dans Plugins > Gestion des plugins > Ondilo. Vérifiez que le statut est bien au vert. Si les données restent figées, cliquez sur le bouton « Sauvegarder » de la page du plugin : cela va relancer proprement les tâches d’arrière-plan (cron15 et cron5).
Particularité
Commandes orphelines
Si vous changez les capteurs physiques de votre ICO (remplacement de la sonde pH par exemple), Jeedom peut conserver l’ancienne commande en double. Pensez à aller dans la configuration de l’équipement ICO, onglet « Commandes », pour supprimer l’ancienne ligne inutile.
Intégration pas à pas sur eedomus
La box eedomus intègre nativement un périphérique dédié à ICO pour vous permettre un suivi centralisé en quelques instants.
Étapes de configuration ICO sur eedomus
Sur le portail eedomus, rendez-vous dans Configuration > Ajouter ou supprimer un périphérique.
Cliquez sur Ajouter un autre type de périphérique.
Dans la liste, choisissez la catégorie Sonde de piscine Ico, puis cliquez sur Créer.
Suivez les instructions à l’écran pour lier votre compte en saisissant vos identifiants de l’application ICO. Cela permettra au système de récupérer automatiquement votre identifiant de piscine unique.
Astuce personnalisation :
Une fois le périphérique créé, vous pouvez vous rendre dans ses paramètres pour masquer ou désactiver les canaux qui ne concernent pas votre bassin (par exemple le canal « Sel » si votre traitement se fait au Chlore ou au Brome).
La box eedomus privilégie la simplicité, mais cela implique moins de flexibilité en cas de bug graphique.
Les courbes « plates » ou vides
Symptôme : Le widget affiche la bonne valeur, mais lorsque vous cliquez dessus, le graphique historique est vide ou linéaire.
Cause : Vous utilisez l’accès gratuit eedomus. L’historique gratuit ne conserve que les dernières 24 heures. Si ICO n’a envoyé qu’une seule mesure dans la journée, le graphique ne peut pas tracer de courbe.
Solution : Pour un suivi complet sur plusieurs mois, l’abonnement Premium eedomus (qui stocke les données pendant 2 ans) est vivement recommandé pour l’usage d’ICO.
Particularité :
Renouvellement forcé du compte
Sur eedomus, si l’authentification Cloud saute, l’affichage peut simplement se figer sans message d’erreur explicite. L’astuce consiste à retourner sur le portail web eedomus, d’ouvrir la configuration du périphérique ICO, et de cliquer sur « Lier à nouveau le compte » pour forcer la box à récupérer un nouveau ticket d’accès auprès d’Ondilo.
Une piscine connectée en toute sérénité
L’interconnexion de votre analyseur d’eau connecté ICO avec votre écosystème domotique peut être la clé pour transformer l’entretien de votre piscine ou de votre spa en une expérience transparente, centralisée et automatisée. En combinant la précision des analyses d’Ondilo avec la puissance de scénarisation de votre box (Home Assistant, Jeedom ou eedomus), vous offrez à votre bassin une protection sur-mesure tout en optimisant vos consommations d’énergie.
Bien que le fonctionnement sur batterie d’ICO impose un rafraîchissement des données par intervalles (Cloud Polling), les passerelles et plugins développés vous garantissent un suivi historique fiable et une grande tranquillité d’esprit au quotidien.
Les forums d’utilisateurs de Home Assistant, Jeedom et eedomus sont actifs. Vous y trouverez de nombreux passionnés qui partagent leurs exemples de cartes visuelles et leurs meilleurs scénarios de filtration.
