Jahresrückblick 2025 – unser neuer Blogbeitrag ist online! ✨

[DasBo1975]

🏊‍♂️ ioBroker.poolcontrol – neues KI-Chemie-Hilfesystem (v0.8.2)

Hallo zusammen 👋,

mit Version 0.8.2 habe ich den PoolControl-Adapter um ein neues, rein informatives KI-Modul zur Poolchemie erweitert.

---

❓ Warum dieses Feature?

Wer sich mit Pools beschäftigt – egal ob im eigenen Garten oder in Foren – kennt diese Fragen:

• „pH zu hoch – was jetzt?“
• „Chlor steigt trotz Zugabe nicht“
• „Warum ist mein Wasser grün oder trüb?“
• „Warum riecht es nach Chlor, obwohl der Wert passt?“

Diese Fragen tauchen immer wieder auf –
in Pool-Foren, Facebook-Gruppen, Kommentaren und auch in privaten Nachrichten.

Die Antworten sind oft:

• verstreut über viele Seiten,
• teilweise widersprüchlich,
• oder sehr pauschal („kipp einfach mehr X rein“).

Genau hier setzt das neue Modul an.

---

🧠 Was macht das neue KI-Chemie-Hilfesystem?

Im Adapter gibt es jetzt einen eigenen Bereich:

ai.chemistry_help.*

Dort kann der Nutzer ein beobachtetes Problem auswählen, z. B.:

• pH-Wert zu niedrig / zu hoch
• Chlor zu niedrig / zu hoch
• Chlor wirkt nicht
• Wasser grün
• Wasser trüb / grau
• Schaumbildung
• Algen sichtbar
• Werte instabil
• Problem unklar

👉 Nach der Auswahl wird automatisch ein erklärender Hilfetext angezeigt, der:

• mögliche Ursachen erklärt
• wichtige Zusammenhänge (pH ↔ Chlor ↔ Filterung) beschreibt
• typische Lösungsrichtungen aufzeigt

---

⚠️ Ganz wichtig: Was dieses Modul bewusst NICHT tut

• ❌ keine Dosierungsangaben
• ❌ keine Produktempfehlungen
• ❌ keine automatische Steuerung
• ❌ keine Sprachausgaben
• ❌ keine Eingriffe in die bestehende Poollogik

Es handelt sich ausschließlich um Information und Einordnung, nicht um eine Chemie-Automatik.

---

📚 Woher kommen die Inhalte?

Die Texte basieren auf:

• gängigen Pool-Fachquellen,
• bewährten Empfehlungen aus dem Pool-Bereich,
• typischen Ursachen-/Wirkungszusammenhängen,
  wie sie auch in Fachartikeln und seriösen Pool-Ratgebern beschrieben werden.

👉 Keine zufälligen Antworten,
sondern bewusst formulierte, nachvollziehbare Erklärungen.

---

🎯 Ziel des Features

• weniger „Ratlosigkeit“ bei Poolproblemen
• weniger hektisches Nachdosieren
• besseres Verständnis für Wasserchemie
• schnelle Orientierung direkt im Adapter, ohne externe Recherche

Kurz gesagt:
Der Adapter hilft beim Verstehen – die Entscheidung bleibt beim Nutzer.

---

🔧 Technische Einordnung

• vollständig eventbasiert
• kein Einfluss auf bestehende Helper
• sauber getrennt vom übrigen KI-System
• jederzeit erweiterbar (weitere Problemfälle sind geplant)

---

Wie immer freue ich mich über:

• Feedback
• Ergänzungsvorschläge
• fachliche Hinweise

Viele Grüße
DasBo / Dirk
(ioBroker.poolcontrol)

[DasBo1975]

🔥 Neue Heizungs- / Wärmepumpensteuerung (ab v0.9.0)

Mit Version 0.9.0 wurde in ioBroker.poolcontrol eine neue Heizungs- bzw. Wärmepumpensteuerung integriert.
Die Steuerung ist vollständig eventbasiert, respektiert bestehende Prioritäten (Wartung, Saison, Pumpenmodus) und arbeitet ohne feste Timer oder Dauerloops.

Die Heizungslogik kann:

• eine schaltbare Steckdose
• oder einen booleschen Steuer-State (z. B. Relais, externer Adapter)

ansteuern und stellt zusätzlich Status- und Auswertedatenpunkte bereit.

📂 Überblick: Datenpunkte im Bereich heat.*

🔧 Steuer- & Konfigurationsdatenpunkte
heat.control_active

➡️ Heizungssteuerung aktivieren / deaktivieren

