Test Adapter pondpump v0.5.0

cybertron

Aktuelle Test Version	0.5.0
Veröffentlichungsdatum	09.09.2026x
Github Link	https://github.com/ssbingo/ioBroker.pondpump

Test Adapter pondpump V0.5.0

Hallo zusammen,

ich möchte euch meinen Adapter pondpump (aktuell v0.5.0) zum Testen vorstellen. Er steuert und überwacht OASE AquaMax Eco Titanium Teichpumpen (Artikel 73656) über den OASE Garden Controller Cloud (EGC) (Artikel 55317) – lokal im LAN und/oder über die OASE-Cloud.

Der Adapter ist bewusst getrennt vom bestehenden oasecontrol-Adapter (der die Steckdosen-Controller abdeckt) und komplett neu geschrieben. Das Protokoll wurde eigenständig analysiert.

Was der Adapter kann

Cloud- oder lokaler Betrieb (sich gegenseitig ausschließend, umschaltbar)
Live-Telemetrie je Pumpe: Leistung (W), Drehzahl (U/min), Temperatur (°C), Netzspannung (V)
Steuerung: Ein/Aus, Drehzahl/Leistung in % (Slider + 5-%-Schnellwahl)
SFC (Seasonal Flow Control) – OASEs saisonale Durchflussregelung – schaltbar
Zwei vis-2-Widgets: Pumpen-Visualisierung (Flügelrad/Eiskristall) + Steuerung
Zeitpläne pro Pumpe: je Pumpe ein eigener Admin-Tab mit nicht-überlappenden Zeitfenstern (Power % oder SFC an/aus) + Grund-Power
Temperatur-/wetterabhängige Regelung (neu): eine Wassertemperatur-Kurve legt den Grunddurchfluss fest (Standardkurve als Preset); Wetterregeln können den Durchfluss nur anheben oder Aktoren schalten (Belüfter, Bachlauf …); dazu Mindestleistung (Q_min), Temperatur-Glättung, Hysterese und Rampenbegrenzung, plus Notlauf auf 100 % bei Sensorausfall
Wassertemperatur-Sensor-Auswahl (neu): je Pumpe wählbar, welcher Geräte-Sensor die Wassertemperatur liefert (im Admin mit Live-Wert angezeigt); der Wert landet in einem eigenen State telemetry.waterTemperature und belegt die Kurvenquelle vor

Hinweis: Die Pumpen-Telemetrie telemetry.temperature ist die Geräte-, nicht zwingend die Wassertemperatur – daher die Sensor-Auswahl bzw. die Option, einen externen Wasserfühler als Quelle zu wählen.

Voraussetzungen

js-controller ≥ 6.0.11
admin ≥ 8.0.11 (die Scheduler-Oberfläche nutzt die neue React-19/MUI-9-Admin-Technik)
Node.js ≥ 22

Installation

