iopool Smart-Home-Integration, kostenlos und Open Source

iopool-EcO-Poolsonde: Wassertemperatur, pH, Redox, Filterempfehlung, Szenen, Widget.

• Veröffentlicht von William-De71
• Geräte
• Version 0.1.0
• Erfordert Gladys >=5.3.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Überblick

Diese Integration bringt die Pools Ihres iopool-Kontos (iopool-EcO-Sonde) in Gladys:

• ein Gerät pro Pool: Wassertemperatur, pH-Wert, Redox (ORP), die von iopool empfohlene tägliche Filterdauer, ob iopool eine Handlung am Wasser verlangt, und der Poolmodus (Standard, Saisonstart, aktive oder passive Überwinterung);
• Szenen-Auslöser (neue Messung, Handlung erforderlich oder erledigt, Poolmodus geändert, Filterempfehlung geändert, seit 24 Stunden keine Messung) und eine Szenen-Aktion (Pool lesen);
• ein Dashboard-Widget „Poolwasser“.

iopool hat keine lokale API: Die Sonde sendet ihre Messungen an die iopool-Cloud, und die Integration liest sie über die offizielle öffentliche iopool-API, nur lesend, mit dem API-Schlüssel Ihres Kontos (Cloud-Transport). Der Schlüssel geht nur an api.iopool.com.

Voraussetzungen

• Gladys Assistant 5.3.0 oder neuer.
• Eine iopool-EcO-Sonde, die bereits in der iopool-App funktioniert.
• Der API-Schlüssel Ihres iopool-Kontos: Öffnen Sie in der iopool-App die Einstellungen; der Schlüssel steht ganz unten auf der Seite.

Konfiguration

1. Integrationen → iopool → Konfiguration.
2. Fügen Sie den API-Schlüssel ein und speichern Sie.

Feld	Beschreibung
API-Schlüssel	Der Schlüssel der iopool-App (Einstellungen, ganz unten), als Geheimnis gespeichert und nie wieder angezeigt.
Leseintervall (Min.)	5 bis 60 Minuten, standardmäßig 10. Die Sonde misst etwa einmal pro Stunde: schneller lesen bringt nichts.
Sprache der Texte	Namen der Funktionen, Poolmodi und Szenen-Zusammenfassungen. Automatisch: die Sprache Ihres Dashboards.

API-Schlüssel testen liest die iopool-API und zeigt, wie viele Pools das Konto hat.

Verwendung

Geräte

Geräte → iopool → Entdecken, dann fügen Sie Ihren Pool hinzu („iopool Garten“, nach dem Namen in der iopool-App). Seine Werte erscheinen sofort.

Funktion	Gladys-Typ
Wassertemperatur	Temperatursensor, °C
pH-Wert	pH-Sensor
Redox (ORP)	ORP-Sensor, mV
Empfohlene Filterung	Dauer, Minuten pro Tag (iopool folgt der Wassertemperatur)
Handlung erforderlich	Text: „Handlung erforderlich“ oder „Nichts zu tun“, wie es die iopool-App sagt
Poolmodus	Text: Standard, Saisonstart, aktive oder passive Überwinterung

Die iopool-API ist nur lesend: Aus Gladys lässt sich nichts steuern. Um die Pumpe zu schalten, nutzen Sie eine smarte Steckdose oder ein Relais zusammen mit der Filterempfehlung.

Szenen

Auslöser:

• iopool: neue Messung: jede neue Messung, mit ihren Werten als Variablen (und ob iopool sie bestätigt hat).
• iopool: Handlung erforderlich: Die iopool-App verlangt eine Handlung am Wasser, oder nicht mehr. Filtern Sie auf „Eine Handlung ist erforderlich“ für einen Alarm.
• iopool: Poolmodus geändert: Standard, Saisonstart, aktive oder passive Überwinterung.
• iopool: Filterempfehlung geändert: Die empfohlene tägliche Dauer hat sich geändert; ihr Wert in Minuten und Stunden als Variablen.
• iopool: Messungen ausgeblieben: seit 24 Stunden keine Messung (Batterie, WLAN, Gateway). Einmal ausgelöst, nie bei passiver Überwinterung.

Aktion:

• iopool: Pool lesen: Temperatur, pH-Wert, Redox, empfohlene Filterung, Handlung erforderlich, Poolmodus und ein fertiger Satz.

Beispiele:

• Wenn iopool eine Handlung verlangt → eine Nachricht mit {{triggerEvent.data.summary}} senden.
• Wenn sich die Filterempfehlung ändert → die Einschaltdauer der Pumpensteckdose anpassen.
• Jeden Abend um 20 Uhr → den Pool lesen und seine Zusammenfassung senden.

Widget

Dashboard → Bearbeiten → Poolwasser hinzufügen. Wählen Sie den Pool, das Diagramm (Temperatur, pH-Wert, Redox, Filterung oder keins) und seinen Zeitraum. Das Diagramm zeigt den Verlauf, den Gladys speichert: Es erscheint, sobald das Gerät des Pools hinzugefügt ist. Die Kacheln sind nicht eingefärbt: iopool veröffentlicht seine Idealbereiche nicht, daher übernimmt das Widget, was iopool sagt („Handlung erforderlich“), statt zu raten.

Fehlerbehebung

• „iopool hat den API-Schlüssel abgelehnt“: Kopieren Sie ihn erneut aus der iopool-App (Einstellungen, ganz unten), ohne Leerzeichen.
• Kein Gerät unter Entdecken: Das Konto hat noch keinen Pool, oder iopool wurde noch nicht gelesen: Nutzen Sie „API-Schlüssel testen“.
• „Noch keine Messung“: Die Sonde wird noch initialisiert; die Werte kommen mit ihrer ersten Messung.
• Werte etwas verspätet: Die Sonde misst etwa einmal pro Stunde, und die Integration liest die API standardmäßig alle 10 Minuten.
• „Die iopool-API antwortet nicht“ oder „iopool begrenzt die Anfragen“: Die Integration versucht es beim nächsten Lesen erneut.
• Logs: Setzen Sie die Umgebungsvariable DEBUG=gladys-integration-sdk und öffnen Sie dann ein Issue auf GitHub mit den Versionen von Gladys und der Integration und den Logs (der API-Schlüssel erscheint nie darin).

Konfigurationseinstellungen

Diese Einstellungen fragt iopool in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
iopool-Konto	section	Nein	Öffnen Sie in der iopool-App die Einstellungen: Ihr API-Schlüssel steht ganz unten auf der Seite. Kopieren Sie ihn hierher. Die Integration liest Ihre Pools über die offizielle iopool-API, nur lesend: Keine Daten gehen anderswohin.
API-Schlüssel	secret	Ja
Optionen	section	Nein	Die iopool-EcO-Sonde sendet etwa einmal pro Stunde eine Messung. Jedes Lesen ist eine Anfrage an die iopool-API, für alle Pools des Kontos.
Leseintervall (Min.)	number	Nein	5 bis 60 Minuten, standardmäßig 10.
Sprache der Texte	select	Nein	Namen der Funktionen, Poolmodi und Szenen-Zusammenfassungen. Automatisch: die Sprache Ihres Dashboards, sobald das iopool-Widget angezeigt wurde.

So installierst du iopool in Gladys

1. Öffne in Gladys Integrationen: iopool erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/william-de71/gladys-iopool:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-iopool.

iopool benötigt Gladys >=5.3.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

iopool ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