• true → Heizungslogik arbeitet
• false → Heizungslogik komplett deaktiviert

heat.control_type

➡️ Art der Heizungsansteuerung

• socket → schaltbare Steckdose
• boolean → boolescher Steuer-State

heat.control_object_id

➡️ Objekt-ID der Heizung / Wärmepumpe
Hier wird die externe Objekt-ID eingetragen, die geschaltet werden soll
(z. B. Steckdose, Relais, Heizungsfreigabe).

heat.target_temperature

➡️ Zieltemperatur des Pools
Solange die Pooltemperatur unterhalb dieses Wertes liegt, wird geheizt.

heat.max_temperature

➡️ Maximale Pooltemperatur (Sicherheitsabschaltung)
Wird dieser Wert erreicht oder überschritten, wird die Heizung sofort deaktiviert – unabhängig von anderen Bedingungen.

heat.pump_afterrun_minutes

➡️ Pumpen-Nachlaufzeit nach Heizende
Legt fest, wie lange die Pumpe nach dem Abschalten der Heizung noch weiterläuft
(z. B. zur Wärmeabfuhr oder Systemstabilisierung).

📊 Status- & Anzeige-Datenpunkte
heat.active

➡️ Heizung aktuell aktiv
Zeigt an, ob die Heizungslogik gerade aktiv heizt.

heat.heating_request

➡️ Interne Heizanforderung
Signalisiert, dass PoolControl aktuell Heizbedarf erkennt.
Dieser State kann extern ausgewertet werden (z. B. Visualisierung, andere Adapter).

heat.blocked

➡️ Heizung blockiert
Wird gesetzt, wenn die Heizungssteuerung bewusst nicht arbeiten darf, z. B.:

• Wartungsmodus aktiv
• Poolsaison inaktiv
• Pumpenmodus nicht „Automatik“

heat.mode

➡️ Aktueller Heizungsmodus
Beispiele:

• heating → Heizung läuft
• afterrun → Pumpennachlauf aktiv
• heat_disabled → Heizungssteuerung deaktiviert
• maintenance_active → durch Wartung blockiert
• max_temp_reached → Maximaltemperatur erreicht

heat.reason

➡️ Begründung für den aktuellen Heizungszustand
Klartext-Beschreibung, warum die Heizung gerade an, aus oder blockiert ist.

heat.info

➡️ Zusätzliche technische Informationen
Enthält ergänzende Hinweise zur aktuellen Steuerentscheidung
(z. B. Steuerart, Ziel-Objekt, Nachlauf).

heat.afterrun_active

➡️ Pumpen-Nachlauf aktiv
Zeigt an, ob die Pumpe aktuell noch aufgrund des Heizungs-Nachlaufs läuft.

heat.last_change

➡️ Zeitstempel der letzten Statusänderung
Hilfreich für Analyse, Logs und Visualisierungen.

🧠 Wichtige Design-Entscheidungen

✔️ Keine eigenen Timer-Schleifen

✔️ Vollständig eventbasiert

✔️ Ownership-Schutz:
Die Pumpe wird nur dann wieder ausgeschaltet, wenn sie zuvor vom HeatHelper selbst eingeschaltet wurde.

✔️ Vorrangschaltung:
Wartungsmodus blockiert die Heizungssteuerung immer.

✔️ Nur im Automatikmodus & aktiver Saison

Wichtige Ergänzung:

Mit dem neuen HeatHelper ist auch der Betrieb einer zweiten Pumpe für einen separaten Heiz- oder Wärmetauscher-Kreis möglich – ohne zusätzliche Speziallogik.

[sigi234]

@DasBo1975 sagte in Test Adapter PoolControl:

Überblick: Datenpunkte im Bereich heat.*

Wo sollte der DP sein?

poolcontrol.0
	2025-12-28 18:09:10.871	info	[aiForecastHelper] Initialisierung abgeschlossen
poolcontrol.0
	2025-12-28 18:09:10.871	info	[aiForecastHelper] Vorhersage für morgen erzeugt
poolcontrol.0
	2025-12-28 18:09:10.588	info	[aiForecastHelper] Erzeuge Vorhersage für morgen ...
poolcontrol.0
	2025-12-28 18:09:10.587	info	[aiForecastHelper] Starte einmalige Sofort-Vorhersage (Adapterstart)
poolcontrol.0
	2025-12-28 18:09:09.310	warn	statisticsHelperWeek: Berechneter Resetzeitpunkt liegt in der Vergangenheit – Korrigiere auf nächste Woche.
