iobroker.poolcontrol 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +129 -0
  3. package/admin/i18n/de/translations.json +5 -0
  4. package/admin/i18n/en/translations.json +5 -0
  5. package/admin/i18n/es/translations.json +5 -0
  6. package/admin/i18n/fr/translations.json +5 -0
  7. package/admin/i18n/it/translations.json +5 -0
  8. package/admin/i18n/nl/translations.json +5 -0
  9. package/admin/i18n/pl/translations.json +5 -0
  10. package/admin/i18n/pt/translations.json +5 -0
  11. package/admin/i18n/ru/translations.json +5 -0
  12. package/admin/i18n/uk/translations.json +5 -0
  13. package/admin/i18n/zh-cn/translations.json +5 -0
  14. package/admin/jsonConfig.json +901 -0
  15. package/admin/poolcontrol.png +0 -0
  16. package/io-package.json +176 -0
  17. package/lib/adapter-config.d.ts +19 -0
  18. package/lib/helpers/consumptionHelper.js +185 -0
  19. package/lib/helpers/frostHelper.js +94 -0
  20. package/lib/helpers/pumpHelper.js +224 -0
  21. package/lib/helpers/runtimeHelper.js +159 -0
  22. package/lib/helpers/solarHelper.js +138 -0
  23. package/lib/helpers/speechHelper.js +108 -0
  24. package/lib/helpers/temperatureHelper.js +227 -0
  25. package/lib/helpers/timeHelper.js +88 -0
  26. package/lib/stateDefinitions/consumptionStates.js +82 -0
  27. package/lib/stateDefinitions/generalStates.js +68 -0
  28. package/lib/stateDefinitions/pumpStates.js +184 -0
  29. package/lib/stateDefinitions/runtimeStates.js +113 -0
  30. package/lib/stateDefinitions/solarStates.js +150 -0
  31. package/lib/stateDefinitions/speechStates.js +104 -0
  32. package/lib/stateDefinitions/temperatureStates.js +182 -0
  33. package/lib/stateDefinitions/timeStates.js +102 -0
  34. package/main.js +145 -0
  35. package/package.json +60 -0
