iobroker.poolcontrol 0.9.0 → 0.9.1

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.9.0",
+    "version": "0.9.1",
     "news": {
+       "0.9.1": {
+         "en": "Extended heating / heat pump control (heatHelper) with configurable pump pre-run before heating start. The pump can now be started a defined time before the heater is activated to ensure sufficient water flow and pressure (e.g. for heat pumps). Includes new states for pre-run timing and status, fully integrated into the existing priority, ownership, and safety logic.",
+         "de": "Erweiterte Heizungs- / Wärmepumpensteuerung (heatHelper) um eine konfigurierbare Pumpen-Vorlaufzeit 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). Enthält neue Datenpunkte für Vorlaufzeit und Vorlaufstatus, vollständig integriert in die bestehende Vorrangs-, Ownership- und Sicherheitslogik.",
+         "ru": "Расширенная система управления отоплением / тепловым насосом (heatHelper) с настраиваемым предварительным запуском насоса перед началом нагрева. Насос может запускаться за заданное время до включения отопления для обеспечения достаточного потока и давления воды (например, для тепловых насосов). Добавлены новые состояния для времени предварительного запуска и его статуса, полностью интегрированные в существующую логику приоритетов, владения и безопасности.",
+         "pt": "Controlo de aquecimento / bomba de calor (heatHelper) alargado com pré-funcionamento configurável da bomba antes do início do aquecimento. A bomba pode agora ser ligada durante um período definido antes da ativação do aquecedor para garantir caudal e pressão de água suficientes (por exemplo, em bombas de calor). Inclui novos estados para tempo e estado do pré-funcionamento, totalmente integrados na lógica existente de prioridades, propriedade e segurança.",
+         "nl": "Uitgebreide verwarmings- / warmtepompregeling (heatHelper) met configureerbare pomp-voorloop vóór de start van de verwarming. De pomp kan nu een ingestelde tijd vóór het inschakelen van de verwarming worden gestart om voldoende waterdoorstroming en druk te garanderen (bijv. voor warmtepompen). Bevat nieuwe states voor voorlooptijd en -status, volledig geïntegreerd in de bestaande prioriteits-, eigendoms- en veiligheidslogica.",
+         "fr": "Extension du contrôle de chauffage / pompe à chaleur (heatHelper) avec un préfonctionnement configurable de la pompe avant le démarrage du chauffage. La pompe peut désormais être démarrée un temps défini avant l’activation du chauffage afin d’assurer un débit et une pression d’eau suffisants (par ex. pour les pompes à chaleur). Ajout de nouveaux états pour la durée et le statut du préfonctionnement, entièrement intégrés à la logique existante de priorité, de propriété et de sécurité.",
+         "it": "Controllo di riscaldamento / pompa di calore (heatHelper) esteso con pre-avviamento configurabile della pompa prima dell’inizio del riscaldamento. La pompa può ora essere avviata per un periodo definito prima dell’attivazione del riscaldamento per garantire un flusso e una pressione dell’acqua sufficienti (ad es. per le pompe di calore). Include nuovi stati per il tempo e lo stato del pre-avviamento, completamente integrati nella logica esistente di priorità, proprietà e sicurezza.",
+         "es": "Control de calefacción / bomba de calor (heatHelper) ampliado con prefuncionamiento configurable de la bomba antes del inicio de la calefacción. La bomba puede iniciarse ahora durante un tiempo definido antes de activar la calefacción para garantizar un caudal y una presión de agua suficientes (p. ej., para bombas de calor). Incluye nuevos estados para el tiempo y el estado del prefuncionamiento, totalmente integrados en la lógica existente de prioridades, propiedad y seguridad.",
+         "pl": "Rozszerzony system sterowania ogrzewaniem / pompą ciepła (heatHelper) o konfigurowalny wstępny bieg pompy przed rozpoczęciem grzania. Pompa może być uruchamiana na określony czas przed włączeniem ogrzewania w celu zapewnienia odpowiedniego przepływu i ciśnienia wody (np. dla pomp ciepła). Dodano nowe stany dla czasu i statusu biegu wstępnego, w pełni zintegrowane z istniejącą logiką priorytetów, własności i bezpieczeństwa.",
+         "uk": "Розширене керування опаленням / тепловим насосом (heatHelper) з налаштовуваним попереднім запуском насоса перед початком нагріву. Насос може запускатися за визначений час до увімкнення опалення для забезпечення достатнього потоку та тиску води (наприклад, для теплових насосів). Додано нові стани для часу та статусу попереднього запуску, повністю інтегровані в існуючу логіку пріоритетів, володіння та безпеки.",
+         "zh-cn": "扩展了加热 / 热泵控制功能（heatHelper），新增可配置的加热前水泵预运行时间。水泵可在加热设备启动前提前运行一段时间，以确保足够的水流和水压（例如用于热泵）。新增了预运行时间和状态的数据点，已完全集成到现有的优先级、所有权和安全逻辑中。"
+       },
        "0.9.0": {
          "en": "New heating / heat pump control (heatHelper). Automatic control based on pool temperature with configurable target and maximum temperature, pump after-run time, and full priority handling (e.g. maintenance mode). Works only in automatic pump mode and respects season status. Supports both switchable sockets and boolean control states. Includes ownership protection to avoid interfering with other pump controllers.",
          "de": "Neue Heizungs- / Wärmepumpensteuerung (heatHelper). Automatische Regelung basierend auf der Pooltemperatur mit konfigurierbarer Ziel- und Maximaltemperatur, Pumpen-Nachlaufzeit sowie vollständiger Vorranglogik (z. B. Wartungsmodus). Arbeitet ausschließlich im Automatikmodus der Pumpe und berücksichtigt den Saisonstatus. Unterstützt schaltbare Steckdosen und boolesche Steuer-States. Enthält Ownership-Schutz, um Konflikte mit anderen Pumpensteuerungen zu vermeiden.",
@@ -80,19 +93,6 @@
          "pl": "Poprawka pozdrowień sezonowych: życzenia świąteczne pojawiają się teraz prawidłowo tylko między 20 a 27 grudnia. Błędna przedwczesna aktywacja została naprawiona.",
          "uk": "Виправлено сезонні вітання: Різдвяне привітання тепер з’являється лише з 20 по 27 грудня. Помилкове передчасне спрацьовування виправлено.",
          "zh-cn": "修复季节性问候：圣诞问候现在仅在 12 月 20 日至 27 日之间显示。已修复错误的提前触发问题。"
-       },
-       "0.7.2": {
-         "en": "Added new info system: The adapter now writes seasonal greetings and the installed adapter version to info.* states. Includes automatic daily refresh at 00:01 and full Easter date calculation.",
-         "de": "Neues Info-System hinzugefügt: Der Adapter schreibt nun saisonale Grüße und die installierte Adapterversion in die info.* States. Enthält eine automatische tägliche Aktualisierung um 00:01 sowie eine vollständige Oster-Berechnung.",
-         "ru": "Добавлена новая информационная система: адаптер теперь записывает сезонные поздравления и установленную версию адаптера в состояния info.*. Включает ежедневное обновление в 00:01 и полный расчёт даты Пасхи.",
-         "pt": "Novo sistema de informações adicionado: o adaptador agora grava saudações sazonais e a versão instalada do adaptador nos estados info.*. Inclui atualização diária automática às 00:01 e cálculo completo da data da Páscoa.",
-         "nl": "Nieuw infosysteem toegevoegd: de adapter schrijft nu seizoensgroeten en de geïnstalleerde adapterversie naar info.*-states. Inclusief automatische dagelijkse update om 00:01 en volledige berekening van Pasen.",
-         "fr": "Nouveau système d'informations ajouté : l'adaptateur écrit désormais des messages saisonniers et la version installée dans les états info.*. Comprend une mise à jour quotidienne automatique à 00:01 et un calcul complet de la date de Pâques.",
-         "it": "Aggiunto nuovo sistema informativo: l'adattatore ora scrive i saluti stagionali e la versione installata negli stati info.*. Include aggiornamento giornaliero automatico alle 00:01 e calcolo completo della data di Pasqua.",
-         "es": "Nuevo sistema de información añadido: el adaptador ahora escribe saludos estacionales y la versión instalada en los estados info.*. Incluye actualización automática diaria a las 00:01 y cálculo completo de la fecha de Pascua.",
-         "pl": "Dodano nowy system informacji: adapter zapisuje teraz sezonowe pozdrowienia oraz zainstalowaną wersję adaptera w stanach info.*. Zawiera automatyczne codzienne odświeżanie o 00:01 oraz pełne wyliczenie daty Wielkanocy.",
-         "uk": "Додано нову інформаційну систему: адаптер тепер записує сезонні привітання та встановлену версію адаптера в стани info.*. Містить щоденне автоматичне оновлення о 00:01 і повний розрахунок дати Великодня.",
-         "zh-cn": "新增信息系统：适配器现在会将季节性问候和已安装的适配器版本写入 info.* 状态。包括每天 00:01 的自动刷新和完整的复活节日期计算。"
        }
 	},
     "titleLang": {

package/lib/helpers/heatHelper.js

@@ -24,6 +24,7 @@ const heatHelper = {
     // dynamische Steuer-ID (foreign)
     _heatControlForeignId: '',
     _afterrunTimer: null,
+    _prerunTimer: null, // NEU: Pumpen-Vorlauf vor Heizstart
 
     // Ownership / Merker
     _ownsPump: false,
@@ -40,6 +41,7 @@ const heatHelper = {
         this.adapter.subscribeStates('heat.target_temperature');
         this.adapter.subscribeStates('heat.max_temperature');
         this.adapter.subscribeStates('heat.pump_afterrun_minutes');
+        this.adapter.subscribeStates('heat.pump_prerun_minutes'); // NEU
 
         // Abhängigkeiten
         this.adapter.subscribeStates('status.season_active');
@@ -81,7 +83,8 @@ const heatHelper = {
                 id.endsWith('status.season_active') ||
                 id.endsWith('pump.mode') ||
                 id.endsWith('temperature.surface.current') ||
-                id.endsWith('control.pump.maintenance_active')
+                id.endsWith('control.pump.maintenance_active') ||
+                id.endsWith('heat.pump_prerun_minutes')
             ) {
                 await this._safeEvaluate('state_change');
                 return;
@@ -216,6 +219,46 @@ const heatHelper = {
             return;
         }
 
+        // -------------------------------------------------
+        // NEU: Pumpen-Prerun vor Heizstart
+        // -------------------------------------------------
+        const prerunMin = Math.max(
+            0,
+            Number((await this.adapter.getStateAsync('heat.pump_prerun_minutes'))?.val ?? 0) || 0,
+        );
+
+        const pumpState = await this.adapter.getStateAsync('pump.pump_switch');
+        const pumpIsOn = !!pumpState?.val;
+
+        // Prerun nur, wenn:
+        // - Zeit > 0
+        // - Pumpe aktuell AUS
+        // - kein Prerun aktiv
+        if (prerunMin > 0 && !pumpIsOn && !this._prerunTimer) {
+            this.adapter.log.info(`[heatHelper] Starte Pumpen-Prerun (${prerunMin} min)`);
+
+            // Pumpe einschalten + Ownership übernehmen
+            this._ownsPump = true;
+            await this.adapter.setStateAsync('pump.pump_switch', { val: true, ack: false });
+
+            // Prerun-Status setzen
+            await this.adapter.setStateAsync('heat.prerun_active', { val: true, ack: true });
+
+            const holdMs = Math.round(prerunMin * 60 * 1000);
+
+            this._prerunTimer = setTimeout(async () => {
+                this._prerunTimer = null;
+
+                await this.adapter.setStateAsync('heat.prerun_active', { val: false, ack: true });
+
+                // Nach Prerun erneut bewerten → Heizung darf jetzt starten
+                await this._safeEvaluate('prerun_done');
+            }, holdMs);
+
+            // WICHTIG: Heizung JETZT noch NICHT einschalten
+            return;
+        }
+
         this._desiredHeat = true;
 
         // Nachlauf ggf. abbrechen
@@ -278,6 +321,13 @@ const heatHelper = {
     },
 
     async _applyBlockedState(mode, reason, afterrunMin) {
+        // NEU: laufenden Prerun abbrechen
+        if (this._prerunTimer) {
+            clearTimeout(this._prerunTimer);
+            this._prerunTimer = null;
+            await this.adapter.setStateAsync('heat.prerun_active', { val: false, ack: true });
+        }
+
         // blockiert => Heizung aus, Request false
         await this._setHeatingDevice(false, (await this.adapter.getStateAsync('heat.control_object_id'))?.val || '');
 
@@ -295,6 +345,13 @@ const heatHelper = {
     },
 
     async _applyOffState(mode, reason, afterrunMin) {
+        // NEU: laufenden Prerun abbrechen
+        if (this._prerunTimer) {
+            clearTimeout(this._prerunTimer);
+            this._prerunTimer = null;
+            await this.adapter.setStateAsync('heat.prerun_active', { val: false, ack: true });
+        }
+
         // off => Heizung aus, Request false
         await this._setHeatingDevice(false, (await this.adapter.getStateAsync('heat.control_object_id'))?.val || '');
 
@@ -371,6 +428,7 @@ const heatHelper = {
         } finally {
             this._ownsPump = false;
             await this.adapter.setStateAsync('heat.afterrun_active', { val: false, ack: true });
+            await this.adapter.setStateAsync('heat.prerun_active', { val: false, ack: true });
             this.adapter.log.info(`[heatHelper] Pumpe AUS (${tag})`);
         }
     },
@@ -442,6 +500,11 @@ const heatHelper = {
             clearTimeout(this._afterrunTimer);
             this._afterrunTimer = null;
         }
+        if (this._prerunTimer) {
+            clearTimeout(this._prerunTimer);
+            this._prerunTimer = null;
+        }
+
         this._ownsPump = false;
         this._desiredHeat = null;
     },

package/lib/stateDefinitions/generalStates.js

@@ -9,6 +9,15 @@
  * @param {import("iobroker").Adapter} adapter - ioBroker Adapter-Instanz
  */
 async function createGeneralStates(adapter) {
+    // Channel: Allgemein
+    await adapter.setObjectNotExistsAsync('general', {
+        type: 'channel',
+        common: {
+            name: 'Allgemeine Einstellungen',
+        },
+        native: {},
+    });
+
     // Poolname
     await adapter.setObjectNotExistsAsync('general.pool_name', {
         type: 'state',

package/lib/stateDefinitions/heatStates.js

@@ -129,6 +129,28 @@ async function createHeatStates(adapter) {
         });
     }
 
+    // --- NEU: Pumpen-Vorlaufzeit vor Heizstart ---
+    await adapter.setObjectNotExistsAsync(`${channelId}.pump_prerun_minutes`, {
+        type: 'state',
+        common: {
+            name: 'Pumpen-Vorlaufzeit vor Heizung',
+            type: 'number',
+            role: 'value.interval',
+            unit: 'min',
+            read: true,
+            write: true,
+            persist: true,
+        },
+        native: {},
+    });
+    const existingPrerun = await adapter.getStateAsync(`${channelId}.pump_prerun_minutes`);
+    if (existingPrerun === null || existingPrerun.val === null || existingPrerun.val === undefined) {
+        await adapter.setStateAsync(`${channelId}.pump_prerun_minutes`, {
+            val: 0,
+            ack: true,
+        });
+    }
+
     await adapter.setObjectNotExistsAsync(`${channelId}.pump_afterrun_minutes`, {
         type: 'state',
         common: {
@@ -190,6 +212,19 @@ async function createHeatStates(adapter) {
         native: {},
     });
 
+    // --- NEU: Pumpen-Vorlauf aktiv ---
+    await adapter.setObjectNotExistsAsync(`${channelId}.prerun_active`, {
+        type: 'state',
+        common: {
+            name: 'Pumpen-Vorlauf aktiv',
+            type: 'boolean',
+            role: 'indicator.working',
+            read: true,
+            write: false,
+        },
+        native: {},
+    });
+
     await adapter.setObjectNotExistsAsync(`${channelId}.afterrun_active`, {
         type: 'state',
         common: {

package/lib/stateDefinitions/pumpStates.js

@@ -13,6 +13,15 @@
  * @param {import("iobroker").Adapter} adapter - ioBroker Adapter-Instanz
  */
 async function createPumpStates(adapter) {
+    // Channel: Pumpe
+    await adapter.setObjectNotExistsAsync('pump', {
+        type: 'channel',
+        common: {
+            name: 'Pumpe',
+        },
+        native: {},
+    });
+
     // Max. Pumpenleistung (W)
     await adapter.setObjectNotExistsAsync('pump.pump_max_watt', {
         type: 'state',

package/lib/stateDefinitions/solarStates.js

@@ -14,6 +14,15 @@
  * @param {import("iobroker").Adapter} adapter - ioBroker Adapter-Instanz
  */
 async function createSolarStates(adapter) {
+    // Channel: Solar
+    await adapter.setObjectNotExistsAsync('solar', {
+        type: 'channel',
+        common: {
+            name: 'Solar',
+        },
+        native: {},
+    });
+
     // Solarsteuerung aktiv (mit Persist-Schutz)
     await adapter.setObjectNotExistsAsync('solar.solar_control_active', {
         type: 'state',

package/lib/stateDefinitions/timeStates.js

@@ -9,6 +9,15 @@
  * @param {import("iobroker").Adapter} adapter - ioBroker Adapter-Instanz
  */
 async function createTimeStates(adapter) {
+    // Channel: Zeitsteuerung
+    await adapter.setObjectNotExistsAsync('timecontrol', {
+        type: 'channel',
+        common: {
+            name: 'Zeitsteuerung',
+        },
+        native: {},
+    });
+
     async function createTimeWindow(prefix, label) {
         // Aktiv
         await adapter.setObjectNotExistsAsync(`timecontrol.${prefix}_active`, {

package/package.json

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