poolcontrol.0
	2025-12-28 18:09:09.153	info	[photovoltaicHelper] Pumpe AUS (mode_not_auto_pv, ohne Nachlauf)
poolcontrol.0
	2025-12-28 18:09:09.121	info	[aiHelper] Initialisierung abgeschlossen
poolcontrol.0
	2025-12-28 18:09:09.098	info	[aiChemistryHelpHelper] Initialisierung abgeschlossen
poolcontrol.0
	2025-12-28 18:09:09.094	info	[pumpHelper2] Erfolgreich initialisiert
poolcontrol.0
	2025-12-28 18:09:09.081	info	[aiForecastHelper] Forecast-Timer gesetzt für 20:06
poolcontrol.0
	2025-12-28 18:09:09.035	info	[aiHelper] KI ist aktiv – Timer werden gesetzt
poolcontrol.0
	2025-12-28 18:09:08.945	info	[controlHelper2] Rückspülerinnerung initialisiert (täglicher Check um 12:00 Uhr).
poolcontrol.0
	2025-12-28 18:09:08.945	info	[controlHelper] initialisiert
poolcontrol.0
	2025-12-28 18:09:08.943	info	[aiChemistryHelpHelper] Initialisierung gestartet
poolcontrol.0
	2025-12-28 18:09:08.943	info	[aiForecastHelper] Initialisierung gestartet
poolcontrol.0
	2025-12-28 18:09:08.942	info	[aiHelper] Initialisierung gestartet
poolcontrol.0
	2025-12-28 18:09:08.942	info	[photovoltaicHelper] Initialisierung abgeschlossen.
poolcontrol.0
	2025-12-28 18:09:08.942	info	[photovoltaicHelper] Subscribed: PV="0_userdata.0.Pool.PV.Erzeugungsleistung", Haus="0_userdata.0.Pool.PV.Hausverbrauch"
poolcontrol.0
	2025-12-28 18:09:08.942	info	[heatHelper] Initialisierung abgeschlossen.
poolcontrol.0
	2025-12-28 18:09:08.940	info	[pumpHelper4] Erfolgreich initialisiert
poolcontrol.0
	2025-12-28 18:09:08.939	info	[pumpHelper4] Initialisierung gestartet (OID: 0_userdata.0.Pool.Drucksensor.Druck)
poolcontrol.0
	2025-12-28 18:09:08.939	info	[pumpHelper3] Erfolgreich initialisiert
poolcontrol.0
	2025-12-28 18:09:08.938	info	[pumpHelper3] Initialisierung gestartet
poolcontrol.0
	2025-12-28 18:09:08.937	info	[pumpHelper2] Initialisierung gestartet
poolcontrol.0
	2025-12-28 18:09:08.931	info	[migrationHelper] Migration-Helper beendet.
poolcontrol.0
	2025-12-28 18:09:08.784	info	[migrationHelper] Starte Migration-Check ...
poolcontrol.0
	2025-12-28 18:09:08.372	info	[createPhotovoltaicStates] Initialisierung abgeschlossen.
poolcontrol.0
	2025-12-28 18:09:08.208	info	Adapter gestartet
poolcontrol.0
	2025-12-28 18:09:08.200	info	starting. Version 0.9.0 (non-npm: DasBo1975/ioBroker.poolcontrol) in C:/SmartHome/node_modules/iobroker.poolcontrol, node: v22.21.1, js-controller: 7.1.0
poolcontrol.0
	2025-12-28 18:09:03.127	info	terminating
poolcontrol.0
	2025-12-28 18:09:03.127	info	terminating
poolcontrol.0
	2025-12-28 18:09:02.620	info	Terminated (ADAPTER_REQUESTED_TERMINATION): Without reason
poolcontrol.0
	2025-12-28 18:09:02.620	info	terminating
poolcontrol.0
	2025-12-28 18:09:02.617	info	Got terminate signal TERMINATE_YOURSELF 

[DasBo1975]

@sigi234 sagte in Test Adapter PoolControl:

@DasBo1975 sagte in Test Adapter PoolControl:

Überblick: Datenpunkte im Bereich heat.*

Wo sollte der DP sein?

[sigi234]

@DasBo1975

Ok, der DP musste zuerst auf true geschaltet werden , dann kamen die DP

[claus1993]

@dasbo1975

für die Heizungssteuerung würde ich eine "Pumpen-Vorlaufzeit vor Heizstart" benötigen.

Hintergrund ist das bei mir die Wärmepumpe eine Fehlermeldung ausgibt wenn kein Wasserdruck vorhanden ist. Wenn die Pumpe jedoch vor der Heizung eingeschaltet wird, passt alles.

