Test Adapter PoolControl

[DasBo1975]

🧠 PoolControl – Version 0.3.0 ist da!

Ich habe heute die neue Version 0.3.0 veröffentlicht.
Diese Version bringt das erste lernfähige System in den PoolControl-Adapter und erweitert die bisherigen Pumpenfunktionen deutlich.

Was ist neu?

• Reelle Durchflussberechnung auf Basis der tatsächlichen Leistungsaufnahme
• Neuer Bereich pump.live für Echtzeit-Werte (Leistung, Durchfluss, Prozentleistung)
• Neuer Bereich pump.learning für Lern- und Analysewerte
  • Automatisches Erkennen des Normalbereichs (Leistung / Durchfluss ± 15 %)
  • Berechnung prozentualer Abweichungen
  • Textbasierte Bewertung:
    „Pumpe läuft im Normalbereich“,
    „unterhalb des Normalbereichs (möglicher Filterdruck)“ oder
    „oberhalb des Normalbereichs (möglicher Luftstau)“
• Die tägliche Umwälzung nutzt jetzt den realen Durchflusswert
• Alles arbeitet ereignisgesteuert – keine Timer, kein unnötiges Polling

Wie funktioniert das Lernen?

Das Lernsystem startet erst beim ersten Ausschalten der Pumpe.
Während des Laufens werden die Live-Werte gesammelt.
Sobald die Pumpe stoppt, berechnet der Adapter den Durchschnitt des letzten Laufs
und aktualisiert die Lernwerte in pump.learning.

Bei jedem weiteren Pumpenstopp werden diese Durchschnittswerte automatisch angepasst
und der Normalbereich (± 15 %) neu bestimmt.
So lernt der Adapter mit jedem Zyklus ein Stück genauer,
welche Werte für deine Pumpe typisch sind.

Fazit

Mit dieser Version beginnt die lernfähige Phase von PoolControl:
Die Pumpe weiß nun selbst, was für sie „normal“ ist.

Ich freue mich über Rückmeldungen, Tests und Vorschläge hier im Forum!
Die Version steht über npm @latest oder direkt über GitHub zur Installation bereit.

---

[DasBo1975]

🧩 Ausblick: Geplante und in Arbeit befindliche Konzepte für den PoolControl-Adapter

Mit der fertiggestellten Version 0.3.0 („Pumpen-Lernsystem & Livewerte“)
läuft der PoolControl-Adapter nun stabil im Produktivsystem.
Parallel dazu entstehen aktuell mehrere Konzeptdateien,
die die künftige Entwicklung und Modulstruktur festlegen.

Diese Konzepte sind noch nicht umgesetzt,
aber bereits vollständig geplant und technisch vorbereitet:

Zukünftige Module (in Planung)

COP-Berechnung
→ Energieeffizienz- und Leistungsbewertung für Wärmepumpen und Solarerträge

JSON & HTML-Generator
→ Automatische Erstellung von Auswertungs- und HTML-Dateien für externe Darstellung

Solar-Ertragsberechnung
→ Analyse der täglichen Solarleistung und Wirkungsgradüberwachung

System-Health-Monitoring
→ Überwachung von Pumpen, Sensoren, Heizsystem und Gesamtzustand des PoolControl-Adapters

Wärmepumpen- / Heizungssteuerung
→ Automatische Regelung mit Ziel- und Maximaltemperatur sowie Pumpen-Nachlaufzeit

KI-Sprachsystem (Blueprint & Konzept)
→ Lernfähiges, natürlich klingendes Sprach- und Textsystem für Benachrichtigungen, Zusammenfassungen und Interaktion

Diese Module werden schrittweise ab Version 0.4.x integriert.
Ziel ist ein vollständig modulares, intelligentes und selbstüberwachendes PoolControl-System.

Feedback, Ideen oder Vorschläge aus der Community sind ausdrücklich willkommen!

[claus1993]

@dasbo1975 said in Test Adapter PoolControl:

Wärmepumpen- / Heizungssteuerung
→ Automatische Regelung mit Ziel- und Maximaltemperatur sowie Pumpen-Nachlaufzeit

Hallo @DasBo1975
könntest du bei diesem Punkt bitte auch berücksichtigen das die Wärmepumpe beim Einschalten verzögert hinter der Umwälzpumpe startet. In meinem Falle läuft die Wärmepumpe in einen Error, wenn diese zeitgleich mit der Pumpe startet. Die Pumpe hat dann noch keinen Druck aufgebaut und die Wärmempume meint das kein Wasser vorhanden ist.

Danke und Grüße.

