wichtiges UPDATE für controller 7.2.2 im stable

[skvarel]

Aktuelle Test Version	0.6.x
Aktuelle Stable Version	0.6.3
Veröffentlichungsdatum	22.01.2026
Github Link	https://github.com/inventwo/ioBroker.foxesscloud
npm Link	https://www.npmjs.com/package/iobroker.foxesscloud

Adapter zur Integration der Fox ESS Cloud

Dieser Adapter ermöglicht das Abrufen von Daten aus der FoxESS Cloud API für Solar-Wechselrichter (z.B. bei Enpal-Anlagen).

Features:

• PV-Leistung (aktuelle Solarproduktion)
• Batterie-Ladezustand (SoC)
• Batterie Laden/Entladen
• Netzbezug und Einspeisung
• Hausverbrauch
• Konfigurierbarer Abfrageintervall (min. 60 Sekunden)

Voraussetzungen:

• FoxESS Cloud Account mit API-Zugang
• API-Token aus dem FoxESS Cloud Portal (www.foxesscloud.com OHNE v2 - Login mit Benutzername anstatt der eMail wie bei v2. Passwort ist das selbe)
• Seriennummer des Wechselrichters

Gesucht:

• Tester mit FoxESS-Wechselrichtern (auch Enpal-Kunden mit FoxESS-Hardware)
• Feedback und Bug-Reports sind willkommen!

Die Instanz:

Die Datenpunkte (Stand: v0.1.0)

Fehlermeldungen, Wünsche & Anregungen bitte nicht nur hier, sondern auch als Issue:
https://github.com/inventwo/ioBroker.foxesscloud/issues

Danke und viel Spaß beim Testen,
skvarel.

[skvarel]

Changelog

(Dieser Beitrag wird laufend erweitert/editiert)

---

0.6.3 (2026-06-05)

(skvarel) Fixed repository checker error E0036

0.6.2 (2026-06-02)

(skvarel) Documented Open API rate limit (per API key, multiple instances) in README and admin General tab
(skvarel) Migrated project rules from GitHub Copilot to Cursor rules

0.6.1 (2026-05-29)

(skvarel) Revised config and i18n

0.6.0 (2026-05-27)

(StephanBeutel) Added support for up to 24 PV strings with dynamic state creation on first occurrence
(StephanBeutel) Added report states for daily, weekly, monthly, and yearly energy totals derived from lifetime API values
(StephanBeutel) Fixed null value handling for inverter and battery temperature states
(StephanBeutel) Extracted reusable makeApiRequest() method for cleaner API communication
(StephanBeutel) Centralized all state name translations into a single STATE_NAMES constant
(skvarel) Fixed report states not updating during current period (values were only written at period rollover)
(skvarel) Made energy reporting configurable via a new Reporting tab in the admin UI

0.5.1 (2026-05-25)

(skvarel) Replaced process.env and process.exit usage in tools/api-test.js to fix compatibility issues reported by ioBroker repository checker (E5049, E5050)
(skvarel) Downgraded @types/node from ^25 to ^22 to match supported Node.js version (W0066)

Older changes:

Spoiler

0.5.0 (2026-05-23)

(skvarel) Added PV Power JSON statistics (daily, weekly, monthly) for VIS widget integration with optional cost calculation per kWh

0.4.0 (2026-05-19)

(skvarel) Added PV string 1 and string 2 power datapoints (pv1Power, pv2Power)
(skvarel) Added battery temperature datapoint (batTemperature)
(skvarel) Added inverter running state datapoint (runningState)

0.3.0 (2026-05-19)

(skvarel) Added inverter internal temperature datapoint in °C

0.2.3 (2026-05-14)

(skvarel) Fixed issue from adapter checker

0.2.2 (2026-05-14)

(skvarel) Fixed some lint errors/warnings

0.2.1 (2026-04-13)

(skvarel) Removed: React and mui

0.2.0 (2026-04-06)

(skvarel) Updated: Minimum Node.js version requirement to >=22

0.1.9 (2026-03-13)

(skvarel) Improved: Enabled Node.js 24 support in GitHub Actions workflows.
(skvarel) Fixed: Issue detected by repository checker.

