iobroker.foxesscloud 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 skvarel <skvarel@inventwo.com>
+
+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/foxesscloud-logo.png)
+
+## ioBroker adapter for FoxESS Cloud
+
+![Number of Installations](https://iobroker.live/badges/foxesscloud-installed.svg) ![Current version in stable repository](https://iobroker.live/badges/foxesscloud-stable.svg)
+[![NPM version](https://img.shields.io/npm/v/iobroker.foxesscloud.svg)](https://www.npmjs.com/package/iobroker.foxesscloud)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.foxesscloud.svg)](https://www.npmjs.com/package/iobroker.foxesscloud)
+
+[![Paypal Donation](https://img.shields.io/badge/paypal-donate%20|%20spenden-green.svg)](https://www.paypal.com/donate/?hosted_button_id=7W6M3TFZ4W9LW)
+
+## What this adapter does
+
+Retrieves real-time data from FoxESS Cloud API for solar inverters (e.g., used in Enpal systems) and exposes ioBroker states for home automation:
+
+- Monitor solar power production in real-time
+- Track battery state of charge (SoC)
+- Analyze grid consumption and feed-in power
+- Automate based on power generation
+- Visualize energy flows in ioBroker dashboards
+
+## Features
+
+### Power Values
+- **`pvPower`**: Current PV power generation (kW)
+- **`generationPower`**: Total generation/output power (kW)
+- **`load`**: Current load/consumption power (kW)
+- **`gridConsumption`**: Power imported from grid (kW)
+- **`feedinPower`**: Power exported to grid (kW)
+
+### Battery
+- **`soc`**: Battery state of charge (%)
+- **`batCharge`**: Battery charging power (kW)
+- **`batDischarge`**: Battery discharging power (kW)
+
+### Connection Status
+- **`info.connection`**: Connection status in**1440 calls per day**. With an interval of 60 seconds, this limit is perfectly utilized (1440 minutes = 24 hours).
+
+## Data Points
+
+The adapter creates the following data points:
+
+- `foxesscloud.0.pvPower` - PV Power (kW)
+- `foxesscloud.0.generationPower` - Generation Power/Output (kW)
+- `foxesscloud.0.soc` - Battery State of Charge (%)
+- `foxesscloud.0.load` - Load Power (kW)
+- `foxesscloud.0.gridConsumption` - Grid Consumption/Import (kW)
+- `foxesscloud.0.feedinPower` - Feed-in/Export Power (kW)
+- `foxesscloud.0.batCharge` - Battery Charge Power (kW)
+- `foxesscloud.0.batDischarge` - Battery Discharge Power (kW)
+- `foxesscloud.0.info.connection` - Connection status
+
+## Installation
+
+1. Install the adapter from the ioBroker admin interface
+2. Create a new instance
+3. Configure:
+   - **API Token**: Your API key from the FoxESS Cloud portal
+   - **Serial Number (SN)**: The serial number of your inverter
+   - **Update Interval**: Data refresh interval in seconds (default: 60, minimum: 60)
+4. Save and start the instance
+
+### How to get your API credentials
+
+1. Log in to [FoxESS Cloud](https://www.foxesscloud.com)
+2. Go to your profile/settings
+3. Generate an API key (token)
+4. Find your inverter serial number in the device list
+
+## Privacy & Data Handling
+
+- This adapter only reads data from **FoxESS Cloud API** using your personal API token
+- Your API token is stored encrypted in the ioBroker database
+
+## Changelog
+<!--
+	### **WORK IN PROGRESS**
+-->
+### 0.1.0 (2026-01-22)
+- Initial release
+
+## Older changes
+- [CHANGELOG_OLD.md](CHANGELOG_OLD.md)
+
+## License
+
+MIT License
+
+Copyright (c) 2026 skvarel <skvarel@inventwo.com>
+
+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/adapter-config.d.ts

@@ -0,0 +1,15 @@
+// This file extends the AdapterConfig type from "@types/iobroker"
+
+// Augment the globally declared type ioBroker.AdapterConfig
+declare global {
+    namespace ioBroker {
+        interface AdapterConfig {
+            token: string;
+            sn: string;
+            interval: number;
+        }
+    }
+}
+
+// this is required so the above AdapterConfig is found by TypeScript / type checking
+export {};

package/admin/i18n/de.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "API-Token",
+    "API-Key aus der FoxESS Cloud": "API-Schlüssel vom FoxESS Cloud-Portal",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Aufrufe/Tag)",
+    "FoxESS Cloud API Configuration": "FoxESS Cloud API-Konfiguration",
+    "Serial Number (SN)": "Seriennummer (SN)",
+    "Seriennummer vom Inverter": "Seriennummer des Wechselrichters",
+    "Update Interval (seconds)": "Aktualisierungsintervall (Sekunden)"
+}

package/admin/i18n/en.json

@@ -0,0 +1,9 @@
+{
+    "FoxESS Cloud API Configuration": "FoxESS Cloud API Configuration",
+    "API Token": "API Token",
+    "API-Key aus der FoxESS Cloud": "API key from the FoxESS Cloud portal",
+    "Serial Number (SN)": "Serial Number (SN)",
+    "Seriennummer vom Inverter": "Serial number of the inverter",
+    "Update Interval (seconds)": "Update Interval (seconds)",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Update interval in seconds (Recommended: 60, Minimum: 60, API limit: 1440 calls/day)"
+}

package/admin/i18n/es.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "Ficha API",
+    "API-Key aus der FoxESS Cloud": "Clave API del portal FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Intervalo de actualización en segundos (recomendado: 60, mínimo: 60, límite de API: 1440 llamadas/día)",
+    "FoxESS Cloud API Configuration": "Configuración de la API de la nube FoxESS",
+    "Serial Number (SN)": "Número de serie (SN)",
+    "Seriennummer vom Inverter": "Número de serie del inversor",
+    "Update Interval (seconds)": "Intervalo de actualización (segundos)"
+}

package/admin/i18n/fr.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "Jeton API",
+    "API-Key aus der FoxESS Cloud": "Clé API du portail FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Intervalle de mise à jour en secondes (Recommandé : 60, Minimum : 60, Limite API : 1 440 appels/jour)",
+    "FoxESS Cloud API Configuration": "Configuration de l'API cloud FoxESS",
+    "Serial Number (SN)": "Numéro de série (SN)",
+    "Seriennummer vom Inverter": "Numéro de série de l'onduleur",
+    "Update Interval (seconds)": "Intervalle de mise à jour (secondes)"
+}

package/admin/i18n/it.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "Token API",
+    "API-Key aus der FoxESS Cloud": "Chiave API dal portale FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Intervallo di aggiornamento in secondi (consigliato: 60, minimo: 60, limite API: 1440 chiamate/giorno)",
+    "FoxESS Cloud API Configuration": "Configurazione API FoxESS Cloud",
+    "Serial Number (SN)": "Numero di serie (SN)",
+    "Seriennummer vom Inverter": "Numero di serie dell'inverter",
+    "Update Interval (seconds)": "Intervallo di aggiornamento (secondi)"
+}

package/admin/i18n/nl.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "API-token",
+    "API-Key aus der FoxESS Cloud": "API-sleutel van het FoxESS Cloud-portaal",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Update-interval in seconden (aanbevolen: 60, minimum: 60, API-limiet: 1440 oproepen/dag)",
+    "FoxESS Cloud API Configuration": "FoxESS Cloud API-configuratie",
+    "Serial Number (SN)": "Serienummer (SN)",
+    "Seriennummer vom Inverter": "Serienummer van de omvormer",
+    "Update Interval (seconds)": "Update-interval (seconden)"
+}