[DasBo1975]

@claus1993 sagte in Test Adapter PoolControl:

@dasbo1975 said in Test Adapter PoolControl:

Wärmepumpen- / Heizungssteuerung
→ Automatische Regelung mit Ziel- und Maximaltemperatur sowie Pumpen-Nachlaufzeit

Hallo @DasBo1975
könntest du bei diesem Punkt bitte auch berücksichtigen das die Wärmepumpe beim Einschalten verzögert hinter der Umwälzpumpe startet. In meinem Falle läuft die Wärmepumpe in einen Error, wenn diese zeitgleich mit der Pumpe startet. Die Pumpe hat dann noch keinen Druck aufgebaut und die Wärmempume meint das kein Wasser vorhanden ist.

Danke und Grüße.

Hallo,

guter Hinweis. Wird gleich notiert

[DasBo1975]

🧱 Ankündigung – PoolControl Hardwareprojekte Winter 2025/26

Neben der laufenden Software-Entwicklung meines PoolControl-Adapters beginne ich in der Wintersaison 2025/26 mit der Konstruktion und Dokumentation verschiedener 3D-druckbarer Gehäuse- und Sensormodule.
Ziel ist es, den Aufbau der Sensorik rund um den Adapter vollständig modular, nachbaubar und langlebig zu gestalten.

---

🧩 Geplante Hardware-Module

1️⃣ ESP32-Sensorgehäuse (Temperaturmodul)

• Aufnahme für ein ESP32 DevKit C
• Anschluss von sechs wasserdichten DS18B20-Temperatursensoren
  (Grund, Oberfläche, Kollektor, Vorlauf, Rücklauf und Außentemperatur)
• Magnethalterung zur einfachen Befestigung an der Poolwand für die beiden Sensoren Grund und Oberfläche
• LED-Statusanzeigen und Metall-Taster im Deckel
• Integriertes System zur Kabel-Zugentlastung
• Kompakte Bauform für dauerhafte Installation im Technikbereich

2️⃣ ESP32-Level-Gehäuse (Wasserstandssensor)

• Für Ultraschall- oder Drucksensor zur Füllstandsermittlung
• Integrierte Zugentlastung und LED-Anzeige
• Optionales Konzept für Mini-Solarpanel- oder Batteriebetrieb

---

Geplante Erweiterungen

Darüber hinaus sind weitere ESP32-basierte Gehäuse für zusätzliche Sensorik und Messsysteme angedacht,
z. B. für chemische Werte (pH / Redox), Drucksensoren, Strommessung oder Wetterdaten.
Alle Module werden vollständig selbst konstruiert (PETG / ASA) und erhalten ein
einheitliches Zugentlastungs- und LED-Montagesystem, das sich nahtlos in die restliche PoolControl-Hardware einfügt.

---

Integration in ioBroker

Alle ESP32-Module werden so konzipiert, dass sie sich über ESPHome direkt und zuverlässig in ioBroker einbinden lassen.
Damit können Temperatur-, Pegel- oder Zusatzsensoren ohne großen Aufwand in den PoolControl-Adapter integriert und ausgewertet werden.

---

Veröffentlichung

Nach erfolgreicher Testphase werden die Gehäuse im
GitHub-Repository von PoolControl unter
/docs/Hardware/ als FreeCAD- (.FCStd) und STL-Dateien
zum freien Download bereitgestellt.

---

️ Mein Ziel

„So wenig Zukauf wie möglich – so viel Eigenbau wie nötig.“

Alle Module sollen mit handelsüblichen 3D-Druckern nachgedruckt werden können,
damit auch andere Nutzer ihre Sensor- und Steuertechnik rund um PoolControl einfach erweitern können.

[DennisMenger]

@sigi234 sind das die Widgets vom Adapter oder sind das Standard-Widgets?

[Homoran]

@dennismenger sagte in Test Adapter PoolControl:

vom Adapter

von welchem?

[sigi234]

@dennismenger sagte in Test Adapter PoolControl:

@sigi234 sind das die Widgets vom Adapter oder sind das Standard-Widgets?

Der Adapter hat noch keine eigene Widget.

[DasBo1975]

Genau. Der Adapter hat zur Zeit noch keine eigenen Widgets. Es sind aber welche geplant. Diese kommen aber erst ganz zum Schluss.

[DasBo1975]

Jetzt muss der Adapter, so wie er auf GitHub steht, erstmal ausgiebig getestet werden. Zeitgleich bin ich gerade dabei eine TasterBox zu kreieren die man im Technikraum platzieren kann.

