Neue Integration: EcoFlow (River 2 / River 2 Max / River 2 Pro)
Hinweis: Der Block unten links ist eine Steckdose vor dem EcoFlow, die ich vor der Integration verwendet habe.
Eine externe Integration, um Ihre EcoFlow-Stationen der River-2-Serie direkt von Gladys aus zu überwachen und zu steuern, über die EcoFlow-Cloud (dasselbe wie die offizielle App).
Was sie kann
Für jedes erfasste Gerät erhalten Sie:
- Batteriestand (%)
- Ladeleistung AC, Gesamtausgangsleistung, AC-Ausgangsleistung, eingehende Solarleistung
- Schalter: AC-Ausgang, X-Boost, DC-Ausgang (Zigarettenanzünder), Notreserve
- Eine Aktion „Verbindung testen“, um zu überprüfen, ob ein Gerät antwortet
Zwei Verbindungsmethoden
- EcoFlow-Entwicklerkonto (Open Platform) — der offizielle und dokumentierte Weg mit automatischer Erkennung aller Geräte des Kontos. Nachteil: Sie müssen ein Entwicklerkonto erstellen und die Genehmigung von EcoFlow abwarten (ca. 1 Woche), und einige Geräte, die bereits mit der mobilen App verknüpft sind, können von EcoFlow abgelehnt werden („bereits zugewiesen“) — eine bekannte und wiederkehrende Einschränkung ihrer Plattform, unabhängig von der Integration.
- Einfache Verbindung (E-Mail/Kennwort) — dieselben Anmeldedaten wie die EcoFlow-App, ohne Entwicklerkonto oder Wartezeit. Inoffiziell (interne Endpunkte der App), daher keine automatische Erkennung: Die Seriennummer jedes Geräts wird manuell eingegeben. Dies ist die Methode, die Geräte freischaltet, die über den Entwicklerweg abgelehnt wurden — getestet und funktionierend an einem echten River 2 Pro (das, was ich verwende).
Beide Methoden können gleichzeitig laufen.
Bekannte Grenzen
- Keine lokale/LAN-Steuerung: Selbst ein Gerät, das nie Ihr WLAN verlässt, geht über die EcoFlow-Cloud, wie die offizielle App — bestätigt von EcoFlow selbst (die einzige Ausnahme in ihrem gesamten Katalog: der EZ1, ein Bewässerungszeitschalter ohne Bezug).
- Noch keine Einstellung der Lade-/Entladegrenzen oder des Notreservestands in Prozent (derzeit nur lesbar).
- Die einfache Methode (2) basiert auf nicht dokumentierten Endpunkten von EcoFlow: Sie kann ohne Vorwarnung ausfallen, wenn EcoFlow seine App ändert.
Installation
Entwicklermodus in Gladys → Link einfügen GitHub - LM1LC3N7/gladys-ecoflow: Integration of EcoFlow River 2 family (River 2 Pro / Max) to Gladys Assistant · GitHub
Sicherheit, Wartung und Wiederverwendung
- Kommunikation nur über HTTPS/MQTT signiert — kein lokaler Zugriff oder offener Port am Gerät
- Nicht-Root-Container, schreibgeschütztes Dateisystem,
npm installohne Skriptausführung (--ignore-scripts) - Anmeldedaten von Gladys verschlüsselt gespeichert, nie an Dritte außer EcoFlow übertragen
- CI (Lint, Tests, Build) bei jeder Änderung + automatische Abhängigkeitsaktualisierungen (Dependabot), Image-Publikation bei jeder Änderung
- Anforderungssignaturen und MQTT-Protokoll mit zwei bereits von der Community genutzten Implementierungen abgeglichen (
tolwi/hassio-ecoflow-cloud,rustyy/ecoflow-api), Validierung über die echten Schemata von@ecoflow-api/schemas
