iobroker.poolcontrol 1.3.20 → 1.3.22

package/README.md

@@ -188,6 +188,40 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.22 (2026-05-24)
+
+- Improved ORP pH reference synchronization
+- ORP helper now updates pH reference independently from ORP value processing
+- Immediate update of ORP pH reference when pH enabled state or pH value changes
+- Fixed missing pH reference updates when ORP evaluation was blocked, invalid or waiting for measurement conditions
+
+### 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.
@@ -211,65 +245,6 @@ New features are added regularly – please refer to the changelog.
 - Added backward-compatible handling for previously stored German date strings.
 - Kept history JSON output unchanged with readable date strings for users and VIS displays.
 
-### 1.3.17 (2026-05-11)
-
-- Fixed release/upload issue from v1.3.16.
-- 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`
-  - 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`
-  - 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
-
 ## Support
 - [ioBroker Forum](https://forum.iobroker.net/)  
 - [GitHub Issues](https://github.com/DasBo1975/ioBroker.poolcontrol/issues)

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.3.20",
+    "version": "1.3.22",
     "news": {
+      "1.3.22": {
+        "en": "Improved ORP pH reference synchronization. The ORP helper now updates the pH reference independently from ORP value processing and immediately reflects pH state changes.",
+        "de": "ORP-pH-Referenz verbessert. Der ORP-Helper aktualisiert die pH-Referenz jetzt unabhängig von der ORP-Wertverarbeitung und übernimmt pH-Änderungen sofort.",
+        "ru": "Улучшена синхронизация эталонного значения pH ОВП. Помощник по ОВП теперь обновляет эталонное значение pH независимо от обработки значений ОВП и немедленно отражает изменения состояния pH.",
+        "pt": "Sincronização de referência de pH ORP aprimorada. O auxiliar ORP agora atualiza a referência de pH independentemente do processamento do valor ORP e reflete imediatamente as alterações do estado de pH.",
+        "nl": "Verbeterde ORP pH-referentiesynchronisatie. De ORP-helper werkt nu de pH-referentie onafhankelijk van de ORP-waardeverwerking bij en weerspiegelt onmiddellijk veranderingen in de pH-toestand.",
+        "fr": "Synchronisation améliorée de la référence ORP pH. L'assistant ORP met désormais à jour la référence pH indépendamment du traitement de la valeur ORP et reflète immédiatement les changements d'état du pH.",
+        "it": "Sincronizzazione del riferimento pH ORP migliorata. L'assistente ORP ora aggiorna il riferimento del pH indipendentemente dall'elaborazione del valore ORP e riflette immediatamente i cambiamenti dello stato del pH.",
+        "es": "Sincronización de referencia de pH ORP mejorada. El asistente de ORP ahora actualiza la referencia de pH independientemente del procesamiento del valor de ORP y refleja inmediatamente los cambios en el estado del pH.",
+        "pl": "Ulepszona synchronizacja odniesienia pH ORP. Pomocnik ORP aktualizuje teraz wartość odniesienia pH niezależnie od przetwarzania wartości ORP i natychmiast odzwierciedla zmiany stanu pH.",
+        "uk": "Покращена синхронізація еталонного pH ОВП. Помічник ОВП тепер оновлює еталонний рН незалежно від обробки значення ОВП і негайно відображає зміни стану рН.",
+        "zh-cn": "改进了 ORP pH 参考同步。 ORP 助手现在独立于 ORP 值处理更新 pH 参考值，并立即反映 pH 状态变化。"
+      },
+      "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.",
@@ -41,32 +67,6 @@
         "pl": "Naprawiono nieprawidłowe wyświetlanie daty dla stanów czasowych pH, ​​ORP i TDS poprzez przechowywanie stanów wartość.czas jako numeryczne znaczniki czasu.",
         "uk": "Виправлено неправильне відображення дати для часових станів pH, ORP і TDS шляхом збереження станів value.time як числових позначок часу.",
         "zh-cn": "通过将 value.time 状态存储为数字时间戳，修复了 pH、ORP 和 TDS 时间状态的不正确日期显示。"
-      },
-      "1.3.17": {
-        "en": "Fixed release packaging issue from v1.3.16. 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": "Release-/Uploadproblem aus v1.3.16 behoben. Sprachsystem verbessert, Runtime-Persistenz stabilisiert, wiederholte Solarbenachrichtigungen reduziert, Umwälzberechnung im Zeitmodus korrigiert und neuer ORP-/Redox-Chemiebereich vorbereitet.",
-        "ru": "Исправлена ​​проблема с упаковкой выпуска версии 1.3.16. Улучшена стабильность речевой системы, стабилизировано постоянство времени выполнения, уменьшено количество повторных уведомлений о солнечной радиации, исправлен расчет циркуляции во временном режиме и подготовлена ​​новая область химического анализа ОВП/окислительно-восстановительного потенциала.",
-        "pt": "Problema de empacotamento de lançamento corrigido da v1.3.16. 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": "Probleem met releaseverpakking vanaf v1.3.16 opgelost. Verbeterde stabiliteit van het spraaksysteem, gestabiliseerde runtime-persistentie, minder herhaalde zonnemeldingen, vaste circulatieberekening in tijdmodus en voorbereid voor een nieuw ORP/Redox-chemieanalysegebied.",
-        "fr": "Correction d'un problème d'emballage de version à partir de la v1.3.16. 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": "Risolto il problema relativo al pacchetto di rilascio dalla v1.3.16. 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 solucionó el problema del paquete de lanzamiento desde v1.3.16. 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": "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/helpers/chemistryOrpHelper.js

@@ -16,6 +16,7 @@ const chemistryOrpHelper = {
 
         void this._subscribeStates();
         void this._loadSourceState();
+        void this._updatePhReference();
         this._scheduleEvaluation('init', 500);
 
         this.adapter.log.debug('[chemistryOrpHelper] Initialized');
@@ -86,6 +87,10 @@ const chemistryOrpHelper = {
                 return;
             }
 
+            if (id.endsWith('chemistry.ph.enabled') || id.endsWith('chemistry.ph.input.current_value')) {
+                await this._updatePhReference();
+            }
+
             if (this._isRelevantOwnState(id)) {
                 this._scheduleEvaluation(`state_change:${id}`, 500);
             }

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.22",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",