iobroker.sigenergy 2.2.4 → 2.2.6

package/README.md

@@ -153,6 +153,11 @@ Status and power readings for the DC charger.
 
 ## Changelog
 
+### 2.2.6 (2026-06-10)
+- (ssbingo) feat: V2.9 register audit — add missing register 30279 (current control command value), move DC Charger PV registers 31509/31511 to dcCharger namespace, fix ESS Preheating TOU time gain (null→1)
+- (ssbingo) feat: implement control write-back for plant.control.*, plant.gridCode.*, inverter.control.*, dcCharger.control.* (FC06/FC10); read RW holding registers on startup
+- (ssbingo) fix: suppress repeated ESS Preheating warn after device reports unsupported registers; downgrade control register startup read errors to debug
+
 ### 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
 
@@ -218,31 +223,6 @@ Status and power readings for the DC charger.
 - (ssbingo) feat: added calculated states plant.pv1Power, plant.pv2Power, plant.pv3Power
 
 
-### 1.9.6 (2026-04-16)
-- (ssbingo) feat: added calculated states plant.pv1Power, plant.pv2Power, plant.pv3Power
-
-
-### 1.9.5 (2026-04-08)
-- (ssbingo) fix: removed unused common.schedule from io-package.json
-
-### 1.9.4 (2026-04-08)
-- (ssbingo) fix: Changelog / adding CHANGELOG_OLD.md
-
-### 1.9.3 (2026-04-08)
-- (ssbingo) fix remove admin/index.html
-
-### 1.9.2 (2026-04-08)
-- (ssbingo) fixes
-
-### 1.9.1 (2026-04-08)
-- (ssbingo) Fixed admin UI: removed legacy index.html/index_m.html/words.js; fixed jsonData type in jsonConfig sendTo buttons
-
-### 1.9.0 (2026-03-26)
-- (ssbingo) Test abgeschlossen
-
-### 1.8.23 (2026-03-26)
-- (ssbingo) Fixed copyright year to 2026 in LICENSE and README; technical corrections: CI/CD workflow, linting, tests
-
 ---
 
 [Older changelogs can be found there](CHANGELOG_OLD.md)

package/io-package.json