Mit der Box, auf ESP 32 Basis kann man dann direkt an der Pumpe funktionieren wie zum Beispiel das Rückspülen oder den Wartungsmodus starten.

[DasBo1975]

🧊 PoolControl v0.3.1 veröffentlicht

Stabilisierung des FrostHelpers

Mit der Version 0.3.1 habe ich den Frostschutz deutlich stabiler und sicherer gemacht.
In den letzten kalten Nächten ist mir aufgefallen, dass die Pumpe im Frostmodus bei schwankenden Temperaturen (z. B. 2,9 3,1 °C) ständig ein- und ausgeschaltet wurde.
Dieses „Flattern“ habe ich nun vollständig behoben.

Änderungen

Feste Hysterese von +2 °C eingebaut
→ Die Pumpe schaltet jetzt erst wieder aus, wenn die Außentemperatur mindestens 2 K über der eingestellten Frostgrenze liegt.

Rundung auf ganze °C hinzugefügt
→ verhindert Schaltvorgänge bei minimalen Sensorabweichungen.

Keine neuen States oder Einstellungen nötig.

Vollständig rückwärtskompatibel – einfach updaten und weiterlaufen lassen.

🧪 Wirkung

Die Frostschutz-Logik reagiert weiterhin zuverlässig, bleibt dabei aber deutlich ruhiger.
Selbst bei Windkälte oder leichtem Messrauschen läuft die Pumpe jetzt stabil durch, bis es wirklich warm genug ist.

Version

v0.3.1 – veröffentlicht am 18. Oktober 2025
(Repository: github.com/DasBo1975/ioBroker.poolcontrol
)

Ausblick

Parallel arbeite ich aktuell an der Temperaturbox (TempBox) – dem ersten externen ESP32-Modul (MQTT-Version) mit bis zu 6 Temperatursensoren (DS18B20).
Die Box ist bereits im finalen Testlauf und kurz vor Fertigstellung.
Sobald die Verbindung zum Adapter stabil läuft, wird sie offiziell ins System integriert – inklusive automatischer Erkennung, LED-Statusanzeige und Hardware-Helper-Anbindung.

Die TempBox ist dabei ein reines Zusatzfeature – also kein Muss.
Der PoolControl-Adapter funktioniert selbstverständlich auch ohne die Box vollständig und wie gewohnt.

[sigi234]

@dasbo1975 sagte in Test Adapter PoolControl:

PoolControl v0.3.1 veröffentlicht

Hallo, ich habe mir wieder ein paar Gedanken gemacht:

Gut wäre es wenn man eine Art User-Controll hätte wo man den Adapter dann unter VIS2 steuern kann.
Manchmal ist es nicht so einfach ersichtlich an den DP's.Denke aber die DP die nicht steuerbar sind sind Schreibgeschütz?
Es werden ja immer mehr DP und da kommen noch sicher einige dazu.

Später mal für die Widgets:

Da denke ich an:

Steuerungs Widgets
Info Widgets
Grafik Widgets
Statistik Widgest

[DasBo1975]

@sigi234 sagte in Test Adapter PoolControl:

@dasbo1975 sagte in Test Adapter PoolControl:

PoolControl v0.3.1 veröffentlicht

Hallo, ich habe mir wieder ein paar Gedanken gemacht:

Gut wäre es wenn man eine Art User-Controll hätte wo man den Adapter dann unter VIS2 steuern kann.
Manchmal ist es nicht so einfach ersichtlich an den DP's.Denke aber die DP die nicht steuerbar sind sind Schreibgeschütz?
Es werden ja immer mehr DP und da kommen noch sicher einige dazu.

Später mal für die Widgets:

Da denke ich an:

Steuerungs Widgets
Info Widgets
Grafik Widgets
Statistik Widgest

Hallo Sigi234,

danke dir für dein wieder sehr gutes Feedback und die Idee mit den User-Controls!

Ich plane genau das, was du beschreibst – allerdings nicht nur für VIS 2, sondern auch für VIS 1, damit es für alle Nutzer funktioniert. Es soll also künftig eine Reihe von Steuer-Widgets, Info-Widgets und Grafik-Widgets geben, die den Adapter deutlich einfacher bedien- und überschaubar machen.

Bei den Steuer-Widgets ist der Plan, dass jedes Modul sein eigenes komplettes Widget bekommt:

🧩 Pumpe-Widget: Alle Funktionen rund um die Pumpe (Ein/Aus, Automatik/Manuell, aktuelle Leistung, Grund des Betriebs usw.)

️ Temperatur-Widget: Übersicht und Steuerung der Sensoren (Oberfläche, Rücklauf, Kollektor usw.)

