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 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.4` (2026-09-11)
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:3bbf7b38d3f42ed4f1d9b1d57c0c654371d7765b8ef90d27fbf7a9675165e835
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
- if (Number.isFinite(e.unitScale) && e.unitScale !== 1) raw = raw / e.unitScale;
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:d8f7bab38ff19e7fa52d306e498c09f5fbe229bf47f12bb425c7e2ba8c5c8951
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