package/admin/i18n/pl.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "Token API",
+    "API-Key aus der FoxESS Cloud": "Klucz API z portalu FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Interwał aktualizacji w sekundach (zalecany: 60, minimalnie: 60, limit API: 1440 połączeń/dzień)",
+    "FoxESS Cloud API Configuration": "Konfiguracja API chmury FoxESS",
+    "Serial Number (SN)": "Numer seryjny (SN)",
+    "Seriennummer vom Inverter": "Numer seryjny falownika",
+    "Update Interval (seconds)": "Interwał aktualizacji (sekundy)"
+}

package/admin/i18n/pt.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "Token de API",
+    "API-Key aus der FoxESS Cloud": "Chave API do portal FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Intervalo de atualização em segundos (recomendado: 60, mínimo: 60, limite de API: 1.440 chamadas/dia)",
+    "FoxESS Cloud API Configuration": "Configuração da API de nuvem FoxESS",
+    "Serial Number (SN)": "Número de série (SN)",
+    "Seriennummer vom Inverter": "Número de série do inversor",
+    "Update Interval (seconds)": "Intervalo de atualização (segundos)"
+}

package/admin/i18n/ru.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "API-токен",
+    "API-Key aus der FoxESS Cloud": "API-ключ от портала FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Интервал обновления в секундах (рекомендуется: 60, минимум: 60, лимит API: 1440 вызовов в день)",
+    "FoxESS Cloud API Configuration": "Конфигурация облачного API FoxESS",
+    "Serial Number (SN)": "Серийный номер (SN)",
+    "Seriennummer vom Inverter": "Серийный номер инвертора",
+    "Update Interval (seconds)": "Интервал обновления (секунды)"
+}

