ioBroker.foxess-pv

Adapter für die FoxESS Cloud API – liest Echtzeit-Daten, Ertrag und Batteriestatus deines FoxESS-Wechselrichters und schreibt sie als ioBroker-States.

Voraussetzungen

• ioBroker mit js-controller ≥ 5.0
• Node.js ≥ 18
• FoxESS Cloud Konto mit aktivem API-Token

API-Token erstellen

1. Anmelden auf https://www.foxesscloud.com
2. Menü → Einstellungen → Schlüsselverwaltung
3. Neuen API-Key generieren und kopieren

Installation

Option A – Manuell (lokale Entwicklung)

# In das ioBroker-Verzeichnis wechseln (typischerweise /opt/iobroker)
cd /opt/iobroker

# Adapter-Ordner anlegen
cp -r /pfad/zu/ioBroker.foxess-pv node_modules/iobroker.foxess-pv

# Abhängigkeiten installieren
cd node_modules/iobroker.foxess-pv
npm install --production

# Zurück und Adapter registrieren
cd /opt/iobroker
iobroker add foxess-pv

Option B – Über ioBroker Admin (GitHub-URL)

1. Admin → Adapter → + → von GitHub installieren
2. GitHub-URL: https://github.com/kilobyte99/ioBroker.foxess-pv
3. Instanz anlegen

Konfiguration

In der Adapterkonfiguration (ioBroker Admin) folgende Werte eintragen:

| Feld | Beschreibung | Beispiel | |------|--------------|---------| | API Token | FoxESS Cloud API-Schlüssel | 8426c51c-... | | Seriennummer (SN) | Seriennummer des Wechselrichters | XXXXXXXXXXXXXXXXX | | API-URL | Basis-URL der Cloud (nicht ändern) | https://www.foxesscloud.com | | Abfrageintervall | Wie oft Daten abgerufen werden (Minuten) | 3 |

States

Alle States werden unter foxess-pv.0.* angelegt.

Ertrag (powerGeneration)

| State | Einheit | Beschreibung | |-------|---------|--------------| | powerGeneration.today | kWh | Ertrag heute | | powerGeneration.month | kWh | Ertrag diesen Monat | | powerGeneration.cumulative | kWh | Gesamtertrag |

Echtzeit (realtime)

| State | Einheit | Beschreibung | |-------|---------|--------------| | realtime.pvPower | kW | PV-Leistung gesamt | | realtime.pv1Power | kW | PV String 1 | | realtime.pv2Power | kW | PV String 2 | | realtime.feedinPower | kW | Einspeisung ins Netz | | realtime.gridConsumptionPower | kW | Netzbezug | | realtime.loadsPower | kW | Hausverbrauch | | realtime.invTemperation | °C | Wechselrichter-Temperatur |

Batterie (realtime)

| State | Einheit | Beschreibung | |-------|---------|--------------| | realtime.SoC | % | Ladestand (State of Charge) | | realtime.SOH | % | Gesundheitszustand (State of Health) | | realtime.batVolt | V | Batteriespannung | | realtime.batCurrent | A | Batteriestrom | | realtime.batChargePower | kW | Ladeleistung | | realtime.batDischargePower | kW | Entladeleistung | | realtime.batTemperature | °C | Batterietemperatur | | realtime.chargeEnergyToTal | kWh | Gesamt geladen | | realtime.dischargeEnergyToTal | kWh | Gesamt entladen |

Lizenz

MIT © Stefan Lueck