️ Runtime-Widget: Alle Informationen zur Laufzeit- und Zeitsteuerung (Tageslaufzeit, Restzeit, Zeitfenster, Nachpumpen usw.)

️ Solar-Widget: Steuerung und Status der Solarregelung (Hysterese, Einschalt-/Ausschaltgrenzen, Warnung)

Sprach-Widget: Aktivierung von Sprach- und Benachrichtigungsausgaben

Dazu kommen später die Info-Widgets (z. B. Gesamtstatus, Warnmeldungen, Saisonstatus) und Grafik-Widgets (Verläufe, Solarertrag, Temperaturen, Laufzeiten usw.).

Im Hintergrund bereite ich das bereits technisch vor:

Im Ordner control.* werden aktuell alle leicht steuerbaren Datenpunkte gesammelt, also solche, die direkt aus VIS geschaltet werden können (z. B. Saisonstart, Rückspülen, Wartungsmodus, Pumpenstart).

Die tiefgreifenden Steuerungen bleiben in den jeweiligen Funktions-Ordnern wie pump., solar. oder runtime.*, damit die Struktur sauber bleibt.

Dein Hinweis zur Übersicht ist absolut richtig – die Datenpunkte werden immer mehr, aber genau deshalb wird das Widget-System so aufgebaut, dass man später alles bequem über eine klare VIS-Oberfläche bedienen kann, ohne sich durch den Objektbaum klicken zu müssen.

Viele Grüße
Dirk

[sigi234]

@dasbo1975 sagte in Test Adapter PoolControl:

Hallo Sigi234,
danke dir für dein wieder sehr gutes Feedback und die Idee mit den User-Controls!
Ich plane genau das, was du beschreibst – allerdings nicht nur für VIS 2, sondern auch für VIS 1, damit es für alle Nutzer funktioniert. Es soll also künftig eine Reihe von Steuer-Widgets, Info-Widgets und Grafik-Widgets geben, die den Adapter deutlich einfacher bedien- und überschaubar machen.

Cool, jetzt fehlt mir nur mehr ein DP wo ich einen Coktail bestellen kann.

[DasBo1975]

@sigi234 sagte in Test Adapter PoolControl:

@dasbo1975 sagte in Test Adapter PoolControl:

Hallo Sigi234,
danke dir für dein wieder sehr gutes Feedback und die Idee mit den User-Controls!
Ich plane genau das, was du beschreibst – allerdings nicht nur für VIS 2, sondern auch für VIS 1, damit es für alle Nutzer funktioniert. Es soll also künftig eine Reihe von Steuer-Widgets, Info-Widgets und Grafik-Widgets geben, die den Adapter deutlich einfacher bedien- und überschaubar machen.

Cool, jetzt fehlt mir nur mehr ein DP wo ich einen Coktail bestellen kann.

Warte, den bau ich. Soll der eine Klingel auslösen oder per Alexa die Frau rufen
Ha, zum Glück liest meine hier nicht mit

[sigi234]

@dasbo1975 sagte in Test Adapter PoolControl:

@sigi234 sagte in Test Adapter PoolControl:

@dasbo1975 sagte in Test Adapter PoolControl:

Hallo Sigi234,
danke dir für dein wieder sehr gutes Feedback und die Idee mit den User-Controls!
Ich plane genau das, was du beschreibst – allerdings nicht nur für VIS 2, sondern auch für VIS 1, damit es für alle Nutzer funktioniert. Es soll also künftig eine Reihe von Steuer-Widgets, Info-Widgets und Grafik-Widgets geben, die den Adapter deutlich einfacher bedien- und überschaubar machen.

Cool, jetzt fehlt mir nur mehr ein DP wo ich einen Coktail bestellen kann.

Warte, den bau ich. Soll der eine Klingel auslösen oder per Alexa die Frau rufen
Ha, zum Glück liest meine hier nicht mit

Meine auch nicht.

Aber da habe ich wieder ein paar Gedanken:

Easy Mode? Meine Nachbarn haben nur einen kleinen Pool ohne Temperaturfühler usw...
Scenensteuerung - Licht an, Musik an

[DasBo1975]

@sigi234 sagte in Test Adapter PoolControl:

Aber da habe ich wieder ein paar Gedanken:
Easy Mode? Meine Nachbarn haben nur einen kleinen Pool ohne Temperaturfühler usw...
Scenensteuerung - Licht an, Musik an

Hallo Sigi,

danke dir wieder für deine Ideen!

