iobroker.sun2000 2.4.5 → 2.5.0

package/README.md

@@ -27,7 +27,7 @@ Read and write register data from Huawei SUN2000 inverter and LUNA2000 battery u
 Feel free to follow the discussions in the german [iobroker forum](https://forum.iobroker.net/topic/71768/test-adapter-sun2000-v0-1-x-huawei-wechselrichter)
 
 ## Requirements
-* Node.js 20 or higher
+* Node.js 22 or higher
 * ioBroker host (js-controller) 6.0.11 or higher
 * ioBroker admin 7.6.20 or higher
 
@@ -69,6 +69,9 @@ The sun2000 adapter calculates how much of your self-generated solar energy is a
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 2.5.0 (2026-06-09)
+* statistics: added live power chart (statistics.jsonLive)
+
 ### 2.4.5 (2026-05-14)
 * statistics fix: return weekly range up to current Monday
 * statistics: added support for generating statistics templates directly from built-in charts
@@ -91,10 +94,7 @@ The sun2000 adapter calculates how much of your self-generated solar energy is a
 * statistics: data placeholders (`%%solarYield%%`, `%%gridExport%%` etc.) allow complete chart layout control via template states
 * statistics: chart output states (`statistics.flexCharts.jsonOutput.hourly` etc.) updated automatically each hour
 
-### 2.4.0 (2026-03-14)
-* fix: the order of bit assignment corrected of alarmsJSON
-* new state `inverter.x.emma.activeAlarmSN` and `inverter.x.emma.HistoricalAlarmSN` : emma alarms  [#226](https://github.com/bolliy/ioBroker.sun2000/issues/226)
-* statistics: Aggregates historical collected datapoints into time-based summaries (e.g. hourly, daily, monthly, yearly). The data is stored in the path `statistics` as JSON.
+[Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## License
 MIT License

package/admin/jsonConfig.json5

@@ -385,6 +385,39 @@
                 }
             }
         },  
