iobroker.poolcontrol 0.0.7

package/io-package.json

@@ -0,0 +1,176 @@
+{
+  "common": {
+    "name": "poolcontrol",
+    "version": "0.0.7",
+    "news": {
+      "0.0.7": {
+        "en": "Added help file (help.md) and first README version",
+        "de": "Hilfedatei (help.md) und erste README-Version hinzugefügt",
+        "ru": "Добавлен файл справки (help.md) и первая версия README",
+        "pt": "Adicionado arquivo de ajuda (help.md) e primeira versão do README",
+        "nl": "Helpbestand (help.md) en eerste README-versie toegevoegd",
+        "fr": "Ajout du fichier d'aide (help.md) et première version du README",
+        "it": "Aggiunto file di aiuto (help.md) e prima versione di README",
+        "es": "Se agregó archivo de ayuda (help.md) y primera versión de README",
+        "pl": "Dodano plik pomocy (help.md) i pierwszą wersję README",
+        "uk": "Додано файл довідки (help.md) та першу версію README",
+        "zh-cn": "添加了帮助文件 (help.md) 和第一个 README 版本"
+      },
+      "0.0.6": {
+        "en": "Added consumption & cost calculation with external kWh meter",
+        "de": "Verbrauchs- und Kostenberechnung mit externem kWh-Zähler hinzugefügt",
+        "ru": "Добавлен расчет потребления и затрат с внешним счетчиком кВт·ч",
+        "pt": "Adicionado cálculo de consumo e custo com medidor externo de kWh",
+        "nl": "Verbruik- en kostenberekening toegevoegd met externe kWh-meter",
+        "fr": "Ajout du calcul de consommation et de coût avec compteur kWh externe",
+        "it": "Aggiunto calcolo di consumo e costi con contatore kWh esterno",
+        "es": "Se agregó cálculo de consumo y costos con medidor externo de kWh",
+        "pl": "Dodano obliczanie zużycia i kosztów z zewnętrznym licznikiem kWh",
+        "uk": "Додано розрахунок споживання та витрат із зовнішнім лічильником кВт·год",
+        "zh-cn": "新增使用外部千瓦时电表的消耗和成本计算"
+      },
+      "0.0.5": {
+        "en": "Added speech output via Alexa and Telegram",
+        "de": "Sprachausgaben über Alexa und Telegram hinzugefügt",
+        "ru": "Добавлен голосовой вывод через Alexa и Telegram",
+        "pt": "Adicionada saída de voz via Alexa e Telegram",
+        "nl": "Spraakuitvoer toegevoegd via Alexa en Telegram",
+        "fr": "Ajout de la sortie vocale via Alexa et Telegram",
+        "it": "Aggiunta uscita vocale tramite Alexa e Telegram",
+        "es": "Se agregó salida de voz a través de Alexa y Telegram",
+        "pl": "Dodano wyjście głosowe przez Alexa i Telegram",
+        "uk": "Додано голосовий вивід через Alexa та Telegram",
+        "zh-cn": "新增通过 Alexa 和 Telegram 的语音输出"
+      },
+      "0.0.4": {
+        "en": "Added runtime & circulation logic including new datapoint 'circulation.daily_required'",
+        "de": "Laufzeit- und Umwälzlogik hinzugefügt, einschließlich neuem Datenpunkt 'circulation.daily_required'",
+        "ru": "Добавлена логика времени работы и циркуляции, включая новую точку данных 'circulation.daily_required'",
+        "pt": "Adicionada lógica de tempo de execução e circulação, incluindo novo datapoint 'circulation.daily_required'",
+        "nl": "Runtime- en circulatielogica toegevoegd, inclusief nieuw datapoint 'circulation.daily_required'",
+        "fr": "Ajout de la logique de temps d'exécution et de circulation, y compris le nouveau point de données 'circulation.daily_required'",
+        "it": "Aggiunta logica di runtime e circolazione, incluso nuovo datapoint 'circulation.daily_required'",
+        "es": "Se agregó lógica de tiempo de ejecución y circulación, incluido nuevo datapoint 'circulation.daily_required'",
+        "pl": "Dodano logikę czasu pracy i cyrkulacji, w tym nowy punkt danych 'circulation.daily_required'",
+        "uk": "Додано логіку часу роботи та циркуляції, включаючи нову точку даних 'circulation.daily_required'",
+        "zh-cn": "新增运行时间和循环逻辑，包括新数据点 'circulation.daily_required'"
+      },
+      "0.0.3": {
+        "en": "Added time control with up to 3 configurable time windows",
+        "de": "Zeitsteuerung mit bis zu 3 konfigurierbaren Zeitfenstern hinzugefügt",
+        "ru": "Добавлено управление временем с до 3 настраиваемыми временными окнами",
+        "pt": "Adicionado controle de tempo com até 3 janelas de tempo configuráveis",
+        "nl": "Tijdregeling toegevoegd met maximaal 3 configureerbare tijdvensters",
+        "fr": "Ajout du contrôle du temps avec jusqu'à 3 fenêtres de temps configurables",
+        "it": "Aggiunto controllo del tempo con fino a 3 finestre temporali configurabili",
+        "es": "Se agregó control de tiempo con hasta 3 ventanas de tiempo configurables",
+        "pl": "Dodano kontrolę czasu z maksymalnie 3 konfigurowalnymi oknami czasowymi",
+        "uk": "Додано керування часом з до 3 налаштовуваними часовими вікнами",
+        "zh-cn": "新增时间控制，最多可配置 3 个时间窗口"
+      },
+      "0.0.2": {
+        "en": "Extended pump logic with error detection and safety functions",
+        "de": "Pumpenlogik erweitert mit Fehlererkennung und Sicherheitsfunktionen",
+        "ru": "Расширена логика насоса с обнаружением ошибок и функциями безопасности",
+        "pt": "Lógica da bomba estendida com detecção de erros e funções de segurança",
+        "nl": "Pomplogica uitgebreid met foutdetectie en veiligheidsfuncties",
+        "fr": "Logique de pompe étendue avec détection d'erreurs et fonctions de sécurité",
+        "it": "Logica della pompa estesa con rilevamento errori e funzioni di sicurezza",
+        "es": "Lógica de la bomba ampliada con detección de errores y funciones de seguridad",
+        "pl": "Rozszerzona logika pompy z wykrywaniem błędów i funkcjami bezpieczeństwa",
+        "uk": "Розширена логіка насоса з виявленням помилок та функціями безпеки",
+        "zh-cn": "扩展泵逻辑，具有错误检测和安全功能"
+      },
+      "0.0.1": {
+        "en": "initial release",
+        "de": "Erstveröffentlichung",
+        "ru": "Начальная версия",
+        "pt": "lançamento inicial",
+        "nl": "Eerste uitgave",
+        "fr": "Première version",
+        "it": "Versione iniziale",
+        "es": "Versión inicial",
+        "pl": "Pierwsze wydanie",
+        "uk": "Початкова версія",
+        "zh-cn": "首次出版"
+      }
+    },
+    "titleLang": {
+      "en": "PoolControl",
+      "de": "PoolControl",
+      "ru": "PoolControl",
+      "pt": "PoolControl",
+      "nl": "PoolControl",
+      "fr": "PoolControl",
+      "it": "PoolControl",
+      "es": "PoolControl",
+      "pl": "PoolControl",
+      "uk": "PoolControl",
+      "zh-cn": "PoolControl"
+    },
+    "desc": {
+      "en": "Adapter for controlling and monitoring pool systems (pump, temperature, solar, consumption, speech output).",
+      "de": "Adapter zur Steuerung und Überwachung von Poolanlagen (Pumpe, Temperatur, Solar, Verbrauch, Sprachausgaben).",
+      "ru": "Адаптер для управления и мониторинга бассейнов (насос, температура, солнечная система, потребление, голосовые оповещения).",
+      "pt": "Adaptador para controlar e monitorar sistemas de piscina (bomba, temperatura, solar, consumo, saída de voz).",
+      "nl": "Adapter voor het besturen en bewaken van zwembadsystemen (pomp, temperatuur, zonne-energie, verbruik, spraakuitvoer).",
+      "fr": "Adaptateur pour contrôler et surveiller les systèmes de piscine (pompe, température, solaire, consommation, sorties vocales).",
+      "it": "Adattatore per il controllo e il monitoraggio dei sistemi della piscina (pompa, temperatura, solare, consumo, uscite vocali).",
+      "es": "Adaptador para controlar y supervisar sistemas de piscina (bomba, temperatura, solar, consumo, salida de voz).",
+      "pl": "Adapter do sterowania i monitorowania systemów basenowych (pompa, temperatura, solar, zużycie, komunikaty głosowe).",
+      "uk": "Адаптер для керування та моніторингу басейнових систем (насос, температура, сонячна енергія, споживання, голосові повідомлення).",
+      "zh-cn": "用于控制和监控泳池系统的适配器（泵、温度、太阳能、能耗、语音输出）。"
+    },
+    "authors": [
+      "DasBo1975 <dasbo1975@outlook.de>"
+    ],
+    "keywords": [
+      "pool",
+      "pumpe",
+      "solar",
+      "wasser",
+      "temperatur"
+    ],
+    "licenseInformation": {
+      "type": "free",
+      "license": "MIT"
+    },
+    "platform": "Javascript/Node.js",
+    "icon": "poolcontrol.png",
+    "enabled": true,
+    "extIcon": "https://raw.githubusercontent.com/DasBo1975/ioBroker.poolcontrol/main/admin/poolcontrol.png",
+    "readme": "https://github.com/DasBo1975/ioBroker.poolcontrol/blob/main/README.md",
+    "loglevel": "info",
+    "tier": 3,
+    "mode": "daemon",
+    "type": "climate-control",
+    "compact": true,
+    "connectionType": "local",
+    "dataSource": "poll",
+    "adminUI": {
+      "config": "json"
+    },
+    "dependencies": [
+      {
+        "js-controller": ">=6.0.11"
+      }
+    ],
+    "globalDependencies": [
+      {
+        "admin": ">=7.0.23"
+      }
+    ]
+  },
+  "native": {
+    "option1": true,
+    "option2": "42"
+  },
+  "objects": [],
+  "instanceObjects": [],
+  "support": {
+    "donate": {
+      "paypal": "https://www.paypal.com/donate?business=dirk.bertin%40t-online.de"
+    }
+  }
+}
+

