iobroker.sun2000 0.1.2-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 bolliy <stephan@mante.info>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+![Logo](admin/sun2000.png)
+# ioBroker.sun2000
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.sun2000.svg)](https://www.npmjs.com/package/iobroker.sun2000)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.sun2000.svg)](https://www.npmjs.com/package/iobroker.sun2000)
+![Number of Installations](https://iobroker.live/badges/sun2000-installed.svg)
+![Current version in stable repository](https://iobroker.live/badges/sun2000-stable.svg)
+
+[![NPM](https://nodei.co/npm/iobroker.sun2000.png?downloads=true)](https://nodei.co/npm/iobroker.sun2000/)
+
+**Tests:** ![Test and Release](https://github.com/bolliy/ioBroker.sun2000/workflows/Test%20and%20Release/badge.svg)
+
+## sun2000 adapter for ioBroker
+
+Read register data from Huawei SUN2000 inverter and LUNA2000 battery using Modbus TCP. 
+
+Modbus interface definition (Issue 5, 2023-02-16):
+https://forum.iobroker.net/assets/uploads/files/1699119419919-solar-inverter-modbus-interface-definitions-v5.pdf
+
+The development of this adapter was inspired by discussions from the forum thread https://forum.iobroker.net/topic/53005/huawei-sun2000-iobroker-via-js-script-funktioniert and the iobroker javascript https://github.com/ChrisBCH/SunLuna2000_iobroker.
+
+## Supported hardware
+
+* HUAWEI Inverter (SUN2000 Serie) M1 
+* HUAWEI Smart Dongle-WLAN-FE / min. Softwareversion: xxxSPC133 (SDongleA-05)
+* HUAWEI Luna2000 Battery
+* HUAWEI Smart Power Sensor DTSU666-H or DDSU666-H
+
+## Feature list
+
+* Maximum 5 inverters (master/slave) can be processed, each with a battery module (max. 30kWh).
+* Live data such as input power , output power , battery charging/discharging power and the grid consumption (meter.activePower) are read out at a fixed interval (default 20 seconds).
+* States are only written for changed data from the inverter. This relieves the burden on the iobroker instance.
+* The states “inputPower” or “activePower” in the “collected” path can be monitored with a “was updated” trigger element. Because these states are always written within the set interval.
+
+## Configure inverters
+
+In order to use the Modbus connection, all Huawei devices must use the latest firmware
+feature. You can perform latest firmware directly in the FusionSolar portal under “Upgrades”.
+In the FusionSolar setup you still have to activate the Modbus on the WLAN dongle and set the access authorization. Download the FusionSolar-App onto your cell phone and use it to connect via the inverter's WLAN hotspot directly.  
+After the click on `Me` (Ich) in the footer Menu> `Commission Device` ("Inbetriebnahme des Geräts“) > `log in` (am Wechselrichter anmelden).
+
+To log into the app as an `installer` you need usually the password:`00000a` or `0000000a` 
+You may also need a password to connect to the inverters own WLAN: `Changeme` 
+
+After login on the inverter go to `Settings` (Einstellungen) > `Communication configuration` (Kommunikationskonfiguration) > `Dongle parameter settings` (Dongle‐Parametereinstellungen) > `Modbus TCP` > Activate the `connection without restriction` (Verbindung uneingeschränkt aktivieren). You can also enter the Modbus comm address at the same time read out. 
+If you use two inverters, then connect to the second inverter and read the communication address there too. A maximum of 2 inverters can be connected via Modbus. 
+
+
+## Settings
+
+* `address`: Inverter IP address
+* `port`: Inverter modbus port (default: 502)
+* `modbusIds`: inverter IDs, separated with "," (default: 1, max. 5 inverters)
+* `updateInterval`: Fast update interval (default: 20 sec)
+
+## Changelog
+<!--
+	Placeholder for the next version (at the beginning of the line):
+	### **WORK IN PROGRESS**
+-->
+### 0.1.2-alpha.1 (2024-01-11)
+* deploy npm package
+
+### 0.1.2-alpha.0 (2024-01-11)
+* prepare collected values more precisely
+* expand up to 5 inverters #18
+* fix problems with multiple inverters
+
+### 0.1.1 (2024-01-07)
+* fix some collected values
+
+### 0.1.0 (2024-01-06)
+* watchdog implemented #11
+* state values are cached - only changed data should be stored 
+* derived and collected values for example `inputPowerEffective` or `inputYield`
+* deploy more register
+
+### 0.0.2 (2023-12-19)
+Dependency and configuration updates
+
+### 0.0.1 
+initial release
+
+## License
+MIT License
+
+Copyright (c) 2024 bolliy <stephan@mante.info>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/admin/i18n/de/translations.json

@@ -0,0 +1,10 @@
+{
+    "sun2000 adapter settings": "Adaptereinstellungen für sun2000",
+    "Address": "IP-Adresse des Wechselrichters",
+    "address": "IP-Adresse (koien) des Wechselrichters",
+    "Port": "Modbus-TCP-Port",
+    "Modbus unit ID": "Modbus-Einheits-ID",
+    "port": "modbus TCP port",
+    "Update interval (s)": "Update interval",
+    "Modbus Inverter ID": "Modbus-Wechselrichter-ID"
+}

package/admin/i18n/en/translations.json

@@ -0,0 +1,7 @@
+{
+	"sun2000 adapter settings": "Adapter settings for huawai inverter sun2000",
+	"address": "Inverter IP address",
+	"port": "modbus TCP port",
+	"Modbus Inverter ID" : "Modbus Inverter ID",
+	"Update interval (s)": "Update interval [sec]"
+}

package/admin/i18n/es/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Ajustes del adaptador para sun2000",
+    "option1": "Opción 1",
+    "option2": "opcion 2",
+    "Address": "Dirección IP del inversor",
+    "Port": "puerto modbus tcp",
+    "Modbus unit ID": "ID de unidad Modbus",
+    "address": "Inverter IP address",
+    "port": "Puerto TCP Modbus",
+    "Update interval (s)": "Intervalo de actualización",
+    "Modbus Inverter ID": "ID del inversor Modbus"
+}

package/admin/i18n/fr/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Paramètres d'adaptateur pour sun2000",
+    "option1": "Option 1",
+    "option2": "Option 2",
+    "Address": "Adresse IP de l'onduleur",
+    "Port": "port TCP Modbus",
+    "Modbus unit ID": "ID de l'unité Modbus",
+    "address": "Adresse IP de l'onduleur",
+    "port": "port TCP Modbus",
+    "Update interval (s)": "Intervalle de mise à jour",
+    "Modbus Inverter ID": "ID de l'onduleur Modbus"
+}

package/admin/i18n/it/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Impostazioni dell'adattatore per sun2000",
+    "option1": "opzione 1",
+    "option2": "opzione 2",
+    "Address": "Indirizzo IP dell'inverter",
+    "Port": "porta tcp modbus",
+    "Modbus unit ID": "ID unità Modbus",
+    "address": "Indirizzo IP dell'inverter",
+    "port": "porta TCP Modbus",
+    "Update interval (s)": "Intervallo di aggiornamento",
+    "Modbus Inverter ID": "ID dell'inverter Modbus"
+}

package/admin/i18n/nl/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Adapterinstellingen voor sun2000",
+    "option1": "Optie 1",
+    "option2": "Optie 2",
+    "Address": "IP-adres van de omvormer",
+    "Port": "modbus tcp-poort",
+    "Modbus unit ID": "Modbus-eenheid-ID",
+    "address": "IP-adres van de omvormer",
+    "port": "modbus TCP-poort",
+    "Update interval (s)": "Bijwerkingsonderbreking",
+    "Modbus Inverter ID": "Modbus-omvormer-ID"
+}

package/admin/i18n/pl/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Ustawienia adaptera dla sun2000",
+    "option1": "opcja 1",
+    "option2": "Opcja 2",
+    "Address": "Adres IP falownika",
+    "Port": "port Modbus TCP",
+    "Modbus unit ID": "Identyfikator jednostki Modbus",
+    "address": "Adres IP falownika",
+    "port": "portu Modbus TCP",
+    "Update interval (s)": "Interwał aktualizacji",
+    "Modbus Inverter ID": "Identyfikator falownika Modbus"
+}

package/admin/i18n/pt/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Configurações do adaptador para sun2000",
+    "option1": "Opção 1",
+    "option2": "opção 2",
+    "Address": "Endereço IP do inversor",
+    "Port": "porta modbus tcp",
+    "Modbus unit ID": "ID da unidade Modbus",
+    "address": "Endereço IP do inversor",
+    "port": "porta modbus TCP",
+    "Update interval (s)": "Intervalo de atualização",
+    "Modbus Inverter ID": "ID do inversor Modbus"
+}

package/admin/i18n/ru/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Настройки адаптера для sun2000",
+    "option1": "Опция 1",
+    "option2": "вариант 2",
+    "Address": "IP-адрес инвертора",
+    "Port": "TCP-порт Modbus",
+    "Modbus unit ID": "Идентификатор устройства Modbus",
+    "address": "IP-адрес инвертора",
+    "port": "TCP-порт Modbus",
+    "Update interval (s)": "Интервал обновления",
+    "Modbus Inverter ID": "Идентификатор преобразователя Modbus"
+}

