iobroker.sigenergy 2.2.7 → 2.3.1

package/README.md

@@ -153,6 +153,12 @@ Status and power readings for the DC charger.
 
 ## Changelog
 
+### 2.3.1 (2026-06-10)
+- (ssbingo) feat: detect Modbus protocol level on startup by probing registers 30088/30200/30228/30286; read firmware version (30525); log result and store as info.protocolLevel state
+
+### 2.3.0 (2026-06-10)
+- (ssbingo) feat: add common.states enum maps for emsWorkMode/runningState/remoteEmsMode/dcCharger.runningState; wire PSS/PID/AC Charger write registers (FC06/FC10) with subscribe and onStateChange handlers
+
 ### 2.2.7 (2026-06-10)
 - (ssbingo) fix: add missing native defaults enableSmartLoads/enableCumulativeEnergy/enableGridCode to io-package.json
 - (ssbingo) fix: update register 30003 desc with V2.7 EMS modes 5 (FullFeedIn) and 9 (Custom)

package/io-package.json

@@ -1,20 +1,20 @@
 {
     "common": {
         "name": "sigenergy",
-        "version": "2.2.7",
+        "version": "2.3.1",
         "news": {
-            "2.2.7": {
-                "en": "(ssbingo) fix: add missing native defaults enableSmartLoads/enableCumulativeEnergy/enableGridCode to io-package.json; update register 30003 desc with V2.7 EMS modes 5 (FullFeedIn) and 9 (Custom)",
-                "de": "(ssbingo) fix: fehlende native-Defaults enableSmartLoads/enableCumulativeEnergy/enableGridCode in io-package.json ergänzt; Register 30003 Beschreibung um V2.7 EMS-Modi 5 (FullFeedIn) und 9 (Custom) erweitert",
-                "ru": "(ssbingo) fix: добавлены отсутствующие native-дефолты enableSmartLoads/enableCumulativeEnergy/enableGridCode в io-package.json; обновлено описание регистра 30003 с режимами EMS V2.7: 5 (FullFeedIn) и 9 (Custom)",
-                "pt": "(ssbingo) fix: defaults native enableSmartLoads/enableCumulativeEnergy/enableGridCode adicionados ao io-package.json; descrição do registo 30003 atualizada com modos EMS V2.7 5 (FullFeedIn) e 9 (Custom)",
-                "nl": "(ssbingo) fix: ontbrekende native-standaarden enableSmartLoads/enableCumulativeEnergy/enableGridCode toegevoegd aan io-package.json; beschrijving register 30003 bijgewerkt met V2.7 EMS-modi 5 (FullFeedIn) en 9 (Custom)",
-                "fr": "(ssbingo) fix: defaults native enableSmartLoads/enableCumulativeEnergy/enableGridCode ajoutés à io-package.json ; description registre 30003 mise à jour avec modes EMS V2.7 5 (FullFeedIn) et 9 (Custom)",
-                "it": "(ssbingo) fix: default native enableSmartLoads/enableCumulativeEnergy/enableGridCode aggiunti a io-package.json; descrizione registro 30003 aggiornata con modalità EMS V2.7 5 (FullFeedIn) e 9 (Custom)",
-                "es": "(ssbingo) fix: defaults native enableSmartLoads/enableCumulativeEnergy/enableGridCode añadidos a io-package.json; descripción del registro 30003 actualizada con modos EMS V2.7 5 (FullFeedIn) y 9 (Custom)",
-                "pl": "(ssbingo) fix: brakujące domyślne native enableSmartLoads/enableCumulativeEnergy/enableGridCode dodane do io-package.json; opis rejestru 30003 zaktualizowany o tryby EMS V2.7 5 (FullFeedIn) i 9 (Custom)",
-                "uk": "(ssbingo) fix: відсутні native-дефолти enableSmartLoads/enableCumulativeEnergy/enableGridCode додано до io-package.json; опис регістру 30003 оновлено з режимами EMS V2.7 5 (FullFeedIn) та 9 (Custom)",
-                "zh-cn": "(ssbingo) fix: 在 io-package.json 中添加缺失的 native 默认值 enableSmartLoads/enableCumulativeEnergy/enableGridCode；更新寄存器 30003 描述以包含 V2.7 EMS 模式 5（完全并网）和 9（自定义）"
+            "2.3.1": {
+                "en": "(ssbingo) feat: detect Modbus protocol level on startup by probing registers 30088/30200/30228/30286; read firmware version (30525); log result and store as info.protocolLevel state",
+                "de": "(ssbingo) feat: Modbus-Protokollebene beim Start durch Probe von Registern 30088/30200/30228/30286 erkennen; Firmware-Version (30525) lesen; Ergebnis loggen und als info.protocolLevel-State speichern",
+                "ru": "(ssbingo) feat: определение уровня протокола Modbus при запуске путём опроса регистров 30088/30200/30228/30286; чтение версии прошивки (30525); журналирование результата и сохранение в состояние info.protocolLevel",
+                "pt": "(ssbingo) feat: detectar nível do protocolo Modbus no arranque sondando registos 30088/30200/30228/30286; ler versão de firmware (30525); registar resultado e guardar como estado info.protocolLevel",
+                "nl": "(ssbingo) feat: Modbus-protocolniveau bij opstarten detecteren door registers 30088/30200/30228/30286 te sonderen; firmwareversie (30525) lezen; resultaat loggen en opslaan als info.protocolLevel-state",
+                "fr": "(ssbingo) feat: détection du niveau de protocole Modbus au démarrage en sondant les registres 30088/30200/30228/30286 ; lecture de la version firmware (30525) ; journalisation du résultat et stockage dans l'état info.protocolLevel",
+                "it": "(ssbingo) feat: rilevamento del livello del protocollo Modbus all'avvio sondando i registri 30088/30200/30228/30286; lettura della versione firmware (30525); registrazione del risultato e salvataggio come stato info.protocolLevel",
+                "es": "(ssbingo) feat: detectar nivel de protocolo Modbus en el arranque sondeando registros 30088/30200/30228/30286; leer versión de firmware (30525); registrar resultado y almacenar como estado info.protocolLevel",
+                "pl": "(ssbingo) feat: wykrywanie poziomu protokołu Modbus przy uruchomieniu przez próbkowanie rejestrów 30088/30200/30228/30286; odczyt wersji firmware (30525); logowanie wyniku i zapis jako stan info.protocolLevel",
+                "uk": "(ssbingo) feat: виявлення рівня протоколу Modbus при запуску шляхом зондування регістрів 30088/30200/30228/30286; зчитування версії прошивки (30525); журналювання результату та збереження як стан info.protocolLevel",
+                "zh-cn": "(ssbingo) feat: 启动时通过探测寄存器 30088/30200/30228/30286 检测 Modbus 协议级别；读取固件版本（30525）；记录结果并存储为 info.protocolLevel 状态"
             }
         },
         "titleLang": {
@@ -178,6 +178,19 @@
                 "def": "idle"
             },
             "native": {}
+        },
+        {
+            "_id": "info.protocolLevel",
+            "type": "state",
+            "common": {
+                "name": "Detected Modbus protocol level",
+                "type": "string",
+                "role": "text",
+                "read": true,
+                "write": false,
+                "def": ""
+            },
+            "native": {}
         }
     ]
 }