package/admin/i18n/uk.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "Маркер API",
+    "API-Key aus der FoxESS Cloud": "Ключ API з порталу FoxESS Cloud",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "Інтервал оновлення в секундах (рекомендовано: 60, мінімум: 60, обмеження API: 1440 викликів/день)",
+    "FoxESS Cloud API Configuration": "Конфігурація FoxESS Cloud API",
+    "Serial Number (SN)": "Серійний номер (SN)",
+    "Seriennummer vom Inverter": "Серійний номер інвертора",
+    "Update Interval (seconds)": "Інтервал оновлення (секунди)"
+}

package/admin/i18n/zh-cn.json

@@ -0,0 +1,9 @@
+{
+    "API Token": "API令牌",
+    "API-Key aus der FoxESS Cloud": "来自 FoxESS Cloud 门户的 API 密钥",
+    "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)": "更新间隔（以秒为单位）（建议：60，最低：60，API 限制：1440 次调用/天）",
+    "FoxESS Cloud API Configuration": "FoxESS云API配置",
+    "Serial Number (SN)": "序列号 (SN)",
+    "Seriennummer vom Inverter": "逆变器序列号",
+    "Update Interval (seconds)": "更新间隔（秒）"
+}

package/admin/jsonConfig.json

@@ -0,0 +1,44 @@
+{
+    "i18n": true,
+    "type": "panel",
+    "items": {
+        "_info": {
+            "type": "header",
+            "text": "FoxESS Cloud API Configuration",
+            "size": 3
+        },
+        "token": {
+            "type": "password",
+            "label": "API Token",
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12,
+            "help": "API-Key aus der FoxESS Cloud"
+        },
+        "sn": {
+            "type": "text",
+            "label": "Serial Number (SN)",
+            "xs": 12,
+            "sm": 12,
+            "md": 12,
+            "lg": 12,
+            "xl": 12,
+            "help": "Seriennummer vom Inverter"
+        },
+        "interval": {
+            "type": "number",
+            "label": "Update Interval (seconds)",
+            "min": 60,
+            "max": 3600,
+            "default": 60,
+            "xs": 12,
+            "sm": 12,
+            "md": 6,
+            "lg": 6,
+            "xl": 6,
+            "help": "Aktualisierungsintervall in Sekunden (Empfohlen: 60, Minimum: 60, API-Limit: 1440 Calls/Tag)"
+        }
+    }
+}

package/io-package.json