0.1.8 (2026-03-12)

(skvarel) Fixed: Issue detected by repository checker.

0.1.7 (2026-02-28)

(skvarel) Fixed: Issue detected by repository checker.

0.1.6 (2026-02-01)

(skvarel) Improved: Use node: prefix for core modules and adapter timer wrappers for better compatibility
(skvarel) Fixed: Added .env.example to .gitignore

0.1.5 (2026-01-31)

(skvarel) Improved: Removed unnecessary devDependencies (eslint, should, dotenv) to follow ioBroker best practices.
(skvarel) Improved: Updated test scripts to use standard mocha command instead of hardcoded paths.
(skvarel) Improved: Switched Node.js core module imports to node:xxx format where applicable.
(skvarel) Improved: Enforced minimum and maximum interval limits for data polling to comply with Node.js timer restrictions.
(skvarel) Improved: Code formatting and configuration files updated for consistency with ioBroker standards.
(skvarel) Fixed: Addressed review feedback for ioBroker latest repository inclusion.
(skvarel) Added: Full multi-language support for all state names (EN, DE, RU, PT, NL, FR, IT, ES, PL, UK, ZH-CN).

0.1.2 (2026-01-23)

(skvarel) Fix .vscode/settings.json

0.1.1 (2026-01-23)

(skvarel) Remove mocha from devDependencies (included in @iobroker/testing)
(skvarel) Add .vscode/settings.json with JSON schema definitions

0.1.0 (2026-01-22)

(skvarel) Initial release

[skvarel]

Keine Wünsche auf weitere Datenpunkte? Bei Adapter-Request waren ein paar Stimmen für diesen Adapter und hier ist es komplett ruhig ?!

[skvarel]

v0.1.6 ist nun im Latest Repo

[skvarel]

LATEST Update

Ich habe gerade die 0.4.0 hochgeladen.

Ein paar weitere Datenpunkte hinzugefügt:

[MartinP]

Bevor es den Adapter gab, habe ich mir ein Script geschrieben um den Fox ESS WR meines Balkonkraftwerks über die Cloud auszulesen bzw den Code in großen Teilen aus dem Internet besorgt und an die Nutzung mit iobroker angepasst.
Läuft derzeit annehmbar, werde aber einen Blick auf den Adapter werfen.

[skvarel]

@MartinP .. bei meinem Microwechselrichter bleiben ein paar Datenpunkte leer, weil ich das Balkonkraftwerk ohne Speicher betreibe.

Ich hatte den Adapter eigentlich für meine große Anlage erstellt und jetzt über eine zweite Instanz das BKW in den ioBroker geholt.

So sieht es bei meinem M1-800-E aus:

Was hast du für Datenpunkte über dein Script erstellen lassen? Ich könnte den Adapter dann gern erweitern.

[MartinP]

Das ist eher schlicht.

• Aktuelle Leistung
• Kumulierte Energie aktueller Tag
• Energie Vortag

[skvarel]

@MartinP sagte:

• Energie Vortag

Das könnte ich noch einbauen

EDIT:
Ich mache es allerdings über SourceAnalytix

(Die Euros sind die Ersparnisse und nicht die Einspeisevergütungen)

[skvarel]

Ich überlege gerade, ein (bzw. mehrere) json in die Objekte schreiben zu lassen ?!

In der Config definierbar, ob man Tage, Wochen und/oder Monate als json haben möchte. Zusätzlich könnte man optional einen Preis je kWh angeben.

Wenn kein Preis angegeben wird, dann nur zwei Spalten .... mit Preis dann drei Spalten

[MartinP]

Ich nutze Influx/Grafana für meine Auswertungen...

Das Script habe ich zwischen Tür und Angel hingebastelt ...

Ausgewertet wird die aktuelle Leistung und Ertrag des Vortages - bei dem gibt es manchmal eine "0", die nicht korrekt ist... Ist wahrscheinlich nicht Script-Neustart sicher.
Außerdem vom Zweiwege-Zähler die Einspeisung..

[skvarel]

ALPHA Update

Ich habe drei json hinzugefügt

Ich beobachte die Werte ein/zwei Tage, dann schicke ich die Version ins Latest