@@ -1,20 +1,20 @@
 {
     "common": {
         "name": "sigenergy",
-        "version": "2.2.4",
+        "version": "2.2.6",
         "news": {
-            "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 状态"
+            "2.2.6": {
+                "en": "(ssbingo) feat: V2.9 register audit — add register 30279, move DC Charger PV regs 31509/31511 to dcCharger, implement control write-back (FC06/FC10); fix: suppress ESS Preheating log flood; downgrade control startup read errors to debug",
+                "de": "(ssbingo) feat: V2.9 Register-Audit — Register 30279 ergänzt, DC-Charger PV-Register 31509/31511 in dcCharger-Namespace; Steuerungs-Rückschreiben (FC06/FC10); fix: ESS-Vorheizungs-Warn-Flooding unterdrückt; Startup-Lesefehler auf Debug herabgestuft",
+                "ru": "(ssbingo) feat: аудит регистров V2.9 — регистр 30279, PV-регистры DC 31509/31511 в dcCharger, обратная запись управляющих регистров; fix: подавление повторяющихся предупреждений ESS; ошибки чтения при старте понижены до debug",
+                "pt": "(ssbingo) feat: auditoria V2.9 — registo 30279, registos PV DC Charger 31509/31511 para dcCharger, escrita de controlo (FC06/FC10); fix: avisos ESS Preheating suprimidos; erros de leitura ao arranque em debug",
+                "nl": "(ssbingo) feat: V2.9 register-audit — register 30279, PV-registers DC Charger 31509/31511 naar dcCharger, terugschrijven besturingsregisters; fix: ESS-voorverwarmingswaarschuwingen onderdrukt; opstartleesfouten naar debug",
+                "fr": "(ssbingo) feat: audit V2.9 — registre 30279, registres PV DC 31509/31511 vers dcCharger, rétro-écriture contrôle (FC06/FC10) ; fix: avertissements ESS Preheating supprimés ; erreurs lecture démarrage en debug",
+                "it": "(ssbingo) feat: audit V2.9 — registro 30279, registri PV DC 31509/31511 in dcCharger, scrittura controllo (FC06/FC10); fix: avvisi ESS Preheating soppressi; errori lettura avvio in debug",
+                "es": "(ssbingo) feat: auditoría V2.9 — registro 30279, registros PV DC 31509/31511 a dcCharger, escritura control (FC06/FC10); fix: avisos ESS Preheating suprimidos; errores lectura inicio en debug",
+                "pl": "(ssbingo) feat: audyt V2.9 — rejestr 30279, rejestry PV DC 31509/31511 do dcCharger, zapis sterujący (FC06/FC10); fix: ostrzeżenia ESS Preheating wyciszone; błędy odczytu przy starcie w debug",
+                "uk": "(ssbingo) feat: аудит V2.9 — регістр 30279, PV-регістри DC 31509/31511 у dcCharger, зворотний запис керуючих; fix: попередження ESS Preheating придушені; помилки читання при запуску знижені до debug",
+                "zh-cn": "(ssbingo) feat: V2.9 寄存器审计 — 寄存器 30279，DC 充电机 PV 31509/31511 至 dcCharger，控制寄存器回写；fix: 抑制 ESS 预热重复警告；控制启动读取错误降级为 debug"
             }
         },
         "titleLang": {

package/lib/registers.js

@@ -1294,6 +1294,16 @@ const PLANT_READ_REGISTERS = [
         role: 'value.voltage',
         desc: 'Grid code rated voltage (V2.9)',
     },
+    {
+        addr: 30279,
+        qty: 1,
+        name: 'plant.currentCtrlCmdValue',
+        type: 'U16',
+        gain: 100,
+        unit: '%',
+        role: 'value',
+        desc: 'Current control command value (V2.8)',
+    },
     {
         addr: 30280,
         qty: 1,
@@ -2529,27 +2539,6 @@ const INVERTER_READ_REGISTERS = [
         role: 'value',
         desc: 'Power factor adjustment feedback (V2.6)',
     },
-    // V2.6 — separate FC04 group (gap > 4 from 31041)
-    {
-        addr: 31509,
-        qty: 2,
-        name: 'inverter.pvDailyGeneration',
-        type: 'U32',
-        gain: 100,
-        unit: 'kWh',
-        role: 'value.energy',
-        desc: 'PV daily generation (V2.6)',
-    },
-    {
-        addr: 31511,
-        qty: 2,
-        name: 'inverter.pvTotalGeneration',
-        type: 'U32',
-        gain: 100,
-        unit: 'kWh',
-        role: 'value.energy',
-        desc: 'PV total generation (V2.6)',
-    },
 ];
 
 // ============================================================
@@ -2849,7 +2838,28 @@ const DC_CHARGER_READ_REGISTERS = [
         role: 'value.time',
         desc: 'Current charging duration (single session)',
     },
-    // V2.8/V2.9 — separate FC04 group (gap of 5 from 31508)
+    // V2.6 — PV generation (DC Charger only, gap of 1 from 31508)
+    {
+        addr: 31509,
+        qty: 2,
+        name: 'dcCharger.pvDailyGeneration',
+        type: 'U32',
+        gain: 100,
+        unit: 'kWh',
+        role: 'value.energy',
+        desc: '[DC Charger] PV daily generation (V2.6)',
+    },
+    {
+        addr: 31511,
+        qty: 2,
+        name: 'dcCharger.pvTotalGeneration',
+        type: 'U32',
+        gain: 100,
+        unit: 'kWh',
+        role: 'value.energy',
+        desc: '[DC Charger] PV total generation (V2.6)',
+    },
+    // V2.8/V2.9 — separate FC04 group (gap of 1 from 31512)
     {
         addr: 31513,
         qty: 1,
@@ -4559,7 +4569,7 @@ const ESS_PREHEATING_WRITE_REGISTERS = (() => {
             qty: 2,
             name: `plant.essPreheating.tou${n}.startTime`,
             type: 'U32',
-            gain: null,
+            gain: 1,
             unit: 's',
             perm: 'RW',
             desc: `TOU ${n} start time`,
@@ -4569,7 +4579,7 @@ const ESS_PREHEATING_WRITE_REGISTERS = (() => {
             qty: 2,
             name: `plant.essPreheating.tou${n}.endTime`,
             type: 'U32',
-            gain: null,
+            gain: 1,
             unit: 's',
             perm: 'RW',
             desc: `TOU ${n} end time`,

package/main.js

@@ -17,6 +17,9 @@ const {
     PSS_READ_REGISTERS,
     PID_READ_REGISTERS,
     ESS_PREHEATING_WRITE_REGISTERS,
+    PLANT_WRITE_REGISTERS,
+    INVERTER_WRITE_REGISTERS,
+    DC_CHARGER_WRITE_REGISTERS,
 } = require('./lib/registers');
 const SigenMicroScanner = require('./lib/scanner');
 const { getRegistersForDevice } = require('./lib/sigenMicroRegisters');
@@ -42,6 +45,8 @@ class Sigenergy extends utils.Adapter {
         // (modbus reads, scans, setTimeout-chains) can abort gracefully instead of
         // calling setStateAsync on a stopped adapter.
         this._stopped = false;
+        this._controlRegistersRead = false;
+        this._essPreheatingUnsupported = false;
 
         this.on('ready', this.onReady.bind(this));
         this.on('stateChange', this.onStateChange.bind(this));
@@ -224,6 +229,11 @@ class Sigenergy extends utils.Adapter {
         this.log.debug('[poll] cycle started');
 
         try {
+            if (!this._controlRegistersRead) {
+                await this._readControlRegisters();
+                this._controlRegistersRead = true;
+            }
+
             const _t0 = Date.now();
             await this._readPlant();
             if (this._stopped) {
@@ -442,11 +452,18 @@ class Sigenergy extends utils.Adapter {
     }
 
     async _readEssPreheating() {
+        if (this._essPreheatingUnsupported) {
+            this.log.debug(
+                '[essPreheating] Skipping — registers not supported by device (disable in adapter settings)',
+            );
+            return;
+        }
         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)`);
 
+        let failCount = 0;
         for (const group of groups) {
             if (this._stopped) {
                 return;
@@ -457,7 +474,71 @@ class Sigenergy extends utils.Adapter {
                 await this._processReadGroup(group, raw, 'essPreheating');
                 await this._sleep(100);
             } catch (err) {
-                this.log.warn(`ESS Preheating read error at ${group.startAddr}: ${err.message}`);
+                failCount++;
+                this.log.debug(`[essPreheating] read error at ${group.startAddr}: ${err.message}`);
+            }
+        }
+        if (failCount === groups.length && groups.length > 0) {
+            this._essPreheatingUnsupported = true;
+            this.log.warn(
+                'ESS Preheating: all register groups failed (Modbus exception 2 — device does not support these registers). ' +
+                    'Polling disabled for this session. Disable "ESS Preheating" in adapter settings to suppress this message.',
+            );
+        }
+    }
+
+    async _readControlRegisters() {
+        const plantId = this.config.plantId || 247;
+        const inverterId = this.config.inverterId || 1;
+        this.log.debug('[controlRegs] Reading RW holding registers (one-time on startup)');
+
+        const plantRw = PLANT_WRITE_REGISTERS.filter(r => r.perm === 'RW' && (!r.feature || this.config[r.feature]));
+        if (plantRw.length > 0) {
+            for (const group of this._buildReadGroups(plantRw, 50)) {
+                if (this._stopped) {
+                    return;
+                }
+                try {
+                    const raw = await this.modbus.readHoldingRegisters(plantId, group.startAddr, group.totalQty);
+                    await this._processReadGroup(group, raw, 'control');
+                    await this._sleep(100);
+                } catch (err) {
+                    this.log.debug(`[controlRegs] plant addr=${group.startAddr}: ${err.message}`);
+                }
+            }
+        }
+
+        const invRw = INVERTER_WRITE_REGISTERS.filter(r => r.perm === 'RW');
+        if (invRw.length > 0) {
+            for (const group of this._buildReadGroups(invRw, 50)) {
+                if (this._stopped) {
+                    return;
+                }
+                try {
+                    const raw = await this.modbus.readHoldingRegisters(inverterId, group.startAddr, group.totalQty);
+                    await this._processReadGroup(group, raw, 'control');
+                    await this._sleep(100);
+                } catch (err) {
+                    this.log.debug(`[controlRegs] inverter addr=${group.startAddr}: ${err.message}`);
+                }
+            }
+        }
+
+        if (this.config.hasDcCharger) {
+            const dcRw = DC_CHARGER_WRITE_REGISTERS.filter(r => r.perm === 'RW');
+            if (dcRw.length > 0) {
+                for (const group of this._buildReadGroups(dcRw, 50)) {
+                    if (this._stopped) {
+                        return;
+                    }
+                    try {
+                        const raw = await this.modbus.readHoldingRegisters(inverterId, group.startAddr, group.totalQty);
+                        await this._processReadGroup(group, raw, 'control');
+                        await this._sleep(100);
+                    } catch (err) {
+                        this.log.debug(`[controlRegs] dcCharger addr=${group.startAddr}: ${err.message}`);
+                    }
+                }
             }
         }
     }
@@ -693,6 +774,25 @@ class Sigenergy extends utils.Adapter {
                 await this._createStateFromRegister(reg);
             }
 
+            // Plant control write states
+            await this._createChannel('plant.control', 'Plant Control');
+            if (this.config.enableGridCode) {
+                await this._createChannel('plant.gridCode', 'Grid Code Parameters');
+            }
+            for (const reg of PLANT_WRITE_REGISTERS) {
+                if (this._stopped) {
+                    return;
+                }
+                if (reg.feature && !this.config[reg.feature]) {
+                    continue;
+                }
+                await this._createWriteStateFromRegister(reg);
+            }
+            this.subscribeStates('plant.control.*');
+            if (this.config.enableGridCode) {
+                this.subscribeStates('plant.gridCode.*');
+            }
+
             // Virtual PV string power states (calculated from voltage × current)
             for (const pvState of [
                 { id: 'plant.pv1Power', desc: 'PV string 1 power' },
@@ -723,6 +823,16 @@ class Sigenergy extends utils.Adapter {
                 await this._createStateFromRegister(reg);
             }
 
+            // Inverter control write states
+            await this._createChannel('inverter.control', 'Inverter Control');
+            for (const reg of INVERTER_WRITE_REGISTERS) {
+                if (this._stopped) {
+                    return;
+                }
+                await this._createWriteStateFromRegister(reg);
+            }
+            this.subscribeStates('inverter.control.*');
+
             if (this.config.hasAcCharger) {
                 this.log.debug('Creating AC charger objects');
                 await this._createChannel('acCharger', 'AC Charger');
@@ -743,6 +853,14 @@ class Sigenergy extends utils.Adapter {
                     }
                     await this._createStateFromRegister(reg);
                 }
+                await this._createChannel('dcCharger.control', 'DC Charger Control');
+                for (const reg of DC_CHARGER_WRITE_REGISTERS) {
+                    if (this._stopped) {
+                        return;
+                    }
+                    await this._createWriteStateFromRegister(reg);
+                }
+                this.subscribeStates('dcCharger.control.*');
             }
 
             if (this.config.hasSigenMicro) {
@@ -861,6 +979,27 @@ class Sigenergy extends utils.Adapter {
         });
     }
 
+    async _createWriteStateFromRegister(reg) {
+        const type = reg.type === 'STRING' ? 'string' : 'number';
+        await this.setObjectNotExistsAsync(reg.name, {
+            type: 'state',
+            common: {
+                name: reg.desc,
+                type,
+                role: 'value',
+                unit: reg.unit || '',
+                read: reg.perm === 'RW',
+                write: true,
+            },
+            native: {
+                addr: reg.addr,
+                qty: reg.qty,
+                dataType: reg.type,
+                gain: reg.gain,
+            },
+        });
+    }
+
     /**
      * Create ioBroker objects for all active SigenMicro devices
      */
@@ -978,27 +1117,68 @@ class Sigenergy extends utils.Adapter {
         if (!state || state.ack) {
             return;
         }
-        // Strip namespace prefix (e.g. "sigenergy.0.")
+        if (!this.modbus || !this.modbus.connected) {
+            this.log.warn(`Cannot write state ${id}: Modbus not connected`);
+            return;
+        }
         const localId = id.replace(/^[^.]+\.\d+\./, '');
-        if (!localId.startsWith('plant.essPreheating.')) {
+
+        // ESS Preheating writes (FC03/FC10)
+        if (localId.startsWith('plant.essPreheating.')) {
+            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}`);
+            }
             return;
         }
-        const reg = ESS_PREHEATING_WRITE_REGISTERS.find(r => r.name === localId);
+
+        // Plant / Inverter / DC Charger control register writes
+        let reg = null;
+        let slaveId = null;
+        let category = '';
+
+        if (localId.startsWith('plant.control.') || localId.startsWith('plant.gridCode.')) {
+            reg = PLANT_WRITE_REGISTERS.find(r => r.name === localId);
+            slaveId = this.config.plantId || 247;
+            category = 'plant';
+        } else if (localId.startsWith('inverter.control.')) {
+            reg = INVERTER_WRITE_REGISTERS.find(r => r.name === localId);
+            slaveId = this.config.inverterId || 1;
+            category = 'inverter';
+        } else if (localId.startsWith('dcCharger.control.')) {
+            reg = DC_CHARGER_WRITE_REGISTERS.find(r => r.name === localId);
+            slaveId = this.config.inverterId || 1;
+            category = 'dcCharger';
+        }
+
         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]);
+                await this.modbus.writeSingleRegister(slaveId, reg.addr, raw[0]);
             } else {
-                await this.modbus.writeMultipleRegisters(plantId, reg.addr, raw);
+                await this.modbus.writeMultipleRegisters(slaveId, reg.addr, raw);
             }
             await this.setStateAsync(id, { val: state.val, ack: true });
-            this.log.debug(`[essPreheating] wrote ${localId} = ${state.val} → addr ${reg.addr}`);
+            this.log.debug(`[${category}] wrote ${localId} = ${state.val} → addr ${reg.addr} slave ${slaveId}`);
         } catch (err) {
-            this.log.error(`ESS Preheating write error for ${localId}: ${err.message}`);
+            this.log.error(`Control register write error for ${localId}: ${err.message}`);
         }
     }
 

package/package.json

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