iobroker.sigenergy 3.1.2 → 3.2.0

package/README.md

@@ -49,7 +49,7 @@ Supports the Sigenergy Modbus Protocol V2.9 (released 2026-05-13).
 | Component | Minimum version |
 |-----------|-----------------|
 | **js-controller** | >= 6.0.11 |
-| **admin** | >= 8.0.0 |
+| **admin** | >= 7.8.23 |
 | **Node.js** | >= 22 |
 
 ---
@@ -255,6 +255,15 @@ Status and power readings for the DC charger.
 
 ## Changelog
 
+### 3.2.0 (2026-09-04)
+- (MMeinhardt1) feat: new state `statistics.emsWorkMode` exposing the EMS work mode as plain text, so consumers do not need the `common.states` lookup table
+- (MMeinhardt1) feat: added EMS work mode 6 (Virtual Power Plant) to the register description and the mode map
+- (MMeinhardt1) change: the `*HM` duration states now hold a bare `H:MM` value with unit `h`, instead of embedding an `h` suffix in the value itself
+- (MMeinhardt1) fix: statistics objects are created with `extendObjectAsync`, so corrected units and roles reach installations where the object already exists
+- (ssbingo) chore: admin minimum requirement lowered back to >= 7.8.23 to keep serving admin 7.x installations
+- (ssbingo) fix: restored the JSDoc parameter descriptions on `_formatMinutesAsHM` to keep `npm run lint` warning-free
+- (ssbingo) chore: repository checker findings — track `.vscode/settings.json` deliberately, bump `@alcalzone/release-script-plugin-license` to 5.2.2, pin `testing-action-deploy` to the major version again
+
 ### 3.1.2 (2026-08-06)
 - (ssbingo) chore: resolved all 28 npm audit findings (3 critical, 11 high) — development tooling only, the published adapter is unchanged
 - (ssbingo) chore: removed `@iobroker/dev-server`; it was the sole source of the critical findings via the deprecated `request` and `xmldom` packages, for which no fixed release exists. This also removes the `npm start` / `npm run watch` scripts

package/io-package.json