+        "tab8": {
+            "type": "panel",
+            "label": "Statistics",
+            "items": {
+                "staticLink1": {
+                    "type": "staticLink",
+                    "text": "Information and settings regarding the statistics explained in the wiki",
+                    "href": "https://github.com/bolliy/ioBroker.sun2000/wiki/Statistk-(statistics)",
+                    "button": true,
+                    "icon": "info",
+                    "newLine": true,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "stat_liveInterval": {
+                    "type": "number",
+                    "label": "Live chart interval (min)",
+                    "min" : 1,
+                    "max" : 15,
+                    "newLine": true,
+                    "tooltip": "Live chart update interval in minutes",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                }     
+            }
+
+        },
         "tab7": {
             "type": "panel",
             "label": "Further Register",

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "sun2000",
-    "version": "2.4.5",
+    "version": "2.5.0",
     "news": {
+      "2.5.0": {
+        "en": "statistics: added live power chart (statistics.jsonLive)\nrequires node.js >= 22",
+        "de": "statistiken: Live Power Chart hinzugefügt (statistics.jsonLive)\nrequires node.js >= 22",
+        "ru": "статистика: добавлена живая диаграмма мощности (statistics.jsonLive)\nrequires node.js >= 22",
+        "pt": "estatísticas: gráfico de potência ao vivo adicionado (statistics.jsonLive)\nrequires node.js >= 22",
+        "nl": "statistieken: toegevoegde live power chart (statistics.jsonLive)",
+        "fr": "statistiques: tableau de puissance en direct ajouté (statistiques.jsonLive)\nrequires node.js >= 22",
+        "it": "statistiche: aggiunto live power chart (statistics.jsonLive)\nrequires node.js >= 22",
+        "es": "estadística: añadido gráfico de potencia en vivo (statistics.jsonLive)\nrequires node.js >= 22",
+        "pl": "statystyki: dodany live power chart (statistics.jsonLive)\nrequires node.js >= 22",
+        "uk": "статистика: додано графік живої потужності (statistics.jsonLive)\nrequires node.js >= 22",
+        "zh-cn": "统计:增加的实电图(统计学.jsonLive)"
+      },
       "2.4.5": {
         "en": "statistics fix: return weekly range up to current Monday\nstatistics: added support for generating statistics templates directly from built-in charts\nstatistics: improved tooltip formatter - tooltip units are now provided explicitly via tooltip.valueFormatter",
         "de": "statistik fix: wöchentliche Rückgabe bis zum aktuellen Montag\nstatistik: unterstützung für die erstellung von statistiken vorlagen direkt aus integrierten diagrammen\nstatistiken: verbesserter Tooltip-Formater - Tooltip-Einheiten werden nun explizit über tooltip.valueFormatter bereitgestellt",
@@ -80,19 +93,6 @@
         "pl": "usunięty stan zdepregatowany \"collected.usableSurplusPower '",
         "uk": "вилучена депресована держава `collected.usableSurplusPower й",
         "zh-cn": "删除已贬值状态“ 已收集。 可使用 SurplusPower `"
-      },
-      "2.3.6": {
-        "en": "dependency and configuration updates\nnew state `inverter.x.derived.alarmsJSON` : json array with intverter alarms (id, name, level) [#226](https://github.com/bolliy/ioBroker.sun2000/issues/226)\nadd ChargeDischargePower for Battery units [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\nadd minimum and maximum temperature for battery packs [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "de": "abhängigkeits- und konfigurationsupdates\nneuer Zustand `inverter.x.derived.alarmsJSON`: json array with intverter alarms (id, name, level) [#226](https://github.com/bolliy/ioBroker.sun2000/issues/226)\nadd ChargeDischargePower for Battery Units [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\nmindest- und Höchsttemperatur für Akkupacks [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "ru": "обновления зависимостей и конфигурации\njson array with intverter alarms (id, name, level) [#226] (https://github.com/bolliy/ioBroker.sun2000/issues/226)\nдобавить ChargeDischargePower для батарейных блоков [#234] (https://github.com/bolliy/ioBroker.sun2000/issues/234)\nдобавить минимальную и максимальную температуру для аккумуляторных батарей [#236] (https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "pt": "atualizações de dependência e configuração\nnovo estado `inverter.x.derived.alarmsJSON` : json array com alarmes de inversor (id, name, level) [#226](https://github.com/bolliy/ioBroker.sun2000/issues/226)\nadicionar ChargeDischargePower for Battery units [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\nadicionar temperatura mínima e máxima para pacotes de bateria [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "nl": "afhankelijkheid en configuratie-updates\nnieuwe staat \nchargeDischargePower for Battery units [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\nminimum- en maximumtemperatuur toevoegen voor batterijpakketten [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "fr": "mises à jour de la dépendance et de la configuration\nnouvel état `inverter.x.derived.alarmsJSON` : tableau json avec alarmes d'intverter (id, nom, niveau) [#226](https://github.com/bolliy/ioBroker.sun2000/issues/226)\najouter ChargeDischargePower pour les unités de batterie [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\najouter la température minimale et maximale pour les batteries [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "it": "aggiornamenti di dipendenza e configurazione\nnuovo stato `inverter.x.derived.alarmsJSON` : json array con allarme intverter (id, nome, livello) [#226](https://github.com/bolliy/ioBroker.sun2000/problems/226)\naggiungi ChargeDischargePower per batterie [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\naggiungere la temperatura minima e massima per le batterie [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "es": "actualizaciones de dependencia y configuración\nnuevo estado `inverter.x.derived.alarmsJSON` : json array with intverter alarms (id, name, level) [#226](https://github.com/bolliy/ioBroker.sun2000/issues/226)\nañadir ChargeDischargePower for Battery units [#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\nañadir la temperatura mínima y máxima para los paquetes de baterías [#236](https://github.com/bolliy/ioBroker.sun2000/issues/236)",
-        "pl": "aktualizacje zależności i konfiguracji\nnowość \"inverter.x.derived.alarmsJSON\": tablica json z alarmami intverter (id, name, level) [# 226] (https: / / github.com / bolliy / ioBroker.sun2000 / issues / 226)\ndata umieszczenia w wykazie\ndodać minimalną i maksymalną temperaturę dla baterii [# 236] (https: / / github.com / bolliy / ioBroker.sun2000 / issues / 236)",
-        "uk": "оновлення залежності та конфігурації\nновий стан `inverter.x.derived.alarmsJSON` : json array with intverter тривоги (id, назва, рівень) [#226](https://github.com/bolliy/ioBroker.sun2000/products/226)\nadd ChargeDischargePower для батарей [#234](https://github.com/bolliy/ioBroker.sun2000/products/234)\nдодайте мінімальну і максимальну температуру для акумуляторних пакетів [#236](https://github.com/bolliy/ioBroker.sun2000/products/236)",
-        "zh-cn": "依赖和配置更新\nnew state `inverter.x. inducted.alarmsJSON ' : json 数组带内置式警报器(id, name, level) [# 226] (https://github.com/bolliy/ioBroker.sun2000/issues/226) (中文(简体) )\n添加电池单位充电放电器[#234](https://github.com/bolliy/ioBroker.sun2000/issues/234)\n增加电池包的最低和最高温度[第236号](https://github.com/bolliy/ioBroker.sun2000/issues/236)"
       }
     },
     "titleLang": {
@@ -251,7 +251,8 @@
     "ds_bu": true,
     "ds_bp": false,
     "cb_tou": false,
-    "integration": 0
+    "integration": 0,
+    "stat_liveInterval": 5
   },
   "objects": [],
   "instanceObjects": [

package/lib/drivers/driver_emma.js

@@ -707,9 +707,9 @@ class Emma extends DriverBase {
 							type: 'number',
 							unit: 'kW',
 							role: 'value.power',
-							desc: 'reg:31651, len:2',
+							desc: 'reg:31665, len:2',
 						},
-						register: { reg: 31651, type: dataType.int32, gain: 1000 },
+						register: { reg: 31665, type: dataType.int32, gain: 1000 },
 					},
 					{
 						state: {
@@ -718,9 +718,9 @@ class Emma extends DriverBase {
 							type: 'number',
 							unit: 'kW',
 							role: 'value.power',
-							desc: 'reg:31653, len:2',
+							desc: 'reg:31667, len:2',
 						},
-						register: { reg: 31653, type: dataType.int32, gain: 1000 },
+						register: { reg: 31667, type: dataType.int32, gain: 1000 },
 					},
 					{
 						state: {
@@ -729,9 +729,9 @@ class Emma extends DriverBase {
 							type: 'number',
 							unit: 'kW',
 							role: 'value.power',
-							desc: 'reg:31655, len:2',
+							desc: 'reg:31669, len:2',
 						},
-						register: { reg: 31655, type: dataType.int32, gain: 1000 },
+						register: { reg: 31669, type: dataType.int32, gain: 1000 },
 					},
 					{
 						state: {

package/lib/drivers/driver_inverter.js

@@ -104,6 +104,19 @@ class InverterSun2000 extends DriverBase {
 			}
 		});
 
+		this.chargeSumHelper = new RiemannSum();
+		this.adapter.getState(`${this.deviceInfo.path}.battery.currentDayChargeCapacity`, (err, state) => {
+			if (!err && state) {
+				this.chargeSumHelper.setStart(state?.val, state?.ts, false);
+			}
+		});
+		this.dischargeSumHelper = new RiemannSum();
+		this.adapter.getState(`${this.deviceInfo.path}.battery.currentDayDischargeCapacity`, (err, state) => {
+			if (!err && state) {
+				this.dischargeSumHelper.setStart(state?.val, state?.ts, false);
+			}
+		});
+
 		this.control = new ServiceQueueMap(this.adapter, this.deviceInfo);
 
 		//https://github.com/ioBroker/ioBroker.docs/blob/master/docs/en/dev/stateroles.md
@@ -222,6 +235,35 @@ class InverterSun2000 extends DriverBase {
 				],
 				//Check if the address field is active
 				checkIfActive: () => this._batteryExists(),
+				postHook: path => {
+					//calculate daily charge and discharge capacity
+					const chargeDischargePower = this.stateCache.get(`${path}battery.chargeDischargePower`)?.value ?? 0;
+					if (chargeDischargePower > 0) this.chargeSumHelper.add(chargeDischargePower); //riemann Sum for charge power
+					if (chargeDischargePower < 0) this.dischargeSumHelper.add(-chargeDischargePower); //riemann Sum for discharge power
+
+					const now = new Date();
+					const minute = now.getMinutes();
+					const hour = now.getHours();
+					//reset at 00:00 - until 00:05 if the inverter is a bit late with the update
+					if (hour !== 0 || minute > 5) {
+						const currentDayChargeCapacity = this.stateCache.get(`${path}battery.currentDayChargeCapacity`)?.value;
+						if (currentDayChargeCapacity !== undefined) {
+							if (!this.chargeSumHelper.startInitialized || currentDayChargeCapacity > this.chargeSumHelper.sum) {
+								this.chargeSumHelper.setStart(currentDayChargeCapacity);
+							}
+						}
+
+						const currentDayDischargeCapacity = this.stateCache.get(`${path}battery.currentDayDischargeCapacity`)?.value;
+						if (currentDayDischargeCapacity !== undefined) {
+							if (!this.dischargeSumHelper.startInitialized || currentDayDischargeCapacity > this.dischargeSumHelper.sum) {
+								this.dischargeSumHelper.setStart(currentDayDischargeCapacity);
+							}
+						}
+					}
+
+					this.stateCache.set(`${path}battery.statistics.currentDayChargeCapacity`, this.chargeSumHelper.sum, { type: 'number', stored: true }); //stored for statistics
+					this.stateCache.set(`${path}battery.statistics.currentDayDischargeCapacity`, this.dischargeSumHelper.sum, { type: 'number', stored: true }); //stored for statistics
+				},
 			},
 			{
 				address: 32064,
@@ -236,7 +278,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Input power',
 							type: 'number',
 							unit: 'kW',
-							role: 'value.power.produced',
+							role: 'value.power',
 							desc: 'reg:32064, len:2, Power from solar',
 						},
 						register: { reg: 32064, type: dataType.int32, gain: 1000 },
@@ -465,7 +507,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:38238, len:2',
 						},
 						register: { reg: 38238, type: dataType.uint32, gain: 100 },
@@ -476,7 +518,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:38240, len:2',
 						},
 						register: { reg: 38240, type: dataType.uint32, gain: 100 },
@@ -508,7 +550,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:38280, len:2',
 						},
 						register: { reg: 38280, type: dataType.uint32, gain: 100 },
@@ -519,7 +561,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:38282, len:2',
 						},
 						register: { reg: 38282, type: dataType.uint32, gain: 100 },