package/main.js

@@ -20,11 +20,25 @@ const {
     PLANT_WRITE_REGISTERS,
     INVERTER_WRITE_REGISTERS,
     DC_CHARGER_WRITE_REGISTERS,
+    AC_CHARGER_WRITE_REGISTERS,
+    PSS_WRITE_REGISTERS,
+    PID_WRITE_REGISTERS,
+    RUNNING_STATES,
+    EMS_WORK_MODES,
+    REMOTE_EMS_MODES,
+    DC_CHARGER_RUNNING_STATES,
 } = require('./lib/registers');
 const SigenMicroScanner = require('./lib/scanner');
 const { getRegistersForDevice } = require('./lib/sigenMicroRegisters');
 const adapterVersion = require('./package.json').version;
 
+const ENUM_STATES_MAP = {
+    'plant.emsWorkMode': EMS_WORK_MODES,
+    'plant.runningState': RUNNING_STATES,
+    'dcCharger.runningState': DC_CHARGER_RUNNING_STATES,
+    'plant.control.remoteEmsMode': REMOTE_EMS_MODES,
+};
+
 class Sigenergy extends utils.Adapter {
     /**
      * @param {Partial<utils.AdapterOptions>} [options] - Adapter options
@@ -46,6 +60,7 @@ class Sigenergy extends utils.Adapter {
         // calling setStateAsync on a stopped adapter.
         this._stopped = false;
         this._controlRegistersRead = false;
+        this._protocolDetected = false;
         this._essPreheatingUnsupported = false;
 
         this.on('ready', this.onReady.bind(this));
@@ -233,6 +248,10 @@ class Sigenergy extends utils.Adapter {
                 await this._readControlRegisters();
                 this._controlRegistersRead = true;
             }
+            if (!this._protocolDetected) {
+                await this._detectProtocolLevel();
+                this._protocolDetected = true;
+            }
 
             const _t0 = Date.now();
             await this._readPlant();
@@ -487,6 +506,40 @@ class Sigenergy extends utils.Adapter {
         }
     }
 
+    async _detectProtocolLevel() {
+        const plantId = this.config.plantId || 247;
+        const inverterId = this.config.inverterId || 1;
+
+        const probes = [
+            { addr: 30088, level: 'V2.6' },
+            { addr: 30200, level: 'V2.7' },
+            { addr: 30228, level: 'V2.8' },
+            { addr: 30286, level: 'V2.9' },
+        ];
+
+        let detectedLevel = null;
+        for (const probe of probes) {
+            try {
+                await this.modbus.readInputRegisters(plantId, probe.addr, 1);
+                detectedLevel = probe.level;
+            } catch {
+                break;
+            }
+        }
+
+        let firmwareVersion = 'unknown';
+        try {
+            const raw = await this.modbus.readInputRegisters(inverterId, 30525, 15);
+            firmwareVersion = ModbusConnection.parseValue(raw, 'STRING', null) || 'unknown';
+        } catch {
+            // not critical
+        }
+
+        const levelStr = detectedLevel ? `>=${detectedLevel}` : 'unknown';
+        this.log.info(`Detected protocol level: ${levelStr} (firmware: ${firmwareVersion})`);
+        await this.setStateAsync('info.protocolLevel', { val: levelStr, ack: true });
+    }
+
     async _readControlRegisters() {
         const plantId = this.config.plantId || 247;
         const inverterId = this.config.inverterId || 1;
@@ -842,6 +895,14 @@ class Sigenergy extends utils.Adapter {
                     }
                     await this._createStateFromRegister(reg);
                 }
+                await this._createChannel('acCharger.control', 'AC Charger Control');
+                for (const reg of AC_CHARGER_WRITE_REGISTERS) {
+                    if (this._stopped) {
+                        return;
+                    }
+                    await this._createWriteStateFromRegister(reg);
+                }
+                this.subscribeStates('acCharger.control.*');
             }
 
             if (this.config.hasDcCharger) {
@@ -882,17 +943,32 @@ class Sigenergy extends utils.Adapter {
                     }
                     await this._createStateFromRegister(reg);
                 }
+                for (const reg of PSS_WRITE_REGISTERS) {
+                    if (this._stopped) {
+                        return;
+                    }
+                    await this._createWriteStateFromRegister(reg);
+                }
+                this.subscribeStates('pss.control.*');
             }
 
             if (this.config.enablePid) {
                 this.log.debug('Creating PID objects');
                 await this._createChannel('pid', 'PV Insulation Detection');
+                await this._createChannel('pid.control', 'PID Control');
                 for (const reg of PID_READ_REGISTERS) {
                     if (this._stopped) {
                         return;
                     }
                     await this._createStateFromRegister(reg);
                 }
+                for (const reg of PID_WRITE_REGISTERS) {
+                    if (this._stopped) {
+                        return;
+                    }
+                    await this._createWriteStateFromRegister(reg);
+                }
+                this.subscribeStates('pid.control.*');
             }
 
             if (this.config.enableEssPreheating) {
@@ -960,16 +1036,22 @@ class Sigenergy extends utils.Adapter {
             type = 'number';
         }
 
+        const common = {
+            name: reg.desc,
+            type,
+            role,
+            unit: reg.unit || '',
+            read: true,
+            write: false,
+        };
+        const states = ENUM_STATES_MAP[reg.name];
+        if (states) {
+            common.states = states;
+        }
+
         await this.setObjectNotExistsAsync(reg.name, {
             type: 'state',
-            common: {
-                name: reg.desc,
-                type,
-                role,
-                unit: reg.unit || '',
-                read: true,
-                write: false,
-            },
+            common,
             native: {
                 addr: reg.addr,
                 qty: reg.qty,
@@ -981,16 +1063,21 @@ class Sigenergy extends utils.Adapter {
 
     async _createWriteStateFromRegister(reg) {
         const type = reg.type === 'STRING' ? 'string' : 'number';
+        const common = {
+            name: reg.desc,
+            type,
+            role: 'value',
+            unit: reg.unit || '',
+            read: reg.perm === 'RW',
+            write: true,
+        };
+        const states = ENUM_STATES_MAP[reg.name];
+        if (states) {
+            common.states = states;
+        }
         await this.setObjectNotExistsAsync(reg.name, {
             type: 'state',
-            common: {
-                name: reg.desc,
-                type,
-                role: 'value',
-                unit: reg.unit || '',
-                read: reg.perm === 'RW',
-                write: true,
-            },
+            common,
             native: {
                 addr: reg.addr,
                 qty: reg.qty,
@@ -1162,6 +1249,18 @@ class Sigenergy extends utils.Adapter {
             reg = DC_CHARGER_WRITE_REGISTERS.find(r => r.name === localId);
             slaveId = this.config.inverterId || 1;
             category = 'dcCharger';
+        } else if (localId.startsWith('pss.control.')) {
+            reg = PSS_WRITE_REGISTERS.find(r => r.name === localId);
+            slaveId = this.config.pssSlaveId || 5;
+            category = 'pss';
+        } else if (localId.startsWith('pid.control.')) {
+            reg = PID_WRITE_REGISTERS.find(r => r.name === localId);
+            slaveId = this.config.pidSlaveId || 6;
+            category = 'pid';
+        } else if (localId.startsWith('acCharger.control.')) {
+            reg = AC_CHARGER_WRITE_REGISTERS.find(r => r.name === localId);
+            slaveId = this.config.acChargerId || 2;
+            category = 'acCharger';
         }
 
         if (!reg) {

package/package.json

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