iobroker.poolcontrol 1.3.10 → 1.3.12

package/README.md

@@ -188,6 +188,75 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.3.12 (2026-05-02)
+
+**Solar Insights – Calculation fix & structure improvement**
+
+- Fixed incorrect thermal power and energy calculation
+- Previously used collector – pool temperature → caused unrealistic values
+- Switched to correct physical calculation: return – flow (water delta)
+- Thermal power is now only calculated when:
+  - valid flow is available
+  - delta T > 0
+- Prevents unrealistic values (e.g. hundreds of kW or >100 kWh daily gain)
+- Stabilized daily gain and peak power calculation
+- No accumulation with invalid or missing data
+- Improved sensor logic:
+  - introduced `flow` and `water_delta`
+  - clear separation between flow and temperature delta
+- Increased transparency:
+  - new output: `thermal_delta_source = return_flow_delta`
+  - HTML and JSON outputs extended
+- Added new i18n key:
+  - `solar_insights_label_thermal_delta_source`
+
+**Photovoltaic Insights – Runtime & stability fix**
+
+- Fixed incorrect runtime calculation
+- Root cause: runtime was only calculated on state changes
+- Added internal periodic recalculation (every 60 seconds during PV runtime)
+- Runtime is now accumulated continuously and correctly
+- Logic unchanged:
+  - only real PV surplus runtime is counted (`pv_surplus_active && photovoltaicHelper`)
+  - no afterrun included
+- Improved calculation:
+  - runtime is now independent from pump power availability
+  - energy is only calculated with valid pump power
+- Increased stability:
+  - improved start detection (`starts_today`)
+  - more reliable time delta handling
+- Added daily reset:
+  - all daily values reset at midnight
+  - runtime, energy, savings, starts and active state cleared
+  - internal helper states reset
+
+### 1.3.11 (2026-05-02)
+
+- (DasBo) New: pH evaluation module (`chemistry.ph`)
+    - supports manual input and external state sources
+    - includes validation, measurement location handling and plausibility checks
+    - evaluation logic with status and user recommendations (no automatic dosing)
+    - manual mixing run with proper pump ownership handling
+    - includes history tracking (last valid value, previous value, time differences)
+    - fully integrated with i18n translations
+
+- (DasBo) New: TDS evaluation module (`chemistry.tds`)
+    - supports manual input and external state sources
+    - includes validation, measurement location and flow-dependent evaluation
+    - reference value tracking (initial water quality baseline)
+    - long-term trend analysis (24h, 7d, 30d)
+    - evaluation based on absolute value, trend and reference delta (no automatic control)
+    - stores measurement history (up to 30 days)
+    - summary outputs (text, JSON, HTML)
+    - fully integrated with i18n translations
+
+- (DasBo) Fix: solar speech toggle (standard vs. extended)
+    - solarExtendedHelper no longer writes to `speech.solar_active` when `solar.control_mode = standard`
+    - prevents conflicting updates between `solarHelper` and `solarExtendedHelper`
+    - eliminates repeated "solar on/off" speech messages
+    - improves separation of solar control modes
+    - stabilizes speech output behavior
+
 ### 1.3.10 (2026-05-01)
 
 New: Photovoltaic Insights
@@ -236,20 +305,6 @@ Bugfixes
 - solarInsightsHelper: fixed detection of standard solar runtime, replaced non-existing solar.active with solar.request_active, improved reliability of solar_ran_today for normal solar setups
 - photovoltaicHelper: round surplus value in status text (avoid long decimal numbers), switched afterrun timer to adapter.setTimeout / clearTimeout
 
-### 1.3.6 (2026-04-21)
-
-frostHelper
-- Fixed incorrect pump shutdown when other helpers (e.g. photovoltaicHelper) are active
-- frostHelper now only disables the pump if it previously activated it itself
-- improved internal ownership logic for safer multi-helper interaction
-- corrected frost speech state handling (no longer based on current pump state)
-- switched timer to adapter.setInterval / adapter.clearInterval for better stability and ioBroker compliance
-
-### 1.3.5 (2026-04-19)
-
-- Fixed critical i18n issue in solarInsightsHelper and solarLogbookHelper that could lead to instability or crashes
-- Switched translation handling to I18n.translate() for stable and consistent i18n behavior
-
 ## 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.10",