@@ -1,8 +1,21 @@
 {
     "common": {
         "name": "sigenergy",
-        "version": "3.1.2",
+        "version": "3.2.0",
         "news": {
+            "3.2.0": {
+                "en": "(MMeinhardt1) feat: EMS work mode as plain text, Virtual Power Plant mode, h:mm values now carry unit 'h' instead of a suffix; statistics objects are updated on every start. (ssbingo) chore: admin requirement lowered back to >=7.8.23",
+                "de": "(MMeinhardt1) feat: EMS-Betriebsmodus als Klartext, Modus Virtual Power Plant, h:mm-Werte tragen jetzt die Einheit 'h' statt eines Suffix; Statistik-Objekte werden bei jedem Start aktualisiert. (ssbingo) chore: admin-Anforderung zurück auf >=7.8.23",
+                "ru": "(MMeinhardt1) feat: режим работы EMS в виде текста, режим Virtual Power Plant, значения h:mm теперь имеют единицу 'h' вместо суффикса; объекты статистики обновляются при каждом запуске. (ssbingo) chore: требование к admin снижено до >=7.8.23",
+                "pt": "(MMeinhardt1) feat: modo de trabalho EMS como texto, modo Virtual Power Plant, valores h:mm passam a ter a unidade 'h' em vez de sufixo; os objetos de estatística são atualizados em cada arranque. (ssbingo) chore: requisito do admin reduzido para >=7.8.23",
+                "nl": "(MMeinhardt1) feat: EMS-werkmodus als tekst, modus Virtual Power Plant, h:mm-waarden krijgen nu eenheid 'h' in plaats van een achtervoegsel; statistiekobjecten worden bij elke start bijgewerkt. (ssbingo) chore: admin-vereiste terug naar >=7.8.23",
+                "fr": "(MMeinhardt1) feat : mode de fonctionnement EMS en texte clair, mode Virtual Power Plant, les valeurs h:mm portent désormais l'unité « h » au lieu d'un suffixe ; les objets de statistiques sont mis à jour à chaque démarrage. (ssbingo) chore : exigence admin ramenée à >=7.8.23",
+                "it": "(MMeinhardt1) feat: modalità di lavoro EMS come testo, modalità Virtual Power Plant, i valori h:mm ora hanno l'unità 'h' invece di un suffisso; gli oggetti statistici vengono aggiornati a ogni avvio. (ssbingo) chore: requisito admin riportato a >=7.8.23",
+                "es": "(MMeinhardt1) feat: modo de trabajo EMS como texto, modo Virtual Power Plant, los valores h:mm llevan ahora la unidad 'h' en lugar de un sufijo; los objetos de estadísticas se actualizan en cada arranque. (ssbingo) chore: requisito de admin reducido a >=7.8.23",
+                "pl": "(MMeinhardt1) feat: tryb pracy EMS jako tekst, tryb Virtual Power Plant, wartości h:mm mają teraz jednostkę 'h' zamiast sufiksu; obiekty statystyk są aktualizowane przy każdym starcie. (ssbingo) chore: wymaganie admin obniżone do >=7.8.23",
+                "uk": "(MMeinhardt1) feat: режим роботи EMS як текст, режим Virtual Power Plant, значення h:mm тепер мають одиницю 'h' замість суфікса; об'єкти статистики оновлюються при кожному запуску. (ssbingo) chore: вимогу до admin знижено до >=7.8.23",
+                "zh-cn": "(MMeinhardt1) feat: EMS 工作模式以纯文本提供、新增 Virtual Power Plant 模式、h:mm 值改用单位 'h' 而非后缀；统计对象在每次启动时更新。(ssbingo) chore: admin 要求下调回 >=7.8.23"
+            },
             "3.1.2": {
                 "en": "(ssbingo) chore: all npm audit findings resolved (28 -> 0); removed @iobroker/dev-server, which pulled in unpatchable deprecated packages. Development tooling only — the adapter itself is unchanged.",
                 "de": "(ssbingo) chore: alle npm-audit-Findings behoben (28 -> 0); @iobroker/dev-server entfernt, das nicht patchbare veraltete Pakete mitzog. Betrifft nur das Entwicklungs-Tooling — der Adapter selbst ist unverändert.",
@@ -121,7 +134,7 @@
         ],
         "globalDependencies": [
             {
-                "admin": ">=8.0.0"
+                "admin": ">=7.8.23"
             }
         ],
         "licenseInformation": {

package/lib/registers.js

@@ -37,7 +37,7 @@ const PLANT_READ_REGISTERS = [
         gain: null,
         unit: '',
         role: 'value',
-        desc: 'EMS work mode: 0=MaxSelfConsumption,1=AI,2=TOU,5=FullFeedIn,7=RemoteEMS,9=Custom',
+        desc: 'EMS work mode: 0=MaxSelfConsumption,1=AI,2=TOU,5=FullFeedIn,6=VirtualPowerPlant,7=RemoteEMS,9=Custom',
     },
     {
         addr: 30004,
@@ -3313,6 +3313,7 @@ const EMS_WORK_MODES = {
     1: 'AI Mode',
     2: 'TOU',
     5: 'Full Feed-in to Grid',
+    6: 'Virtual Power Plant',
     7: 'Remote EMS',
     9: 'Custom',
 };

package/main.js

@@ -1128,6 +1128,7 @@ class Sigenergy extends utils.Adapter {
             'plant.essSoc': 'soc',
             'plant.essRatedEnergyCapacity': 'ratedCapacity',
             'plant.essDischargeSOC': 'cutoffSoc',
+            'plant.emsWorkMode': 'emsWorkMode',
             'inverter.pv1Voltage': 'pv1Voltage',
             'inverter.pv1Current': 'pv1Current',
             'inverter.pv2Voltage': 'pv2Voltage',
@@ -1141,15 +1142,16 @@ class Sigenergy extends utils.Adapter {
     }
 
     /**
-     * Format a minute value as an "H:MMh" string (e.g. 83 -> "1:23h").
-     * Hours are not capped at 24. Distinguishes three cases so the caller's
-     * null-vs-undefined write semantics (see _updateStatistics) are preserved:
+     * Format a minute value as an "H:MM" string (e.g. 83 -> "1:23").
+     * Hours are not capped at 24.
+     * Distinguishes three cases so the caller's null-vs-undefined write
+     * semantics (see _updateStatistics) are preserved:
      *  - undefined  (statistic disabled via config)          -> undefined (skip write)
      *  - null / NaN (statistic enabled but currently N/A)     -> null (clears stale value)
-     *  - number                                                -> formatted "H:MMh" string
+     *  - number                                                -> formatted "H:MM" string
      *
      * @param {number|null|undefined} totalMinutes - Duration in minutes, or null/undefined per the cases above
-     * @returns {string|null|undefined} Formatted "H:MMh" string, or null/undefined mirroring the input case
+     * @returns {string|null|undefined} Formatted "H:MM" string, or null/undefined mirroring the input case
      */
     _formatMinutesAsHM(totalMinutes) {
         if (totalMinutes === undefined) {
@@ -1162,7 +1164,26 @@ class Sigenergy extends utils.Adapter {
         const abs = Math.round(Math.abs(totalMinutes));
         const hours = Math.floor(abs / 60);
         const minutes = abs % 60;
-        return `${sign}${hours}:${String(minutes).padStart(2, '0')}h`;
+        return `${sign}${hours}:${String(minutes).padStart(2, '0')}`;
+    }
+
+    /**
+     * Look up the plain-text label for the numeric EMS work mode (register
+     * 30003 / plant.emsWorkMode), using the same EMS_WORK_MODES map already
+     * used for the `common.states` metadata on plant.emsWorkMode. Unlike that
+     * metadata (only understood by UIs/tools that render `common.states`),
+     * this writes the human-readable text directly as the state value, so any
+     * consumer (VIS, Node-RED, external scripts) can use it without needing
+     * the lookup table.
+     *
+     * @param {number|undefined} mode - Raw value of plant.emsWorkMode
+     * @returns {string|undefined} Plain-text label, or undefined if mode hasn't been read yet
+     */
+    _formatEmsWorkMode(mode) {
+        if (mode === undefined) {
+            return undefined;
+        }
+        return EMS_WORK_MODES[mode] || `Unknown (${mode})`;
     }
 
     /**
@@ -1193,6 +1214,7 @@ class Sigenergy extends utils.Adapter {
             'statistics.housePower': statsValues.housePower,
             'statistics.currentSoc': statsValues.currentSoc,
             'statistics.currentPvPower': statsValues.currentPvPower,
+            'statistics.emsWorkMode': this._formatEmsWorkMode(this._currentData.emsWorkMode),
             'statistics.dayMaxSoc': statsValues.dayMaxSoc,
             'statistics.dayMinSoc': statsValues.dayMinSoc,
         };
@@ -1674,7 +1696,7 @@ class Sigenergy extends utils.Adapter {
                 id: 'statistics.batteryTimeToFullHM',
                 name: 'Time until battery is fully charged (h:mm)',
                 type: 'string',
-                unit: '',
+                unit: 'h',
                 role: 'text',
             },
             {
@@ -1688,7 +1710,7 @@ class Sigenergy extends utils.Adapter {
                 id: 'statistics.batteryTimeRemainingHM',
                 name: 'Battery time remaining at current load (h:mm)',
                 type: 'string',
-                unit: '',
+                unit: 'h',
                 role: 'text',
             },
             {
@@ -1702,7 +1724,7 @@ class Sigenergy extends utils.Adapter {
                 id: 'statistics.batteryDailyChargeTimeHM',
                 name: 'Today: cumulative time spent charging (h:mm)',
                 type: 'string',
-                unit: '',
+                unit: 'h',
                 role: 'text',
             },
             {
@@ -1716,7 +1738,7 @@ class Sigenergy extends utils.Adapter {
                 id: 'statistics.batteryCoverageTodayHM',
                 name: 'Today: time battery covered consumption (h:mm)',
                 type: 'string',
-                unit: '',
+                unit: 'h',
                 role: 'text',
             },
             {
@@ -1782,6 +1804,13 @@ class Sigenergy extends utils.Adapter {
                 unit: 'kW',
                 role: 'value.power',
             },
+            {
+                id: 'statistics.emsWorkMode',
+                name: 'EMS work mode (plain text)',
+                type: 'string',
+                unit: '',
+                role: 'text',
+            },
             {
                 id: 'statistics.dayMaxSoc',
                 name: 'Today maximum SOC',
@@ -1812,7 +1841,12 @@ class Sigenergy extends utils.Adapter {
                 },
                 native: {},
             };
-            await this.setObjectNotExistsAsync(s.id, statObj);
+            // extendObjectAsync (not setObjectNotExistsAsync) so that changes to
+            // an existing definition (e.g. a corrected unit or role) are applied
+            // on every adapter start, instead of being silently ignored forever
+            // once the object has been created once. The state's current value
+            // is untouched by this — only the object's common metadata is merged.
+            await this.extendObjectAsync(s.id, statObj);
         }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.sigenergy",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "description": "ioBroker adapter for Sigenergy solar energy systems via Modbus TCP/RTU",
   "author": {
     "name": "ssbingo",
@@ -30,12 +30,12 @@
   "devDependencies": {
     "@alcalzone/release-script": "^5.2.1",
     "@alcalzone/release-script-plugin-iobroker": "^5.2.0",
-    "@alcalzone/release-script-plugin-license": "^5.2.0",
+    "@alcalzone/release-script-plugin-license": "^5.2.2",
     "@alcalzone/release-script-plugin-manual-review": "^5.2.0",
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/eslint-config": "^2.3.4",
     "@iobroker/testing": "^5.3.0",
-    "@tsconfig/node22": "^22.0.5",
+    "@tsconfig/node22": "^22.0.6",
     "@types/node": "^22.20.1"
   },
   "main": "main.js",