iobroker.sigenergy 2.2.3 → 2.2.4

package/README.md

@@ -153,6 +153,9 @@ Status and power readings for the DC charger.
 
 ## Changelog
 
+### 2.2.4 (2026-06-10)
+- (ssbingo) fix: implement ESS Preheating TOU polling (FC03, 50000–50183, 94 registers) and write-back via onStateChange; add encodeValue to ModbusConnection
+
 ### 2.2.3 (2026-06-10)
 - (ssbingo) fix: add 25 missing admin i18n keys for PSS, PID, ESS Preheating, Extended Registers across all 11 languages
 

package/io-package.json

@@ -1,20 +1,20 @@
 {
     "common": {
         "name": "sigenergy",
-        "version": "2.2.3",
+        "version": "2.2.4",
         "news": {
-            "2.2.3": {
-                "en": "(ssbingo) fix: add 25 missing admin i18n keys for PSS, PID, ESS Preheating, Extended Registers, Smart Loads, Grid Code across all 11 languages",
-                "de": "(ssbingo) fix: 25 fehlende Admin-i18n-Schlüssel für PSS, PID, ESS-Vorheizung, Erweiterte Register, Smart Loads, Netzcode in allen 11 Sprachen ergänzt",
-                "ru": "(ssbingo) fix: добавлены 25 отсутствующих ключей i18n для PSS, PID, предварительного нагрева ESS, расширенных регистров, умных нагрузок, кода сети во всех 11 языках",
-                "pt": "(ssbingo) fix: adicionadas 25 chaves i18n em falta para PSS, PID, pré-aquecimento ESS, registos alargados, cargas inteligentes, código de rede em todos os 11 idiomas",
-                "nl": "(ssbingo) fix: 25 ontbrekende i18n-sleutels toegevoegd voor PSS, PID, ESS-voorverwarming, uitgebreide registers, slimme verbruikers, netcodes in alle 11 talen",
-                "fr": "(ssbingo) fix: ajout de 25 clés i18n manquantes pour PSS, PID, préchauffage ESS, registres étendus, charges intelligentes, code réseau dans les 11 langues",
-                "it": "(ssbingo) fix: aggiunte 25 chiavi i18n mancanti per PSS, PID, preriscaldamento ESS, registri estesi, carichi intelligenti, codice rete in tutte le 11 lingue",
-                "es": "(ssbingo) fix: añadidas 25 claves i18n faltantes para PSS, PID, precalentamiento ESS, registros extendidos, cargas inteligentes, código de red en los 11 idiomas",
-                "pl": "(ssbingo) fix: dodano 25 brakujących kluczy i18n dla PSS, PID, podgrzewania ESS, rejestrów rozszerzonych, inteligentnych obciążeń, kodu sieci we wszystkich 11 językach",
-                "uk": "(ssbingo) fix: додано 25 відсутніх ключів i18n для PSS, PID, нагрівання ESS, розширених регістрів, розумних навантажень, коду мережі у всіх 11 мовах",
-                "zh-cn": "(ssbingo) fix: 为 PSS、PID、ESS 预热、扩展寄存器、智能负载、电网规格在所有 11 种语言中添加 25 个缺失的 i18n 键"
+            "2.2.4": {
+                "en": "(ssbingo) fix: implement ESS Preheating TOU read (FC03 registers 50000–50183) and write-back; 94 states with read+write; subscribe to state changes",
+                "de": "(ssbingo) fix: ESS-Vorheizung TOU-Lesen (FC03 Register 50000–50183) und Rückschreiben implementiert; 94 States mit read+write; Zustandsänderungen werden abonniert",
+                "ru": "(ssbingo) fix: реализовано чтение TOU предварительного нагрева ESS (FC03 регистры 50000–50183) и запись; 94 состояния read+write",
+                "pt": "(ssbingo) fix: implementada leitura TOU de pré-aquecimento ESS (FC03 registos 50000–50183) e escrita; 94 estados read+write",
+                "nl": "(ssbingo) fix: ESS-voorverwarming TOU lezen (FC03 registers 50000–50183) en terugschrijven geïmplementeerd; 94 states read+write",
+                "fr": "(ssbingo) fix: lecture TOU préchauffage ESS (FC03 registres 50000–50183) et écriture implémentées; 94 états read+write",
+                "it": "(ssbingo) fix: implementata lettura TOU preriscaldamento ESS (FC03 registri 50000–50183) e scrittura; 94 stati read+write",
+                "es": "(ssbingo) fix: implementada lectura TOU precalentamiento ESS (FC03 registros 50000–50183) y escritura; 94 estados read+write",
+                "pl": "(ssbingo) fix: zaimplementowano odczyt TOU podgrzewania ESS (FC03 rejestry 50000–50183) i zapis; 94 stany read+write",
+                "uk": "(ssbingo) fix: реалізовано читання TOU попереднього нагрівання ESS (FC03 регістри 50000–50183) та запис; 94 стани read+write",
+                "zh-cn": "(ssbingo) fix: 实现 ESS 预热 TOU 读取（FC03 寄存器 50000–50183）和写回；94 个 read+write 状态"
             }
         },
         "titleLang": {

package/lib/modbus.js

@@ -244,6 +244,26 @@ class ModbusConnection {
      * @param {number|null} gain - Scaling factor
      * @returns {number|string} Decoded value
      */
+    static encodeValue(value, type, gain) {
+        const raw = gain && gain !== 1 ? Math.round(value * gain) : Math.round(value);
+        switch (type) {
+            case 'U16':
+                return [raw & 0xffff];
+            case 'S16':
+                return [raw < 0 ? (raw + 65536) & 0xffff : raw & 0xffff];
+            case 'U32': {
+                const u = raw >>> 0;
+                return [(u >>> 16) & 0xffff, u & 0xffff];
+            }
+            case 'S32': {
+                const u32 = (raw < 0 ? raw + 4294967296 : raw) >>> 0;
+                return [(u32 >>> 16) & 0xffff, u32 & 0xffff];
+            }
+            default:
+                return [raw & 0xffff];
+        }
+    }
+
     static parseValue(rawData, type, gain) {
         let raw;
 

package/main.js

@@ -16,6 +16,7 @@ const {
     AC_CHARGER_READ_REGISTERS,
     PSS_READ_REGISTERS,
     PID_READ_REGISTERS,
+    ESS_PREHEATING_WRITE_REGISTERS,
 } = require('./lib/registers');
 const SigenMicroScanner = require('./lib/scanner');
 const { getRegistersForDevice } = require('./lib/sigenMicroRegisters');
@@ -43,6 +44,7 @@ class Sigenergy extends utils.Adapter {
         this._stopped = false;
 
         this.on('ready', this.onReady.bind(this));
+        this.on('stateChange', this.onStateChange.bind(this));
         this.on('message', this.onMessage.bind(this));
         this.on('unload', this.onUnload.bind(this));
     }
@@ -263,6 +265,12 @@ class Sigenergy extends utils.Adapter {
                     return;
                 }
             }
+            if (this.config.enableEssPreheating) {
+                await this._readEssPreheating();
+                if (this._stopped) {
+                    return;
+                }
+            }
 
             await this._updateStatistics();
             await this._updatePvStringPowers();
@@ -433,6 +441,27 @@ class Sigenergy extends utils.Adapter {
         }
     }
 
+    async _readEssPreheating() {
+        const plantId = this.config.plantId || 247;
+        const batchSize = 50;
+        const groups = this._buildReadGroups(ESS_PREHEATING_WRITE_REGISTERS, batchSize);
+        this.log.debug(`Reading ESS Preheating (slaveId=${plantId}): ${groups.length} group(s)`);
+
+        for (const group of groups) {
+            if (this._stopped) {
+                return;
+            }
+            try {
+                this.log.debug(`[essPreheating] FC03 addr=${group.startAddr} qty=${group.totalQty}`);
+                const raw = await this.modbus.readHoldingRegisters(plantId, group.startAddr, group.totalQty);
+                await this._processReadGroup(group, raw, 'essPreheating');
+                await this._sleep(100);
+            } catch (err) {
+                this.log.warn(`ESS Preheating read error at ${group.startAddr}: ${err.message}`);
+            }
+        }
+    }
+
     /**
      * Read all active SigenMicro devices
      */
@@ -754,6 +783,21 @@ class Sigenergy extends utils.Adapter {
                 for (let n = 1; n <= 30; n++) {
                     await this._createChannel(`plant.essPreheating.tou${n}`, `TOU Window ${n}`);
                 }
+                for (const reg of ESS_PREHEATING_WRITE_REGISTERS) {
+                    await this.setObjectNotExistsAsync(reg.name, {
+                        type: 'state',
+                        common: {
+                            name: reg.desc,
+                            type: 'number',
+                            role: 'value',
+                            unit: reg.unit || '',
+                            read: true,
+                            write: true,
+                        },
+                        native: { addr: reg.addr, qty: reg.qty, dataType: reg.type, gain: reg.gain },
+                    });
+                }
+                this.subscribeStates('plant.essPreheating.*');
             }
 
             await this._createStatisticsStates();
@@ -928,7 +972,38 @@ class Sigenergy extends utils.Adapter {
     /**
      * Handle messages from admin (connection test, etc.)
      *
-     * @param {object} obj - Message object
+     * @param {ioBroker.Object} obj - Message object
+     */
+    async onStateChange(id, state) {
+        if (!state || state.ack) {
+            return;
+        }
+        // Strip namespace prefix (e.g. "sigenergy.0.")
+        const localId = id.replace(/^[^.]+\.\d+\./, '');
+        if (!localId.startsWith('plant.essPreheating.')) {
+            return;
+        }
+        const reg = ESS_PREHEATING_WRITE_REGISTERS.find(r => r.name === localId);
+        if (!reg) {
+            return;
+        }
+        const plantId = this.config.plantId || 247;
+        const raw = ModbusConnection.encodeValue(state.val, reg.type, reg.gain);
+        try {
+            if (raw.length === 1) {
+                await this.modbus.writeSingleRegister(plantId, reg.addr, raw[0]);
+            } else {
+                await this.modbus.writeMultipleRegisters(plantId, reg.addr, raw);
+            }
+            await this.setStateAsync(id, { val: state.val, ack: true });
+            this.log.debug(`[essPreheating] wrote ${localId} = ${state.val} → addr ${reg.addr}`);
+        } catch (err) {
+            this.log.error(`ESS Preheating write error for ${localId}: ${err.message}`);
+        }
+    }
+
+    /**
+     * @param {ioBroker.Object} obj - Message object
      */
     async onMessage(obj) {
         if (!obj || !obj.command) {

package/package.json

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