@@ -0,0 +1,117 @@
+{
+    "common": {
+        "name": "foxesscloud",
+        "version": "0.1.0",
+        "news": {
+            "0.1.0": {
+                "en": "Initial release",
+                "de": "Erstveröffentlichung",
+                "ru": "Первоначальный выпуск",
+                "pt": "Lançamento inicial",
+                "nl": "Eerste release",
+                "fr": "Version initiale",
+                "it": "Rilascio iniziale",
+                "es": "Lanzamiento inicial",
+                "pl": "Pierwsze wydanie",
+                "uk": "Початковий випуск",
+                "zh-cn": "初次发布"
+            }
+        },
+        "titleLang": {
+            "en": "FoxESS Cloud",
+            "de": "FoxESS Cloud",
+            "ru": "Облако FoxESS",
+            "pt": "Nuvem FoxESS",
+            "nl": "FoxESS-wolk",
+            "fr": "Nuage FoxESS",
+            "it": "FoxESSNuvola",
+            "es": "Nube FoxESS",
+            "pl": "Chmura FoxESS",
+            "uk": "Хмара FoxESS",
+            "zh-cn": "福克斯云"
+        },
+        "desc": {
+            "en": "Adapter to retrieve data from FoxESS Cloud API",
+            "de": "Adapter zum Abrufen von Daten aus der FoxESS Cloud API",
+            "ru": "Адаптер для получения данных из FoxESS Cloud API",
+            "pt": "Adaptador para recuperar dados da API FoxESS Cloud",
+            "nl": "Adapter om gegevens op te halen uit FoxESS Cloud API",
+            "fr": "Adaptateur pour récupérer les données de l'API FoxESS Cloud",
+            "it": "Adattatore per recuperare i dati dall'API FoxESS Cloud",
+            "es": "Adaptador para recuperar datos de FoxESS Cloud API",
+            "pl": "Adapter do pobierania danych z FoxESS Cloud API",
+            "uk": "Адаптер для отримання даних з FoxESS Cloud API",
+            "zh-cn": "Adapter to retrieve data from FoxESS Cloud API"
+        },
+        "authors": [
+            "skvarel <skvarel@inventwo.com>"
+        ],
+        "keywords": [
+            "FoxESS",
+            "Enpal",
+            "Solar",
+            "PV",
+            "Battery"
+        ],
+        "licenseInformation": {
+            "license": "MIT",
+            "type": "free"
+        },
+        "tier": 3,
+        "platform": "Javascript/Node.js",
+        "icon": "foxesscloud.png",
+        "enabled": true,
+        "extIcon": "https://raw.githubusercontent.com/inventwo/ioBroker.foxesscloud/main/admin/foxesscloud.png",
+        "readme": "https://github.com/inventwo/ioBroker.foxesscloud/blob/main/README.md",
+        "loglevel": "info",
+        "mode": "daemon",
+        "type": "energy",
+        "compact": true,
+        "connectionType": "cloud",
+        "dataSource": "poll",
+        "adminUI": {
+            "config": "json"
+        },
+        "dependencies": [
+            {
+                "js-controller": ">=6.0.11"
+            }
+        ],
+        "globalDependencies": [
+            {
+                "admin": ">=7.6.17"
+            }
+        ]
+    },
+    "protectedNative": ["token"],
+    "encryptedNative": ["token"],
+    "native": {
+        "token": "",
+        "sn": "",
+        "interval": 60
+    },
+    "objects": [],
+    "instanceObjects": [
+        {
+            "_id": "info",
+            "type": "channel",
+            "common": {
+                "name": "Information"
+            },
+            "native": {}
+        },
+        {
+            "_id": "info.connection",
+            "type": "state",
+            "common": {
+                "role": "indicator.connected",
+                "name": "Device or service connected",
+                "type": "boolean",
+                "read": true,
+                "write": false,
+                "def": false
+            },
+            "native": {}
+        }
+    ]
+}

package/main.js