package/admin/i18n/uk/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "Налаштування адаптера для sun2000",
+    "option1": "варіант1",
+    "option2": "варіант2",
+    "Address": "IP-адреса інвертора",
+    "Port": "порт modbus tcp",
+    "Modbus unit ID": "ID пристрою Modbus",
+    "address": "IP-адреса інвертора",
+    "port": "порт Modbus TCP",
+    "Update interval (s)": "Інтервал оновлення",
+    "Modbus Inverter ID": "Ідентифікатор інвертора Modbus"
+}

package/admin/i18n/zh-cn/translations.json

@@ -0,0 +1,12 @@
+{
+    "sun2000 adapter settings": "sun2000的适配器设置",
+    "option1": "选项1",
+    "option2": "选项2",
+    "Address": "逆变器IP地址",
+    "Port": "MODBUS TCP 端口",
+    "Modbus unit ID": "Modbus 单元 ID",
+    "address": "逆变器IP地址",
+    "port": "Modbus TCP 端口",
+    "Update interval (s)": "更新间隔",
+    "Modbus Inverter ID": "Modbus 逆变器 ID"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,33 @@
+{
+    "i18n": true,
+    "type": "panel",
+    "items": {
+        "address": {
+            "type": "text",
+            "label": "address",
+            "newLine": false,
+            "tooltip": "The inverters ip address"
+        },
+        "port": {
+            "type": "number",
+            "label": "port",
+            "default": 502,
+            "newLine": true,
+            "tooltip": "The modbus TCP port"
+        },
+        "modbusIds": {
+            "type": "text",
+            "label": "Modbus Inverter IDs",
+            "default": "1",
+            "newLine": true,
+            "tooltip": "The modbus inverter IDs, separated with character \",\""
+        },
+        "updateInterval": {
+            "type": "number",
+            "label": "Update interval (s)",
+            "default": 20,
+            "newLine": true,
+            "tooltip": "Update interval to update the values from the inverters"
+        }
+    }
+}

package/io-package.json

@@ -0,0 +1,206 @@
+{
+  "common": {
+    "name": "sun2000",
+    "version": "0.1.2-alpha.1",
+    "news": {
+      "0.1.2-alpha.1": {
+        "en": "deploy npm package",
+        "de": "npm paket bereitstellen",
+        "ru": "развернуть пакет npm",
+        "pt": "implementar pacote npm",
+        "nl": "npm-pakket implementeren",
+        "fr": "déployer le paquet npm",
+        "it": "distribuire il pacchetto npm",
+        "es": "paquete npm",
+        "pl": "rozmieszczenie pakietu npm",
+        "uk": "пакет npm",
+        "zh-cn": "部署 npm 软件包"
+      },
+      "0.1.2-alpha.0": {
+        "en": "prepare collected values more precisely\nexpand up to 5 inverters #18\nfix problems with multiple inverters",
+        "de": "die gesammelten werte genauer\nbis zu 5 wechselrichtern #18 erweitern\nprobleme mit mehreren wechselrichtern beheben",
+        "ru": "готовить собранные значения точнее\n#18\nисправить проблемы с несколькими инверторами",
+        "pt": "preparar valores coletados mais precisamente\nexpandir até 5 inversores #18\ncorrigir problemas com vários inversores",
+        "nl": "verzamelde waarden nauwkeuriger voorbereiden\nuit te breiden tot 5 omvormers #18\nproblemen oplossen met meerdere inverters",
+        "fr": "préparer plus précisément les valeurs collectées\nétendre jusqu'à 5 onduleurs #18\nrésoudre les problèmes avec plusieurs onduleurs",
+        "it": "preparare i valori raccolti più precisamente\nespandere fino a 5 inverter #18\nrisolvere problemi con più inverter",
+        "es": "preparar los valores recogidos con mayor precisión\nampliar hasta 5 inversores #18\nsolucionar problemas con múltiples inversores",
+        "pl": "dokładniej przygotować zebrane wartości\nrozszerzyć do 5 inwerterów # 18\nrozwiązać problemy z wieloma inwerterami",
+        "uk": "підготовка зібраних значень точно\nрозширити до 5 інверторів #18\nвиправити проблеми з декількома інверторами",
+        "zh-cn": "更准确地编制收集的数值\n扩展至5个反转器 # 18\n解决多个反转器的问题"
+      },
+      "0.1.1": {
+        "en": "fix some collected values",
+        "de": "Korrektur einiger der gesammelten Werte (collected values)"
+      }
+    },
+    "titleLang": {
+      "en": "sun2000",
+      "de": "sun2000",
+      "ru": "солнце2000",
+      "pt": "sol2000",
+      "nl": "zon2000",
+      "fr": "soleil2000",
+      "it": "sole2000",
+      "es": "sol2000",
+      "pl": "słońce2000",
+      "uk": "sun2000",
+      "zh-cn": "太阳2000"
+    },
+    "desc": {
+      "en": "Read data from Huawei SUN2000 inverter and LUNA2000 battery using Modbus TCP\n",
+      "de": "Lesen Sie die Daten von Huawei SUN2000 Wechselrichter und LUNA2000 Akku mit Modbus TCP\n",
+      "ru": "Прочитайте данные от Huawei SUN2000 inverter и LUNA2000 батареи с помощью Modbus TCP\n",
+      "pt": "Leia dados do inversor Huawei SUN2000 e da bateria LUNA2000 usando Modbus TCP\n",
+      "nl": "Lees gegevens van Huawei SUN2000 inverter en LUNA2000 batterij met Modbus TCP\n",
+      "fr": "Lire les données de Huawei SUN2000 inverter et batterie LUNA2000 en utilisant Modbus TCP\n",
+      "it": "Leggi i dati dell'inverter Huawei SUN2000 e della batteria LUNA2000 utilizzando Modbus TCP\n",
+      "es": "Lea los datos de la batería Huawei SUN2000 inverter y LUNA2000 utilizando Modbus TCP\n",
+      "pl": "Dane z inwersatora Huawei SUN2000 i baterii LUNA2000 za pomocą modułu TCP\n",
+      "uk": "Читання даних від Huawei SUN2000 і LUNA2000 батареї за допомогою Modbus TCP\n",
+      "zh-cn": "使用Modbus TCPT2000 verter和LUN2000电池的阅读数据\n"
+    },
+    "authors": [
+      "bolliy <stephan@mante.info>"
+    ],
+    "keywords": [
+      "huawei",
+      "modbus",
+      "sun2000",
+      "luna2000",
+      "inverter"
+    ],
+    "license": "MIT",
+    "platform": "Javascript/Node.js",
+    "main": "main.js",
+    "icon": "sun2000.png",
+    "enabled": true,
+    "extIcon": "https://raw.githubusercontent.com/bolliy/ioBroker.sun2000/main/admin/sun2000.png",
+    "readme": "https://github.com/bolliy/ioBroker.sun2000/blob/main/README.md",
+    "loglevel": "info",
+    "mode": "daemon",
+    "type": "energy",
+    "compact": true,
+    "connectionType": "local",
+    "dataSource": "poll",
+    "adminUI": {
+      "config": "json"
+    },
+    "dependencies": [
+      {
+        "js-controller": ">=3.3.22"
+      }
+    ],
+    "globalDependencies": [
+      {
+        "admin": ">=5.1.13"
+      }
+    ]
+  },
+  "native": {
+    "address": "",
+    "port": 502,
+    "modbusIds": "1",
+    "updateInterval": 20
+  },
+  "objects": [],
+  "instanceObjects": [
+    {
+      "_id": "info",
+      "type": "channel",
+      "common": {
+        "name": {
+          "en": "Information",
+          "de": "Informationen",
+          "ru": "Информация",
+          "pt": "Informação",
+          "nl": "Informatie",
+          "fr": "Information",
+          "it": "Informazioni",
+          "es": "Información",
+          "pl": "Informacja",
+          "uk": "Інформація",
+          "zh-cn": "信息"
+        },
+        "role": "info"
+      },
+      "native": {}
+    },
+    {
+      "_id": "info.connection",
+      "type": "state",
+      "common": {
+        "name": {
+          "en": "Inverter connected",
+          "de": "Wechselrichter angeschlossen"
+        },
+        "type": "boolean",
+        "role": "indicator.connected",
+        "read": true,
+        "write": false,
+        "desc": "Is the inverter connected?"
+      }
+    },
+    {
+      "_id": "info.ip",
+      "type": "state",
+      "common": {
+        "name": {
+          "en": "Inverter IP",
+          "de": "Inverter IP"
+        },
+        "type": "string",
+        "role": "indicator.ip",
+        "read": true,
+        "write": false,
+        "desc": "Inverter IP address"
+      }
+    },
+    {
+      "_id": "info.port",
+      "type": "state",
+      "common": {
+        "name": {
+          "en": "Modbus port",
+          "de": "Modbusport"
+        },
+        "type": "number",
+        "role": "indicator.port",
+        "read": true,
+        "write": false,
+        "desc": "Inverter modbus port"
+      }
+    },
+    {
+      "_id": "info.modbusIds",
+      "type": "state",
+      "common": {
+        "name": {
+          "en": "Secondary Modbus inverter ID",
+          "de": "Modbus ID des 2ten Wechselrichters"
+        },
+        "type": "string",
+        "role": "indicator.id",
+        "read": true,
+        "write": false,
+        "desc": "Inverter modbus inverter IDs"
+      }
+    },
+    {
+      "_id": "info.modbusUpdateInterval",
+      "type": "state",
+      "common": {
+        "name": {
+          "en": "modbus update interval",
+          "de": "modbus Update Intervall"
+        },
+        "type": "number",
+        "role": "value",
+        "read": true,
+        "write": false,
+        "desc": "modbus update interval",
+        "unit": "sec"
+      }
+    }
+  ]
+}

package/lib/adapter-config.d.ts

@@ -0,0 +1,19 @@
+// This file extends the AdapterConfig type from "@types/iobroker"
+// using the actual properties present in io-package.json
+// in order to provide typings for adapter.config properties
+
+import { native } from '../io-package.json';
+
+type _AdapterConfig = typeof native;
+
+// Augment the globally declared type ioBroker.AdapterConfig
+declare global {
+	namespace ioBroker {
+		interface AdapterConfig extends _AdapterConfig {
+			// Do not enter anything here!
+		}
+	}
+}
+
+// this is required so the above AdapterConfig is found by TypeScript / type checking
+export {};