iobroker.poolcontrol 0.0.10 → 0.1.0

package/README.md

@@ -94,6 +94,13 @@ Funktionen können sich ändern, bitte regelmäßig den Changelog beachten.
 ## Changelog
 Auszug, vollständige Liste siehe `io-package.json`:
 
+### 0.1.0
+- Sprachausgabe über **E-Mail** hinzugefügt (konfigurierbar: Instanz, Empfänger, Betreff).
+- Erweiterung der Instanz-Konfiguration im Tab „Sprachausgaben“.
+  **Bugfixes**
+- Kleinere Korrekturen und Optimierungen in der Dokumentation (`help.md`).
+- Logging in `speechHelper` verbessert.
+
 ### 0.0.10
 
 Statusübersicht

package/admin/jsonConfig.json

@@ -49,6 +49,21 @@
 		  "lg": 3,
 		  "xl": 3,
           "newLine": true
+        },
+		"divider_season1": {
+          "type": "divider",
+          "newLine": true
+        },
+        "season_active": {
+          "type": "checkbox",
+          "label": "Poolsaison aktiv",
+          "default": false,
+          "xs": 12,
+          "sm": 3,
+          "md": 3,
+          "lg": 3,
+          "xl": 3,
+          "newLine": true
         }
       }
     },
@@ -831,6 +846,53 @@
 		  "lg": 6,
 		  "xl": 6
 		},
