iobroker.sigenergy 2.2.3 → 2.2.6

package/README.md

@@ -153,6 +153,14 @@ 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
+
 ### 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
 
@@ -215,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.3",
+        "version": "2.2.6",
         "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.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/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/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

@@ -16,6 +16,10 @@ const {
     AC_CHARGER_READ_REGISTERS,
     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');
@@ -41,8 +45,11 @@ 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));
         this.on('message', this.onMessage.bind(this));
         this.on('unload', this.onUnload.bind(this));
     }
@@ -222,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) {
@@ -263,6 +275,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 +451,98 @@ 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;
+            }
+            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) {
+                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}`);
+                    }
+                }
+            }
+        }
+    }
+
     /**
      * Read all active SigenMicro devices
      */
@@ -664,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' },
@@ -694,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');
@@ -714,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) {
@@ -754,6 +901,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();
@@ -817,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
      */
@@ -928,7 +1111,79 @@ 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;
+        }
+        if (!this.modbus || !this.modbus.connected) {
+            this.log.warn(`Cannot write state ${id}: Modbus not connected`);
+            return;
+        }
+        const localId = id.replace(/^[^.]+\.\d+\./, '');
+
+        // 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;
+        }
+
+        // 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 raw = ModbusConnection.encodeValue(state.val, reg.type, reg.gain);
+        try {
+            if (raw.length === 1) {
+                await this.modbus.writeSingleRegister(slaveId, reg.addr, raw[0]);
+            } else {
+                await this.modbus.writeMultipleRegisters(slaveId, reg.addr, raw);
+            }
+            await this.setStateAsync(id, { val: state.val, ack: true });
+            this.log.debug(`[${category}] wrote ${localId} = ${state.val} → addr ${reg.addr} slave ${slaveId}`);
+        } catch (err) {
+            this.log.error(`Control register 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.6",
   "description": "ioBroker adapter for Sigenergy solar energy systems via Modbus TCP/RTU",
   "author": {
     "name": "ssbingo",