package/lib/adapter-config.d.ts

@@ -0,0 +1,19 @@
+// This file extends the AdapterConfig type from "@types/iobroker"
+// using the actual properties present in io-package.json
+// in order to provide typings for adapter.config properties
+
+import { native } from "../io-package.json";
+
+type _AdapterConfig = typeof native;
+
+// Augment the globally declared type ioBroker.AdapterConfig
+declare global {
+    namespace ioBroker {
+        interface AdapterConfig extends _AdapterConfig {
+            // Do not enter anything here!
+        }
+    }
+}
+
+// this is required so the above AdapterConfig is found by TypeScript / type checking
+export {};

package/lib/helpers/consumptionHelper.js

@@ -0,0 +1,185 @@
+'use strict';
+
+/**
+ * consumptionHelper
+ * - Nutzt externen kWh-Zähler (objectId aus Config)
+ * - Berechnet Periodenwerte (Tag/Woche/Monat/Jahr)
+ * - Berechnet Kosten anhand Strompreis (€/kWh)
+ * - Offset-Mechanismus: summiert alte Werte bei Zählerwechsel/Reset auf
+ */
+
+const consumptionHelper = {
+    adapter: null,
+    energyId: null, // Objekt-ID des externen kWh-Zählers
+    price: 0, // Strompreis €/kWh
+    baselines: {}, // { day, week, month, year }
+    resetTimer: null,
+
+    init(adapter) {
+        this.adapter = adapter;
+        this.energyId = adapter.config.external_energy_total_id || null;
+        this.price = adapter.config.energy_price_eur_kwh || 0;
+
+        if (this.energyId) {
+            adapter.subscribeForeignStates(this.energyId);
+            adapter.log.info(`[consumptionHelper] Überwache externen kWh-Zähler: ${this.energyId}`);
+        } else {
+            adapter.log.info('[consumptionHelper] Kein externer kWh-Zähler konfiguriert → Verbrauchslogik inaktiv.');
+        }
+
+        // Reset-Timer für Mitternacht
+        this._scheduleDailyReset();
+    },
+
+    async handleStateChange(id, state) {
+        if (!state) {
+            return;
+        }
+        if (id !== this.energyId) {
+            return;
+        }
+
+        const totalNowRaw = Number(state.val);
+        if (!Number.isFinite(totalNowRaw)) {
+            return;
+        }
+
+        await this._updateConsumption(totalNowRaw);
+    },
+
+    async _updateConsumption(totalNowRaw) {
+        try {
+            // Offset laden
+            const offset = (await this.adapter.getStateAsync('consumption.offset_kwh'))?.val || 0;
+            const last = (await this.adapter.getStateAsync('consumption.last_total_kwh'))?.val || 0;
+
+            let totalNow = totalNowRaw;
+
+            // Prüfen: Reset oder neues Gerät?
+            if (totalNowRaw < last) {
+                this.adapter.log.warn('[consumptionHelper] Zähler-Reset erkannt → Offset wird angepasst');
+                const newOffset = offset + last;
+                await this.adapter.setStateAsync('consumption.offset_kwh', {
+                    val: newOffset,
+                    ack: true,
+                });
+                totalNow = newOffset + totalNowRaw;
+            } else {
+                totalNow = offset + totalNowRaw;
+            }
+
+            // Aktuellen Gesamtwert setzen
+            await this.adapter.setStateAsync('consumption.total_kwh', {
+                val: totalNow,
+                ack: true,
+            });
+
+            // Baselines laden (falls leer)
+            if (Object.keys(this.baselines).length === 0) {
+                await this._loadBaselines(totalNow);
+            }
+
+            // Differenzen berechnen
+            const values = {
+                day: totalNow - (this.baselines.day ?? totalNow),
+                week: totalNow - (this.baselines.week ?? totalNow),
+                month: totalNow - (this.baselines.month ?? totalNow),
+                year: totalNow - (this.baselines.year ?? totalNow),
+            };
+
+            // Negative Werte abfangen (bei Reset)
+            for (const key of Object.keys(values)) {
+                if (values[key] < 0) {
+                    this.baselines[key] = totalNow;
+                    values[key] = 0;
+                }
+            }
+
+            // In States schreiben
+            await this.adapter.setStateAsync('consumption.day_kwh', {
+                val: Number(values.day.toFixed(3)),
+                ack: true,
+            });
+            await this.adapter.setStateAsync('consumption.week_kwh', {
+                val: Number(values.week.toFixed(3)),
+                ack: true,
+            });
+            await this.adapter.setStateAsync('consumption.month_kwh', {
+                val: Number(values.month.toFixed(3)),
+                ack: true,
+            });
+            await this.adapter.setStateAsync('consumption.year_kwh', {
+                val: Number(values.year.toFixed(3)),
+                ack: true,
+            });
+
+            // Kosten berechnen
+            if (this.price > 0) {
+                await this.adapter.setStateAsync('costs.day_eur', {
+                    val: Number((values.day * this.price).toFixed(2)),
+                    ack: true,
+                });
+                await this.adapter.setStateAsync('costs.week_eur', {
+                    val: Number((values.week * this.price).toFixed(2)),
+                    ack: true,
+                });
+                await this.adapter.setStateAsync('costs.month_eur', {
+                    val: Number((values.month * this.price).toFixed(2)),
+                    ack: true,
+                });
+                await this.adapter.setStateAsync('costs.year_eur', {
+                    val: Number((values.year * this.price).toFixed(2)),
+                    ack: true,
+                });
+                await this.adapter.setStateAsync('costs.total_eur', {
+                    val: Number((totalNow * this.price).toFixed(2)),
+                    ack: true,
+                });
+            }
+
+            // Letzten Stand des externen Zählers merken
+            await this.adapter.setStateAsync('consumption.last_total_kwh', {
+                val: totalNowRaw,
+                ack: true,
+            });
+        } catch (err) {
+            this.adapter.log.warn(`[consumptionHelper] Fehler bei Verbrauchsupdate: ${err.message}`);
+        }
+    },
+
+    async _loadBaselines(totalNow) {
+        this.baselines = {};
+        const day = (await this.adapter.getStateAsync('consumption.day_kwh'))?.val;
+        const week = (await this.adapter.getStateAsync('consumption.week_kwh'))?.val;
+        const month = (await this.adapter.getStateAsync('consumption.month_kwh'))?.val;
+        const year = (await this.adapter.getStateAsync('consumption.year_kwh'))?.val;
+
+        this.baselines.day = totalNow - (day || 0);
+        this.baselines.week = totalNow - (week || 0);
+        this.baselines.month = totalNow - (month || 0);
+        this.baselines.year = totalNow - (year || 0);
+
+        this.adapter.log.info(`[consumptionHelper] Baselines geladen: ${JSON.stringify(this.baselines)}`);
+    },
+
+    _scheduleDailyReset() {
+        const now = new Date();
+        const nextMidnight = new Date(now);
+        nextMidnight.setHours(24, 0, 0, 0);
+        const msUntilMidnight = nextMidnight - now;
+
+        this.resetTimer = setTimeout(() => {
+            this.baselines = {};
+            this._scheduleDailyReset();
+        }, msUntilMidnight);
+    },
+
+    cleanup() {
+        if (this.resetTimer) {
+            clearTimeout(this.resetTimer);
+            this.resetTimer = null;
+        }
+    },
+};
+
+module.exports = consumptionHelper;