package/LICENSE ADDED
@@ -0,0 +1,22 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 DasBo1975 <dasbo1975@outlook.de>
4
+
5
+ Hiermit wird jedem, der eine Kopie dieser Software und der zugehörigen
6
+ Dokumentationsdateien (die "Software") erhält, die Erlaubnis erteilt,
7
+ die Software uneingeschränkt zu nutzen, einschließlich, aber nicht
8
+ beschränkt auf das Recht, die Software zu verwenden, zu kopieren,
9
+ zu ändern, zu verbinden, zu veröffentlichen, zu verbreiten,
10
+ Unterlizenzen zu erteilen und/oder Kopien der Software zu verkaufen,
11
+ sowie Personen, denen die Software zur Verfügung gestellt wird, dies zu gestatten,
12
+ unter der Bedingung, dass der oben genannte Urheberrechtshinweis und dieser
13
+ Erlaubnishinweis in allen Kopien oder wesentlichen Teilen der Software
14
+ beibehalten werden.
15
+
16
+ DIE SOFTWARE WIRD "WIE BESEHEN" OHNE JEDE GARANTIE, WEDER AUSDRÜCKLICH NOCH
17
+ STILLSCHWEIGEND, EINSCHLIESSLICH, ABER NICHT BEGRENZT AUF DIE GARANTIEN DER
18
+ MARKTGÄNGIGKEIT, EIGNUNG FÜR EINEN BESTIMMTEN ZWECK UND NICHTVERLETZUNG.
19
+ IN KEINEM FALL HAFTEN DIE AUTOREN ODER COPYRIGHT-INHABER FÜR ANSPRÜCHE, SCHÄDEN
20
+ ODER SONSTIGE HAFTUNG, OB IN EINER KLAGE ODER EINER ANDEREN HAFTUNGSGRUNDLAGE,
21
+ DIE AUS ODER IM ZUSAMMENHANG MIT DER SOFTWARE ODER DER NUTZUNG DER SOFTWARE
22
+ ODER ANDEREN VEREINBARUNGEN ENTSTEHT.
package/README.md ADDED
@@ -0,0 +1,129 @@
1
+ # ioBroker.poolcontrol
2
+
3
+ ![Test and Release](https://github.com/DasBo1975/iobroker.poolcontrol/actions/workflows/test-and-release.yml/badge.svg)
4
+
5
+ Der Adapter **ioBroker.poolcontrol** dient zur Steuerung und Überwachung von Poolanlagen.
6
+ Er ermöglicht die Automatisierung von Pumpen, Temperatur- und Solarsteuerung sowie Verbrauchsauswertung.
7
+
8
+ ---
9
+
10
+ ## Funktionen
11
+
12
+ - **Pumpensteuerung**
13
+ - Betriebsmodi: Automatik, Manuell, Zeitsteuerung, Aus
14
+ - Fehlererkennung (kein Stromverbrauch, Leistung trotz „AUS“, Überlast)
15
+ - Sicherheitsfunktionen (Frostschutz, Überhitzungsschutz)
16
+
17
+ - **Temperaturverwaltung**
18
+ - Bis zu 6 Sensoren (Oberfläche, Grund, Vorlauf, Rücklauf, Kollektor, Außentemperatur)
19
+ - Tages-Minimum / -Maximum
20
+ - Änderung pro Stunde
21
+ - Differenzen (z. B. Kollektor – Luft, Oberfläche – Grund, Vorlauf – Rücklauf)
22
+
23
+ - **Solarsteuerung**
24
+ - Ein-/Ausschaltgrenzen mit Hysterese
25
+ - Kollektor-Warnung (mit automatischer Rücksetzung bei 10 % unter der Schwelle)
26
+ - Optional Sprachausgabe bei Warnung
27
+
28
+ - **Zeitsteuerung**
29
+ - Bis zu 3 frei konfigurierbare Zeitfenster pro Woche
30
+
31
+ - **Laufzeit & Umwälzung**
32
+ - Zählt Laufzeiten (heute, gesamt)
33
+ - Berechnet tägliche Umwälzung und Restmenge
34
+
35
+ - **Verbrauch & Kosten**
36
+ - Auswertung eines externen kWh-Zählers
37
+ - Tages-, Wochen-, Monats- und Jahresverbrauch
38
+ - Berechnung der Stromkosten anhand konfigurierbarem Preis
39
+ **Hinweis:**
40
+ Details zum Verhalten der Verbrauchs- und Kostenwerte (z. B. bei Neustarts oder beim Wechsel des Stromzählers) finden Sie in der Datei [help.md](./help.md).
41
+
42
+ - **Sprachausgaben**
43
+ - Ausgabe über Alexa oder Telegram
44
+ - Ansagen bei Pumpenstart/-stopp, Fehlern oder Temperaturschwellen
45
+
46
+ ---
47
+
48
+ ## Installation
49
+
50
+ 1. Adapter über ioBroker Admin installieren.
51
+ 2. Instanz anlegen.
52
+ 3. Konfiguration im Admin-Tab vornehmen: Pumpenleistung, Sensoren, Solar, Sprachausgaben, etc.
53
+
54
+ ---
55
+
56
+ ## Konfiguration
57
+
58
+ Die Konfiguration erfolgt über Tabs im Admin-Interface:
59
+ - **Allgemein** → Poolname, Poolgröße, minimale Umwälzung
60
+ - **Pumpe** → Pumpenleistung, Leistungsgrenzen, Sicherheitsfunktionen
61
+ - **Temperaturen** → Auswahl und Objekt-IDs der Sensoren
62
+ - **Solarverwaltung** → Ein-/Ausschaltgrenzen, Hysterese, Warnschwelle
63
+ - **Zeitsteuerung** → Zeitfenster für Pumpenbetrieb
64
+ - **Sprachausgaben** → Aktivierung, Alexa/Telegram-Anbindung
65
+ - **Verbrauch & Kosten** → externer kWh-Zähler, Strompreis
66
+
67
+ ---
68
+
69
+ ## Geplante Erweiterungen
70
+
71
+ - Rückspülerinnerung (Intervall in Tagen, Erinnerung über State)
72
+ - Wartung Kesseldruck (maximaler Druck, Warnung bei Überschreitung)
73
+ - Weitere Komfortfunktionen nach Praxistests
74
+
75
+ ---
76
+
77
+ ## Hinweis
78
+
79
+ Der Adapter befindet sich aktuell in der Entwicklung.
80
+ Funktionen können sich ändern, bitte regelmäßig den Changelog beachten.
81
+
82
+ ---
83
+
84
+ ## Dokumentation
85
+ - [Help.md (ausführliche Beschreibung und Hinweise)](./help.md)
86
+
87
+ ---
88
+
89
+ ## Changelog
90
+ Auszug, vollständige Liste siehe `io-package.json`:
91
+
92
+ ### 0.0.7
93
+ - Help-Datei (`help.md`) und erste README-Version hinzugefügt
94
+
95
+ ### 0.0.6
96
+ - Verbrauchs- und Kostenberechnung mit externem kWh-Zähler
97
+
98
+ ### 0.0.5
99
+ - Sprachausgabe über Alexa und Telegram
100
+
101
+ ### 0.0.1
102
+ - initial release
103
+
104
+ ---
105
+
106
+ ## Support
107
+ - [ioBroker Forum](https://forum.iobroker.net/)
108
+ - [GitHub Issues](https://github.com/DasBo1975/ioBroker.poolcontrol/issues)
109
+
110
+ ---
111
+
112
+ ## Unterstützung der Adapterentwicklung
113
+ Wenn Ihnen **ioBroker.poolcontrol** gefällt, denken Sie bitte über eine Spende nach:
114
+
115
+ ➡️ [Unterstützen via PayPal](https://www.paypal.com/donate?business=dirk.bertin@t-online.de)
116
+
117
+ ---
118
+
119
+ ## Haftungsausschluss
120
+ Die Nutzung des Adapters erfolgt **auf eigene Gefahr**.
121
+ Der Entwickler übernimmt **keine Haftung** für Schäden, die durch die Installation, Nutzung oder Fehlfunktionen entstehen.
122
+ Dies gilt insbesondere bei direkter Ansteuerung von elektrischen Geräten (z. B. Poolpumpen).
123
+ Der Nutzer ist für die **sichere Installation und den Betrieb seiner Hardware** verantwortlich.
124
+
125
+ ---
126
+
127
+ ## LICENSE
128
+ [MIT](./LICENSE) License
129
+ Copyright (c) 2025 DasBo1975
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Adaptereinstellungen für poolcontrol",
3
+ "option1": "Option1",
4
+ "option2": "Option2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Adapter settings for poolcontrol",
3
+ "option1": "option1",
4
+ "option2": "option2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Ajustes del adaptador para poolcontrol",
3
+ "option1": "Opción1",
4
+ "option2": "opción 2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Paramètres d'adaptateur pour poolcontrol",
3
+ "option1": "option1",
4
+ "option2": "Option2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Impostazioni dell'adattatore per poolcontrol",
3
+ "option1": "opzione1",
4
+ "option2": "opzione2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Adapterinstellingen voor poolcontrol",
3
+ "option1": "Option1",
4
+ "option2": "Optie2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Ustawienia adaptera dla poolcontrol",
3
+ "option1": "opcja 1",
4
+ "option2": "opcja2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Configurações do adaptador para poolcontrol",
3
+ "option1": "opção1",
4
+ "option2": "opção2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Настройки адаптера для poolcontrol",
3
+ "option1": "вариант1",
4
+ "option2": "вариант2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "Налаштування адаптера для poolcontrol",
3
+ "option1": "Варіант1",
4
+ "option2": "Варіант2"
5
+ }
@@ -0,0 +1,5 @@
1
+ {
2
+ "poolcontrol adapter settings": "poolcontrol的适配器设置",
3
+ "option1": "选项1",
4
+ "option2": "选项2"
5
+ }