@@ -551,7 +593,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:38322, len:2',
 						},
 						register: { reg: 38322, type: dataType.uint32, gain: 100 },
@@ -562,7 +604,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:38324, len:2',
 						},
 						register: { reg: 38324, type: dataType.uint32, gain: 100 },
@@ -843,7 +885,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:37780, len:2',
 						},
 						register: { reg: 37780, type: dataType.uint32, gain: 100 },
@@ -854,7 +896,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:37782, len:2',
 						},
 						register: { reg: 37782, type: dataType.uint32, gain: 100 },
@@ -865,10 +907,11 @@ class InverterSun2000 extends DriverBase {
 							name: 'Current day charge capacity',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:37784, len:2',
 						},
 						register: { reg: 37784, type: dataType.uint32, gain: 100 },
+						//store: storeType.never,
 					},
 					{
 						state: {
@@ -876,10 +919,11 @@ class InverterSun2000 extends DriverBase {
 							name: 'Current day discharge capacity',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:37786, len:2',
 						},
 						register: { reg: 37786, type: dataType.uint32, gain: 100 },
+						//store: storeType.never,
 					},
 				],
 				checkIfActive: () => this._batteryExists(),
@@ -1466,7 +1510,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Positive active energy',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:37119, len:2',
 						},
 						register: { reg: 37119, type: dataType.int32, gain: 100 },
