iobroker.poolcontrol 0.5.1 → 0.5.3

package/README.md

@@ -121,6 +121,14 @@ Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
 ## Changelog
 ### **WORK IN PROGRESS**
 
+## v0.5.3 (2025-10-30)
+- Telegram-Benutzerwahl hinzugefügt
+
+## v0.5.2 (2025-10-30)
+- Erweitertes Helper-Vorrangssystem: Konflikte zwischen Zeit- und Solarsteuerung behoben
+- Frostschutz pausiert während Zeitfenster. Nun stabiles Pumpenverhalten und Verbesserte
+  Koordination zwischen den Helpern
+
 ## v0.5.0 (2025-10-28)
 - Erweiterung der Temperaturstatistik um Wochen- und Monatsauswertung  
   (`analytics.statistics.temperature.week` / `.month`)

package/admin/jsonConfig.json

@@ -849,7 +849,30 @@
 		  "lg": 6,
 		  "xl": 6
 		},
-		        "divider_speech_email": {
+        "speech_telegram_placeholder": {
+          "type": "staticText",
+          "label": "",
+          "text": "",
+		  "xs": 12,
+          "sm": 3,
+		  "md": 3,
+		  "lg": 3,
+		  "xl": 3,
+          "newLine": true
+        },
+        "speech_telegram_users": {
+          "type": "text",
+          "label": "Telegram-Empfänger (Benutzernamen, Komma-getrennt / leer = an alle Benutzer)",
+          "attr": "speech_telegram_users",
+          "tooltip": "Beispiel: Dirk,Dennis (leer = an alle Benutzer senden)",
+          "default": "",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6
+        },
+		  "divider_speech_email": {
           "type": "divider",
           "newLine": true
         },

package/io-package.json

@@ -1,8 +1,33 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.5.1",
+    "version": "0.5.3",
     "news": {
+       "0.5.3": {
+         "en": "Added user selection for Telegram notifications. If no user is selected, messages are sent globally as before; if one or more usernames are specified, only those users receive the messages. Admin UI visually improved (recipient field indented under the instance). speechHelper and jsonConfig.json updated.",
+         "de": "Benutzerauswahl für Telegram-Benachrichtigungen hinzugefügt. Wenn kein Benutzer ausgewählt ist, werden Nachrichten wie bisher global gesendet; bei einem oder mehreren Benutzernamen erhalten nur diese die Nachrichten. Admin-UI optisch verbessert (Empfängerfeld unter der Instanz eingerückt). speechHelper und jsonConfig.json aktualisiert.",
+         "ru": "Добавлен выбор пользователей для уведомлений Telegram. Если пользователь не выбран, сообщения отправляются глобально, как и раньше; при указании одного или нескольких имен сообщения получают только эти пользователи. Улучшен интерфейс админки (поле получателей расположено под экземпляром). Обновлены speechHelper и jsonConfig.json.",
+         "pt": "Adicionada seleção de usuários para notificações do Telegram. Se nenhum usuário for selecionado, as mensagens serão enviadas globalmente como antes; se um ou mais nomes forem informados, apenas esses usuários receberão as mensagens. UI de administração melhorada visualmente (campo de destinatários recuado sob a instância). speechHelper e jsonConfig.json atualizados.",
+         "nl": "Gebruikersselectie toegevoegd voor Telegram-meldingen. Als er geen gebruiker is geselecteerd, worden berichten zoals voorheen wereldwijd verzonden; bij één of meer opgegeven gebruikersnamen ontvangen alleen die gebruikers de berichten. Admin-UI visueel verbeterd (ontvanger-veld ingesprongen onder de instantie). speechHelper en jsonConfig.json bijgewerkt.",
+         "fr": "Ajout de la sélection d’utilisateurs pour les notifications Telegram. Si aucun utilisateur n’est sélectionné, les messages sont envoyés globalement comme auparavant ; si un ou plusieurs noms sont spécifiés, seuls ces utilisateurs reçoivent les messages. Amélioration visuelle de l’interface d’admin (champ destinataire indenté sous l’instance). speechHelper et jsonConfig.json mis à jour.",
+         "it": "Aggiunta la selezione degli utenti per le notifiche Telegram. Se non viene selezionato alcun utente, i messaggi vengono inviati globalmente come prima; indicando uno o più nomi utente, solo questi riceveranno i messaggi. Migliorata l’UI di amministrazione (campo destinatari rientrato sotto l’istanza). Aggiornati speechHelper e jsonConfig.json.",
+         "es": "Se añadió la selección de usuarios para notificaciones de Telegram. Si no se selecciona ningún usuario, los mensajes se envían globalmente como antes; si se especifican uno o más nombres de usuario, solo esos usuarios reciben los mensajes. Mejora visual en la interfaz de administración (campo de destinatarios sangrado bajo la instancia). speechHelper y jsonConfig.json actualizados.",
+         "pl": "Dodano wybór użytkowników dla powiadomień Telegram. Gdy nie wybrano żadnego użytkownika, wiadomości są wysyłane globalnie jak wcześniej; po podaniu jednego lub kilku nazw użytkowników wiadomości otrzymują tylko oni. Ulepszono UI administracyjne (pole odbiorców pod instancją). Zaktualizowano speechHelper i jsonConfig.json.",
+         "uk": "Додано вибір користувачів для сповіщень Telegram. Якщо користувача не вибрано, повідомлення надсилаються глобально, як і раніше; якщо вказано одне чи кілька імен, їх отримують лише ці користувачі. Візуально покращено інтерфейс адміністрування (поле одержувача під екземпляром). Оновлено speechHelper та jsonConfig.json.",
+         "zh-cn": "新增 Telegram 通知的用户选择功能。未选择用户时消息将像以前一样全局发送；指定一个或多个用户名时，仅这些用户会收到消息。优化了管理界面显示（收件人字段缩进至实例下方）。已更新 speechHelper 和 jsonConfig.json。"
+       },
+       "0.5.2": {
+         "en": "Extended helper priority system: fixed time/solar conflicts, frost pauses during time windows. Stable pump behavior and improved coordination between helpers.",
+         "de": "Erweitertes Helper-Vorrangsystem: Konflikte zwischen Zeit- und Solarsteuerung behoben, Frostschutz pausiert während Zeitfenstern. Stabiles Pumpenverhalten und verbesserte Koordination zwischen den Helpern.",
+         "ru": "Расширена система приоритетов помощников: устранены конфликты между таймером и солнечным управлением, мороз приостанавливается во время временных окон. Стабильная работа насоса и улучшенная координация между помощниками.",
+         "pt": "Sistema de prioridade dos helpers expandido: corrigidos conflitos de tempo/solar, proteção contra geada pausa durante janelas de tempo. Comportamento estável da bomba e melhor coordenação entre helpers.",
+         "nl": "Uitgebreid helperprioriteitssysteem: conflicten tussen tijd- en zonregeling opgelost, vorstbeveiliging pauzeert tijdens tijdvensters. Stabiel pompgedrag en betere coördinatie tussen helpers.",
+         "fr": "Système de priorité des helpers étendu : conflits temps/solaire corrigés, protection antigel en pause pendant les plages horaires. Comportement de pompe stable et meilleure coordination entre les helpers.",
+         "it": "Sistema di priorità degli helper esteso: risolti i conflitti tempo/solare, la protezione antigelo si mette in pausa durante le finestre temporali. Comportamento stabile della pompa e migliore coordinamento tra gli helper.",
+         "es": "Sistema de prioridad de helpers ampliado: solucionados los conflictos de tiempo/solar, la protección contra heladas se pausa durante las ventanas de tiempo. Comportamiento estable de la bomba y mejor coordinación entre helpers.",
+         "pl": "Rozszerzony system priorytetów helperów: naprawiono konflikty między czasem a sterowaniem solarnym, ochrona przed mrozem wstrzymuje się podczas okien czasowych. Stabilne działanie pompy i lepsza koordynacja między helperami.",
+         "zh-cn": "扩展的助手优先级系统：修复时间/太阳能冲突，防冻在时间窗口内暂停。泵运行稳定，助手之间协调更好。"
+       },
        "0.5.1": {
          "en": "Extended week and month statistics with persistent data, unified JSON format, and installation protection.",
          "de": "Erweiterte Wochen- und Monatsstatistik mit persistenten Daten, einheitlichem JSON-Format und Überinstallationsschutz.",
@@ -53,18 +78,6 @@
         "pl": "Ustabilizowano logikę ochrony przed zamarzaniem: stała histereza +2 °C i zaokrąglone wartości temperatury, aby uniknąć wahań przełączania pompy w okolicach 3 °C.",
         "uk": "Стабілізовано логіку захисту від замерзання: фіксована гістерезис +2 °C і округлені значення температури, щоб уникнути коливань увімкнення насоса біля 3 °C.",
         "zh-cn": "防冻逻辑稳定：固定 +2 °C 滞后并四舍五入温度值，以避免泵在 3 °C 附近频繁切换。"
-      },
-      "0.3.0": {
-        "en": "Added real pump flow calculation, live monitoring, and self-learning normal range system for pump analysis.",
-        "de": "Reelle Durchflussberechnung, Liveüberwachung und selbstlernendes Normalbereich-System zur Pumpenanalyse hinzugefügt.",
-        "ru": "Добавлен расчет реального расхода насоса, живой мониторинг и самообучающаяся система нормальных диапазонов для анализа насоса.",
-        "pt": "Adicionada cálculo de fluxo real da bomba, monitoramento ao vivo e sistema autoaprendente de faixa normal para análise da bomba.",
-        "nl": "Reële pompdebietberekening, livebewaking en zelflerend normaalbereiksysteem voor pompanalyse toegevoegd.",
-        "fr": "Ajout du calcul du débit réel de la pompe, de la surveillance en direct et d’un système de plage normale auto-apprenant pour l’analyse de la pompe.",
-        "it": "Aggiunto calcolo del flusso reale della pompa, monitoraggio live e sistema autoapprendente di intervallo normale per l'analisi della pompa.",
-        "es": "Se añadió el cálculo del caudal real de la bomba, la monitorización en vivo y un sistema de rango normal autoaprendente para el análisis de la bomba.",
-        "pl": "Dodano obliczanie rzeczywistego przepływu pompy, monitorowanie na żywo i samouczący się system normalnego zakresu do analizy pompy.",
-        "zh-cn": "添加了实际泵流量计算、实时监控以及用于泵分析的自学习正常范围系统。"
       }
 	},
     "titleLang": {

package/lib/helpers/frostHelper.js

@@ -40,6 +40,12 @@ const frostHelper = {
                 return;
             }
 
+            // --- NEU: Vorrangprüfung durch TimeHelper ---
+            if (activeHelper === 'timeHelper') {
+                this.adapter.log.debug('[frostHelper] Vorrang durch TimeHelper aktiv – Frostschutz pausiert.');
+                return;
+            }
+
             // Frostschutz aktiviert?
             const frostActive = (await this.adapter.getStateAsync('pump.frost_protection_active'))?.val;
             if (!frostActive) {

package/lib/helpers/solarHelper.js

@@ -39,6 +39,12 @@ const solarHelper = {
                 return;
             }
 
+            // --- NEU: Vorrangprüfung durch TimeHelper ---
+            if (activeHelper === 'timeHelper') {
+                this.adapter.log.debug('[solarHelper] Vorrang durch TimeHelper aktiv – Solarregelung pausiert.');
+                return;
+            }
+
             // --- NEU: Saisonstatus ---
             const season = (await this.adapter.getStateAsync('status.season_active'))?.val;
 

package/lib/helpers/speechHelper.js

@@ -148,8 +148,24 @@ const speechHelper = {
             if (this.adapter.config.speech_telegram_enabled && this.adapter.config.speech_telegram_instance) {
                 const instance = this.adapter.config.speech_telegram_instance;
                 try {
-                    this.adapter.sendTo(instance, { text, parse_mode: 'Markdown' });
-                    this.adapter.log.info(`[speechHelper] Telegram sendet: ${text}`);
+                    // NEU: Benutzerliste aus Admin lesen (Komma-getrennte Namen)
+                    const rawUsers = this.adapter.config.speech_telegram_users || '';
+                    const users = rawUsers
+                        .split(',')
+                        .map(u => u.trim())
+                        .filter(Boolean);
+
+                    // Wenn keine Benutzer angegeben → Standard: global an alle senden
+                    if (users.length === 0) {
+                        await this.adapter.sendToAsync(instance, { text, parse_mode: 'Markdown' });
+                        this.adapter.log.info(`[speechHelper] Telegram (global): ${text}`);
+                    } else {
+                        // Nur an ausgewählte Benutzer senden
+                        for (const user of users) {
+                            await this.adapter.sendToAsync(instance, { user, text, parse_mode: 'Markdown' });
+                            this.adapter.log.info(`[speechHelper] Telegram an ${user}: ${text}`);
+                        }
+                    }
                 } catch (err) {
                     this.adapter.log.warn(
                         `[speechHelper] Telegram-Versand fehlgeschlagen (${instance}): ${err.message}`,

package/lib/helpers/temperatureHelper.js

@@ -76,6 +76,35 @@ const temperatureHelper = {
                     : 'keine Sensoren konfiguriert'
             }`,
         );
+        // ------------------------------------------------------
+        // NEU: Re-Subscribe-Überwachung für hängende Sensoren
+        // ------------------------------------------------------
+        setInterval(
+            async () => {
+                for (const [key, id] of Object.entries(this.sensors)) {
+                    try {
+                        const state = await this.adapter.getStateAsync(`temperature.${key}.current`);
+                        const lastTs = state?.ts || 0;
+                        const minutes = (Date.now() - lastTs) / 60000;
+
+                        // Wenn länger als 10 Minuten keine Aktualisierung, Subscribe erneuern
+                        if (minutes > 10) {
+                            this.adapter.log.warn(
+                                `[temperatureHelper] Keine Aktualisierung für ${key} seit ${Math.round(
+                                    minutes,
+                                )} Min – re-subscribing ${id}`,
+                            );
+                            this.adapter.subscribeForeignStates(id);
+                        }
+                    } catch (err) {
+                        this.adapter.log.debug(
+                            `[temperatureHelper] Re-Subscribe-Prüfung für ${key} fehlgeschlagen: ${err.message}`,
+                        );
+                    }
+                }
+            },
+            10 * 60 * 1000,
+        ); // alle 10 Minuten prüfen
     },
 
     _collectActiveSensors(adapter) {

package/lib/helpers/timeHelper.js

@@ -4,7 +4,8 @@
  * timeHelper
  * - Überwacht Zeitfenster (time1, time2, time3)
  * - Schaltet Pumpe, wenn Modus "time" aktiv ist
- * - Schaltet über die reale Steckdosen-ID aus der Config
+ * - Schaltet über den internen Pumpenschalter (pump.pump_switch)
+ * - Die eigentliche Steckdose wird vom pumpHelper gespiegelt
  */
 
 const timeHelper = {
@@ -32,15 +33,19 @@ const timeHelper = {
     async _checkWindows() {
         try {
             const mode = (await this.adapter.getStateAsync('pump.mode'))?.val;
+
+            // NEU: Wenn nicht im Zeitmodus, ggf. Vorrang freigeben
             if (mode !== 'time') {
+                const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val;
+                if (activeHelper === 'timeHelper') {
+                    await this.adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
+                    this.adapter.log.debug('[timeHelper] Zeitmodus beendet – Vorrang an Solar/Control freigegeben.');
+                }
                 return;
             } // nur aktiv im Zeitmodus
 
-            const pumpSwitchId = this.adapter.config.pump_switch;
-            if (!pumpSwitchId) {
-                this.adapter.log.warn('[timeHelper] Keine pump_switch (Fremd-ID) konfiguriert!');
-                return;
-            }
+            // Interner Pumpenschalter statt externer Steckdose
+            const pumpStateId = 'pump.pump_switch';
 
             const now = new Date();
             const hhmm = now.toTimeString().slice(0, 5); // "HH:MM"
@@ -59,7 +64,7 @@ const timeHelper = {
                 }
             }
 
-            // --- NEU: Sprachsignal für Zeitsteuerung setzen ---
+            // --- Sprachsignal für Zeitsteuerung setzen ---
             const oldVal = (await this.adapter.getStateAsync('speech.time_active'))?.val;
             if (oldVal !== shouldRun) {
                 await this.adapter.setStateAsync('speech.time_active', {
@@ -68,14 +73,25 @@ const timeHelper = {
                 });
             }
 
-            // --- NEU: nur schalten, wenn sich der Zustand wirklich ändert ---
-            const currentState = (await this.adapter.getForeignStateAsync(pumpSwitchId))?.val;
+            // NEU: Vorrangverwaltung (active_helper)
+            const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val;
+            if (shouldRun && activeHelper !== 'timeHelper') {
+                await this.adapter.setStateAsync('pump.active_helper', { val: 'timeHelper', ack: true });
+                this.adapter.log.debug('[timeHelper] Vorrang übernommen (Zeitfenster aktiv).');
+            }
+            if (!shouldRun && activeHelper === 'timeHelper') {
+                await this.adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
+                this.adapter.log.debug('[timeHelper] Vorrang zurückgegeben (Zeitfenster beendet).');
+            }
+
+            // --- Nur schalten, wenn sich der Zustand wirklich ändert ---
+            const currentState = (await this.adapter.getStateAsync(pumpStateId))?.val;
             if (currentState !== shouldRun) {
-                await this.adapter.setForeignStateAsync(pumpSwitchId, {
+                await this.adapter.setStateAsync(pumpStateId, {
                     val: shouldRun,
                     ack: false,
                 });
-                this.adapter.log.debug(`[timeHelper] Pumpe ${shouldRun ? 'EIN' : 'AUS'} (${hhmm})`);
+                this.adapter.log.debug(`[timeHelper] Pumpenschalter ${shouldRun ? 'EIN' : 'AUS'} (${hhmm})`);
             } else {
                 this.adapter.log.debug(
                     `[timeHelper] Keine Änderung (${hhmm}) – Zustand bleibt ${shouldRun ? 'EIN' : 'AUS'}.`,

package/package.json

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