+		        "divider_speech_email": {
+          "type": "divider",
+          "newLine": true
+        },
+        "speech_email_enabled": {
+          "type": "checkbox",
+          "label": "Ausgabe über E-Mail aktivieren",
+          "default": false,
+          "xs": 12,
+          "sm": 3,
+          "md": 3,
+          "lg": 3,
+          "xl": 3,
+          "newLine": true
+        },
+        "speech_email_instance": {
+          "type": "instance",
+          "adapter": "email",
+          "label": "E-Mail Adapter-Instanz",
+          "default": "email.0",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6
+        },
+        "speech_email_recipient": {
+          "type": "text",
+          "label": "Empfänger-Adresse",
+          "default": "meineadresse@example.com",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6,
+          "newLine": true
+        },
+        "speech_email_subject": {
+          "type": "text",
+          "label": "E-Mail Betreff",
+          "default": "PoolControl Nachricht",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6
+        },
 		"divider_speech4": {
 		  "type": "divider",
 		  "newLine": true

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.0.10",
+    "version": "0.1.0",
     "news": {
+      "0.1.0": {
+       "en": "Added speech output via E-Mail (configurable: instance, recipient, subject)",
+       "de": "Sprachausgabe per E-Mail hinzugefügt (konfigurierbar: Instanz, Empfänger, Betreff)",
+       "ru": "Добавлен вывод речи по электронной почте (настраивается: экземпляр, получатель, тема)",
+       "pt": "Adicionada saída de fala por e-mail (configurável: instância, destinatário, assunto)",
+       "nl": "Spraakuitvoer via e-mail toegevoegd (configureerbaar: instantie, ontvanger, onderwerp)",
+       "fr": "Ajout de la sortie vocale par e-mail (configurable : instance, destinataire, sujet)",
+       "it": "Aggiunta uscita vocale via e-mail (configurabile: istanza, destinatario, oggetto)",
+       "es": "Se agregó salida de voz por correo electrónico (configurable: instancia, destinatario, asunto)",
+       "pl": "Dodano wyjście głosowe przez e-mail (konfigurowalne: instancja, odbiorca, temat)",
+       "uk": "Додано озвучення електронною поштою (налаштовується: екземпляр, одержувач, тема)",
+       "zh-cn": "新增通过电子邮件的语音输出（可配置：实例、收件人、主题）"
+      },
       "0.0.10": {
        "en": "Added extended status overview with pump statistics, system flags and JSON summary",
        "de": "Erweiterte Statusübersicht mit Pumpenstatistiken, Systemanzeigen und JSON-Zusammenfassung hinzugefügt",
@@ -28,19 +41,6 @@
         "pl": "Stany czasu pracy, cyrkulacji, zużycia/kosztów i temp. min/max są teraz zachowane po restartach",
         "uk": "Стан часу роботи, циркуляції, споживання/вартості та мін/макс температури тепер зберігаються після перезапусків",
         "zh-cn": "运行时间、循环、消耗/成本和温度最小/最大状态现在在重启后保持"
-      },
-	  "0.0.8": {
-        "en": "Added Help tab in instance configuration with link to GitHub documentation",
-        "de": "Hilfetab in der Instanzkonfiguration hinzugefügt mit Link zur GitHub-Dokumentation",
-        "ru": "Добавлена вкладка помощи в настройке экземпляра со ссылкой на документацию GitHub",
-        "pt": "Guia de ajuda adicionado na configuração da instância com link para a documentação do GitHub",
-        "nl": "Help-tab toegevoegd in de instance-configuratie met link naar GitHub-documentatie",
-        "fr": "Onglet d'aide ajouté dans la configuration de l'instance avec lien vers la documentation GitHub",
-        "it": "Aggiunta scheda di aiuto nella configurazione dell'istanza con collegamento alla documentazione GitHub",
-        "es": "Se agregó pestaña de ayuda en la configuración de la instancia con enlace a la documentación de GitHub",
-        "pl": "Dodano kartę pomocy w konfiguracji instancji z linkiem do dokumentacji GitHub",
-        "uk": "Додано вкладку довідки в конфігурацію екземпляра з посиланням на документацію GitHub",
-        "zh-cn": "在实例配置中添加了帮助选项卡，并链接到 документацию GitHub"
       }
     },
     "titleLang": {

package/lib/helpers/pumpHelper.js

@@ -92,6 +92,15 @@ const pumpHelper = {
             return;
         }
 
+        // Saisonprüfung
+        const season = (await this.adapter.getStateAsync('status.season_active'))?.val;
+        if (!season) {
+            this.adapter.log.debug(
+                '[pumpHelper] Saison inaktiv – Pumpenlogik übersprungen (Frostschutz läuft separat)',
+            );
+            return;
+        }
+
         // 1) Leistung aus Fremd-State spiegeln
         if (this.currentPowerId && id === this.currentPowerId) {
             const val = this._parseNumber(state.val);

package/lib/helpers/solarHelper.js

@@ -32,17 +32,14 @@ const solarHelper = {
 
     async _checkSolar() {
         try {
+            // --- NEU: Saisonstatus ---
+            const season = (await this.adapter.getStateAsync('status.season_active'))?.val;
+
             // Solarsteuerung aktiv?
             const active = (await this.adapter.getStateAsync('solar.solar_control_active'))?.val;
-            if (!active) {
-                return;
-            }
 
-            // Pumpenmodus muss AUTO sein
+            // Pumpenmodus
             const mode = (await this.adapter.getStateAsync('pump.mode'))?.val;
-            if (mode !== 'auto') {
-                return;
-            }
 
             // Grenzwerte laden
             const tempOn = (await this.adapter.getStateAsync('solar.temp_on'))?.val;
@@ -58,32 +55,45 @@ const solarHelper = {
                 return;
             }
 
-            let shouldRun = false;
-            const delta = collector - pool;
+            // --- Schaltlogik nur ausführen, wenn Saison aktiv, Solar aktiv und Modus AUTO ---
+            if (season && active && mode === 'auto') {
+                let shouldRun = false;
+                const delta = collector - pool;
 
-            // Logik: Einschalten, wenn Collector > tempOn und Delta > 0
-            if (collector >= tempOn && delta > 0) {
-                shouldRun = true;
-            }
+                // Logik: Einschalten, wenn Collector > tempOn und Delta > 0
+                if (collector >= tempOn && delta > 0) {
+                    shouldRun = true;
+                }
 
-            // Ausschalten, wenn Collector < tempOff oder Delta <= 0
-            if (collector <= tempOff || delta <= 0) {
-                shouldRun = false;
-            }
+                // Ausschalten, wenn Collector < tempOff oder Delta <= 0
+                if (collector <= tempOff || delta <= 0) {
+                    shouldRun = false;
+                }
 
-            // Optional Hysterese (kann später erweitert werden)
-            if (hysteresis) {
-                // z. B. Ausschaltgrenze etwas absenken
-            }
+                // Optional Hysterese (kann später erweitert werden)
+                if (hysteresis) {
+                    // z. B. Ausschaltgrenze etwas absenken
+                }
 
-            // ZENTRAL: Pumpe über Bool-Schalter setzen
-            await this.adapter.setStateAsync('pump.pump_switch', {
-                val: shouldRun,
-                ack: false,
-            });
-            this.adapter.log.debug(
-                `[solarHelper] Solarregelung → Pumpe ${shouldRun ? 'EIN' : 'AUS'} (Collector=${collector}°C, Pool=${pool}°C, Delta=${delta}°C)`,
-            );
+                // ZENTRAL: Pumpe über Bool-Schalter setzen
+                await this.adapter.setStateAsync('pump.pump_switch', {
+                    val: shouldRun,
+                    ack: false,
+                });
+                this.adapter.log.debug(
+                    `[solarHelper] Solarregelung → Pumpe ${shouldRun ? 'EIN' : 'AUS'} (Collector=${collector}°C, Pool=${pool}°C, Delta=${delta}°C)`,
+                );
+            } else {
+                // Keine Schaltung – Grund protokollieren
+                const reason = !season
+                    ? 'Saison inaktiv'
+                    : !active
+                      ? 'Solarsteuerung aus'
+                      : mode !== 'auto'
+                        ? 'Pumpenmodus != auto'
+                        : 'unbekannt';
+                this.adapter.log.debug(`[solarHelper] Solarregelung übersprungen (${reason})`);
+            }
 
             // --- Kollektor-Warnung ---
             const warnActive = (await this.adapter.getStateAsync('solar.warn_active'))?.val;

package/lib/helpers/speechHelper.js

@@ -2,7 +2,7 @@
 
 /**
  * speechHelper
- * - Sendet Texte an Alexa und/oder Telegram
+ * - Sendet Texte an Alexa, Telegram und optional per E-Mail
  * - Verwendet Config (jsonConfig) + States aus speechStates.js
  */
 
@@ -95,6 +95,24 @@ const speechHelper = {
                 });
                 this.adapter.log.info(`[speechHelper] Telegram sendet: ${text}`);
             }
+
+            // E-Mail-Ausgabe
+            if (this.adapter.config.speech_email_enabled && this.adapter.config.speech_email_instance) {
+                const instance = this.adapter.config.speech_email_instance;
+                const sendState = `${instance}.mail`;
+
+                await this.adapter.setForeignStateAsync(sendState, {
+                    val: {
+                        to: this.adapter.config.speech_email_recipient,
+                        subject: this.adapter.config.speech_email_subject || 'PoolControl Nachricht',
+                        text: text,
+                    },
+                    ack: false,
+                });
+                this.adapter.log.info(
+                    `[speechHelper] E-Mail gesendet an ${this.adapter.config.speech_email_recipient}: ${text}`,
+                );
+            }
         } catch (err) {
             this.adapter.log.warn(`[speechHelper] Fehler beim Sprechen: ${err.message}`);
         }

package/lib/stateDefinitions/statusStates.js

@@ -171,9 +171,9 @@ async function createStatusStates(adapter) {
         common: {
             name: 'Poolsaison aktiv',
             type: 'boolean',
-            role: 'indicator',
+            role: 'switch',
             read: true,
-            write: false,
+            write: true,
         },
         native: {},
     });

package/main.js

@@ -65,6 +65,12 @@ class Poolcontrol extends utils.Adapter {
         // --- Statusübersicht ---
         await createStatusStates(this);
 
+        // Saisonstatus aus Config übernehmen
+        await this.setStateAsync('status.season_active', {
+            val: this.config.season_active,
+            ack: true,
+        });
+
         // --- Helper starten ---
         temperatureHelper.init(this);
         timeHelper.init(this);
@@ -113,12 +119,20 @@ class Poolcontrol extends utils.Adapter {
         }
     }
 
-    onStateChange(id, state) {
+    async onStateChange(id, state) {
         if (state) {
             this.log.debug(`state ${id} changed: ${state.val} (ack = ${state.ack})`);
         } else {
             this.log.debug(`state ${id} deleted`);
         }
+
+        // Saisonstatus manuell ändern (z.B. über VIS)
+        if (id.endsWith('status.season_active') && state && state.ack === false) {
+            this.log.info(`[main] Saisonstatus geändert: ${state.val}`);
+            await this.setStateAsync('status.season_active', { val: state.val, ack: true });
+            return; // danach keine Helper mehr aufrufen
+        }
+
         try {
             temperatureHelper.handleStateChange(id, state);
         } catch (e) {

package/package.json

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