ICO mit Ihrem Hausautomationssystem verbinden (Home Assistant, Jeedom, eedomus)
Um Ihnen maximale Flexibilität zu bieten, stellt Ondilo eine offene API (Customer API) zur Verfügung, mit der Sie Ihren vernetzten ICO-Wasseranalysator an Ihre Hausautomationsplattformen anbinden können. In dieser Anleitung erfahren Sie, wie Sie diese Anbindungsmöglichkeiten nutzen und Ihre Integrationen Schritt für Schritt konfigurieren können.
Wichtiger Hinweis zu Ihren Zugangsdaten
Bevor Sie mit der Konfiguration der Hausautomation beginnen, stellen Sie bitte sicher, dass Ihr ICO in der offiziellen ICO-App korrekt eingerichtet ist und einwandfrei funktioniert.
Achtung:
Für alle API- und Hausautomations-Authentifizierungen müssen Sie die E-Mail-Adresse und das Passwort verwenden, die Ihrer ICO-App zugeordnet sind.
Diese Zugangsdaten können sich von denen unterscheiden, die Sie für die Anmeldung im Online-Shop auf der Website Ondilo.com verwenden.
Integration und maßgeschneiderte Konfigurationen
Wenn Sie eine individuelle Integration vornehmen oder ein eigenes Skript entwickeln möchten, können Sie auf unsere offizielle technische Dokumentation zurückgreifen. Unsere API basiert auf dem sicheren OAuth2-Protokoll und ermöglicht es Ihnen, alle Daten zu Ihrem Pool- oder Whirlpoolwasser (pH-Wert, Temperatur, Redox-Wert, Salzgehalt) sowie zum ICO (Batteriestand, RSSI-Signal) abzufragen.
Schritt-für-Schritt-Anleitung zur Integration in Home Assistant
Die Ondilo-ICO-Integration wird von Home Assistant nativ unterstützt. Dabei werden das oder die Geräte sowie die zugehörigen Entitäten (Messwerte) automatisch angelegt.
Schritte zur ICO-Konfiguration in Home Assistant
Melden Sie sich bei Ihrer Home Assistant-Benutzeroberfläche an.
Gehen Sie zum Menü „Einstellungen“ > „Geräte und Dienste“.
Klicken Sie unten rechts auf dem Bildschirm auf die Schaltfläche „Integration hinzufügen“.
4. Geben Sie in die Suchleiste „Ondilo ICO“ ein und wählen Sie den Eintrag aus.
5. In einem Fenster werden Sie aufgefordert, die Anmeldedaten Ihrer ICO-App einzugeben, um die Verknüpfung zu bestätigen.
Symptom: Alle Sensoren zeigen den Status „Nicht verfügbar“ (Unavailable) an, und in Home Assistant erscheint eine Benachrichtigung mit der Aufforderung, die Verbindung erneut herzustellen.
Symptom: Alle Sensoren zeigen den Status „Nicht verfügbar“ (Unavailable) an, und in Home Assistant erscheint eine Benachrichtigung mit der Aufforderung, die Verbindung erneut herzustellen.
Lösung: Sie müssen die Integration nicht löschen. Klicken Sie auf der Seite „Geräte und Dienste“ einfach auf „Neu laden“ und geben Sie Ihre Anmeldedaten für die ICO-App erneut ein.
Besonderheit:
Standardmäßig deaktivierte Einheiten
Je nach Version Ihres ICO (Chlor/Brom oder Salz) können bestimmte Elemente wie der TDS (Salzgehalt) in Home Assistant standardmäßig ausgegraut oder deaktiviert sein, um Ihr System nicht zu überlasten. Klicken Sie in der Liste der Entitäten einfach auf „Deaktivierte Entitäten“, wählen Sie die ausgegraute Entität aus, öffnen Sie die Einstellungen (Zahnrad-Symbol) und klicken Sie auf die Schaltfläche „Aktivieren“.
Schritt-für-Schritt-Anleitung zur Integration in Jeedom
Jeedom kommuniziert mit ICO über ein speziell für die Plattform entwickeltes Plugin, mit dem Sie Ihre Geräte ganz einfach verbinden können.
Schritte zur ICO-Konfiguration auf Jeedom
Melden Sie sich bei Ihrem Jeedom-Dashboard an.
Gehen Sie zum Menü „Plugins“ > „Plugin-Verwaltung“ und klicken Sie dann auf „Market“.
Suchen Sie nach dem Stichwort „Ondilo“ (oder dem Tag „plugin-ondilo“) und installieren Sie das Plugin.
Aktivieren Sie das Plugin, sobald der Download abgeschlossen ist
Rufen Sie die Konfigurationsseite des Plugins auf, klicken Sie auf „Hinzufügen“, um Ihr Gerät anzulegen, und geben Sie Ihre Ondilo-ICO-Zugangsdaten ein, um Ihre Schwimmbad-Daten automatisch zu synchronisieren.
Jeedom bietet vollständige Kontrolle, doch die Abhängigkeit von internen geplanten Aufgaben kann manchmal zu Blockaden führen.
Diagramme, die nicht mehr aktualisiert werden (Cron-Hänger)
Symptom: Die Kachel zeigt Werte an, die bereits mehrere Tage alt sind, obwohl die ICO-App auf dem Smartphone auf dem neuesten Stand ist.
Ursache: Die Planungs-Engine von Jeedom (das Cron-System) wurde angehalten oder das Plugin ist bei einer Abfrage auf einen Netzwerkfehler gestoßen.
Lösung: Gehen Sie zu „Plugins“ > „Plugin-Verwaltung“ > „Ondilo“. Vergewissern Sie sich, dass der Status grün ist. Falls die Daten weiterhin nicht aktualisiert werden, klicken Sie auf der Plugin-Seite auf die Schaltfläche „Speichern“: Dadurch werden die Hintergrundaufgaben (cron15 und cron5) ordnungsgemäß neu gestartet.
Besonderheit
Verwaisten Befehle
Wenn Sie die physischen Sensoren Ihres ICO austauschen (z. B. den Austausch der pH-Sonde), kann Jeedom den alten Befehl doppelt speichern. Denken Sie daran, in den Einstellungen des ICO-Geräts auf der Registerkarte „Befehle“ den alten, nicht mehr benötigten Eintrag zu löschen.
Schritt-für-Schritt-Anleitung zur Integration in eedomus
Die eedomus-Box verfügt standardmäßig über ein spezielles ICO-Gerät, mit dem Sie die Daten im Handumdrehen zentral überwachen können.
Schritte zur ICO-Konfiguration auf eedomus
Gehen Sie auf dem eedomus-Portal zu „Einstellungen“ > „Gerät hinzufügen oder entfernen“.
Klicken Sie auf „Anderen Gerätetyp hinzufügen“.
Wählen Sie in der Liste die Kategorie „Ico-Poolfühler“ aus und klicken Sie anschließend auf „Erstellen“.
Befolgen Sie die Anweisungen auf dem Bildschirm, um Ihr Konto zu verknüpfen, indem Sie Ihre Anmeldedaten für die ICO-App eingeben. Dadurch kann das System automatisch Ihre eindeutige Pool-ID abrufen.
Tipp zur individuellen Anpassung:
Sobald das Gerät angelegt ist, können Sie in dessen Einstellungen die Kanäle ausblenden oder deaktivieren, die für Ihr Becken nicht relevant sind (z. B. den Kanal „Salz“, wenn Sie Ihr Becken mit Chlor oder Brom behandeln).
Die eedomus-Box setzt auf Einfachheit, was jedoch bei grafischen Fehlern weniger Flexibilität bedeutet.
„Flache“ oder leere Kurven
Symptom: Das Widget zeigt den richtigen Wert an, aber wenn man darauf klickt, ist das Verlaufsdiagramm leer oder linear.
Ursache: Sie nutzen den kostenlosen eedomus-Zugang. Der kostenlose Verlauf speichert nur die letzten 24 Stunden. Wenn ICO an diesem Tag nur einen einzigen Messwert gesendet hat, kann das Diagramm keine Kurve darstellen.
Lösung: Für eine umfassende Nachverfolgung über mehrere Monate hinweg wird das eedomus-Premium-Abonnement (bei dem die Daten zwei Jahre lang gespeichert werden) für die Nutzung von ICO dringend empfohlen.
Besonderheit:
Erzwungene Verlängerung des Kontos
Wenn bei eedomus die Cloud-Authentifizierung fehlschlägt, kann es vorkommen, dass die Anzeige einfach einfriert, ohne dass eine explizite Fehlermeldung erscheint. Der Trick besteht darin, zum eedomus-Webportal zurückzukehren, die Konfiguration des ICO-Geräts zu öffnen und auf „Konto erneut verknüpfen“ zu klicken, um die Box dazu zu zwingen, ein neues Zugangsticket von Ondilo abzurufen.
Ein vernetztes Schwimmbecken – ganz ohne Sorgen
Die Vernetzung Ihres vernetzten ICO-Wasseranalysators mit Ihrem Hausautomationssystem kann der Schlüssel sein, um die Pflege Ihres Pools oder Whirlpools zu einem nahtlosen, zentralisierten und automatisierten Erlebnis zu machen. Durch die Kombination der Präzision der Ondilo-Analysen mit den leistungsstarken Automatisierungsfunktionen Ihrer Steuerungsbox (Home Assistant, Jeedom oder eedomus) bieten Sie Ihrem Becken einen maßgeschneiderten Schutz und optimieren gleichzeitig Ihren Energieverbrauch.
Obwohl der Batteriebetrieb von ICO eine regelmäßige Datenaktualisierung (Cloud Polling) erfordert, garantieren Ihnen die entwickelten Gateways und Plugins eine zuverlässige Verlaufsüberwachung und sorgen so für mehr Sicherheit im Alltag.
Die Benutzerforen von Home Assistant, Jeedom und eedomus sind sehr aktiv. Dort finden Sie zahlreiche Enthusiasten, die ihre Beispiele für visuelle Karten und ihre besten Filterszenarien teilen.