@@ -0,0 +1,373 @@
+'use strict';
+
+/*
+ * Created with @iobroker/create-adapter v2.1.1
+ */
+
+const utils = require('@iobroker/adapter-core');
+const https = require('https');
+const crypto = require('crypto');
+
+class Foxesscloud extends utils.Adapter {
+    /**
+     * @param {Partial<utils.AdapterOptions>} [options] - Adapter options
+     */
+    constructor(options) {
+        super({
+            ...options,
+            name: 'foxesscloud',
+        });
+        this.on('ready', this.onReady.bind(this));
+        this.on('unload', this.onUnload.bind(this));
+
+        this.updateInterval = null;
+    }
+
+    /**
+     * Is called when databases are connected and adapter received configuration.
+     */
+    async onReady() {
+        // Initialize your adapter here
+
+        // Reset the connection indicator during startup
+        this.setState('info.connection', false, true);
+
+        // Check configuration
+        if (!this.config.token) {
+            this.log.error('API Token is not configured!');
+            return;
+        }
+
+        if (!this.config.sn) {
+            this.log.error('Serial Number (SN) is not configured!');
+            return;
+        }
+
+        // Create states
+        await this.createStates();
+
+        // Get interval from config (default 60 seconds, minimum 60 seconds)
+        const intervalSeconds = Math.max(60, this.config.interval || 60);
+        this.log.info(`Update interval set to ${intervalSeconds} seconds`);
+
+        // Start periodic data retrieval
+        this.getData(); // First call immediately
+        this.updateInterval = setInterval(() => {
+            this.getData();
+        }, intervalSeconds * 1000);
+    }
+
+    /**
+     * Create all necessary states
+     */
+    async createStates() {
+        await this.setObjectNotExistsAsync('pvPower', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'PV Power',
+                    de: 'PV-Leistung',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('generationPower', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Generation Power (Output)',
+                    de: 'Erzeugungsleistung (Ausgang)',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('soc', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Battery State of Charge',
+                    de: 'Batterie-Ladezustand',
+                },
+                type: 'number',
+                role: 'value.battery',
+                unit: '%',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('load', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Load Power',
+                    de: 'Verbrauchsleistung',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('gridConsumption', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Grid Consumption Power (Importing)',
+                    de: 'Netzbezugsleistung (Import)',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('feedinPower', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Feed-in Power (Exporting)',
+                    de: 'Einspeiseleistung (Export)',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('batCharge', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Battery Charge Power',
+                    de: 'Batterie-Ladeleistung',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+
+        await this.setObjectNotExistsAsync('batDischarge', {
+            type: 'state',
+            common: {
+                name: {
+                    en: 'Battery Discharge Power',
+                    de: 'Batterie-Entladeleistung',
+                },
+                type: 'number',
+                role: 'value.power',
+                unit: 'kW',
+                read: true,
+                write: false,
+            },
+            native: {},
+        });
+    }
+
+    /**
+     * Get data from FoxESS Cloud API
+     */
+    async getData() {
+        try {
+            const data = JSON.stringify({
+                sn: this.config.sn,
+                variables: [
+                    'pvPower',
+                    'generationPower',
+                    'SoC',
+                    'loadsPower',
+                    'gridConsumptionPower',
+                    'feedinPower',
+                    'batChargePower',
+                    'batDischargePower',
+                ],
+            });
+
+            const path = '/op/v0/device/real/query';
+            const milliseconds = new Date().getTime();
+
+            // WICHTIG: Die Signatur verwendet buchstäbliche Zeichen "\\r\\n", NICHT echte Zeilenumbrüche!
+            const signatureString = `${path}\\r\\n${this.config.token}\\r\\n${milliseconds}`;
+            const signature = crypto.createHash('md5').update(signatureString).digest('hex');
+
+            const options = {
+                headers: {
+                    'Content-Type': 'application/json',
+                    token: this.config.token,
+                    timestamp: milliseconds,
+                    signature: signature,
+                    lang: 'en',
+                },
+                hostname: 'www.foxesscloud.com',
+                method: 'POST',
+                path: path,
+                port: 443,
+            };
+
+            const request = https.request(options, response => {
+                response.setEncoding('utf8');
+
+                let responseData = '';
+
+                response.on('data', chunk => {
+                    responseData += chunk;
+                });
+
+                response.on('end', () => {
+                    try {
+                        if (!responseData) {
+                            this.log.error('No data received from API');
+                            this.setState('info.connection', false, true);
+                            return;
+                        }
+
+                        const json = JSON.parse(responseData);
+
+                        // Check if API response is valid
+                        if (!json.result || !json.result[0] || !json.result[0].datas) {
+                            this.log.error('Invalid API response - missing result/datas structure');
+                            this.log.error(`API response: ${JSON.stringify(json, null, 2)}`);
+                            if (json.errno !== undefined) {
+                                this.log.error(`API error code: ${json.errno}`);
+                            }
+                            if (json.msg !== undefined) {
+                                this.log.error(`API error message: ${json.msg}`);
+                            }
+                            this.setState('info.connection', false, true);
+                            return;
+                        }
+
+                        const datas = json.result[0].datas;
+
+                        // Update connection state
+                        this.setState('info.connection', true, true);
+
+                        // Update all states
+                        if (datas.length > 0 && datas[0] && datas[0].value !== undefined) {
+                            const pvPower = parseFloat(datas[0].value.toFixed(3));
+                            this.setState('pvPower', pvPower, true);
+                        }
+
+                        if (datas.length > 1 && datas[1] && datas[1].value !== undefined) {
+                            const genPower = parseFloat(datas[1].value.toFixed(3));
+                            this.setState('generationPower', genPower, true);
+                        }
+
+                        if (datas.length > 2 && datas[2] && datas[2].value !== undefined) {
+                            const soc = datas[2].value;
+                            this.setState('soc', soc, true);
+                        }
+
+                        if (datas.length > 3 && datas[3] && datas[3].value !== undefined) {
+                            const load = parseFloat(datas[3].value.toFixed(3));
+                            this.setState('load', load, true);
+                        }
+
+                        if (datas.length > 4 && datas[4] && datas[4].value !== undefined) {
+                            const gridCons = parseFloat(datas[4].value.toFixed(3));
+                            this.setState('gridConsumption', gridCons, true);
+                        }
+
+                        if (datas.length > 5 && datas[5] && datas[5].value !== undefined) {
+                            const feedin = parseFloat(datas[5].value.toFixed(3));
+                            this.setState('feedinPower', feedin, true);
+                        }
+
+                        if (datas.length > 6 && datas[6] && datas[6].value !== undefined) {
+                            const charge = parseFloat(datas[6].value.toFixed(3));
+                            this.setState('batCharge', charge, true);
+                        }
+
+                        if (datas.length > 7 && datas[7] && datas[7].value !== undefined) {
+                            const discharge = parseFloat(datas[7].value.toFixed(3));
+                            this.setState('batDischarge', discharge, true);
+                        }
+
+                        this.log.debug('Data successfully updated');
+                    } catch (parseError) {
+                        this.log.error(
+                            `Error processing API response: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
+                        );
+                        this.log.error(`Raw data: ${responseData}`);
+                        this.setState('info.connection', false, true);
+                    }
+                });
+
+                response.on('error', err => {
+                    this.log.error(`Response error: ${err.message}`);
+                    this.setState('info.connection', false, true);
+                });
+            });
+
+            request.on('error', err => {
+                this.log.error(`Request error: ${err.message}`);
+                this.setState('info.connection', false, true);
+            });
+
+            request.write(data);
+            request.end();
+        } catch (e) {
+            this.log.error(`Exception error: ${e instanceof Error ? e.message : String(e)}`);
+            if (e instanceof Error && e.stack) {
+                this.log.error(e.stack);
+            }
+            this.setState('info.connection', false, true);
+        }
+    }
+
+    /**
+     * Is called when adapter shuts down - callback has to be called under any circumstances!
+     *
+     * @param {() => void} callback - Callback function to call when cleanup is complete
+     */
+    onUnload(callback) {
+        try {
+            // Clear interval
+            if (this.updateInterval) {
+                clearInterval(this.updateInterval);
+                this.updateInterval = null;
+            }
+
+            callback();
+        } catch {
+            callback();
+        }
+    }
+}
+
+if (require.main !== module) {
+    // Export the constructor in compact mode
+    /**
+     * @param {Partial<utils.AdapterOptions>} [options] - Adapter options
+     */
+    module.exports = options => new Foxesscloud(options);
+} else {
+    // otherwise start the instance directly
+    new Foxesscloud();
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "iobroker.foxesscloud",
+  "version": "0.1.0",
+  "description": "ioBroker adapter to retrieve data from FoxESS Cloud API",
+  "author": {
+    "name": "skvarel",
+    "email": "skvarel@inventwo.com"
+  },
+  "homepage": "https://github.com/inventwo/ioBroker.foxesscloud",
+  "license": "MIT",
+  "keywords": [
+    "ioBroker",
+    "FoxESS",
+    "Enpal",
+    "Solar",
+    "PV",
+    "Battery",
+    "Energy"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inventwo/ioBroker.foxesscloud.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@iobroker/adapter-core": "^3.3.2"
+  },
+  "devDependencies": {
+    "@alcalzone/release-script": "^5.0.0",
+    "@alcalzone/release-script-plugin-iobroker": "^4.0.0",
+    "@alcalzone/release-script-plugin-license": "^4.0.0",
+    "@alcalzone/release-script-plugin-manual-review": "^4.0.0",
+    "@iobroker/adapter-dev": "^1.5.0",
+    "@iobroker/eslint-config": "^2.2.0",
+    "@iobroker/testing": "^5.2.2",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.0.0",
+    "mocha": "^10.2.0",
+    "should": "^13.2.3"
+  },
+  "main": "main.js",
+  "files": [
+    "admin/",
+    "main.js",
+    "io-package.json",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test:js": "mocha --config test/mocharc.custom.json \"{!(node_modules|test)/**/*.test.js,*.test.js,test/**/test!(PackageFiles|Startup).js}\"",
+    "test:package": "mocha test/package --exit",
+    "test:integration": "mocha test/integration --exit",
+    "test": "npm run test:package",
+    "check": "tsc --noEmit -p tsconfig.check.json",
+    "check:ts": "tsc --noEmit",
+    "lint": "eslint --ext .js,.jsx",
+    "translate": "translate-adapter",
+    "release": "release-script",
+    "release:patch": "release-script patch --yes",
+    "release:minor": "release-script minor --yes",
+    "release:major": "release-script major --yes"
+  }
+}