iobroker.sun2000 2.1.1 → 2.2.1-alpha.0

package/README.md

@@ -30,7 +30,7 @@ Feel free to follow the discussions in the german [iobroker forum](https://forum
 ## Requirements
 * Node.js 20 or higher
 * ioBroker host (js-controller) 6.0.11 or higher
-* ioBroker admin 7.4.10 or higher
+* ioBroker admin 7.6.17 or higher
 
 ## Documentation
 
@@ -65,6 +65,20 @@ browse in the [wiki](https://github.com/bolliy/ioBroker.sun2000/wiki)
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 2.2.1-alpha.0 (2025-10-21)
+* inverter control: add same state for startup and shutdown an inverter [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)
+* fix: Device status name has been corrected [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)
+* add undocumented device status `Shutdown: End of the ESS discharge process` 
+* emma control: new state ` emma.control.battery.ESSControlMode`. You can now configure EMMA with TOU-mode (Time of Use) to charge the battery from grid. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)
+* if an Emma is installed, some control states of the inverter are deactivated (read only). Mainly for the grid settings.
+* deprecated control states have been removed.
+* a workaround for issue [#582](https://github.com/yaacov/node-modbus-serial/issues/582) of node-modbus-serial has been implemented.
+
+### 2.2.0 (2025-10-05)
+* dependency and configuration updates
+* new state `meter.derived.signConventionForPowerFeed-in` sign of meter.activePower that is currently being fed into the power grid
+* new state `meter.derived.feed-inPower` electric power that is supplied to a grid ("fed in")
+
 ### 2.1.1 (2025-09-24)
 * dependency and configuration updates
 * fix: adjust event value limits based on usableSurplus parameters

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "sun2000",
-    "version": "2.1.1",
+    "version": "2.2.1-alpha.0",
     "news": {
+      "2.2.1-alpha.0": {
+        "en": "inverter control: add same state for startup and shutdown an inverter [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\nfix: Device status name has been corrected [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)\nadd undocumented device status `Shutdown: End of the ESS discharge process` \nemma control: new state ` emma.control.battery.ESSControlMode`. You can now configure EMMA with TOU-mode (Time of Use) to charge the battery from grid. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nif an Emma is installed, some control states of the inverter are deactivated (read only). Mainly for the grid settings.\ndeprecated control states have been removed.\na workaround for issue [#582](https://github.com/yaacov/node-modbus-serial/issues/582) of node-modbus-serial has been implemented.",
+        "de": "inverter-Steuerung: Fügen Sie den gleichen Zustand für Start und Abschaltung eines Inverters [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199) hinzu\nbehoben: Gerätestatusname wurde korrigiert [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)\n`Shutdown: Ende des ESS-Entladungsvorgangs`\nemma control: new state ` emma.control.battery.ESSControlMode`. Sie können nun EMMA mit TOU-Modus (Time of Use) konfigurieren, um den Akku aus dem Netz zu laden. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nwenn eine Emma installiert ist, werden einige Steuerzustände des Wechselrichters deaktiviert (nur lesen). Hauptsächlich für die Netzeinstellungen.\ndeprekierte steuerzustände wurden entfernt.\nein workaround für ausgabe [#582](https://github.com/yaacov/node-modbus-serial/issues/582) von node-modbus-serial wurde implementiert.",
+        "ru": "инверторное управление: добавьте то же состояние для запуска и отключения инвертора [#199] (https://github.com/bolliy/ioBroker.sun2000/issues/199)\nисправление: имя статуса устройства было исправлено [#202] (https://github.com/bolliy/ioBroker.sun2000/pull/202)\nдобавить незарегистрированный статус устройства «Shutdown: End of the ESS discharge process»\nemma control: emma.control.battery.ESSControlMode. Теперь вы можете настроить EMMA с режимом TOU (Время использования) для зарядки батареи из сетки. [#200] (https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nесли установлена Эмма, некоторые контрольные состояния инвертора деактивируются (только чтение). В основном для настроек сетки.\nустаревшие контрольные штаты были удалены.\nбыл реализован обходной путь для выпуска [#582] (https://github.com/yaacov/node-modbus-serial/issues/582) node-modbus-serial.",
+        "pt": "controle do inversor: adicione o mesmo estado para iniciar e desligar um inversor [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\ncorreção: o nome do estado do dispositivo foi corrigido [#202] (https://github.com/bolliy/ioBroker.sun2000/pull/202)\nadicionar status do dispositivo não documentado `Shutdown: Fim do processo de descarga do ESS'\nemma control: novo estado `emma.control.battery.ESSControlMode`. Agora você pode configurar o EMMA com o modo TOU (Time of Use) para carregar a bateria da grade. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nse uma Emma estiver instalada, alguns estados de controle do inversor são desativados (apenas lidos). Principalmente para as configurações da grade.\nos estados de controlo desactualizados foram removidos.\numa solução alternativa para o problema [#582](https://github.com/yaacov/node-modbus-serial/issues/582) do nó-modbus-serial foi implementada.",
+        "nl": "inverter control: voeg dezelfde status toe voor het opstarten en afsluiten van een inverter [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\nfix: De status van het apparaat is gecorrigeerd [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)\nstatus van niet-gedocumenteerd apparaat toevoegen: Afsluiten: Einde van het ESS-ontladingsproces\nemma control: nieuwe staat  U kunt nu EMMA configureren met de TOU-modus (Time of Use) om de batterij op te laden van het net. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nals een Emma is geïnstalleerd, worden sommige controletoestanden van de omvormer gedeactiveerd (alleen lezen). Vooral voor de rasterinstellingen.\nverouderde controlestaten zijn verwijderd.\ner is een oplossing gevonden voor nummer [#582](https://github.com/yaacov/node-modbus-serial/issues/582) van node-modbus-serial.",
+        "fr": "contrôle de l'onduleur: ajouter le même état pour le démarrage et l'arrêt d'un onduleur [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\ncorrection : le nom de l'état du périphérique a été corrigé [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)\najouter l'état de l'appareil sans papiers `Shutdown: Fin du processus de décharge ESS'\ncontrôle emma: nouvel état ` emma.control.battery.ESSControlMode`. Vous pouvez maintenant configurer EMMA en mode TOU (Time of Use) pour charger la batterie à partir de la grille. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nsi une Emma est installée, certains états de contrôle de l'onduleur sont désactivés (lisez seulement). Principalement pour les paramètres de la grille.\nles états de contrôle dépréciés ont été supprimés.\nune solution de rechange pour l'émission [#582](https://github.com/yaacov/node-modbus-serial/issues/582) de nœud-modbus-serial a été mise en œuvre.",
+        "it": "controllo inverter: aggiungere lo stesso stato per l'avvio e l'arresto di un inverter [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\nfix: Il nome dello stato del dispositivo è stato corretto [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)\naggiungere lo stato del dispositivo non documentato `Shutdown: Fine del processo di scarico ESS`\ncontrollo emma: nuovo stato ` emma.control.battery.ESSControlMode`. È ora possibile configurare EMMA con TOU-mode (Time of Use) per caricare la batteria dalla rete. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nse viene installata una Emma, alcuni stati di controllo dell'inverter sono disattivati (leggi solo). Principalmente per le impostazioni della griglia.\nstati di controllo deprecati sono stati rimossi.\nè stato implementato un workaround per il numero [#582](https://github.com/yaacov/node-modbus-serial/issues/582) di node-modbus-serial.",
+        "es": "control inverter: añadir el mismo estado para iniciar y cerrar un inverter [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\nfijado: Se ha corregido el nombre del estado de los dispositivos [#202](https://github.com/bolliy/ioBroker.sun2000/pull/202)\nañadir estado de dispositivo no documentado `Shutdown: Final del proceso de descarga ESS`\nemma control: nuevo estado ` emma.control.battery.ESSControlMode`. Ahora puede configurar EMMA con TOU-mode (Time of Use) para cargar la batería de la red. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nsi se instala una Emma, se desactivan algunos estados de control del inversor (sólo lectura). Principalmente para la configuración de la red.\nestados de control deprecatados han sido eliminados.\na workaround for issue [#582](https://github.com/yaacov/node-modbus-serial/issues/582) of node-modbus-serial has been implemented.",
+        "pl": "inverter control: add same state for startup and shutdown an inverter [# 199] (https: / / github.com / bolliy / ioBroker.sun2000 / issues / 199)\nfix: Nazwa statusu urządzenia została poprawiona [# 202] (https: / / github.com / bolliy / ioBroker.sun2000 / pull / 202)\ndodać nieudokumentowany status urządzenia \"Wyłączenie: koniec procesu rozładowania ESS\"\nemma control: New state 'emma.control.battery.ESSControlMode'. Można teraz skonfigurować EMMA z TOU- mode (Time of Use), aby naładować baterię z siatki. [# 200] (https: / / github.com / bolliy / ioBroker.sun2000 / discussions / 200)\njeśli zainstalowana jest Emma, niektóre stany sterujące inwertera są wyłączone (tylko do odczytu). Głównie dla ustawień siatki.\nusunięto zdepregatowane stany kontrolne.\na workaround for issue [# 582] (https: / / github.com / yaacov / node- modbus- serial / issues / 582) of node- modbus- serial został wdrożony.",
+        "uk": "контроль інвертора: додати однаковий стан для запуску та відключення інвертора [#199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\nвиправлено: Назва стану пристрою було виправлено [#202] (https://github.com/bolliy/ioBroker.sun2000/pull/202)\nдодати недокументований статус пристрою `Пошук: кінець процесу розряду ESS\nемма управління: новий стан ` emma.control.battery.ESSControlMode`. Ви можете налаштувати EMMA з TOU-mode (Time of Use) для зарядки акумулятора з сітки. [#200](https://github.com/bolliy/ioBroker.sun2000/discussions/200)\nякщо встановлений Емма, деактивуються деякі стани управління інвертором (прочитати тільки). В основному для налаштування сітки.\nвилучені стани керування.\n[#582](https://github.com/yaacov/node-modbus-serial/issues/582) вузла-modbus-serial.",
+        "zh-cn": "反转器控制:为启动和关闭添加相同状态的反转器[199](https://github.com/bolliy/ioBroker.sun2000/issues/199)\n固定: 设备状态名称已更正 [# 202] (https://github.com/bolliy/ioBroker.sun2000/pul/202)\n添加无文件设备状态“关闭:ESS放电过程结束”\nemma控制:新状态`emma.control.battery.ESS Control Mode'. 您现在可以用 TOU- mode( 使用时间) 配置 EMMA 从电网中充电 。 [# 200] (https://github.com/bolliy/ioBroker.sun2000/discussions/200)\n如果安装了Emma,反转器的某些控制状态就会失效(只读). 主要用于网格设置.\n贬值的控制状态已被取消.\n已落实了节点-modbus-serial[#582](https://github.com/yaacov/node-modbus-serial/issues/582)的工作."
+      },
+      "2.2.0": {
+        "en": "dependency and configuration updates\nnew state `meter.derived.signConventionForPowerFeed-in` sign of meter.activePower that is currently being fed into the power grid\nnew state `meter.derived.feed-inPower` electric power that is supplied to a grid (\"fed in\")",
+        "de": "abhängigkeits- und konfigurationsupdates\nneuer Zustand `meter.derived.signConventionForPowerFeed-in` Zeichen von meter.active Strom, der derzeit in das Stromnetz eingespeist wird\nneue Zustand `meter.derived.feed-inPower` elektrische Leistung, die einem Netz zugeführt wird (\"fed in\")",
+        "ru": "обновления зависимостей и конфигурации\nновый государственный знак «meter.derived.signConventionForPowerFeed-in» Мощность, которая в настоящее время подается в электросеть\nэлектрическая мощность нового состояния «meter.derived.feed-inPower», которая подается в сеть («питается в»)",
+        "pt": "atualizações de dependência e configuração\nnovo estado `meter.derived.signConventionForPowerFeed-in` sinal do medidor.active Energia que está sendo alimentada na rede de energia\nnovo estado `meter.derived.feed-inPower` energia elétrica que é fornecida a uma grade (\"feed in\")",
+        "nl": "afhankelijkheid en configuratie-updates\nnieuwe staat  Energie die momenteel wordt gevoed in het elektriciteitsnet\nnieuwe toestand ",
+        "fr": "mises à jour de la dépendance et de la configuration\nnouvel état `meter.derived.signConventionForPowerFeed-in` signe de meter.active Puissance qui est actuellement introduite dans le réseau électrique\nnouvel état `meter.derived.feed-inPower` électricité qui est fourni à un réseau (\"feed in\")",
+        "it": "aggiornamenti di dipendenza e configurazione\nnuovo stato `meter.derived.signConventionForPowerFeed-in` segno di metro.active Potenza che sta attualmente alimentando nella rete elettrica\nnuovo stato `meter.derived.feed-inPower` potere elettrico che viene fornito a una griglia (\"fed in\")",
+        "es": "actualizaciones de dependencia y configuración\nnuevo estado `meter.derived.signConventionForPowerFeed-in` signo de medidor.active Potencia que actualmente está siendo alimentada en la red eléctrica\nnuevo estado `meter.derived.feed-inPower` energía eléctrica que se suministra a una red (\"fed in\")",
+        "pl": "aktualizacje zależności i konfiguracji\nnowy stan 'meter.derived.signConventionForPowerFeed- in' znak meter.active Energia zasilana obecnie do sieci energetycznej\nnowy stan 'meter.derived.feed-inPower' energia elektryczna, która jest dostarczana do sieci (\"karmiona w\")",
+        "uk": "оновлення залежності та конфігурації\nновий стан `meter.derived.signConventionForPowerFeed-in` знак лічильника.active Потужність, яка в даний час вдається в електромережу\nновий стан `meter.derived.feed-inPower` електрична потужність, яка подається в сітку (\"fed in\")",
+        "zh-cn": "依赖和配置更新\n新的状态“ 公尺” 。 生成。 签署 Convention ForPowerFeed- in' sign of meter. 活动 目前输入电网的电力\n新状态“ met. entered. feed-inpower” 供电给电网(“ feeded in”)"
+      },
       "2.1.1": {
         "en": "dependency and configuration updates\nfix: adjust event value limits based on usableSurplus parameters\nfix: swap register values for power consumption in Emma driver #190\nemma: improve power calculation with exponential moving average in EmmaCharger\nupdate surplus power state definitions and deprecate old identifiers",
         "de": "abhängigkeits- und konfigurationsupdates\nfix: Event-Wert-Grenze basierend auf nutzbar Überschüssige Parameter\nfix: Swap-Registerwerte für den Stromverbrauch in Emma Treiber #190\nemma: Leistungsberechnung mit exponentiellem Bewegungsmittel in EmmaCharger verbessern\naktualisierung der überschussstrom-zustandsdefinitionen und abschreibung alter kennungen",
@@ -67,32 +93,6 @@
         "pl": "control: nowy stan kontroli 'sun2000.0.control.externalPower' # 76\nstała emisja wykryta przez kontroler repozytorium # 166",
         "uk": "контроль: новий стан управління `sun2000.0.control.externalPower` #76\nвиправлено проблему, виявлену репозиторійною перевіркою #166",
         "zh-cn": "控制:新的控制状态`sun 2000.0.control.external Power ' 76号\n仓库检查器检测到的固定问题 # 166"
-      },
-      "1.3.0": {
-        "en": "usableSurplusPower: new control state `sun2000.0.control.usableSurplus.allowNegativeValue`",
-        "de": "usableSurplusPower: neuer Steuerzustand `sun2000.0.control.usableSurplus.allowNegativeValue `",
-        "ru": "usableSurplusPower: новое состояние управления 'sun2000.0.control.usableSurplus.allowНегативная ценность пункт",
-        "pt": "usableSurplusPower: novo estado de controle `sun2000.0.control.usableSurplus.allowValue negativo \"",
-        "nl": "bruikbareSurplusPower: nieuwe controlestatus  Wat",
-        "fr": "utilisableSurplusPower: nouvel état de contrôle `sun2000.0.control.usableSurplus.allowNegativeValue \"",
-        "it": "usableSurplusPower: nuovo stato di controllo `sun2000.0.control.usableSurplus.allowValore negativo #",
-        "es": "usableSurplusPower: nuevo estado de control `sun2000.0.control.usableSurplus.allowNegativeValue `",
-        "pl": "usableSurplusPower: nowy stan kontroli 'Sun2000.0.control.usableSurplus.allowNegativeValue'",
-        "uk": "english, Українська, Français... й",
-        "zh-cn": "可用SurpusPower: 新的控制状态 `sun 2000.control.usurplus.allow NegativeValue ' `"
-      },
-      "1.2.2": {
-        "en": "deploy 1.2",
-        "de": "bereitstellung 1.2",
-        "ru": "развернуть 1.2",
-        "pt": "implementação 1.2",
-        "nl": "1.2 inzetten",
-        "fr": "déploiement 1,2",
-        "it": "distribuzione 1.2",
-        "es": "despliegue 1.2",
-        "pl": "rozmieszczenie 1.2",
-        "uk": "розгортання 1.2",
-        "zh-cn": "部署"
       }
     },
     "titleLang": {

package/lib/controls/emma_service_queue.js

@@ -0,0 +1,304 @@
+'use strict';
+const { deviceType, dataType } = require(`${__dirname}/../types.js`);
+class ServiceQueueMap {
+	constructor(adapterInstance, emma) {
+		this.adapter = adapterInstance;
+		this.log = this.adapter.logger;
+		this.inverterInfo = emma;
+		this._modbusClient = null;
+		this._serviceMap = new Map();
+		this._eventMap = new Map();
+		this._initialized = false;
+		this._name = 'emma control';
+
+		this.serviceFields = [
+			{
+				state: { id: 'battery.ESSControlMode', name: 'ESS control mode', type: 'number', unit: '', role: 'level', desc: 'reg:40000, len:1' },
+				type: deviceType.battery,
+				fn: async event => {
+					let ret = false;
+					if (event.value > 6) {
+						event.value = 2;
+					}
+					if (event.value < 2 || event.value === 3) {
+						event.value = 2;
+					}
+					if (this.isTestMode()) {
+						this.log.info(`${this._name}: the test mode is active, so the ESS control mode is always written to register 47086`);
+						ret = await this._writeRegisters(47086, dataType.numToArray(event.value, dataType.uint16));
+					} else {
+						ret = await this._writeRegisters(40000, dataType.numToArray(event.value, dataType.uint16));
+						/*
+						if (ret) {
+							this.inverterInfo.instance.stateCache.set(`emma.${event.id}`, event.value, { type: 'number' });
+						}
+						*/
+					}
+					return ret;
+				},
+			},
+			{
+				state: {
+					id: 'battery.tou.preferredUseOfSurplusPvPower',
+					name: '[Time of Use mode] Preferred use of surplus PV power',
+					type: 'boolean',
+					unit: '',
+					role: 'switch.enable',
+					desc: 'reg: 40001, len: 1',
+				},
+				type: deviceType.battery,
+				fn: async event => {
+					let ret = false;
+
+					if (this.isTestMode()) {
+						this.log.info(`${this._name}: the test mode is active, so the maximum power for charging batteries from grid not transferred`);
+						ret = true;
+					} else {
+						ret = await this._writeRegisters(40001, event.value === true ? [1] : [0]);
+					}
+					/*
+					if (ret) {
+						this.inverterInfo.instance.stateCache.set(`emma.${event.id}`, event.value);
+					}
+					*/
+					return ret;
+				},
+			},
+			{
+				state: {
+					id: 'battery.tou.maximumPowerForChargingFromGrid',
+					name: '[Time of Use mode] Maximum power for charging batteries from grid',
+					type: 'number',
+					unit: 'kW',
+					role: 'level.power',
+					desc: 'reg: 40002, len: 2',
+				},
+				type: deviceType.battery,
+				fn: async event => {
+					let ret = false;
+					if (event.value > 50) {
+						event.value = 50;
+					}
+					if (event.value < 0) {
+						event.value = 0;
+					}
+					if (this.isTestMode()) {
+						this.log.info(`${this._name}: the test mode is active, so the maximum power for charging batteries from grid not transferred`);
+						ret = true;
+					} else {
+						ret = await this._writeRegisters(40002, dataType.numToArray(event.value * 1000, dataType.uint32));
+					}
+					/*
+					if (ret) {
+						this.inverterInfo.instance.stateCache.set(`emma.${event.id}`, event.value, { type: 'number' });
+					}
+					*/
+					return ret;
+				},
+			},
+		];
+	}
+
+	async _init() {
+		if (this.inverterInfo.instance) {
+			for (const item of this.serviceFields) {
+				if (item?.state) {
+					this._serviceMap.set(item.state.id, item);
+				}
+			}
+
+			for (const entry of this._serviceMap.values()) {
+				//await this._initState('emma.control.',entry.state);
+				const path = `emma.control.`;
+				await this._initState(path, entry.state);
+				const state = await this.adapter.getState(path + entry.state.id);
+				if (state && state.ack === false) {
+					this.set(entry.state.id, state);
+				}
+			}
+			//subscribe all control states
+			this.adapter.subscribeStates(`emma.control*`);
+			this._initialized = true;
+
+			if (this.adapter.settings?.cb.tou && !this.isTestMode()) {
+				const essControlMode = await this._readHoldingRegisters(40000, 1);
+				//const tou = await this._readHoldingRegisters(40004,43); //first periode
+				if (essControlMode && essControlMode[0] !== 5) {
+					/*
+					127 - Working mode settings
+					2 : Maximise self consumptions (default)
+					5 : Time Of Use(Luna) - hilfreich bei dynamischem Stromtarif (z.B Tibber)
+
+					Time of Using charging and discharging periodes (siehe Table 5-6)
+					tCDP[3] = 127 - Working mode settings - load from grid (charge)
+					tCDP[3] = 383 - Working mode settings - self-consumption (discharge)
+					*/
+					const tCDP = [
+						1, 0, 1440, 127, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
+					];
+					if (await this._writeRegisters(40004, tCDP)) {
+						this.inverterInfo.instance.addHoldingRegisters((40004, tCDP));
+						this.log.info(`${this._name}: The default TOU setting are transferred`);
+					}
+				}
+			}
+		}
+
+		if (this._initialized) {
+			this.log.info(`${this._name}: service queue initialized`);
+		}
+	}
+
+	/**
+	 * Checks if the device is in test mode
+	 * @returns {boolean} True if the device is in test mode, false otherwise
+	 */
+	isTestMode() {
+		return this.inverterInfo.instance?.isTestMode() || false;
+	}
+
+	/**
+	 * @description Check if the value of the event is a number and optionally round it to the nearest integer.
+	 * @param {object} event The event object
+	 * @param {boolean} [round] If true, the value is rounded to the nearest integer
+	 * @returns {boolean} True if the value is a number, false otherwise
+	 */
+	isNumber(event, round = true) {
+		if (isNaN(event.value)) {
+			return false;
+		}
+		if (round) event.value = Math.round(event.value);
+		return true;
+	}
+
+	get(id) {
+		return this._eventMap.get(id);
+	}
+
+	set(id, state) {
+		const service = this._serviceMap.get(id);
+		if (state && service) {
+			if (state.val !== null && !state.ack) {
+				this.log.info(`${this._name}: Event - state: emma.control.${id} changed: ${state.val} ack: ${state.ack}`);
+				const event = this._eventMap.get(id);
+				if (event) {
+					event.value = state.val;
+					event.ack = false;
+				} else {
+					this._eventMap.set(id, { id: id, value: state.val, ack: false });
+				}
+			}
+		}
+	}
+
+	/**
+	 * Processes pending events in the service queue and attempts to execute their associated functions.
+	 *
+	 * @async
+	 * @param {object} modbusClient - The modbus client instance used for communication.
+	 *
+	 * @description This function iterates over the events in the service queue, checking whether each event
+	 * can be processed. It verifies conditions such as battery presence and running status, and checks if the
+	 * event value is a number when required. If the event is successfully processed, it acknowledges the event
+	 * by setting its state in the adapter and removes it from the event map. If the event cannot be processed
+	 * after multiple attempts, it is discarded. The function initializes the service queue if it is not already
+	 * initialized and the adapter is connected.
+	 */
+
+	async process(modbusClient) {
+		this._modbusClient = modbusClient;
+
+		if (this._initialized) {
+			let count = 0;
+			for (const event of this._eventMap.values()) {
+				if (event.ack) {
+					continue;
+				} //allready done
+				const service = this._serviceMap.get(event.id);
+				if (!service.errorCount) {
+					service.errorCount = 0;
+				}
+				if (event.value !== null && service.fn) {
+					//check if battery is present and running
+					if (service.state.type === 'number') {
+						if (!this.isNumber(event)) {
+							this.log.warn(
+								`${this._name}: Event is discarded because the value ${event.value} is not a number. State: emma.control.${event.id}`,
+							);
+							this._eventMap.delete(event.id); //forget the event
+							continue;
+						}
+					}
+					count++;
+					if (await service.fn(event)) {
+						service.errorCount = 0;
+						try {
+							event.ack = true;
+							await this.adapter.setState(`emma.control.${event.id}`, { val: event.value, ack: true });
+							this._eventMap.delete(event.id);
+							this.log.info(`${this._name}: write state emma.control.${event.id} : ${event.value} ack: true`);
+						} catch {
+							this.log.warn(`${this._name}: Can not write state emma.control.${event.id}`);
+						}
+					} else {
+						service.errorCount++;
+						if (service.errorCount > 1) {
+							this._eventMap.delete(event.id); //forget it
+							this.log.info(`${this._name}: Event is discarded because it could not be processed. State: emma.control.${event.id}`);
+						}
+					}
+				}
+				if (count > 1) {
+					break;
+				} //max 2 Events
+			}
+		}
+		if (!this._initialized && this.adapter.isConnected) {
+			await this._init();
+		}
+	}
+
+	async _writeRegisters(address, data) {
+		try {
+			this.log.debug(`Try to write data to id/address/length ${this._modbusClient.id}/${address}/${data.length}`);
+			await this._modbusClient.writeRegisters(address, data);
+			this.inverterInfo.instance.addHoldingRegisters(address, data); //write also to the modbus read cache
+			return true;
+		} catch (err) {
+			this.log.warn(
+				`Error while writing to ${this._modbusClient.ipAddress} [Reg: ${address}, Len: ${data.length}, modbusID: ${this._modbusClient.id}] with: ${err.message}`,
+			);
+		}
+	}
+
+	async _readHoldingRegisters(address, length) {
+		try {
+			this.log.debug(`Try to read data to id/address/length ${this._modbusClient.id}/${address}/${length}`);
+			const data = await this._modbusClient.readHoldingRegisters(address, length);
+			return data;
+		} catch (err) {
+			this.log.warn(
+				`Error while reading from ${this._modbusClient.ipAddress} [Reg: ${address}, Len: ${length}, modbusID: ${this._modbusClient.id}] with: ${err.message}`,
+			);
+		}
+	}
+
+	//state
+	async _initState(path, state) {
+		await this.adapter.extendObject(path + state.id, {
+			type: 'state',
+			common: {
+				name: state.name,
+				type: state.type,
+				role: state.role,
+				unit: state.unit,
+				desc: state.desc,
+				read: true,
+				write: true,
+			},
+			native: {},
+		});
+	}
+}
+
+module.exports = ServiceQueueMap;