Wäre super wenn du das einbauen könntest :-)

[DasBo1975]

v0.9.1 – Heizungssteuerung: Pumpen-Vorlauf

✨ Neu

• Konfigurierbarer Pumpen-Vorlauf vor Heizstart.
• Die Pumpe kann nun für eine definierte Zeit vor dem Einschalten der Heizung gestartet werden, um ausreichend Wasserdurchfluss und Druck sicherzustellen (z. B. bei Wärmepumpen).
• Neue Datenpunkte:
  • heat.pump_prerun_minutes
  • heat.prerun_active

🔒 Sicherheit & Integration

• Vollständig integriert in die bestehende Vorrangs-, Ownership- und Sicherheitslogik.
• Arbeitet ausschließlich im Automatikmodus der Pumpe und berücksichtigt den Saisonstatus sowie den Wartungsmodus.

Danke an claus1993 für das praxisnahe Feedback und die Feature-Anfrage.

🔹 heat.pump_prerun_minutes

Pumpen-Vorlaufzeit vor Heizstart (in Minuten)

Dieser Datenpunkt legt fest, wie lange die Pumpe laufen soll, bevor die Heizung eingeschaltet wird.

0 → kein Vorlauf
Die Heizung startet sofort, sobald Heizbedarf erkannt wird.

0 → Vorlauf aktiv
Die Pumpe wird zuerst eingeschaltet und läuft die eingestellte Zeit,
erst danach wird die Heizung aktiviert.

👉 Typischer Einsatz:
Wärmepumpen oder Heizgeräte, die Wasserdruck / Durchfluss benötigen,
bevor sie starten dürfen.

🔹 heat.prerun_active

Status: Pumpen-Vorlauf aktiv

Dieser Datenpunkt zeigt an, ob gerade ein Pumpen-Vorlauf läuft.

true
→ Der Vorlauf ist aktiv
(Pumpe läuft bereits, Heizung ist noch aus)

false
→ Kein Vorlauf aktiv (normaler Zustand)

(null)
→ Der Vorlauf wurde noch nie ausgelöst, seit der Adapter läuft

⚠️ Wichtig:
prerun_active wird nicht beim Start auf false gesetzt, sondern erst dann beschrieben,
wenn der Vorlauf tatsächlich gebraucht wird.
Das ist Absicht und unterscheidet:

„existiert, wurde aber noch nie genutzt“
von

„war aktiv und ist jetzt beendet“

[claus1993]

@dasbo1975 Danke dir!

[DasBo1975]

ioBroker.poolcontrol v1.0.0

✨ Neues Feature: Zusatz-Aktoren (Beleuchtung & Zusatzpumpen)

Mit Version 1.0.0 wird der Adapter um einen neuen Bereich Zusatz-Aktoren erweitert.
Damit können optionale Verbraucher wie Poolbeleuchtung, Attraktionen oder Zusatzpumpen direkt aus dem Adapter heraus gesteuert werden.

Funktionen im Überblick

• Steuerung von bis zu 3 Beleuchtungen und 3 Zusatzpumpen / Attraktionen
• Ansteuerung externer Geräte über konfigurierbare Objekt-IDs (z. B. Schaltsteckdosen)
• Manuelles Ein- und Ausschalten über eigene States
• Optionaler Dauerbetrieb
• Zeitgesteuerter Betrieb mit Laufzeitvorgabe und Restlaufzeit-Anzeige
• Klarer, schreibgeschützter Status-State pro Aktor
• Aktoren sind nur aktiv, wenn sie in der Instanz-Konfiguration freigegeben wurden
• Kein Eingriff in bestehende Pumpen-, Solar- oder Heizlogik
• Vollständig eventbasiert, ohne Polling

Technische Hinweise

• Alle Aktor-States sind fest angelegt und dauerhaft verfügbar
• Die Ansteuerung externer Geräte erfolgt direkt über die in der Admin-UI hinterlegte Objekt-ID
• Die Logik ist vollständig gekapselt im neuen actuatorsHelper
• Bestehende Installationen bleiben vollständig kompatibel

[DasBo1975]

Version 1.0.1

"Bugfix-Release. Behebt unvollständige Wettercode-Beschreibungen im KI-Wettervorhersagemodul durch vollständige Anpassung an die offizielle Open-Meteo-Wettercode-Spezifikation. Dadurch wird verhindert, dass rohe numerische Wettercodes in Benachrichtigungen, Sprachausgaben oder KI-generierten Texten erscheinen, und es werden durchgehend verständliche Klartext-Beschreibungen sichergestellt.