iobroker.sigenergy 3.3.0 → 3.3.1

package/README.md

@@ -255,6 +255,10 @@ Status and power readings for the DC charger.
 
 ## Changelog
 
+### 3.3.1 (2026-09-07)
+- (ssbingo) fix: registers the device marks as not valid are no longer turned into plausible looking measurements. The protocol signals this by setting all bits ("Range:[0, 0xFFFFFFFE]. With value 0xFFFFFFFF, register is not valid.") and a device answers that way for a register that does not currently apply or that its firmware does not implement. The raw sentinel was scaled by the register gain, so it arrived as a reading that looks real: observed on a SigenStor EC 10.0 TP **with** a DC charger installed, `dcCharger.runningState` = 65535 (Appendix 14 only defines 0x00-0x0A), `dcCharger.dischargingCurrent` = 6553.5 A, `dcCharger.currentDischargingCapacity` = 42949672.95 kWh and `dcCharger.currentDischargingDuration` = 4294967295 s, while the neighbouring DC charger registers (rated power, PV generation, totals) returned real values. The same pattern appears outside the DC charger, e.g. `plant.currentCtrlCmdValue` = 655.35 %, `plant.mergedAlarm7` = 65535, `inverter.essMaxBatteryCellVoltage` = 65.535 V and the ESS/PCS/grid limit registers as 4294967.295 kW. Such registers now report no value instead
+- (ssbingo) fix: a register that reports no value no longer feeds the statistics calculation, which keeps the last known good reading instead
+
 ### 3.3.0 (2026-09-07)
 - (ssbingo) fix: when the device rejects a grouped register read with a Modbus exception, the registers of that group are now read one by one and only the register(s) the device does not implement are excluded from further polling. Previously a single unsupported register silently disabled its whole group for the rest of the adapter runtime, e.g. `dcCharger.runningState` (31513) never received a value when the discharging registers 31514–31518 of the same group were rejected
 - (ssbingo) feat: new state `info.protocolVersion` (number, e.g. `2.9`) next to the textual `info.protocolLevel`, so widgets and scripts can adapt to the detected protocol version without parsing strings

package/io-package.json