+    "version": "1.3.12",
     "news": {
+      "1.3.12": {
+        "en": "Solar Insights calculation fixed and photovoltaic runtime tracking stabilized",
+        "de": "Solar Insights Berechnung korrigiert und Photovoltaik-Laufzeit stabilisiert",
+        "ru": "Исправлен расчет Solar Insights и стабилизировано отслеживание времени работы фотоэлектрических систем.",
+        "pt": "Cálculo do Solar Insights corrigido e rastreamento de tempo de execução fotovoltaico estabilizado",
+        "nl": "Solar Insights-berekening vast en tracking van fotovoltaïsche looptijd gestabiliseerd",
+        "fr": "Calcul de Solar Insights corrigé et suivi de la durée de fonctionnement photovoltaïque stabilisé",
+        "it": "Calcolo Solar Insights fisso e monitoraggio dell'autonomia fotovoltaica stabilizzato",
+        "es": "Cálculo de Solar Insights fijo y seguimiento del tiempo de funcionamiento fotovoltaico estabilizado",
+        "pl": "Naprawiono obliczenia Solar Insights i ustabilizowano śledzenie czasu działania fotowoltaiki",
+        "uk": "Виправлено розрахунок Solar Insights і стабілізовано відстеження часу роботи фотоелектричної системи",
+        "zh-cn": "Solar Insights 计算固定，光伏运行时间跟踪稳定"
+      },
+      "1.3.11": {
+        "en": "New: Added pH evaluation module (chemistry.ph) with manual and external input, validation, measurement location handling and recommendations. New: Added TDS evaluation module (chemistry.tds) with trend analysis (24h, 7d, 30d), reference tracking and summary outputs (text/JSON/HTML). Fix: Resolved solar speech toggle issue between standard and extended mode. solarExtendedHelper no longer overwrites speech.solar_active in standard mode.",
+        "de": "Neu: pH-Auswertungsmodul (chemistry.ph) mit manueller und externer Eingabe, Validierung, Messort-Berücksichtigung und Handlungsempfehlungen. Neu: TDS-Auswertungsmodul (chemistry.tds) mit Trendanalyse (24h, 7 Tage, 30 Tage), Referenzwert-Verfolgung und Zusammenfassungen (Text/JSON/HTML). Fix: Problem mit Solar-Sprachausgabe zwischen Standard- und Extended-Modus behoben. Der solarExtendedHelper überschreibt speech.solar_active im Standard-Modus nicht mehr.",
+        "ru": "Новое: добавлен модуль оценки pH (chemistry.ph) с ручным и внешним вводом, проверкой, обработкой места измерения и рекомендациями. Новое: добавлен модуль оценки TDS (chemistry.tds) с анализом тенденций (24 часа, 7 дней, 30 дней), отслеживанием ссылок и сводными результатами (текст/JSON/HTML). Исправлено: решена проблема переключения солнечной речи между стандартным и расширенным режимом. SolarExtendedHelper больше не перезаписывает voice.solar_active в стандартном режиме.",
+        "pt": "Novo: Adicionado módulo de avaliação de pH (chemistry.ph) com entrada manual e externa, validação, manuseio do local de medição e recomendações. Novo: Adicionado módulo de avaliação TDS (chemistry.tds) com análise de tendências (24h, 7d, 30d), rastreamento de referência e resultados resumidos (texto/JSON/HTML). Correção: Resolvido problema de alternância de fala solar entre o modo padrão e estendido. solarExtendedHelper não substitui mais Speech.solar_active no modo padrão.",
+        "nl": "Nieuw: pH-evaluatiemodule toegevoegd (chemistry.ph) met handmatige en externe invoer, validatie, afhandeling van meetlocaties en aanbevelingen. Nieuw: TDS-evaluatiemodule toegevoegd (chemistry.tds) met trendanalyse (24 uur, 7 dagen, 30 dagen), referentietracking en samenvattingsresultaten (tekst/JSON/HTML). Oplossing: het probleem met het wisselen van spraak op zonne-energie tussen de standaard- en de uitgebreide modus is opgelost. solarExtendedHelper overschrijft speech.solar_active niet langer in de standaardmodus.",
+        "fr": "Nouveau : ajout d'un module d'évaluation du pH (chemistry.ph) avec saisie manuelle et externe, validation, gestion des emplacements de mesure et recommandations. Nouveau : Ajout du module d'évaluation TDS (chemistry.tds) avec analyse des tendances (24h, 7j, 30j), suivi des références et sorties récapitulatives (texte/JSON/HTML). Correction : Résolution du problème de basculement de la parole solaire entre le mode standard et le mode étendu. solarExtendedHelper n’écrase plus Speech.solar_active en mode standard.",
+        "it": "Novità: aggiunto il modulo di valutazione del pH (chemistry.ph) con input manuale ed esterno, convalida, gestione del luogo di misurazione e raccomandazioni. Novità: aggiunto il modulo di valutazione TDS (chemistry.tds) con analisi dei trend (24 ore, 7 giorni, 30 giorni), tracciamento dei riferimenti e output di riepilogo (testo/JSON/HTML). Correzione: risolto il problema di commutazione del parlato solare tra la modalità standard e quella estesa. solarExtendedHelper non sovrascrive più Speech.solar_active in modalità standard.",
+        "es": "Nuevo: Módulo de evaluación de pH agregado (chemistry.ph) con entrada manual y externa, validación, manejo de la ubicación de medición y recomendaciones. Nuevo: Módulo de evaluación TDS agregado (chemistry.tds) con análisis de tendencias (24h, 7d, 30d), seguimiento de referencias y resultados resumidos (texto/JSON/HTML). Solución: se resolvió el problema de alternar la voz solar entre el modo estándar y extendido. solarExtendedHelper ya no sobrescribe Speech.solar_active en modo estándar.",
+        "pl": "Nowość: Dodano moduł oceny pH (chemistry.ph) z ręcznym i zewnętrznym wprowadzaniem danych, walidacją, obsługą miejsca pomiaru i zaleceniami. Nowość: Dodano moduł oceny TDS (chemistry.tds) z analizą trendów (24h, 7d, 30d), śledzeniem referencji i wynikami podsumowującymi (tekst/JSON/HTML). Poprawka: rozwiązano problem z przełączaniem mowy słonecznej między trybem standardowym i rozszerzonym. solarExtendedHelper nie zastępuje już mowy.solar_active w trybie standardowym.",
+        "uk": "Нове: додано модуль оцінки pH (chemistry.ph) із ручним і зовнішнім введенням, перевіркою, обробкою місця вимірювання та рекомендаціями. Нове: додано модуль оцінки TDS (chemistry.tds) з ​​аналізом тенденцій (24 години, 7 днів, 30 днів), відстеженням посилань і підсумковими виходами (текст/JSON/HTML). Виправлення: вирішено проблему перемикання сонячної мови між стандартним і розширеним режимами. solarExtendedHelper більше не перезаписує speak.solar_active у стандартному режимі.",
+        "zh-cn": "新增内容：添加了 pH 评估模块 (chemistry.ph)，具有手动和外部输入、验证、测量位置处理和建议。新增内容：添加了 TDS 评估模块 (chemistry.tds)，具有趋势分析（24 小时、7 天、30 天）、参考跟踪和摘要输出（文本/JSON/HTML）。修复：解决了标准模式和扩展模式之间的太阳能语音切换问题。在标准模式下，solarExtendedHelper 不再覆盖pepe.solar_active。"
+      },
       "1.3.10": {
         "en": "Added photovoltaic insights (runtime, energy, savings) with new analytics states and helper. Improved active_helper ownership handling across photovoltaic, solar and extended solar helpers. Fixed PV circulation logic when ignore_on_circulation is disabled.",
         "de": "Photovoltaik-Einblicke (Laufzeit, Energie, Einsparungen) mit neuen Analysezuständen und Hilfsfunktionen hinzugefügt. Verbesserte Handhabung des Active_Helper-Besitzes für Photovoltaik-, Solar- und erweiterte Solar-Helfer. Die PV-Zirkulationslogik wurde korrigiert, wenn „ignore_on_circulation“ deaktiviert ist.",
@@ -41,32 +67,6 @@
         "pl": "Napraw wykrywanie solarInsights dla standardowej energii słonecznej (użyj solar.request_active zamiast nieistniejącego solar.active). Udoskonalenia programu photovoltaicHelper: zaokrąglona wartość nadwyżki w tekście statusu i przełączona licznik czasu afterrun na adapter.setTimeout/clearTimeout.",
         "uk": "Виправте виявлення solarInsights для стандартної сонячної енергії (використовуйте solar.request_active замість неіснуючого solar.active). Покращення photovoltaicHelper: округлене надлишкове значення в тексті стану та переключений таймер післязапуску на adapter.setTimeout/clearTimeout.",
         "zh-cn": "修复标准太阳能的 SolarInsights 检测（使用 Solar.request_active 而不是不存在的 Solar.active）。 PVHelper 改进：对状态文本中的剩余值进行四舍五入，并将 Afterrun 计时器切换为 adapter.setTimeout/clearTimeout。"
-      },
-      "1.3.6": {
-        "en": "Fix for frostHelper: prevents incorrect pump shutdown when other helpers (e.g. photovoltaic) are active. Frost protection now only disables the pump if it previously activated it itself. Improved speech state logic for frost indication. Switched frostHelper timer to adapter.setInterval for better stability and ioBroker compliance.",
-        "de": "Fix für frostHelper: verhindert falsches Abschalten der Pumpe, wenn andere Helper (z. B. Photovoltaik) aktiv sind. Frostschutz schaltet die Pumpe jetzt nur noch aus, wenn er sie zuvor selbst aktiviert hat. Sprach-State für Frostanzeige korrigiert. Timer im frostHelper auf adapter.setInterval umgestellt für bessere Stabilität und ioBroker-Konformität.",
-        "ru": "Исправление FrostHelper: предотвращает некорректное выключение насоса, когда активны другие помощники (например, фотоэлектрические). Защита от замерзания теперь отключает насос только в том случае, если он ранее активировал его сам. Улучшена логика речевого состояния для индикации замерзания. Таймер FrostHelper переключен на адаптер.setInterval для большей стабильности и соответствия требованиям ioBroker.",
-        "pt": "Correção parafrostHelper: evita o desligamento incorreto da bomba quando outros auxiliares (por exemplo, fotovoltaicos) estão ativos. A proteção contra congelamento agora só desativa a bomba se ela mesma a tiver ativado anteriormente. Lógica de estado de fala aprimorada para indicação de congelamento. Mudou o temporizadorfrostHelper para adaptador.setInterval para melhor estabilidade e conformidade com ioBroker.",
-        "nl": "Oplossing voor FrostHelper: voorkomt onjuiste pompuitschakeling wanneer andere helpers (bijv. fotovoltaïsche energie) actief zijn. De vorstbeveiliging schakelt de pomp nu alleen uit als deze deze eerder zelf heeft geactiveerd. Verbeterde spraakstatuslogica voor vorstindicatie. FrostHelper-timer omgeschakeld naar adapter.setInterval voor betere stabiliteit en ioBroker-compliance.",
-        "fr": "Correctif pour frostHelper : empêche un arrêt incorrect de la pompe lorsque d'autres assistants (par exemple photovoltaïques) sont actifs. La protection antigel désactive désormais la pompe uniquement si elle l'a activée elle-même auparavant. Logique d’état vocale améliorée pour l’indication de gel. La minuterie FrostHelper a été remplacée par adapter.setInterval pour une meilleure stabilité et une meilleure conformité à ioBroker.",
-        "it": "Correzione per FrostHelper: impedisce lo spegnimento errato della pompa quando altri helper (ad esempio fotovoltaico) sono attivi. La protezione antigelo ora disabilita la pompa solo se precedentemente l'aveva attivata da sola. Logica dello stato vocale migliorata per l'indicazione del gelo. Cambiato il timer FrostHelper su Adapter.setInterval per una migliore stabilità e conformità con ioBroker.",
-        "es": "Solución para frostHelper: evita el apagado incorrecto de la bomba cuando otros ayudantes (por ejemplo, fotovoltaicos) están activos. La protección contra heladas ahora solo desactiva la bomba si previamente la activó ella misma. Lógica de estado de voz mejorada para indicación de escarcha. Se cambió el temporizador frostHelper a adaptor.setInterval para una mejor estabilidad y cumplimiento de ioBroker.",
-        "pl": "Poprawka dla FrostHelper: zapobiega nieprawidłowemu wyłączeniu pompy, gdy aktywne są inne pomoce (np. fotowoltaiczne). Ochrona przed zamarzaniem wyłącza teraz pompę tylko wtedy, gdy wcześniej sama ją uruchomiła. Ulepszona logika stanu mowy dla sygnalizacji mrozu. Zmieniono licznik czasu FrostHelper na adapter.setInterval, aby zapewnić lepszą stabilność i zgodność z ioBrokerem.",
-        "uk": "Виправлення для frostHelper: запобігає неправильному вимкненню насоса, коли інші помічники (наприклад, фотоелектричні) активні. Захист від замерзання тепер вимикає насос лише в тому випадку, якщо він раніше сам його активував. Покращена логіка стану мови для індикації морозу. Перемкнуто таймер frostHelper на adapter.setInterval для кращої стабільності та відповідності ioBroker.",
-        "zh-cn": "修复霜助手：防止当其他助手（例如光伏）处于活动状态时错误地关闭泵。现在，防冻保护只会在泵之前自行激活的情况下禁用泵。改进了霜冻指示的语音状态逻辑。将frostHelper计时器切换为adapter.setInterval以获得更好的稳定性和ioBroker合规性。"
-      },
-      "1.3.5": {
-        "en": "Fixed critical i18n issue in solarInsightsHelper and solarLogbookHelper that could lead to instability or crashes. Switched translation handling to I18n.translate() to ensure stable operation.",
-        "de": "Kritischer i18n-Fehler in solarInsightsHelper und solarLogbookHelper behoben, der zu Instabilität oder Abstürzen führen konnte. Übersetzungen wurden auf I18n.translate() umgestellt, um einen stabilen Betrieb sicherzustellen.",
-        "ru": "Исправлена ​​критическая проблема i18n в SolarInsightsHelper и SolarLogbookHelper, которая могла привести к нестабильности или сбоям. Обработку перевода переключили на I18n.translate() для обеспечения стабильной работы.",
-        "pt": "Foi corrigido um problema crítico do i18n no solarInsightsHelper e no solarLogbookHelper que poderia causar instabilidade ou travamentos. Manipulação de tradução alterada para I18n.translate() para garantir uma operação estável.",
-        "nl": "Een kritiek i18n-probleem in solarInsightsHelper en solarLogbookHelper opgelost dat tot instabiliteit of crashes kon leiden. De verwerking van de vertalingen is gewijzigd naar I18n.translate() om een ​​stabiele werking te garanderen.",
-        "fr": "Correction d'un problème i18n critique dans solarInsightsHelper et solarLogbookHelper qui pouvait entraîner une instabilité ou des plantages. Gestion de la traduction commutée vers I18n.translate() pour garantir un fonctionnement stable.",
-        "it": "Risolto un problema critico i18n in solarInsightsHelper e solarLogbookHelper che poteva portare a instabilità o arresti anomali. Modificata la gestione della traduzione su I18n.translate() per garantire un funzionamento stabile.",
-        "es": "Se solucionó un problema crítico de i18n en solarInsightsHelper y solarLogbookHelper que podía provocar inestabilidad o fallas. Se cambió el manejo de traducción a I18n.translate() para garantizar un funcionamiento estable.",
-        "pl": "Naprawiono krytyczny problem i18n w programach solarInsightsHelper i solarLogbookHelper, który mógł prowadzić do niestabilności lub awarii. Przełączono obsługę tłumaczeń na I18n.translate(), aby zapewnić stabilne działanie.",
-        "uk": "Виправлено критичну проблему i18n у solarInsightsHelper і solarLogbookHelper, яка могла призвести до нестабільності або збоїв. Перемкнуто обробку перекладу на I18n.translate(), щоб забезпечити стабільну роботу.",
-        "zh-cn": "修复了 SolarInsightsHelper 和 SolarLogbookHelper 中可能导致不稳定或崩溃的关键 i18n 问题。将翻译处理切换为 I18n.translate() 以确保稳定运行。"
       }
     },
     "titleLang": {