Über den latest-Repo installierbar (Adapter „pondpump"), alternativ direkt aus npm/GitHub.

Einrichtung (kurz)

Cloud-Modus: einmalig einen Refresh-Token aus einem OASE-App-Login abgreifen und in den Instanz-Einstellungen hinterlegen (das Kontopasswort wird nie gespeichert). Eine Schritt-für-Schritt-Anleitung mit mitmproxy liegt dem Handbuch bei.
Lokaler Modus: Controller-IP + Gerätepasswort eintragen.

Worauf ich besonders Feedback brauche

Erkennung der Pumpen (Cloud- und lokaler Modus)
Zuverlässigkeit der Steuerung (Ein/Aus, Leistung, SFC)
Plausibilität der Telemetriewerte bei euren Modellen
Wassertemperatur-Sensor: Welcher Geräte-Sensor zeigt bei euren Pumpen die Wassertemperatur? (Live-Werte im Auswahlfeld mit einem Thermometer vergleichen)
Temperatur-/Wettersteuerung: Kurve, Wetterregeln (Anheben/Halten/SFC/Aktor setzen), Glättung/Hysterese/Rampe – verständlich und sinnvoll eingestellt?
Zeitpläne: Anlegen, Speichern, Überschneidungsprüfung, Ausführung an den Fenstergrenzen
vis-2-Widgets

Links

GitHub: https://github.com/ssbingo/ioBroker.pondpump
npm: https://www.npmjs.com/package/iobroker.pondpump
Changelog: siehe README

Über Rückmeldungen (gern mit Debug-Log bei Problemen: Instanz-Loglevel auf debug, Secrets werden nie geloggt) freue ich mich sehr. Danke fürs Testen! 🐟

Hinweis: inoffizielles Community-Projekt, nicht mit der OASE GmbH verbunden. Nutzung auf eigenes Risiko.

cybertron

Aktuelle Test Version	0.12.1
Veröffentlichungsdatum	10.09.2026x
Github Link	https://github.com/ssbingo/ioBroker.pondpump

Titel: Test Adapter pondpump V0.12.1

Hallo zusammen,

großes Update zu meinem Adapter pondpump – inzwischen bei v0.12.1. Er steuert und überwacht OASE AquaMax Eco Titanium Teichpumpen (Artikel 73656) über den OASE Garden Controller Cloud (EGC) (Artikel 55317) – lokal im LAN und/oder über die OASE-Cloud.

Der Adapter ist bewusst getrennt vom bestehenden oasecontrol-Adapter (der die Steckdosen-Controller abdeckt) und komplett neu geschrieben. Das Protokoll wurde eigenständig analysiert.

Neu in der Visualisierung (vis-2)

Neues Widget „Scheduler-Status" (PumpScheduler): zeigt auf einen Blick, was der eingebaute Scheduler gerade mit einer Pumpe macht – und warum: aktuelle Ausgabe + Zielleistung, Status-Abzeichen (aktiv / manuell / Notlauf), Begründungs-Chips (Temperaturkurve, Zeitfenster, Grundlast, Nachtschutz, Wetter-Boost, Frost-Halt), das aktive Fenster, die nächste Änderung, Sonnenauf-/-untergang und die Wassertemperatur – dazu Live-Werte und eine Steuerleiste (An/Aus, Leistungs-Schnellwahl, SFC).
Benannte Aktoren mit Icon: Ein Aktor-Zeitfenster (Wasserfall, Bachlauf, Sauerstoffpumpe …) bekommt jetzt einen Namen und ein wählbares Icon. Im Scheduler-Widget erscheint jeder Aktor über der Telemetrie als Icon – Name – kleines hellgrünes Flügelrad, das sich dreht, solange der Aktor an ist. Jeder Aktor lässt sich im Widget einzeln ein-/ausblenden.
Wassertemperatur im Visualisierungs-Widget: Liegt ein Wassertemperatur-Wert vor, zeigt das PumpVisual-Widget neben dem Flügelrad ein farbcodiertes Thermometer mit dem Wert.
Status-Objekte je Pumpe: neue read-only States pumps.<n>.schedule.* (Zielleistung, Grund, aktives Fenster, nächste Änderung, Aktoren …) – auch in Skripten/History nutzbar.

Steuerung & Regelung (seit V0.5.0)

Maximalleistung je Pumpe: je Pumpe ein Max-Wert (z. B. 90 %) – eine harte Obergrenze, die die Kurve, jede Wetter-Anhebung und den Notlauf deckelt.
Astronomische Zeitfenster: Fenster können an Sonnenauf-/-untergang ausgerichtet werden (mit optionalem Offset in Minuten), nicht nur an fester Uhrzeit.
Standortauswahl mit interaktiver Karte: wahlweise pro Instanz oder pro Pumpe. Der Standort bestimmt die Sonnenzeiten – Eingabe über eine OpenStreetMap-Karte, per Adresssuche oder Koordinaten; ein Klick übernimmt den ioBroker-Systemstandort.
Nachtschutz (statt Nachtabsenkung): wissenschaftlich begründet – eine sommerliche Nachtabsenkung ist kontraproduktiv (O₂-Minimum nachts). Der Adapter senkt nachts nicht ab, sondern hält bei ausreichend warmem Wasser optional einen Mindestdurchfluss.
Verständlichere Scheduler-Einstellungen: alle Felder mit Erklärtexten und Wertvorschlägen.
Ausführlichstes Debugging: die komplette Regelentscheidung je Pumpe ist im Log nachvollziehbar (siehe unten).

Was der Adapter insgesamt kann

Cloud- oder lokaler Betrieb (sich gegenseitig ausschließend, umschaltbar)
Live-Telemetrie je Pumpe: Leistung (W), Drehzahl (U/min), Temperatur (°C), Netzspannung (V)
Steuerung: Ein/Aus, Drehzahl/Leistung in % (Slider + 5-%-Schnellwahl)
SFC (Seasonal Flow Control) – OASEs saisonale Durchflussregelung – schaltbar
Drei vis-2-Widgets: Pumpen-Visualisierung (Flügelrad/Eiskristall + Wassertemperatur-Thermometer), Steuerung und Scheduler-Status
Zeitpläne pro Pumpe: je Pumpe ein eigener Admin-Tab mit nicht-überlappenden Zeitfenstern – nach Uhrzeit oder Sonnenstand – für Power %, SFC an/aus oder Aktorschaltung (mit Name + Icon)
Temperatur-/wetterabhängige Regelung: eine Wassertemperatur-Kurve legt den Grunddurchfluss fest; Wetterregeln können den Durchfluss nur anheben, halten, SFC schalten oder Aktoren setzen; dazu Mindest-/Maximalleistung (Q_min/Q_max), Temperatur-Glättung, Hysterese und Rampenbegrenzung, plus Notlauf auf 100 % bei Sensorausfall
Wassertemperatur-Sensor-Auswahl: je Pumpe wählbar (Geräte-Sensor oder externer Fühler als Kurvenquelle); der effektiv genutzte Wert landet in telemetry.waterTemperature
Astro-States je Pumpe: astro.sunrise, astro.sunset (+ Zeitstempel) und astro.isDay

Hinweis: Die Pumpen-Telemetrie telemetry.temperature ist die Geräte-, nicht zwingend die Wassertemperatur – daher die Sensor-Auswahl bzw. die Option, einen externen Wasserfühler als Quelle zu wählen.

Voraussetzungen

js-controller ≥ 6.0.11
admin ≥ 8.0.11 (Scheduler-Oberfläche + Standortkarte nutzen die neue React-19/MUI-9-Admin-Technik)
Node.js ≥ 22

Installation

Über den latest-Repo installierbar (Adapter „pondpump"), alternativ direkt aus npm/GitHub.

Einrichtung (kurz)

Cloud-Modus: einmalig einen Refresh-Token aus einem OASE-App-Login abgreifen und in den Instanz-Einstellungen hinterlegen (das Kontopasswort wird nie gespeichert). Anleitung mit mitmproxy liegt dem Handbuch bei.
Lokaler Modus: Controller-IP + Gerätepasswort eintragen.
Standort: unter „Standort" pro Instanz oder pro Pumpe setzen – nötig für die Sonnen-Zeitfenster und den Nachtschutz.
Widgets: in vis-2 aus der Gruppe „Pond Pump" ziehen und nur die Pumpe wählen. Das Scheduler-Status-Widget zeigt Ziel/Fenster/Aktoren, sobald für die Pumpe ein Zeitplan/Kurve aktiviert ist – sonst korrekt „Manuell / aus".

Debugging – bitte bei Problemen mitliefern

Instanz-Loglevel auf debug stellen: Der Adapter protokolliert dann bei jeder Scheduler-Auswertung die komplette Entscheidungskette je Pumpe – Eingangswerte (roh/geglättet/gemappte Wassertemperatur, alle Quell-States, Sonnenauf-/-untergang, Tag/Nacht), die einzelnen Schritte (Basis aus Kurve/Fenster, Q_min, Nachtschutz, jede greifende Wetterregel, Aktor-Fenster, Q_max) bis zur finalen Leistung/SFC, sowie Rampen-/Halte-Status und der nächste Auswertungszeitpunkt. Ebenso werden Standort-Auflösung und Adress-Geocoding geloggt. Secrets (Passwörter/Token) werden nie geloggt.

Worauf ich besonders Feedback brauche

Erkennung der Pumpen (Cloud- und lokaler Modus)
Zuverlässigkeit der Steuerung (Ein/Aus, Leistung, SFC)
Plausibilität der Telemetriewerte bei euren Modellen
Scheduler-Status-Widget: verständlich? Stimmen Zielleistung, Grund-Chips, Fenster, nächste Änderung und die Aktor-Zeilen?
Aktoren: Name/Icon setzen, Anzeige (Icon – Name – Flügelrad), Ein-/Ausblenden je Aktor
Wassertemperatur-Sensor: Welcher Geräte-Sensor zeigt bei euren Pumpen die Wassertemperatur? Externer Fühler als Quelle?
Temperatur-/Wettersteuerung: Kurve, Wetterregeln, Q_min/Q_max, Glättung/Hysterese/Rampe – sinnvoll einstellbar?
Standort/Karte: Lädt die Karte im Admin? Marker, Adresssuche, „Systemstandort übernehmen"? (Bei geblockten Kacheln bitte melden.)
Sonnen-Zeitfenster & Nachtschutz: stimmen die Sonnenzeiten? Verhält sich der Nachtschutz wie erwartet?
Zeitpläne: Anlegen, Speichern, Überschneidungsprüfung, Ausführung an den Fenstergrenzen

Links

GitHub: https://github.com/ssbingo/ioBroker.pondpump
npm: https://www.npmjs.com/package/iobroker.pondpump
Changelog: siehe README

Über Rückmeldungen (gern mit Debug-Log, siehe oben) freue ich mich sehr. Danke fürs Testen! 🐟

Hinweis: inoffizielles Community-Projekt, nicht mit der OASE GmbH verbunden. Nutzung auf eigenes Risiko.

Community Forum

NEWS

Test Adapter pondpump v0.5.0