@@ -1,8 +1,21 @@
 {
     "common": {
         "name": "sigenergy",
-        "version": "3.3.0",
+        "version": "3.3.1",
         "news": {
+            "3.3.1": {
+                "en": "(ssbingo) fix: registers the device marks as not valid (all bits set, 0xFFFF / 0xFFFFFFFF) are no longer scaled by the register gain into plausible looking measurements — observed as a 6553.5 A discharging current, 42949672.95 kWh and an out-of-range running state 65535 on the DC charger, and as 655.35 % or 65.535 V elsewhere. Such registers now report no value",
+                "de": "(ssbingo) fix: Register, die das Gerät als ungültig kennzeichnet (alle Bits gesetzt, 0xFFFF / 0xFFFFFFFF), werden nicht mehr über den Gain in plausibel aussehende Messwerte umgerechnet — sichtbar als 6553,5 A Entladestrom, 42949672,95 kWh und Betriebszustand 65535 beim DC-Charger sowie als 655,35 % oder 65,535 V an anderer Stelle. Solche Register liefern jetzt keinen Wert",
+                "ru": "(ssbingo) fix: регистры, помеченные устройством как недействительные (все биты установлены, 0xFFFF / 0xFFFFFFFF), больше не пересчитываются через коэффициент в правдоподобные значения — это проявлялось как ток разряда 6553,5 A, 42949672,95 кВт·ч и состояние 65535 у DC-зарядки, а также как 655,35 % или 65,535 В в других местах. Теперь такие регистры не возвращают значения",
+                "pt": "(ssbingo) fix: os registos que o dispositivo marca como inválidos (todos os bits a 1, 0xFFFF / 0xFFFFFFFF) deixam de ser convertidos pelo ganho em medições aparentemente plausíveis — surgiam como 6553,5 A de corrente de descarga, 42949672,95 kWh e o estado 65535 no carregador DC, e como 655,35 % ou 65,535 V noutros pontos. Esses registos passam a não devolver valor",
+                "nl": "(ssbingo) fix: registers die het apparaat als ongeldig markeert (alle bits gezet, 0xFFFF / 0xFFFFFFFF) worden niet langer via de gain omgerekend naar plausibel ogende metingen — zichtbaar als 6553,5 A ontlaadstroom, 42949672,95 kWh en status 65535 bij de DC-lader, en als 655,35 % of 65,535 V elders. Zulke registers geven nu geen waarde meer",
+                "fr": "(ssbingo) fix : les registres que l'appareil marque comme non valides (tous les bits à 1, 0xFFFF / 0xFFFFFFFF) ne sont plus convertis par le gain en mesures d'apparence plausible — cela apparaissait comme un courant de décharge de 6553,5 A, 42949672,95 kWh et l'état 65535 sur le chargeur DC, et comme 655,35 % ou 65,535 V ailleurs. Ces registres ne renvoient plus de valeur",
+                "it": "(ssbingo) fix: i registri che il dispositivo segnala come non validi (tutti i bit a 1, 0xFFFF / 0xFFFFFFFF) non vengono più convertiti dal gain in misure apparentemente plausibili — comparivano come corrente di scarica di 6553,5 A, 42949672,95 kWh e stato 65535 sul caricatore DC, e come 655,35 % o 65,535 V altrove. Tali registri ora non restituiscono alcun valore",
+                "es": "(ssbingo) fix: los registros que el dispositivo marca como no válidos (todos los bits a 1, 0xFFFF / 0xFFFFFFFF) ya no se convierten mediante la ganancia en mediciones de apariencia plausible — aparecían como una corriente de descarga de 6553,5 A, 42949672,95 kWh y el estado 65535 en el cargador DC, y como 655,35 % o 65,535 V en otros puntos. Esos registros ya no devuelven valor",
+                "pl": "(ssbingo) fix: rejestry oznaczone przez urządzenie jako nieprawidłowe (wszystkie bity ustawione, 0xFFFF / 0xFFFFFFFF) nie są już przeliczane przez wzmocnienie na wiarygodnie wyglądające pomiary — objawiało się to prądem rozładowania 6553,5 A, 42949672,95 kWh i stanem 65535 na ładowarce DC oraz 655,35 % lub 65,535 V w innych miejscach. Takie rejestry nie zwracają teraz wartości",
+                "uk": "(ssbingo) fix: регістри, позначені пристроєм як недійсні (усі біти встановлено, 0xFFFF / 0xFFFFFFFF), більше не перетворюються через коефіцієнт на правдоподібні вимірювання — це виглядало як струм розряду 6553,5 A, 42949672,95 кВт·год і стан 65535 на DC-зарядці та як 655,35 % або 65,535 В в інших місцях. Тепер такі регістри не повертають значення",
+                "zh-cn": "(ssbingo) fix: 设备标记为无效的寄存器（全部位为 1，0xFFFF / 0xFFFFFFFF）不再经增益换算成看似合理的测量值——此前表现为直流充电桩的 6553.5 A 放电电流、42949672.95 kWh 和超出范围的运行状态 65535，以及其他位置的 655.35 % 或 65.535 V。此类寄存器现在不再返回数值"
+            },
             "3.3.0": {
                 "en": "(ssbingo) feat: registers are gated by the detected Modbus protocol version, so a device is no longer asked for registers its firmware does not know; rejected register groups are now retried register by register, so one unsupported register no longer silences its whole group; new state info.protocolVersion",
                 "de": "(ssbingo) feat: Register werden anhand der erkannten Modbus-Protokollversion gefiltert, damit ein Gerät nicht mehr nach Registern gefragt wird, die seine Firmware nicht kennt; abgelehnte Registergruppen werden jetzt einzeln nachgelesen, sodass ein nicht unterstütztes Register nicht mehr die ganze Gruppe stilllegt; neuer State info.protocolVersion",

package/lib/modbus.js

@@ -269,13 +269,38 @@ class ModbusConnection {
         }
     }
 
+    /**
+     * Values the protocol uses to mark an unsigned register as "not valid",
+     * i.e. all bits set. The V2.9 document spells this out for the power
+     * limitation registers ("Range:[0, 0xFFFFFFFE]. With value 0xFFFFFFFF,
+     * register is not valid.") and devices apply the same convention to
+     * registers they do not implement — e.g. a SigenStor without a DC charger
+     * answers 0xFFFF for [DC Charger] running state 31513.
+     *
+     * Only the unsigned types are listed. The document does not define a
+     * sentinel for the signed types, and 0x7FFF / 0x7FFFFFFF are legal
+     * measurements there, so those must not be filtered.
+     */
+    static get INVALID_RAW() {
+        return {
+            U16: 0xffff,
+            U32: 0xffffffff,
+            U64: 18446744073709552000, // 2^64 - 1, as close as a double gets
+        };
+    }
+
     /**
      * Parse raw register data into a typed value
      *
+     * Returns null when the device marked the register as not valid (see
+     * INVALID_RAW). Without this, the sentinel is scaled by the gain and ends
+     * up as a plausible looking measurement — 0xFFFF with gain 10 becomes
+     * "6553.5 A", 0xFFFFFFFF with gain 1000 becomes "4294967.295 kW".
+     *
      * @param {number[]} rawData - Raw register data
      * @param {string} type - Data type (U16, S16, U32, S32, U64, STRING)
      * @param {number|null} gain - Scaling factor
-     * @returns {number|string|null} Decoded value
+     * @returns {number|string|null} Decoded value, or null if the register is not valid
      */
     static parseValue(rawData, type, gain) {
         let raw;
@@ -327,6 +352,11 @@ class ModbusConnection {
                 raw = rawData[0];
         }
 
+        const invalid = ModbusConnection.INVALID_RAW[type];
+        if (invalid !== undefined && raw === invalid) {
+            return null;
+        }
+
         if (gain && gain !== 1 && gain !== null) {
             return raw / gain;
         }

package/main.js

@@ -991,9 +991,16 @@ class Sigenergy extends utils.Adapter {
             'inverter.pv3Voltage': 'pv3Voltage',
             'inverter.pv3Current': 'pv3Current',
         };
-        if (map[name] !== undefined) {
-            this._currentData[map[name]] = value;
+        if (map[name] === undefined) {
+            return;
+        }
+        // A null value means the device marked the register as not valid
+        // (see ModbusConnection.INVALID_RAW). Keep the last known good value
+        // instead, so the statistics are not poisoned by a single bad poll.
+        if (value === null) {
+            return;
         }
+        this._currentData[map[name]] = value;
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.sigenergy",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "ioBroker adapter for Sigenergy solar energy systems via Modbus TCP/RTU",
   "author": {
     "name": "ssbingo",