@@ -1477,7 +1521,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Reverse active energy',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:37121, len:2',
 						},
 						register: { reg: 37121, type: dataType.int32, gain: 100 },
@@ -1488,7 +1532,7 @@ class InverterSun2000 extends DriverBase {
 							name: 'Accumulated reactive power',
 							type: 'number',
 							unit: 'kVarh',
-							role: 'value.power.reactive.consumption',
+							role: 'value.power.reactive.consumed',
 							desc: 'reg:37123, len:2',
 						},
 						register: { reg: 37123, type: dataType.int32, gain: 100 },
@@ -1643,7 +1687,7 @@ class InverterSun2000 extends DriverBase {
 					name: 'Portal yield today',
 					type: 'number',
 					unit: 'kWh',
-					role: 'value.power.consumption',
+					role: 'value.power.produced',
 					desc: 'yield from the portal',
 				},
 				fn: path => {
@@ -1666,7 +1710,7 @@ class InverterSun2000 extends DriverBase {
 					name: 'Solar yield today',
 					type: 'number',
 					unit: 'kWh',
-					role: 'value.power.consumption',
+					role: 'value.power.produced',
 					desc: 'Riemann sum of input power with efficiency loss',
 				},
 				fn: path => {
@@ -1680,7 +1724,7 @@ class InverterSun2000 extends DriverBase {
 					name: 'Active Energy today',
 					type: 'number',
 					unit: 'kWh',
-					role: 'value.power.consumption',
+					role: 'value.power.produced',
 					desc: 'Amount of Riemann sum of sum of active power',
 				},
 				fn: path => {
@@ -2104,7 +2148,7 @@ class InverterSun2000_M1 extends InverterSun2000 {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:38364, len:2',
 						},
 						register: { reg: 38364, type: dataType.uint32, gain: 100 },
@@ -2115,7 +2159,7 @@ class InverterSun2000_M1 extends InverterSun2000 {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:38366, len:2',
 						},
 						register: { reg: 38366, type: dataType.uint32, gain: 100 },
@@ -2147,7 +2191,7 @@ class InverterSun2000_M1 extends InverterSun2000 {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:38406, len:2',
 						},
 						register: { reg: 38406, type: dataType.uint32, gain: 100 },
@@ -2158,7 +2202,7 @@ class InverterSun2000_M1 extends InverterSun2000 {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:38408, len:2',
 						},
 						register: { reg: 38408, type: dataType.uint32, gain: 100 },
@@ -2190,7 +2234,7 @@ class InverterSun2000_M1 extends InverterSun2000 {
 							name: 'Total charge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.consumed',
 							desc: 'reg:38448, len:2',
 						},
 						register: { reg: 38448, type: dataType.uint32, gain: 100 },
@@ -2201,7 +2245,7 @@ class InverterSun2000_M1 extends InverterSun2000 {
 							name: 'Total discharge',
 							type: 'number',
 							unit: 'kWh',
-							role: 'value.power.consumption',
+							role: 'value.power.produced',
 							desc: 'reg:38450, len:2',
 						},
 						register: { reg: 38450, type: dataType.uint32, gain: 100 },

package/lib/json_helper.js

@@ -3,7 +3,7 @@
 /**
  * Serializes an object to JSON, converting functions to their string representation.
  *
- * @param {any} obj - The object to serialize.
+ * @param {object} obj - The object to serialize.
  * @returns {string} JSON string where functions are represented as strings.
  */
 function stringifyWithFunctions(obj) {
@@ -22,30 +22,8 @@ function stringifyWithFunctions(obj) {
 		2,
 	);
 }
-/*
-const FUNCTION_KEYS = ['formatter', 'render', 'parser'];
 
-function reviveFunctions(obj, key = '') {
-	if (typeof obj === 'string' && FUNCTION_KEYS.includes(key)) {
-		const str = obj.trim();
-
-		try {
-			return new Function(`return (${str})`)();
-		} catch {
-			return obj;
-		}
-	}
-
-	if (typeof obj === 'object' && obj !== null) {
-		for (const k in obj) {
-			obj[k] = reviveFunctions(obj[k], k);
-		}
-	}
-
-	return obj;
-}
-*/
-const FUNCTION_KEYS = ['formatter', 'parser', 'render', 'labelFormatter', 'valueFormatter', 'position'];
+const FUNCTION_KEYS = ['formatter', 'parser', 'render', 'labelFormatter', 'valueFormatter', 'position', 'interval'];
 
 function reviveFunctions(obj, key = '') {
 	if (typeof obj === 'string' && FUNCTION_KEYS.includes(key)) {
@@ -109,7 +87,7 @@ function deepMerge(target, source) {
  *
  * @param {object} obj - The object to modify.
  * @param {string} path - Dot‑separated path (e.g., "a.b.c").
- * @param {any} value - The value to set at the specified path.
+ * @param {string} value - The value to set at the specified path.
  */
 function setByPath(obj, path, value) {
 	const keys = path.split('.');

package/lib/modbus/modbus_server.js

@@ -194,7 +194,7 @@ class ModbusServer {
 	 * @param {number} startAddr The start address of the register.
 	 * @param {number} length The length of the register.
 	 * @param {number} unitId The modbus unitId.
-	 * @param {Function} callback The callback function.
+	 * @param {callback} callback The callback function.
 	 * @returns {Promise<void>}
 	 */