iobroker.poolcontrol 1.3.20 → 1.3.21

package/README.md

@@ -188,6 +188,33 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.21 (2026-05-17)
+
+NEW: Follow-pump devices
+
+Added a new `actuators.follow_pump_devices` area.
+
+Up to three external devices can now automatically follow the operation of the main pump.
+
+Typical examples:
+
+- UV systems
+- Water features
+- Auxiliary filters
+- Additional circulation devices
+
+Features:
+
+- Automatic ON when the main pump starts
+- Automatic OFF when the main pump stops
+- Configurable target state per device
+- Validation of target states:
+  - state exists
+  - boolean type required
+  - writable required
+- Protection against invalid internal follow-pump targets
+- Persistent configuration values
+
 ### 1.3.20 (2026-05-13)
 
 - Added runtime self-healing for missed pump start events.
@@ -220,35 +247,6 @@ New features are added regularly – please refer to the changelog.
 - Reduced repeated solar notifications.
 - Added internal stability improvements.
 
-- Added new ORP/Redox chemistry preparation:
-  - new `chemistryOrpStates.js`
-  - new `chemistryOrpHelper.js`
-  - integrated ORP handling into `main.js`
-  - supports disabled/manual/state input modes
-  - ORP value handling in mV
-  - pH reference from `chemistry.ph.enabled` and `chemistry.ph.input.current_value`
-  - measurement location, pump and stabilization logic aligned with pH/TDS
-  - ORP evaluation without automatic dosing or chlorine control
-  - ORP 24h/7d/30d trend support
-  - ORP history support
-  - ORP text/HTML/JSON outputs
-
-- Added ORP i18n texts.
-- Aligned pH structure with TDS/ORP:
-  - added `chemistry.ph.history.*`
-  - added `chemistry.ph.trend.*`
-  - added `chemistry.ph.outputs.*`
-  - extended pH helper with history, trend and summary logic
-  - existing pH input, evaluation and mix-run logic remain backward compatible
-
-### 1.3.16 (2026-05-11)
-
-- Fixed circulation calculation in time mode when live flow values were not recalculated after helper-driven pump starts.
-- Improved speech system stability.
-- Stabilized runtime persistence.
-- Reduced repeated solar notifications.
-- Added internal stability improvements.
-
 - Added new ORP/Redox chemistry preparation:
   - new `chemistryOrpStates.js`
   - new `chemistryOrpHelper.js`

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.20",
+    "version": "1.3.21",
     "news": {
+      "1.3.21": {
+        "en": "Added new follow-pump devices. Up to three external devices can now automatically follow the main pump operation. Added validation for target states including existence, boolean type and writable checks. Added protection against internal follow-pump loops.",
+        "de": "Neue Geräte mit Pumpenlauf hinzugefügt. Bis zu drei externe Geräte können jetzt automatisch dem Lauf der Hauptpumpe folgen. Zusätzlich wurden Prüfungen für Ziel-Datenpunkte (Existenz, Boolean-Typ und Schreibbarkeit) ergänzt. Schutz gegen interne Follow-Pump-Schleifen hinzugefügt.",
+        "ru": "Добавлены новые устройства, следующие за работой насоса. До трёх внешних устройств теперь могут автоматически следовать за работой основного насоса. Добавлена проверка целевых состояний (существование, тип boolean и возможность записи). Добавлена защита от внутренних циклов Follow-Pump.",
+        "pt": "Adicionados novos dispositivos dependentes da bomba. Até três dispositivos externos podem agora seguir automaticamente o funcionamento da bomba principal. Adicionadas verificações para estados alvo (existência, tipo booleano e permissão de escrita). Adicionada proteção contra loops internos Follow-Pump.",
+        "nl": "Nieuwe apparaten met pompkoppeling toegevoegd. Tot drie externe apparaten kunnen nu automatisch de hoofdpomp volgen. Validatie voor doelstatussen toegevoegd inclusief bestaan, boolean-type en schrijfbaarheid. Bescherming tegen interne Follow-Pump-lussen toegevoegd.",
+        "fr": "Ajout de nouveaux appareils liés à la pompe. Jusqu'à trois appareils externes peuvent désormais suivre automatiquement le fonctionnement de la pompe principale. Validation des états cibles ajoutée (existence, type booléen et écriture). Protection contre les boucles internes Follow-Pump ajoutée.",
+        "it": "Aggiunti nuovi dispositivi collegati alla pompa. Fino a tre dispositivi esterni possono ora seguire automaticamente il funzionamento della pompa principale. Aggiunti controlli per gli stati di destinazione (esistenza, tipo booleano e scrivibilità). Aggiunta protezione contro i loop interni Follow-Pump.",
+        "es": "Añadidos nuevos dispositivos dependientes de la bomba. Hasta tres dispositivos externos ahora pueden seguir automáticamente el funcionamiento de la bomba principal. Se añadieron validaciones para estados destino (existencia, tipo booleano y escritura). Añadida protección contra bucles internos Follow-Pump.",
+        "pl": "Dodano nowe urządzenia podążające za pompą. Do trzech urządzeń zewnętrznych może teraz automatycznie podążać za pracą głównej pompy. Dodano sprawdzanie stanów docelowych (istnienie, typ boolean i możliwość zapisu). Dodano ochronę przed wewnętrznymi pętlami Follow-Pump.",
+        "uk": "Додано нові пристрої, що слідують за насосом. До трьох зовнішніх пристроїв тепер можуть автоматично працювати разом з головним насосом. Додано перевірку цільових станів (існування, тип boolean та можливість запису). Додано захист від внутрішніх циклів Follow-Pump.",
+        "zh-cn": "新增随泵运行设备。现在最多可让三个外部设备自动跟随主泵运行。增加了目标状态验证（存在性、布尔类型和可写性）。增加了内部 Follow-Pump 循环保护。"
+      },
       "1.3.20": {
         "en": "Added runtime self-healing for missed pump start events and protected time control states from being overwritten during adapter updates.",
         "de": "Runtime-Selbstheilung für verpasste Pumpenstart-Ereignisse ergänzt und Zeitsteuerungs-Datenpunkte vor dem Überschreiben bei Adapter-Updates geschützt.",
@@ -54,19 +67,6 @@
         "pl": "Naprawiono problem z pakowaniem wersji od wersji 1.3.16. Poprawiona stabilność systemu mowy, ustabilizowana trwałość czasu działania, zmniejszona liczba powtarzających się powiadomień słonecznych, stałe obliczanie cyrkulacji w trybie czasowym i przygotowany nowy obszar analizy chemicznej ORP/Redox.",
         "uk": "Виправлена ​​проблема упаковки випуску з версії 1.3.16. Покращена стабільність мовної системи, стабілізована стійкість під час виконання, зменшено кількість повторюваних сонячних сповіщень, виправлено обчислення циркуляції в часовому режимі та підготовлено нову область аналізу ORP/Redox.",
         "zh-cn": "修复了 v1.3.16 版本的打包问题。提高了语音系统的稳定性，稳定了运行时间的持久性，减少了重复的太阳通知，修复了时间模式下的循环计算，并准备了新的ORP/氧化还原化学分析区域。"
-      },
-      "1.3.16": {
-        "en": "Improved speech system stability, stabilized runtime persistence, reduced repeated solar notifications, fixed circulation calculation in time mode and prepared new ORP/Redox chemistry analysis area.",
-        "de": "Sprachsystem verbessert, Runtime-Persistenz stabilisiert, wiederholte Solarbenachrichtigungen reduziert, Umwälzberechnung im Zeitmodus korrigiert und neuer ORP-/Redox-Chemiebereich vorbereitet.",
-        "ru": "Улучшена стабильность речевой системы, стабилизировано постоянство времени выполнения, уменьшено количество повторных уведомлений о солнечной радиации, исправлен расчет циркуляции во временном режиме и подготовлена ​​новая область химического анализа ОВП/окислительно-восстановительного потенциала.",
-        "pt": "Melhor estabilidade do sistema de fala, persistência de tempo de execução estabilizada, redução de notificações solares repetidas, cálculo de circulação fixo no modo de tempo e nova área de análise química ORP/Redox preparada.",
-        "nl": "Verbeterde stabiliteit van het spraaksysteem, gestabiliseerde runtime-persistentie, minder herhaalde zonnemeldingen, vaste circulatieberekening in tijdmodus en voorbereid voor een nieuw ORP/Redox-chemieanalysegebied.",
-        "fr": "Amélioration de la stabilité du système vocal, persistance d'exécution stabilisée, réduction des notifications solaires répétées, calcul de la circulation fixe en mode temps et préparation d'une nouvelle zone d'analyse chimique ORP/Redox.",
-        "it": "Stabilità del sistema vocale migliorata, persistenza del tempo di esecuzione stabilizzata, notifiche solari ripetute ridotte, calcolo della circolazione fissa in modalità temporale e nuova area di analisi chimica ORP/Redox preparata.",
-        "es": "Se mejoró la estabilidad del sistema de voz, se estabilizó la persistencia del tiempo de ejecución, se redujeron las notificaciones solares repetidas, se arregló el cálculo de la circulación en el modo de tiempo y se preparó una nueva área de análisis de química ORP/Redox.",
-        "pl": "Poprawiona stabilność systemu mowy, ustabilizowana trwałość czasu działania, zmniejszona liczba powtarzających się powiadomień słonecznych, stałe obliczanie cyrkulacji w trybie czasowym i przygotowany nowy obszar analizy chemicznej ORP/Redox.",
-        "uk": "Покращена стабільність мовної системи, стабілізована стійкість під час виконання, зменшено кількість повторюваних сонячних сповіщень, виправлено обчислення циркуляції в часовому режимі та підготовлено нову область аналізу ORP/Redox.",
-        "zh-cn": "提高了语音系统的稳定性，稳定了运行时间的持久性，减少了重复的太阳通知，修复了时间模式下的循环计算，并准备了新的ORP/氧化还原化学分析区域。"
       }
     },
     "titleLang": {

package/lib/helpers/actuatorsHelper.js

@@ -30,10 +30,16 @@ const actuatorsHelper = {
         // 🔥 WICHTIG: Actuator-States abonnieren
         this.adapter.subscribeStates('actuators.*');
 
+        // NEU: Hauptpumpe abonnieren, damit Follow-Pump-Geräte reagieren können
+        this.adapter.subscribeStates('pump.pump_switch');
+
         // FIX: Config-Werte in interne States übernehmen
 
         await this._syncConfigToStates();
 
+        // NEU: Follow-Pump-Geräte beim Start prüfen und passend setzen
+        await this._updateFollowPumpDevices();
+
         this.adapter.log.info('[actuatorsHelper] initialized');
     },
 
@@ -41,7 +47,7 @@ const actuatorsHelper = {
     // Zentrale StateChange-Anbindung (aus main.js)
     // ======================================================
     async handleStateChange(id, state) {
-        if (!state || state.ack) {
+        if (!state) {
             return;
         }
 
@@ -49,6 +55,26 @@ const actuatorsHelper = {
             // FIX: ID normalisieren (poolcontrol.0.x -> x)
             const relId = this._toRelId(id);
 
+            // NEU: Follow-Pump-Geräte reagieren auch auf ack=true der internen Pumpenlogik
+            if (relId === 'pump.pump_switch') {
+                await this._updateFollowPumpDevices();
+                return;
+            }
+
+            if (!relId.startsWith('actuators.')) {
+                return;
+            }
+
+            if (state.ack) {
+                return;
+            }
+
+            // NEU: Änderungen an Follow-Pump-Geräten verarbeiten
+            if (relId.startsWith('actuators.follow_pump_devices.')) {
+                await this._handleFollowPumpDeviceChange(relId);
+                return;
+            }
+
             if (relId.endsWith('.switch')) {
                 await this._handleSwitch(relId, !!state.val);
                 return;
@@ -221,6 +247,155 @@ const actuatorsHelper = {
         }
     },
 
+    // ======================================================
+    // NEU: Follow-Pump-Geräte
+    // ======================================================
+    async _handleFollowPumpDeviceChange(relId) {
+        const parts = relId.split('.');
+
+        if (parts.length < 4) {
+            return;
+        }
+
+        const base = parts.slice(0, 3).join('.');
+
+        if (relId.endsWith('.enabled') || relId.endsWith('.target_state_id')) {
+            await this._validateFollowPumpDevice(base);
+            await this._syncFollowPumpDevice(base);
+        }
+    },
+
+    async _validateAllFollowPumpDevices() {
+        for (let i = 1; i <= 3; i++) {
+            await this._validateFollowPumpDevice(`actuators.follow_pump_devices.device${i}`);
+        }
+    },
+
+    async _updateFollowPumpDevices() {
+        for (let i = 1; i <= 3; i++) {
+            const base = `actuators.follow_pump_devices.device${i}`;
+
+            await this._validateFollowPumpDevice(base);
+            await this._syncFollowPumpDevice(base);
+        }
+    },
+
+    async _validateFollowPumpDevice(base) {
+        const targetId = String((await this._get(`${base}.target_state_id`, '')) || '').trim();
+
+        if (!targetId) {
+            await this._set(`${base}.target_valid`, false);
+            await this._set(`${base}.target_writeable`, false);
+            await this._set(`${base}.validation_text`, 'target_empty');
+            return false;
+        }
+
+        // NEU: Interne PoolControl-Ziele mit Schleifen-/Nebenwirkungsgefahr blockieren
+        const namespace = this.adapter?.namespace || '';
+
+        if (
+            namespace &&
+            (targetId === `${namespace}.pump.pump_switch` ||
+                targetId.startsWith(`${namespace}.actuators.follow_pump_devices.`))
+        ) {
+            await this._set(`${base}.target_valid`, false);
+            await this._set(`${base}.target_writeable`, false);
+            await this._set(`${base}.validation_text`, 'internal_target_not_allowed');
+            return false;
+        }
+
+        try {
+            const obj = await this.adapter.getForeignObjectAsync(targetId);
+
+            if (!obj || obj.type !== 'state') {
+                await this._set(`${base}.target_valid`, false);
+                await this._set(`${base}.target_writeable`, false);
+                await this._set(`${base}.validation_text`, 'state_not_found');
+                return false;
+            }
+
+            const isBoolean = obj.common && obj.common.type === 'boolean';
+            const isWriteable = obj.common && obj.common.write === true;
+
+            await this._set(`${base}.target_valid`, isBoolean);
+            await this._set(`${base}.target_writeable`, isWriteable);
+
+            if (!isBoolean) {
+                await this._set(`${base}.validation_text`, 'state_is_not_boolean');
+                return false;
+            }
+
+            if (!isWriteable) {
+                await this._set(`${base}.validation_text`, 'state_not_writeable');
+                return false;
+            }
+
+            await this._set(`${base}.validation_text`, 'OK');
+            return true;
+        } catch (err) {
+            await this._set(`${base}.target_valid`, false);
+            await this._set(`${base}.target_writeable`, false);
+            await this._set(`${base}.validation_text`, `validation_error: ${err.message}`);
+            return false;
+        }
+    },
+
+    async _syncFollowPumpDevice(base) {
+        const enabled = await this._get(`${base}.enabled`, false);
+        const targetValid = await this._get(`${base}.target_valid`, false);
+        const targetWriteable = await this._get(`${base}.target_writeable`, false);
+        const pumpRunning = await this._get('pump.pump_switch', false);
+
+        if (!enabled) {
+            if (targetValid && targetWriteable) {
+                await this._applyFollowPumpTarget(base, false);
+            }
+
+            await this._set(`${base}.active`, false);
+            await this._set(`${base}.status`, 'disabled');
+            return;
+        }
+
+        if (!targetValid || !targetWriteable) {
+            await this._set(`${base}.active`, false);
+            await this._set(`${base}.status`, 'invalid_target');
+            return;
+        }
+
+        if (pumpRunning) {
+            await this._applyFollowPumpTarget(base, true);
+            await this._set(`${base}.active`, true);
+            await this._set(`${base}.status`, 'running_with_pump');
+        } else {
+            await this._applyFollowPumpTarget(base, false);
+            await this._set(`${base}.active`, false);
+            await this._set(`${base}.status`, 'waiting_for_pump');
+        }
+    },
+
+    async _applyFollowPumpTarget(base, on) {
+        const targetId = String((await this._get(`${base}.target_state_id`, '')) || '').trim();
+
+        if (!targetId) {
+            return;
+        }
+
+        try {
+            await this.adapter.setForeignStateAsync(targetId, {
+                val: !!on,
+                ack: false,
+            });
+
+            this.adapter.log.debug(
+                `[actuatorsHelper] ${base}: follow-pump target "${targetId}" -> ${on ? 'ON' : 'OFF'}`,
+            );
+        } catch (err) {
+            this.adapter.log.warn(
+                `[actuatorsHelper] ${base}: follow-pump target set failed (${targetId}): ${err.message}`,
+            );
+        }
+    },
+
     // ======================================================
     // Externes Ziel schalten (aus jsonConfig)
     // ======================================================

package/lib/stateDefinitions/actuatorsStates.js

@@ -395,6 +395,198 @@ async function createActuatorsStates(adapter) {
             native: {},
         });
     }
+
+    // ======================================================
+    // Follow-Pump Geräte
+    // ======================================================
+    await adapter.setObjectNotExistsAsync('actuators.follow_pump_devices', {
+        type: 'channel',
+        common: {
+            name: {
+                en: 'Follow-pump devices',
+                de: 'Geräte mit Pumpenlauf',
+            },
+        },
+        native: {},
+    });
+
+    for (let i = 1; i <= 3; i++) {
+        const base = `actuators.follow_pump_devices.device${i}`;
+
+        await adapter.setObjectNotExistsAsync(base, {
+            type: 'channel',
+            common: {
+                name: {
+                    en: `Follow-pump device ${i}`,
+                    de: `Gerät mit Pumpenlauf ${i}`,
+                },
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.enabled`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Enabled',
+                    de: 'Aktiviert',
+                },
+                desc: {
+                    en: 'Enables this follow-pump device. If enabled, the configured target state is switched on when the main pump is running and switched off when the main pump stops.',
+                    de: 'Aktiviert dieses Gerät mit Pumpenlauf. Wenn aktiviert, wird der eingetragene Ziel-Datenpunkt eingeschaltet, sobald die Hauptpumpe läuft, und ausgeschaltet, sobald die Hauptpumpe stoppt.',
+                },
+                type: 'boolean',
+                role: 'switch',
+                read: true,
+                write: true,
+                def: false,
+                persist: true,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.name`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Name',
+                    de: 'Name',
+                },
+                desc: {
+                    en: 'Custom display name for this follow-pump device, for example UV lamp, water feature or auxiliary filter.',
+                    de: 'Frei vergebener Anzeigename für dieses Gerät mit Pumpenlauf, zum Beispiel UV-Lampe, Wasserspiel oder Zusatzfilter.',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: true,
+                def: '',
+                persist: true,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.target_state_id`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Target state ID',
+                    de: 'Ziel-Datenpunkt',
+                },
+                desc: {
+                    en: 'ioBroker state ID of the device that should follow the main pump. The target state must exist, must be writable and must be of type boolean.',
+                    de: 'ioBroker-Datenpunkt des Geräts, das dem Lauf der Hauptpumpe folgen soll. Der Ziel-Datenpunkt muss existieren, beschreibbar sein und den Typ boolean haben.',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: true,
+                def: '',
+                persist: true,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.target_valid`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Target valid',
+                    de: 'Ziel gültig',
+                },
+                desc: {
+                    en: 'Shows whether the configured target state exists and is of type boolean.',
+                    de: 'Zeigt an, ob der eingetragene Ziel-Datenpunkt existiert und vom Typ boolean ist.',
+                },
+                type: 'boolean',
+                role: 'indicator',
+                read: true,
+                write: false,
+                def: false,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.target_writeable`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Target writable',
+                    de: 'Ziel beschreibbar',
+                },
+                desc: {
+                    en: 'Shows whether the configured target state can be written by PoolControl.',
+                    de: 'Zeigt an, ob der eingetragene Ziel-Datenpunkt von PoolControl beschrieben werden kann.',
+                },
+                type: 'boolean',
+                role: 'indicator',
+                read: true,
+                write: false,
+                def: false,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.validation_text`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Validation text',
+                    de: 'Prüfmeldung',
+                },
+                desc: {
+                    en: 'Readable validation result for the configured target state, for example OK, target empty, state not found, state is not boolean or state is not writable.',
+                    de: 'Lesbare Prüfausgabe für den eingetragenen Ziel-Datenpunkt, zum Beispiel OK, Ziel leer, Datenpunkt nicht gefunden, Datenpunkt ist nicht boolean oder Datenpunkt ist nicht beschreibbar.',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: '',
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.active`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Active with pump',
+                    de: 'Mit Pumpe aktiv',
+                },
+                desc: {
+                    en: 'Shows whether this follow-pump device is currently switched on by PoolControl because the main pump is running.',
+                    de: 'Zeigt an, ob dieses Gerät aktuell von PoolControl eingeschaltet wurde, weil die Hauptpumpe läuft.',
+                },
+                type: 'boolean',
+                role: 'indicator',
+                read: true,
+                write: false,
+                def: false,
+            },
+            native: {},
+        });
+
+        await adapter.setObjectNotExistsAsync(`${base}.status`, {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Status',
+                    de: 'Status',
+                },
+                desc: {
+                    en: 'Current status of this follow-pump device, for example disabled, waiting_for_pump, running_with_pump or invalid_target.',
+                    de: 'Aktueller Status dieses Geräts mit Pumpenlauf, zum Beispiel deaktiviert, wartet auf Pumpenlauf, läuft mit Pumpe oder ungültiger Ziel-Datenpunkt.',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: '',
+            },
+            native: {},
+        });
+    }
 }
 
 module.exports = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "1.3.20",
+  "version": "1.3.21",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",