iobroker.nexowatt-ui 1.0.4 → 1.0.6
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.
- package/README.md +1 -1
- package/docs/STABLE_1_0_5_RELEASE_DE.md +101 -0
- package/docs/STABLE_1_0_6_RELEASE_DE.md +30 -0
- package/ems/datapoints.js +12 -3
- package/ems/engine.js +5 -1
- package/ems/modules/charging-management.js +120 -55
- package/ems/modules/storage-control.js +119 -24
- package/io-package.json +10 -11
- package/lib/evcs-electrical-limits.js +113 -0
- package/lib/ts-mirrors/ems/charging-management/charging-allocation.js +6 -3
- package/main.js +22 -2
- package/package.json +11 -4
- package/scripts/verify-stable-1.0.5-storage-protection-telemetry.cjs +284 -0
- package/scripts/verify-stable-1.0.6-dc-control.cjs +157 -0
- package/scripts/verify-stable-release.cjs +16 -3
- package/www/ems-apps.html +1 -0
- package/www/ems-apps.js +50 -5
- package/www/manifest.webmanifest +2 -2
- package/www/sw.js +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
NexoWatt EOS is the local platform for energy, charging and building control, including the responsive customer cockpit and installer workspace.
|
|
4
4
|
|
|
5
|
-
**Current stable release:** `1.0.
|
|
5
|
+
**Current stable release:** `1.0.6` (2026-09-15)
|
|
6
6
|
|
|
7
7
|
It provides live energy-flow visualization, historical analysis, SmartHome visualization, installer-controlled EMS applications, and selected customer controls for desktop, tablet, and smartphone use.
|
|
8
8
|
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# NexoWatt EOS 1.0.5 – offizielle Stable-Version
|
|
2
|
+
|
|
3
|
+
**Datum:** 2026-09-12
|
|
4
|
+
**Basis:** vollständige Repository-ZIP 1.0.4
|
|
5
|
+
|
|
6
|
+
## Gezielte Korrektur
|
|
7
|
+
|
|
8
|
+
Die Kundenwahl „Speicher schützen“ ist von der Messwertqualität getrennt. In Auto,
|
|
9
|
+
Boost und Min+PV wird eine unbekannte Fahrzeuglast nicht mehr als 0 W und damit als
|
|
10
|
+
Freigabe der Speicherentladung behandelt. Alte Wattwerte werden nicht als aktuelle
|
|
11
|
+
Messwerte fortgeschrieben; Sollwerte ersetzen keine gemessene Fahrzeugleistung.
|
|
12
|
+
|
|
13
|
+
Bei unbekannter geschützter Fahrzeuglast pausiert die gesamte Speicherentladung.
|
|
14
|
+
Der NVP allein erlaubt keine verlässliche Trennung von Hauslast und Fahrzeuglast.
|
|
15
|
+
Daher kann während dieser Störung auch der Hausverbrauch vorübergehend Netzbezug
|
|
16
|
+
verursachen. Das ist der beabsichtigte konservative Fehlerfall, keine Änderung der
|
|
17
|
+
Normalregelung. Echter Gesamtüberschuss nach Haus und Fahrzeug darf weiterhin in
|
|
18
|
+
den Speicher geladen werden. Speicherentladung wird nicht als PV interpretiert.
|
|
19
|
+
|
|
20
|
+
Nach Rückkehr gültiger Telemetrie ist ohne manuellen Reset wieder der bisherige
|
|
21
|
+
Hauslastausgleich aktiv. Frisch bestätigter Stillstand/Standby blockiert ihn nicht.
|
|
22
|
+
Ein Wechsel auf „Mitnutzen“ oder reines PV-Laden wird bei der nächsten vollständigen
|
|
23
|
+
Policy-Auswertung berücksichtigt; reines PV aktiviert weiterhin keinen Speicherschutz.
|
|
24
|
+
Die AppCenter-Bedienfreigabe bleibt eine Bedienfreigabe, keine neue Installateursperre.
|
|
25
|
+
|
|
26
|
+
## Verteilung und Schutzpfade
|
|
27
|
+
|
|
28
|
+
Auto-PV-Priorität, Gebäudeverbrauch, Wallbox-Startminimum, Phasenwahl/-umschaltung,
|
|
29
|
+
Umschaltpausen, Tarif-/Ladezielfreigaben und bestehende Netz-/Stations-/§14a-Grenzen
|
|
30
|
+
bleiben unverändert. Im Normalbetrieb wird nur der frische geschützte Fahrzeuganteil
|
|
31
|
+
aus der zulässigen Speicherentladung entfernt. Unterhalb des technisch zulässigen
|
|
32
|
+
PV-Ladestarts bleibt ungenutzter Überschuss für den Speicher verfügbar.
|
|
33
|
+
|
|
34
|
+
Die Korrektur sitzt in der gemeinsamen EVCS-Speicher-Policy und der vorhandenen
|
|
35
|
+
asymmetrischen Speicherschranke vor den Ausgangspfaden. Die bestehenden Protokoll-Writer bleiben erhalten. Für E3/DC RSCP wird ein
|
|
36
|
+
0-W-Stopp wegen unbekannter geschützter Fahrzeuglast ausdrücklich mit dem bereits
|
|
37
|
+
vorhandenen IDLE-Modus gesendet: NORMAL würde die lokale Eigenverbrauchsregelung
|
|
38
|
+
wieder freigeben. Diese Auswahl gilt nur für den betreffenden Störfallbefehl; die
|
|
39
|
+
gespeicherte Einstellung `e3dcZeroMode` und alle normalen Schreibpfade bleiben erhalten. Ein notwendiger Stopp
|
|
40
|
+
läuft über die vorhandene Zero-Write-Firewall und darf dort nicht gehalten werden.
|
|
41
|
+
|
|
42
|
+
## Snapshot und Diagnose
|
|
43
|
+
|
|
44
|
+
Ein begrenzter JSON-Snapshot enthält Freigabeabsicht, aktuelle Wattwerte, Anzahl
|
|
45
|
+
unbekannter geschützter Ladepunkte und einen Zeitstempel. Er wird im bestehenden
|
|
46
|
+
Regeltakt veröffentlicht, ohne zusätzlichen Timer oder unbeschränkte Historie.
|
|
47
|
+
Bei unvollständigem Tick, abgelaufenem Snapshot oder Wiederanlauf werden alte Wattwerte
|
|
48
|
+
verworfen, eine bekannte Schutzanforderung aber konservativ beibehalten. Der nächste
|
|
49
|
+
vollständige gültige Snapshot ersetzt sie, einschließlich bewusster Modusänderungen.
|
|
50
|
+
|
|
51
|
+
Neue beziehungsweise ergänzte Diagnosewerte:
|
|
52
|
+
|
|
53
|
+
- `chargingManagement.control.storagePolicyJson`
|
|
54
|
+
- `chargingManagement.control.storageProtectionRequestedWallboxes`
|
|
55
|
+
- `chargingManagement.control.storageProtectedUnknownWallboxes`
|
|
56
|
+
- `chargingManagement.wallboxes.<Ladepunkt>.storagePolicyLoadUnknown`
|
|
57
|
+
- `speicher.regelung.evcsSpeicherSchutzLastUnbekannt`
|
|
58
|
+
- `speicher.regelung.evcsSpeicherSchutzUnbekannteWallboxen`
|
|
59
|
+
- vorhandene `evcsSpeicherSchutzAktion` / `evcsSpeicherSchutzJson`
|
|
60
|
+
|
|
61
|
+
## Prüfgrenzen und Inbetriebnahme
|
|
62
|
+
|
|
63
|
+
Die automatisierten Tests verwenden simulierte ioBroker-Zustände und Schreibziele,
|
|
64
|
+
keine reale Kundenanlage. Vor Kundenfreigabe sind Schützen/Mitnutzen, ein kontrollierter
|
|
65
|
+
Telemetrieausfall mit laufender Ladung, Wiederkehr gültiger Werte sowie PV-Übergabe
|
|
66
|
+
an Fahrzeug und Speicher zu prüfen. Ein defekter oder unerreichbarer Speicherwriter
|
|
67
|
+
kann physische Vorgaben nicht garantieren; vorhandene Geräteschutz-/Watchdogkonzepte
|
|
68
|
+
bleiben erforderlich. Die Releasebezeichnung ist keine Hardware-Zertifizierung.
|
|
69
|
+
|
|
70
|
+
Eine frische Online-Abhängigkeitsinstallation (`npm ci`) scheiterte in der Prüfumgebung
|
|
71
|
+
an Registry-/DNS-Fehlern (`EAI_AGAIN`). Build/Tests verwenden lokal vorhandene Werkzeuge:
|
|
72
|
+
Node.js 22.16.0, TypeScript 5.8.3, Node-Typen 22.19.7. Der Lockfile verlangt Node-Typen
|
|
73
|
+
22.19.21; eine frische Installation genau dieser Entwicklungsabhängigkeiten wird daher
|
|
74
|
+
nicht behauptet. Die Produktions- und Entwicklungsabhängigkeiten wurden nicht geändert.
|
|
75
|
+
Die npm-Versionsverfügbarkeit prüft weiterhin der bestehende Publish-Guard.
|
|
76
|
+
|
|
77
|
+
## Testpflege ohne Änderung des Frontends
|
|
78
|
+
|
|
79
|
+
Zwei ältere Prüfskripte (`evcs-visual-online-state` und `evcs-online-id-depth`)
|
|
80
|
+
prüften noch veraltete Funktionssignaturen beziehungsweise Quelltextzeilen. Beide
|
|
81
|
+
schlugen auch im unveränderten 1.0.4-Repository fehl. Ihre Erwartungen entsprechen
|
|
82
|
+
jetzt dem bereits vorhandenen Online-/OCPP-Vertrag. Die Kachelprüfung führt zusätzlich
|
|
83
|
+
die echten Frontend-Hilfsfunktionen für Online, Leerlauf, Störung und veralteten Status
|
|
84
|
+
aus. Die produktive Online-Ermittlung und das Wallbox-Frontend wurden nicht geändert.
|
|
85
|
+
|
|
86
|
+
## Automatisierte Freigabeprüfung
|
|
87
|
+
|
|
88
|
+
- TypeScript-Build, Typecheck, Runtime-Synchronität und vollständige `test:all`-Kette.
|
|
89
|
+
- Neuer Speicherschutztest: 87 Szenariogruppen und 960 deterministische Grenzfälle.
|
|
90
|
+
- Vorhandener 1.0.4-Test: 37 Szenariogruppen zur Auto-/PV-/Phasenregelung.
|
|
91
|
+
- Zusätzliche 57 Speicher-, EVCS- und PV-Prüfskripte, einschließlich beider aktualisierter Online-Verträge.
|
|
92
|
+
- 4.400 Vergleichsfälle gegen die unveränderte 1.0.4-Basis: bestehende Ergebnisfelder
|
|
93
|
+
der normalen Speicherpolicy und der asymmetrischen Leistungsgrenze unverändert.
|
|
94
|
+
- Drei untergeordnete Speicher-Writer bytegleich auf Methodenebene. Im Dispatcher
|
|
95
|
+
kommt ausschließlich die E3/DC-IDLE-Auswahl für den neuen Telemetrie-Stopp hinzu.
|
|
96
|
+
- Echte Modul-Ticks mit simulierten Lese-/Schreibdatenpunkten für signed/split,
|
|
97
|
+
Sungrow und E3/DC; keine reale Hardware angesteuert.
|
|
98
|
+
|
|
99
|
+
Paketmanifest, npm-Pakettrockenlauf und abschließende ZIP-Prüfung gehören zur
|
|
100
|
+
Freigabe. Die frisch entpackte Repository-ZIP wird erneut gebaut und vollständig
|
|
101
|
+
getestet. Build-Zwischenstände und lokale Abhängigkeiten sind nicht Teil der ZIP.
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# NexoWatt EOS 1.0.6
|
|
2
|
+
|
|
3
|
+
Diese offizielle Stable-Version korrigiert den AC/DC-Ladepunktvertrag im UI-/EMS-Adapter.
|
|
4
|
+
|
|
5
|
+
## Grenzwerte je Ladepunkt
|
|
6
|
+
|
|
7
|
+
- Im AppCenter unter Ladepunkte → Erweitert sind Min. und Max. Strom (A) oder Min. und Max. Leistung (W) einzutragen. Mindestwerte müssen positiv sein; Maximalwerte dürfen nicht kleiner sein.
|
|
8
|
+
- Bei DC mit Leistungssollwert sind Min. und Max. Leistung in W verpflichtend. Beispiel: 4.200 W Mindestleistung und 20.000 W Maximum, **nur wenn diese Werte zum konkreten Gerät passen**.
|
|
9
|
+
- Bei AC können Strom- und Leistungsgrenzen ineinander umgerechnet werden. Wenn beide vorliegen, gelten die strengeren kombinierten Grenzen. Die bestehenden technischen AC-Mindestwerte und Phasenfreigaben bleiben wirksam.
|
|
10
|
+
- Bei DC-Stromsteuerung sind Min./Max. Strom sowie der Bezug des Strom-Datenpunkts verpflichtend: AC-Netzeingang oder DC-Ladeausgang. DC-Ladeausgang benötigt einen plausiblen, höchstens zehn Sekunden alten Spannungsmesswert in V, auch vor einer positiven Startvorgabe. Ohne diese Information erfolgt keine Stromfreigabe. Ein Watt-Sollwert bleibt bei Auto die bevorzugte DC-Schnittstelle.
|
|
11
|
+
- Unvollständige bestehende Ladepunkte starten nach dem Update nicht automatisch mit erfundenen Grenzen. Sie bleiben bei 0 und melden `electricalLimitsValid=false` sowie eine Erklärung in `electricalLimitsError`.
|
|
12
|
+
- Mindestwerte werden auf die nächste ausführbare Gerätestufe angehoben; Maximalwerte und Budgets werden abgerundet. Passt keine positive Stufe zwischen alle wirksamen Grenzen, wird 0 geschrieben.
|
|
13
|
+
|
|
14
|
+
## Regelung und Zuordnung
|
|
15
|
+
|
|
16
|
+
Min+PV hält die konfigurierte technische Mindestleistung auch ohne PV, soweit Netz-, Stations- und weitere harte Grenzen dies zulassen. PV-Zusatzleistung bleibt dem zentralen Budget untergeordnet. Für Netzphasenbegrenzungen zählt der konfigurierte AC-Netzanschluss der DC-Station; die DC-Ausgangsspannung wird ausschließlich für den DC-Ladestrom verwendet. Umrechnende ioBroker-Aliase erhalten Sollwerte in der Einheit des Aliasobjekts.
|
|
17
|
+
|
|
18
|
+
## Prüfung und Inbetriebnahme
|
|
19
|
+
|
|
20
|
+
Der neue Regressionstest `npm run test:stable-1.0.6-dc` prüft die Konfigurationskette, Null-PV-Min+PV, Grenzen, AC-Vergleich, DC-Strombezüge, Spannungsfrische, finale Phasengrenzen und ausgehende Aliaswerte. Er ist Teil von `test:all`.
|
|
21
|
+
|
|
22
|
+
Gemäß den Repository-Richtlinien ist vor Aktivierung eine projektbezogene Inbetriebnahme im Diagnosemodus erforderlich: echte Register/Aliase, Strombezug, Gerätemindestleistung, Geräte-Maximum, Start/Stop und reale Reaktion auf Sollwertsenkungen prüfen. Eine erfolgreiche Übergabe an einen ioBroker-Datenpunkt ersetzt keine Rückmeldung der Station. Der Geräteadapter und die Herstellerregister sind nicht Teil dieses UI-Repositorys; ein Live-Hardwaretest wurde bei dieser Bearbeitung nicht ausgeführt.
|
|
23
|
+
|
|
24
|
+
### Ergebnisse dieser Bearbeitung
|
|
25
|
+
|
|
26
|
+
- `npm run build:ts`, `npm run test:all`, `npm run publish:check` und `npm pack --dry-run --json --ignore-scripts`: erfolgreich.
|
|
27
|
+
- Paket-Startprüfung: 189 JS/MJS-Dateien syntaktisch geprüft; relative Abhängigkeiten und Adapter-/EMS-Startkette vollständig.
|
|
28
|
+
- Chromium: Pflichtgrenzen, Speichersperre, Übernahme von AC/DC-Min-/Max-Leistung sowie DC-Strombezug und Spannungszuordnung geprüft. Bestehende Ladepunktdiagnose, OCPP-Zuordnung und Stationsanzeige ebenfalls erfolgreich.
|
|
29
|
+
- Zwei zusätzliche historische Betriebsstrategie-Browsertests (RC53/RC54, außerhalb von `test:all`) erreichen in dieser Umgebung ihr Render-Ziel nicht. Derselbe Timeout wurde mit der unveränderten gelieferten Version 1.0.5 reproduziert. Diese Tests werden daher ausdrücklich nicht als bestanden gewertet.
|
|
30
|
+
- Ein Test an der realen Projekt-Ladestation steht aus.
|
package/ems/datapoints.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* AUTO-GENERATED RUNTIME FILE - NICHT MANUELL BEARBEITEN.
|
|
3
3
|
*
|
|
4
4
|
* Quelle: src-ts/runtime-executables/ems/datapoints.ts
|
|
5
|
-
* Quell-Hash: sha256:
|
|
5
|
+
* Quell-Hash: sha256:8ddbfc6deaba82a1e7b7e1febe2280a7dbb23740deb4b1bbba67b9e1388a0cdc
|
|
6
6
|
* Erzeugung: npm run sync:ts-runtime-executables
|
|
7
7
|
*
|
|
8
8
|
* Zweck:
|
|
@@ -329,7 +329,7 @@ class DatapointRegistry {
|
|
|
329
329
|
unitIn = inUnit ? String(inUnit) : '';
|
|
330
330
|
}
|
|
331
331
|
const aId = obj?.common?.alias?.id;
|
|
332
|
-
aliasId = aId ? String(aId) : '';
|
|
332
|
+
aliasId = typeof aId === 'string' ? aId : (aId && typeof aId === 'object' ? String(aId.read || aId.write || '') : '');
|
|
333
333
|
} catch (_e) {
|
|
334
334
|
// ignore
|
|
335
335
|
}
|
|
@@ -346,6 +346,9 @@ class DatapointRegistry {
|
|
|
346
346
|
}
|
|
347
347
|
}
|
|
348
348
|
|
|
349
|
+
// Writes address the alias object; ioBroker applies its own write conversion.
|
|
350
|
+
const objectWriteUnit = unitIn;
|
|
351
|
+
|
|
349
352
|
// If this mapping uses an ioBroker alias, prefer the unit of the alias target.
|
|
350
353
|
// Reason: values/freshness come from srcObjectId (= aliasId) but the alias object itself
|
|
351
354
|
// may have no unit or an incorrect display unit.
|
|
@@ -373,6 +376,9 @@ class DatapointRegistry {
|
|
|
373
376
|
}
|
|
374
377
|
|
|
375
378
|
normalized.unitIn = unitIn || '';
|
|
379
|
+
normalized.unitOut = objectWriteUnit || unitIn || '';
|
|
380
|
+
const writeFactor = _computeUnitScale(normalized.unitOut, normalized.unit);
|
|
381
|
+
normalized.writeUnitScale = Math.abs(normalized.scale - writeFactor) < 1e-9 || Math.abs(normalized.scale - 1 / writeFactor) < 1e-9 ? 1 : writeFactor;
|
|
376
382
|
normalized.aliasId = aliasId || '';
|
|
377
383
|
normalized.srcObjectId = normalized.aliasId || normalized.objectId;
|
|
378
384
|
|
|
@@ -465,6 +471,8 @@ class DatapointRegistry {
|
|
|
465
471
|
&& String(prev.direction || '') === String(normalized.direction || '')
|
|
466
472
|
&& String(prev.unit || '') === String(normalized.unit || '')
|
|
467
473
|
&& String(prev.unitIn || '') === String(normalized.unitIn || '')
|
|
474
|
+
&& String(prev.unitOut || '') === String(normalized.unitOut || '')
|
|
475
|
+
&& Number(prev.writeUnitScale || 1) === Number(normalized.writeUnitScale || 1)
|
|
468
476
|
&& Number(prev.unitScale || 1) === Number(normalized.unitScale || 1)
|
|
469
477
|
&& Number(prev.scale || 1) === Number(normalized.scale || 1)
|
|
470
478
|
&& Number(prev.offset || 0) === Number(normalized.offset || 0)
|
|
@@ -1006,7 +1014,8 @@ class DatapointRegistry {
|
|
|
1006
1014
|
let raw = (v - e.offset) / (e.scale || 1);
|
|
1007
1015
|
if (e.invert) raw = -raw;
|
|
1008
1016
|
|
|
1009
|
-
|
|
1017
|
+
const outputScale = Number.isFinite(e.writeUnitScale) ? e.writeUnitScale : e.unitScale;
|
|
1018
|
+
if (Number.isFinite(outputScale) && outputScale !== 1) raw = raw / outputScale;
|
|
1010
1019
|
|
|
1011
1020
|
// deadband in physical space against last written value
|
|
1012
1021
|
const last = this.lastWriteByObjectId.get(e.objectId);
|
package/ems/engine.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* AUTO-GENERATED RUNTIME FILE - NICHT MANUELL BEARBEITEN.
|
|
3
3
|
*
|
|
4
4
|
* Quelle: src-ts/runtime-executables/ems/engine.ts
|
|
5
|
-
* Quell-Hash: sha256:
|
|
5
|
+
* Quell-Hash: sha256:ed86d70ff4a62c05e60d3a1813b199e721b9f3e6c7bcafc91e537825092bcc2b
|
|
6
6
|
* Erzeugung: npm run sync:ts-runtime-executables
|
|
7
7
|
*
|
|
8
8
|
* Zweck:
|
|
@@ -701,6 +701,7 @@ class EmsEngine {
|
|
|
701
701
|
const minA = (Number.isFinite(Number(wb.minCurrentA)) ? Number(wb.minCurrentA) : 0);
|
|
702
702
|
const maxA = (Number.isFinite(Number(wb.maxCurrentA)) ? Number(wb.maxCurrentA) : 0);
|
|
703
703
|
const maxPowerW = (Number.isFinite(Number(wb.maxPowerW)) ? Number(wb.maxPowerW) : 0);
|
|
704
|
+
const minPowerW = (Number.isFinite(Number(wb.minPowerW)) ? Number(wb.minPowerW) : 0);
|
|
704
705
|
const stepA = (Number.isFinite(Number(wb.stepA)) ? Number(wb.stepA) : 0);
|
|
705
706
|
const stepW = (Number.isFinite(Number(wb.stepW)) ? Number(wb.stepW) : 0);
|
|
706
707
|
// Default mode from Admin table (runtime state can override)
|
|
@@ -745,6 +746,8 @@ class EmsEngine {
|
|
|
745
746
|
controlBasis,
|
|
746
747
|
phases,
|
|
747
748
|
voltageV,
|
|
749
|
+
dcCurrentReference: String(wb.dcCurrentReference || '').trim(),
|
|
750
|
+
dcVoltageId: String(wb.dcVoltageId || '').trim(),
|
|
748
751
|
// Stationsmeta
|
|
749
752
|
...(stationKey ? { stationKey } : {}),
|
|
750
753
|
...(connectorNo > 0 ? { connectorNo } : {}),
|
|
@@ -754,6 +757,7 @@ class EmsEngine {
|
|
|
754
757
|
...(minA > 0 ? { minA } : {}),
|
|
755
758
|
...(maxA > 0 ? { maxA } : {}),
|
|
756
759
|
...(maxPowerW > 0 ? { maxPowerW } : {}),
|
|
760
|
+
...(minPowerW > 0 ? { minPowerW } : {}),
|
|
757
761
|
...(stepA > 0 ? { stepA } : {}),
|
|
758
762
|
...(stepW > 0 ? { stepW } : {}),
|
|
759
763
|
// datapoints
|