package/lib/helpers/frostHelper.js

@@ -0,0 +1,94 @@
+'use strict';
+
+/**
+ * frostHelper
+ * - Prüft Außentemperatur gegen Frostschutz-Grenze
+ * - Schaltet Pumpe bei Frost ein (nur im Modus "auto")
+ * - Kleine Hysterese: +1°C zum Ausschalten
+ * - Schaltet über den zentralen Bool-State pump.pump_switch
+ */
+
+const frostHelper = {
+    adapter: null,
+    checkTimer: null,
+
+    init(adapter) {
+        this.adapter = adapter;
+
+        // Minütlicher Check
+        this._scheduleCheck();
+
+        this.adapter.log.info('[frostHelper] initialisiert (Prüfung alle 60s)');
+    },
+
+    _scheduleCheck() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+        }
+        this.checkTimer = setInterval(() => this._checkFrost(), 60 * 1000);
+        // Beim Start sofort prüfen
+        this._checkFrost();
+    },
+
+    async _checkFrost() {
+        try {
+            // Nur aktiv im AUTO-Modus
+            const mode = (await this.adapter.getStateAsync('pump.mode'))?.val;
+            if (mode !== 'auto') {
+                return;
+            }
+
+            // Frostschutz aktiviert?
+            const frostActive = (await this.adapter.getStateAsync('pump.frost_protection_active'))?.val;
+            if (!frostActive) {
+                return;
+            }
+
+            // Grenztemperatur laden
+            const frostTemp = (await this.adapter.getStateAsync('pump.frost_protection_temp'))?.val;
+            if (frostTemp == null) {
+                return;
+            }
+
+            // Außentemperatur laden
+            const outside = (await this.adapter.getStateAsync('temperature.outside.current'))?.val;
+            if (outside == null) {
+                this.adapter.log.debug('[frostHelper] Keine Außentemperatur verfügbar');
+                return;
+            }
+
+            // Aktueller Pumpenzustand (zentraler Bool)
+            const pumpActive = (await this.adapter.getStateAsync('pump.pump_switch'))?.val;
+            let shouldRun = pumpActive;
+
+            // Logik: einschalten bei <= frostTemp, ausschalten bei >= frostTemp+1
+            if (outside <= frostTemp) {
+                shouldRun = true;
+            } else if (outside >= frostTemp + 1) {
+                shouldRun = false;
+            }
+
+            // Schalten nur, wenn sich etwas ändert
+            if (shouldRun !== pumpActive) {
+                await this.adapter.setStateAsync('pump.pump_switch', {
+                    val: shouldRun,
+                    ack: false,
+                });
+                this.adapter.log.info(
+                    `[frostHelper] Frostschutz → Pumpe ${shouldRun ? 'EIN' : 'AUS'} (Außen=${outside}°C, Grenze=${frostTemp}°C)`,
+                );
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[frostHelper] Fehler im Check: ${err.message}`);
+        }
+    },
+
+    cleanup() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+    },
+};
+
+module.exports = frostHelper;