iobroker.nexowatt-ui 1.0.1 → 1.0.3

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.1` (2026-09-09)
5
+ **Current stable release:** `1.0.3` (2026-09-09)
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,72 @@
1
+ # NexoWatt EOS 1.0.2 – offizielle Stable-Version
2
+
3
+ **Veröffentlichungsdatum:** 2026-09-09
4
+ **Status:** Official Stable Patch / produktiver Verkaufsstand
5
+
6
+ ## Zweck des Patches
7
+
8
+ NexoWatt EOS 1.0.2 beseitigt die nach 1.0.1 weiterhin beobachtete zyklische Anzeige „Offline / veraltet“ in der EOS-Admin-Übersicht. Der Fehler lag nicht mehr im RC88-Speicherwächter oder im SSE-Livekanal. Es bestand ein eigenständiger Timing-Konflikt zwischen dem ungefähr 20 Sekunden großen Frischefenster der Oberfläche, dem bisherigen 30-Sekunden-Heartbeat von `info.connection` und EMS-/Diagnosezyklen, die innerhalb ihrer Watchdoggrenzen länger als 20 Sekunden laufen dürfen.
9
+
10
+ Der Feldfall zeigte gleichzeitig einen erreichbaren Adapter, einen 25 Sekunden alten Tick-Start und eine vorherige Zyklusdauer von 2608 ms. Ein noch laufender, nicht festhängender Zyklus wurde dabei irrtümlich wie ein nicht erreichbarer Adapter dargestellt.
11
+
12
+ ## Neuer Zustandsvertrag
13
+
14
+ Die Übersicht unterscheidet jetzt vier technisch getrennte Signale:
15
+
16
+ | Signal | Takt / Grenze | Bedeutung |
17
+ |---|---:|---|
18
+ | Adapter-/HTTP-Erreichbarkeit | 4 s | `info.connection` wird aus dem realen Serverzustand bestätigt |
19
+ | EMS-Scheduler-Liveness | 4 s | Schedulerprozess lebt unabhängig vom vollständigen Regelzyklus |
20
+ | EMS-Regelzyklus | Watchdog 30 s, konfigurierbar | laufend, aktuell oder tatsächlich festhängend |
21
+ | Diagnose-Publisher | 4 s Liveness, 5 s Vollsnapshot | Übersichtspfad lebt; vollständige Diagnose kann separat verzögert sein |
22
+
23
+ ### Normalbetrieb
24
+
25
+ Adapter, Scheduler und Regelzyklus sind aktuell. Die Übersicht bleibt online und wechselt nicht aufgrund eines 20–30 Sekunden laufenden Zyklus auf „veraltet“.
26
+
27
+ ### Verzögerter Regelzyklus
28
+
29
+ Ist der Adapter erreichbar und der Scheduler-Heartbeat frisch, läuft der aktuelle Regelzyklus aber länger als die Watchdoggrenze, erscheint eine Warnung:
30
+
31
+ ```text
32
+ Adapter online – EMS-Regelzyklus überschreitet Zeitlimit
33
+ ```
34
+
35
+ Dies ist ausdrücklich kein Adapter-Offlinezustand.
36
+
37
+ ### Tatsächlicher Offlinefall
38
+
39
+ Meldet der reale HTTP-Server nicht mehr `listening`, wird `info.connection=false` geschrieben. Bei Prozessabbruch enden alle Heartbeats und überschreiten das Frischefenster. Beide Fälle werden weiterhin zuverlässig als offline erkannt. Ein frischer Scheduler- oder alter Summary-Wert darf `info.connection=false` nicht überdecken.
40
+
41
+ ## Last- und Ressourcenverhalten
42
+
43
+ Der vollständige Diagnose-Snapshot bleibt im Fünf-Sekunden-Takt. Der unabhängige Liveness-Timer aktualisiert kleine Health-States alle vier Sekunden. `summaryJson` wird vom Zusatzheartbeat nur dann erneuert, wenn der normale Vollsnapshot bereits länger ausbleibt; dadurch wird die übliche Snapshotlast nicht verdoppelt. Alle Timer werden beim Adapter-Unload explizit beendet.
44
+
45
+ ## Regressionstests
46
+
47
+ Die Stable-Prüfung enthält folgende Szenarien:
48
+
49
+ - 25 Sekunden laufender Regelzyklus, frischer Scheduler, vorherige Zyklusdauer 2608 ms: online, kein Stall, keine Veraltet-Anzeige;
50
+ - 35 Sekunden laufender Regelzyklus bei frischem Scheduler: Warnung `tick-stalled`, aber Adapter online;
51
+ - Scheduler-Heartbeat älter als seine Grenze bei weiterhin verbundenem Adapter: Scheduler-Warnung, nicht Adapter offline;
52
+ - `info.connection=false` trotz frischer anderer Werte: sofortiger echter Offlinezustand;
53
+ - unabhängiger Vier-Sekunden-Heartbeat während eines laufenden vollständigen Diagnosezyklus;
54
+ - korrekter Shutdown aller neuen Timer;
55
+ - Auswahl des neuesten statt des ersten vorhandenen Aktivitätszeitstempels.
56
+
57
+ ## Unveränderte Regelungsfunktionen
58
+
59
+ Der Patch betrifft ausschließlich Statusermittlung, Heartbeats und Diagnosepublikation. Unverändert bleiben insbesondere:
60
+
61
+ - signierter NVP und Netzanschlussgrenzen;
62
+ - Lade- und Lastmanagement;
63
+ - Speicher- und Multi-Use-Regelung;
64
+ - Netzlimit, feste Einspeisebegrenzung und Nulleinspeisung;
65
+ - Export Guard und Single-Writer-Struktur;
66
+ - §14a, Tarife und Prognosen;
67
+ - EZA-/Parkregler-Priorität und deren Fallbacks;
68
+ - sämtliche produktiven Hardware-Writer.
69
+
70
+ ## Feldprüfung nach Update
71
+
72
+ Nach Installation aus einem frischen Ordner ist der Adapter vollständig neu zu starten und der Browser einmal mit `Strg+F5` zu laden. Die EOS-Übersicht sollte mindestens 30 Minuten geöffnet bleiben. Im Normalbetrieb darf sie nicht mehr rhythmisch zwischen online und „Offline / veraltet“ wechseln. Für einen Gegencheck kann die Adapterinstanz kontrolliert gestoppt werden; nach dem Frischefenster muss die Übersicht eindeutig offline anzeigen.
@@ -0,0 +1,88 @@
1
+ # NexoWatt EOS 1.0.3 – offizielle Stable-Version
2
+
3
+ **Veröffentlichungsdatum:** 2026-09-09
4
+ **Status:** Official Stable Patch / produktiver Verkaufsstand
5
+
6
+ ## Zweck des Patches
7
+
8
+ NexoWatt EOS 1.0.3 behebt einen Lizenz-/Authentifizierungsfehler im geschützten AppCenter. Mit einer gültigen Home-Lizenz konnte sich ein Administrator korrekt anmelden und den AppCenter zunächst öffnen. Kurz danach wurde die Seite jedoch erneut gesperrt und der Login-Dialog erschien wieder.
9
+
10
+ Die Admin-Sitzung war dabei weiterhin gültig. Ursache war ein erwartbarer HTTP-403-Status eines nicht in Home enthaltenen Pro-Moduls. Der globale Frontend-Fetch-Handler behandelte bisher jeden 401- oder 403-Status pauschal als Authentifizierungsverlust. Dadurch konnte eine fachliche Lizenzantwort wie `eos_required` die gesamte geschützte Seite verriegeln.
11
+
12
+ ## Korrigierter Authentifizierungsvertrag
13
+
14
+ Nach einer 401-/403-Antwort wird der Auth-Status erneut beim Adapter geprüft. Die Seite wird nur noch gesperrt, wenn mindestens einer dieser Zustände bestätigt wird:
15
+
16
+ - die Sitzung ist tatsächlich nicht mehr angemeldet;
17
+ - die für die aktuelle Seite erforderliche Capability fehlt;
18
+ - der Auth-Status ist nicht erreichbar und kann deshalb nicht sicher bestätigt werden.
19
+
20
+ Ist der Benutzer weiterhin als Admin oder Installer angemeldet und besitzt `appcenter.open`, bleibt der AppCenter geöffnet. Die fachliche API-Antwort wird unverändert an das jeweilige Modul weitergereicht.
21
+
22
+ Damit werden unter anderem folgende fachliche Antworten nicht mehr mit einem Loginverlust verwechselt:
23
+
24
+ - `eos_required`;
25
+ - `license_required`;
26
+ - `readOnly`;
27
+ - `customer_control_disabled`;
28
+ - geräte- oder funktionsbezogene 403-Antworten.
29
+
30
+ ## Home-Lizenz und alte Pro-Konfiguration
31
+
32
+ Beim Wechsel von Pro auf Home können im gespeicherten Projektstand weiterhin Konfigurationen von Pro-Apps vorhanden sein. Diese Daten werden nicht ungefragt gelöscht. Für die an die Home-Oberfläche gelieferte Konfigurationskopie werden Pro-only Apps jedoch mit der bestehenden Lizenznormalisierung auf `installed=false`, `enabled=false` und `licenseBlocked=true` gesetzt.
33
+
34
+ Zusätzlich gelten im Frontend drei Schutzebenen:
35
+
36
+ 1. Mesh/Microgrid, Netzbetreiber-Schnittstelle und Betriebsstrategien werden nur bei gültiger App-Lizenz als installiert bewertet.
37
+ 2. Pro-only Komponenten werden unter Home nicht initialisiert.
38
+ 3. Die Netzbetreiber-Komponente prüft die Edition vor dem Laden des Pro-Treiberverzeichnisses.
39
+
40
+ Dadurch kann ein alter `installed=true`-Wert keine versteckten Pro-API-Aufrufe und keine erneute Login-Sperre mehr auslösen.
41
+
42
+ ## Sicherheitsverhalten bleibt fail-closed
43
+
44
+ Der Patch setzt den AppCenter nicht pauschal auf „frei“. Folgende Fälle sperren weiterhin zuverlässig:
45
+
46
+ - bestätigtes `authed=false`;
47
+ - fehlende Capability `appcenter.open`;
48
+ - nicht erreichbare Auth-Statusprüfung;
49
+ - echter Logout oder abgelaufene Session.
50
+
51
+ Der Hintergrund wird dabei wie bisher inert geschaltet, der Pflichtdialog kann nicht durch Außenklick oder Escape umgangen werden, und die serverseitigen Rollenprüfungen bleiben unverändert.
52
+
53
+ ## Regressionstest
54
+
55
+ Der neue Stable-Test startet den realen AppCenter in Chromium mit:
56
+
57
+ - gültiger Home-Lizenz;
58
+ - angemeldetem Admin und Capability `*`;
59
+ - absichtlich verbliebenen Pro-Flags für Netzbetreiber, Mesh/Microgrid und Betriebsstrategien;
60
+ - einer simulierten fachlichen Antwort `403 eos_required`.
61
+
62
+ Geprüft wird:
63
+
64
+ - Home-Lizenz wird im AppCenter angezeigt;
65
+ - Login-Overlay bleibt geschlossen;
66
+ - Seite und Hintergrund bleiben entsperrt;
67
+ - AppCenter-DOM bleibt vollständig vorhanden;
68
+ - `/api/netoperator/drivers` wird unter Home nicht aufgerufen;
69
+ - eine manuell ausgelöste fachliche 403-Antwort verriegelt die Seite nicht;
70
+ - ein anschließend simulierter echter Sessionverlust mit 401 sperrt die Seite wieder fail-closed;
71
+ - keine Browser-Ausnahmen treten auf.
72
+
73
+ ## Unveränderte Regelungsfunktionen
74
+
75
+ Der Patch betrifft ausschließlich Auth-Fehlerklassifizierung, Lizenzsichtbarkeit und Initialisierung von AppCenter-Komponenten. Unverändert bleiben insbesondere:
76
+
77
+ - NVP- und Netzanschlussregelung;
78
+ - Lade- und Lastmanagement;
79
+ - Speicher- und Speicherfarmregelung;
80
+ - Netzlimit, feste Einspeisebegrenzung und Nulleinspeisung;
81
+ - §14a, Tarife und Prognosen;
82
+ - Export Guard und Single-Writer-Struktur;
83
+ - EZA-/Parkregler-Priorität;
84
+ - sämtliche produktiven Hardware-Writer.
85
+
86
+ ## Aktualisierung
87
+
88
+ Die Version aus einem neuen, leeren Ordner installieren, den Adapter vollständig neu starten und den Browser einmal mit `Strg+F5` neu laden. Der Service-Worker-Cache wurde auf `nexowatt-cache-v503` angehoben. Danach die Home-Lizenz aktivieren, als Admin anmelden und den AppCenter mehrfach öffnen. Er muss nach erfolgreicher Anmeldung dauerhaft geöffnet bleiben. Ein echter Logout muss die Seite anschließend wieder sperren.
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:39e9a577a619aebd1cda1e43ddb58f9cc7d647d71b568b8e6a06e04f272c0543
5
+ * Quell-Hash: sha256:d8f7bab38ff19e7fa52d306e498c09f5fbe229bf47f12bb425c7e2ba8c5c8951
6
6
  * Erzeugung: npm run sync:ts-runtime-executables
7
7
  *
8
8
  * Zweck:
@@ -107,6 +107,13 @@ class EmsEngine {
107
107
  this.mm = null;
108
108
  this._timer = null;
109
109
  this._intervalMs = 1000;
110
+ // Independent scheduler liveness. It is deliberately separate from the
111
+ // complete EMS tick, because a legitimate long-running module must not make
112
+ // EOS Admin classify the whole adapter as offline.
113
+ this._schedulerHeartbeatTimer = null;
114
+ this._schedulerHeartbeatRunning = false;
115
+ this._schedulerHeartbeatIntervalMs = 4000;
116
+ this._schedulerHeartbeatSequence = 0;
110
117
  // Reaktionspfad für Bedienänderungen: Ein Moduswechsel im Kundenfrontend
111
118
  // soll nicht bis zum nächsten regulären Scheduler-Tick warten. Der kurze
112
119
  // Debounce fasst API-Write und nachfolgenden StateChange zu genau einem
@@ -333,6 +340,42 @@ class EmsEngine {
333
340
  },
334
341
  native: {},
335
342
  });
343
+ await a.setObjectNotExistsAsync('ems.core.schedulerHeartbeatAt', {
344
+ type: 'state',
345
+ common: {
346
+ name: 'Independent EMS scheduler heartbeat (ts)',
347
+ type: 'number',
348
+ role: 'value.time',
349
+ read: true,
350
+ write: false,
351
+ def: 0,
352
+ },
353
+ native: {},
354
+ });
355
+ await a.setObjectNotExistsAsync('ems.core.schedulerHeartbeatSequence', {
356
+ type: 'state',
357
+ common: {
358
+ name: 'Independent EMS scheduler heartbeat sequence',
359
+ type: 'number',
360
+ role: 'value',
361
+ read: true,
362
+ write: false,
363
+ def: 0,
364
+ },
365
+ native: {},
366
+ });
367
+ await a.setObjectNotExistsAsync('ems.core.schedulerAlive', {
368
+ type: 'state',
369
+ common: {
370
+ name: 'EMS scheduler process alive',
371
+ type: 'boolean',
372
+ role: 'indicator.connected',
373
+ read: true,
374
+ write: false,
375
+ def: false,
376
+ },
377
+ native: {},
378
+ });
336
379
  await a.setObjectNotExistsAsync('ems.core.tickSkipCount', {
337
380
  type: 'state',
338
381
  common: {
@@ -987,6 +1030,55 @@ class EmsEngine {
987
1030
  catch (_e) { }
988
1031
  return { anyControl, chargingCfg, stationGroups, stationGroupMap };
989
1032
  }
1033
+ /**
1034
+ * Publishes scheduler liveness independently from a full EMS control cycle.
1035
+ * The local process object is updated even if a previous ioBroker state write
1036
+ * is delayed, so the co-located Admin overview can still distinguish a live
1037
+ * scheduler from a stalled regulation tick.
1038
+ */
1039
+ async _publishSchedulerHeartbeat(reason = 'timer') {
1040
+ if (!this.adapter || this.adapter._nwShuttingDown)
1041
+ return;
1042
+ const now = Date.now();
1043
+ const configuredStaleMs = clampNumber(this.adapter?.config?.diagnostics?.emsTickStaleAfterMs, 15000, 300000, this._tickStaleAfterMs);
1044
+ const activeTickAgeMs = this._tickRunning && this._lastTickStartMs > 0
1045
+ ? Math.max(0, now - this._lastTickStartMs)
1046
+ : 0;
1047
+ const tickStalled = this._tickRunning && activeTickAgeMs > configuredStaleMs;
1048
+ this._schedulerHeartbeatSequence += 1;
1049
+ this.adapter._nwEmsSchedulerHealth = {
1050
+ heartbeatAt: now,
1051
+ sequence: this._schedulerHeartbeatSequence,
1052
+ reason: String(reason || 'timer'),
1053
+ tickRunning: this._tickRunning === true,
1054
+ activeTickAgeMs,
1055
+ tickStalled,
1056
+ tickStaleAfterMs: configuredStaleMs,
1057
+ lastTickStartMs: this._lastTickStartMs,
1058
+ lastTickEndMs: this._lastTickEndMs,
1059
+ };
1060
+ if (this._schedulerHeartbeatRunning)
1061
+ return;
1062
+ this._schedulerHeartbeatRunning = true;
1063
+ try {
1064
+ await Promise.allSettled([
1065
+ this.adapter.setStateAsync('ems.core.schedulerHeartbeatAt', { val: now, ack: true }),
1066
+ this.adapter.setStateAsync('ems.core.schedulerHeartbeatSequence', { val: Math.round(this._schedulerHeartbeatSequence), ack: true }),
1067
+ this.adapter.setStateAsync('ems.core.schedulerAlive', { val: true, ack: true }),
1068
+ ]);
1069
+ }
1070
+ finally {
1071
+ this._schedulerHeartbeatRunning = false;
1072
+ }
1073
+ }
1074
+ _startSchedulerHeartbeat() {
1075
+ if (!this.adapter || this.adapter._nwShuttingDown || this._schedulerHeartbeatTimer)
1076
+ return;
1077
+ this._publishSchedulerHeartbeat('startup').catch(() => { });
1078
+ this._schedulerHeartbeatTimer = this._setInterval(() => {
1079
+ this._publishSchedulerHeartbeat('timer').catch(() => { });
1080
+ }, this._schedulerHeartbeatIntervalMs);
1081
+ }
990
1082
  /**
991
1083
  * Code-Teil: Methode `init`
992
1084
  * Zweck: initialisiert UI/Modul, bindet Events oder bereitet Startzustände vor.
@@ -1002,6 +1094,7 @@ class EmsEngine {
1002
1094
  async init() {
1003
1095
  const adapter = this.adapter;
1004
1096
  await this._ensureInternalStates();
1097
+ this._startSchedulerHeartbeat();
1005
1098
  // Scheduler interval from config (Admin UI / jsonConfig)
1006
1099
  const cfgInterval = adapter.config && adapter.config.schedulerIntervalMs;
1007
1100
  // Aktor- und Speicher-Watchdogs muessen spaetestens sekündlich erneuert werden.
@@ -1238,6 +1331,7 @@ class EmsEngine {
1238
1331
  this._activeTickId = tickId;
1239
1332
  const tickStart = Date.now();
1240
1333
  this._lastTickStartMs = tickStart;
1334
+ this._publishSchedulerHeartbeat('tick-start').catch(() => { });
1241
1335
  try {
1242
1336
  try {
1243
1337
  await this.adapter.setStateAsync('ems.core.tickRunning', { val: true, ack: true });
@@ -1366,6 +1460,7 @@ class EmsEngine {
1366
1460
  }
1367
1461
  const dur = Date.now() - tickStart;
1368
1462
  this._lastTickEndMs = Date.now();
1463
+ this._publishSchedulerHeartbeat('tick-end').catch(() => { });
1369
1464
  try {
1370
1465
  if (ownsTickLock)
1371
1466
  await this.adapter.setStateAsync('ems.core.tickRunning', { val: false, ack: true });
@@ -1397,6 +1492,20 @@ class EmsEngine {
1397
1492
  * TypeScript: Parameter, Rückgabewert und verwendete Config-/State-Objekte später explizit typisieren.
1398
1493
  */
1399
1494
  stop() {
1495
+ if (this._schedulerHeartbeatTimer) {
1496
+ this._clearInterval(this._schedulerHeartbeatTimer);
1497
+ this._schedulerHeartbeatTimer = null;
1498
+ }
1499
+ this._schedulerHeartbeatRunning = false;
1500
+ try {
1501
+ this.adapter._nwEmsSchedulerHealth = {
1502
+ ...(this.adapter._nwEmsSchedulerHealth || {}),
1503
+ heartbeatAt: Date.now(),
1504
+ alive: false,
1505
+ reason: 'stopped',
1506
+ };
1507
+ }
1508
+ catch (_error) { }
1400
1509
  if (this._timer) {
1401
1510
  this._clearInterval(this._timer);
1402
1511
  this._timer = null;