Den Punkt mit der Szenensteuerung finde ich grundsätzlich interessant – vor allem das Thema Lichtsteuerung passt da sehr gut rein.
Ich könnte mir vorstellen, dass wir das später einmal mit dem Wasserstandsensor kombinieren, den ich ohnehin noch bauen möchte – zusätzlich zu den anderen geplanten Boxen wie Temperatur-Box, Drucksensor-Box, Chemie-Box und Taster-Box.

Der Wasserstandsensor könnte dann nicht nur den Füllstand erfassen, sondern auch erkennen, wenn unregelmäßige Wellenbewegungen im Wasser auftreten. Daraus ließe sich dann ableiten, dass abends gebadet wird.
In Kombination mit einer einstellbaren Uhrzeit könnte der Adapter das Poollicht dann automatisch aktivieren, sobald er merkt, dass der Pool genutzt wird.

Das ist aktuell natürlich noch Zukunftsmusik, aber solche Ideen merke ich mir mit, damit wir später sehen, was davon technisch sinnvoll umsetzbar ist.

Was den Easy-Mode betrifft: der passt eigentlich nicht so recht zum PoolControl-Adapter, weil er für komplexere Anlagen mit Sensorik und Automatik gedacht ist.
Wer nur eine einfache Pumpe ohne Sensoren betreiben möchte, kann das viel einfacher über eine Zeitschaltuhr oder einen Shelly-Schalter lösen – das ist für solche Fälle die deutlich unkompliziertere Lösung.

Viele Grüße
Dirk

[DennisMenger]

@DasBo1975

Darf ich fragen wo nach der FrostHelper geht bzw. nach welchem Wert dann die Pumpe eingeschaltet wird?

Viele Grüße
Dennis

[DasBo1975]

@dennismenger sagte in Test Adapter PoolControl:

@DasBo1975

Darf ich fragen wo nach der FrostHelper geht bzw. nach welchem Wert dann die Pumpe eingeschaltet wird?

Hallo Dennis,

der FrostHelper überwacht die Außentemperatur (temperature.outside.current) und vergleicht sie mit der in der Instanz eingestellten Frostschutz-Grenze.

Sobald die Außentemperatur unter diesen Wert fällt, schaltet der Adapter die Pumpe automatisch ein, um Frostschäden zu vermeiden.
Erst wenn die Temperatur wieder mindestens 2 °C über der eingestellten Grenze liegt, wird sie automatisch ausgeschaltet.
Damit wird verhindert, dass die Pumpe ständig an- und ausgeht – das ist die feste Hysterese.

Der FrostHelper arbeitet unabhängig vom Pumpenmodus, also auch dann, wenn die Pumpe manuell oder zeitgesteuert betrieben wird.
Entscheidend ist nur, dass in der Instanz die Checkbox „Frostschutz aktivieren“ eingeschaltet ist.

Ich habe mich hier ganz bewusst dafür entschieden, die Außentemperatur als Referenz zu nehmen,
weil Vorlauf-, Rücklauf- oder Pooltemperaturen viel träger reagieren und damit zu spät auf Frost reagieren würden.
Die Außenluft kühlt dagegen als Erstes ab – und genau dort entsteht die eigentliche Frostgefahr an den Rohrleitungen und am Filter.

Wenn kein Außentemperatursensor vorhanden ist, wird der Frostschutz einfach übersprungen und im Log als Hinweis ausgegeben.

Wichtig ist auch, dass der Außentemperatursensor so positioniert ist, dass er wirklich die Außenlufttemperatur misst – also nicht in direkter Nähe zu einer Hauswand, einem Heizraum oder anderen wärmeabstrahlenden Flächen.
Ein zu warmer Einbauort kann die Messwerte deutlich verfälschen und den Frostschutz dadurch zu spät aktivieren.

Viele Grüße
Dirk

[DasBo1975]

Hinweis zur Version 0.3.1

Kleine Info am Rande:
Wer sich die Version 0.3.1 bereits heute Vormittag heruntergeladen hat,
sollte sie sich bitte noch einmal neu installieren,
da ein kleiner Bug im FrostHelper behoben wurde.

Der Bug betraf eine Kleinigkeit in der Hysterese-Berechnung des FrostHelpers.
Ich hatte dort anfangs nicht auf Ganzzahlen gerundet, was in seltenen Fällen zu minimalen Schwankungen beim Ein- und Ausschalten geführt hat.
Das ist inzwischen korrigiert, damit die Temperaturwerte sauber verarbeitet werden.

Die aktuelle Version ist bereits online und kann ganz normal über die gewohnte Update-Funktion geladen werden.

Viele Grüße
Dirk