Ecoflow

verbindet sich mit Ecoflow-Produkten

Aktueller Release
1.4.9
Entwickler
foxthefox
Lizenz
MIT

ecoflow-mqtt-Adapter für ioBroker

Verbindet sich mit Produkten von Ecoflow ([ https://www.ecoflow.com ])

WARNUNG

Dieser Adapter nutzt eine inoffizielle Kommunikationsschnittstelle zu den Geräten. Fehlerhafte Kommunikation oder falsche Werte können die Funktionalität des Geräts beeinträchtigen und zum Ausschluss vom Dienst führen.

Der Adapter basiert auf der Arbeit von:

EF-Anmeldeinformationen

Auf der Admin-Seite (erster Tab) müssen die MQQT-Zugangsdaten für den MQQT-Broker eingegeben werden.

  • Benutzername – etwa „app-...“.
  • Benutzer-ID – eine 19-stellige Nummer
  • Benutzerpasswort - ein alphanumerisches
  • ClientID - eine Zeichenkette, die mit "ANDROID_...." beginnt.

Es gibt 3 Möglichkeiten:

  1. per Skript https://github.com/mmiller7/ecoflow-withoutflow/blob/main/cloud-mqtt/ecoflow_get_mqtt_login.sh
  2. von der Website https://energychain.github.io/site_ecoflow_mqtt_credentials/
  3. durch den eigenen Algorithmus des Adapters (Drücken des Knopfes), hierfür sind der Ecoflow-Benutzername und das Passwort erforderlich.

Die Einstellungen des MQQT-Brokers sind Standard und müssen normalerweise nicht geändert werden.

!!! Falls der MQTT-Server die Verbindung ablehnt, kann es hilfreich sein, mit Option 2 die Ausgabe der Webseite zu überprüfen. In manchen Fällen wird eine andere MQTT-Broker-Adresse zurückgegeben !!!

Geräteeinrichtung und Konfiguration

Über die Registerkarte „Gerätekonfiguration“ können Sie Ihre Geräte hinzufügen.

Parametrizing the Powerstream or STREAM

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID von (Power)Stream wie in der App angezeigt ein, etwa so: "HW51..../BK...."
  • Gib ihm einen Namen
  • Wählen Sie die Version aus

Parametrizing the Powerstation

  • Füge eine neue Zeile hinzu
  • Legen Sie die Geräte-ID der Powerstation wie in der App angezeigt fest; die Zeichenfolge variiert je nach Gerätetyp.
  • Gib ihm einen Namen
  • Wählen Sie den Gerätetyp aus
  • Falls ein zusätzlicher Akku angeschlossen ist, überprüfen Sie die Portnummer, an der er angeschlossen ist.

Parametrizing the Smart Plug

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Smart Plugs wie in der App angezeigt ein, etwa so: "HW52...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf "Stecker" ein.

Parametrizing the Smartmeter

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Smartmeters (Shelly oder EF) wie in der App angezeigt ein. Beachten Sie bei Shelly, dass die ID sich von der ID des Shelly-Geräts selbst unterscheidet.
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „Shelly3EM“ oder „EF Smartmeter“ ein.

Parametrizing the Generator

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Generators wie in der App angezeigt ein, etwa so: "DGEB...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „Generator“ ein.

Parametrizing the Smart Home Panel

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Generators wie in der App angezeigt ein, etwa so: "SP10...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „SHP“ oder „SHP2“ ein.

Parametrizing the Power Kit & Hub

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Stromversorgungs-Kits wie in der App angezeigt ein, etwa so: "M10...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „Power Kit BP2000“ oder „Power Kit BP5000“ ein.
  • Falls eine zweite oder dritte Batterie angeschlossen ist, prüfen Sie diese als Slave 1 oder Slave 2.

Parametrizing the Power Ocean DC fit

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Generators wie in der App angezeigt ein, etwa so: "HJ31...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „Power Ocean“ ein.
  • Falls eine zweite oder dritte Batterie angeschlossen ist, prüfen Sie diese als Slave 1 oder Slave 2.

Parametrizing the Wave

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Smart Plugs wie in der App angezeigt ein, etwa so: "KT21ZCH...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf "Wave2" ein.

Parametrizing the Glacier

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Smart Plugs wie in der App angezeigt ein, etwa so: "BX11ZCB...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „Gletscher“ ein.

Parametrizing the Alternator

  • Füge eine neue Zeile hinzu
  • Stellen Sie die Geräte-ID des Smart Plugs wie in der App angezeigt ein, etwa so: "F371ZE...".
  • Gib ihm einen Namen
  • Stellen Sie den Typ auf „Lichtmaschine 800W“ ein.

Verwenden Sie den Tab „Home Assistant“, um die MQTT-Verbindung zu Home Assistant einzurichten.

Parametrizing Homeassistant Connector

  • Dienst aktivieren
  • Die Benutzereinstellungen des MQTT-Brokers von HA festlegen
  • Legen Sie die Verbindungsparameter des MQTT-Brokers von HA fest.
  • Wählen Sie bei Bedarf die Debug-Einstellungen aus.

Modifikation auf der HA-Seite:

  • Der Adapter nutzt die Erkennungsfunktion in HA, eine Konfiguration von Datenpunkten in HA ist nicht erforderlich.
  • MQTT-Add-on ...

Aktualisierung des Adapters

Normalerweise genügt es, die nächste Version über die alte zu installieren. In manchen Fällen (z. B. bei Version 1.0.0) muss möglicherweise der gesamte Objektbaum gelöscht werden. Wenn sich datenpunktbezogene Werte ändern, wie z. B. Minimal- oder Maximalwerte des Bereichs, müssen Sie Folgendes tun:

  • Schalten Sie den Adapter aus
  • Die betreffenden Datenpunkte wurden gelöscht.
  • Starten Sie den Adapter. Danach werden die neuen Bereiche übernommen.

ioBroker-Adapterfunktionen

  • Die definierten Geräte sind über MQTT mit dem Adapter verbunden.
  • Der Adapter filtert die eingehenden Nachrichten der Geräte. Nur geänderte Werte werden intern gespeichert.
  • Wenn die App die Anpassung unter einer bestimmten Bedingung verhindert, wird dies, sobald es bekannt ist, repliziert (z. B. wird das Einschalten des Wechselrichters verhindert, wenn der Batteriestand unter dem Mindestwert liegt; dies kann als Warnung im Protokoll angezeigt werden).
  • Da nicht alles bekannt ist, kann die Interpretation der Informationen unsicher sein; dies wird meist durch ein nachgestelltes „?“ gekennzeichnet.

Anmerkungen zur Aktualisierung der Datenpunktkonfiguration (Minimum, Maximum, Einheit, ....).

Wenn die Einstellungen eines Datenpunkts in der neuen Version des Adapters geändert werden (z. B. Name, Einheit, Maximalwert), wird die Änderung erst wirksam, wenn Sie:

  • Die Adapterinstanz stoppen
  • Löschen Sie den entsprechenden Datenpunkt oder die gesamte Objektstruktur der Adapterinstanz.
  • Starten Sie die Adapterinstanz.

Beim Startvorgang werden die Datenpunkte erstellt, aber nicht verändert, sobald sie vorhanden sind.

Anmerkungen zu Warnungen/Fehlern

Bestimmte Ereignisse im Adapter werden als Warnung oder Fehler gekennzeichnet, um im Protokoll im Info-Modus angezeigt zu werden. Dies bedeutet nicht zwangsläufig einen Fehler oder dass der Adapter nicht funktioniert, sondern weist eher auf ein unerwartetes Verhalten hin. Die Ursache liegt möglicherweise nicht im Adapter selbst, aber es wird darauf hingewiesen.

HA-Anschluss/Gateway

  • Die MQTT-Erkennungsfunktion in HA ermöglicht einen eleganten Informationsaustausch.
  • Die MQTT-Erkennungsfunktion ist möglicherweise nicht aktiviert, wenn der MQTT-Broker bereits in HA ausgeführt wird. Sie muss während der Neukonfiguration des MQTT-Dienstes aktiviert werden.
  • Bei jedem Start des iobroker-Adapters werden alle Discovery-Objekte an HA übertragen (auch wenn sie in HA verbleiben sollten).
  • Der iobroker-Adapter filtert die eingehenden Nachrichten der Geräte. Nur geänderte Werte werden intern gespeichert und an HA übertragen.
  • Wird ein Wert nicht durch eine Gerätedatenaktualisierung festgelegt, wird er in HA als unbekannt angezeigt.
  • Wenn das Gerät erreichbar ist, wird die Verfügbarkeit in der Geräteverbindung angezeigt; dies wird an die „Untergeräte“ vererbt (Nichtverfügbarkeit wird auf die gleiche Weise verarbeitet).

einige_Hinweise_für HA

Anmerkungen zur Funktionalität

  • Aufgrund der Asynchronität von Informationsaktualisierungen und Befehlsübertragung können mitunter Race Conditions auftreten. So kann beispielsweise beobachtet werden, wie ein Schalter betätigt wird und anschließend mehrmals hin und her schaltet, bevor er in der eingestellten Position verbleibt.

Implementierte Geräte & Struktur mit Datenpunkten

eine Erklärung zu den Gerätedaten

  • Zahl -> Datenpunkt mit numerischem Wert
  • Ebene -> anpassbarer Datenpunkt mit numerischem Wert, manchmal auch Auswahlen mit numerischer Darstellung
  • Schalter -> einstellbarer Datenpunkt (Boolescher Wert)
  • Diagnose -> boolescher oder mehrwertiger Datenpunkt in Text umgewandelt
  • Zeichenkette -> Datenpunkt nur als Text
  • Array -> Datenpunkt mit Array
  • Bei der Umwandlung von Wert in Text kann ein nicht validierter Text verwendet werden (Feedback ist willkommen). Dies wird durch ein "?" am Ende des Textes angezeigt.

Kraftwerk

River Max

River Pro

Fluss 2 Max

River 2 Pro

Fluss 3

River 3 Plus

Delta Mini

Delta

Delta Max

Delta 2

Delta 2 Max

Delta 3

Delta 3 Plus

Delta 3 Max Plus

Delta 3 Classic

Delta Pro

Delta Pro 3

Delta Pro Ultra

Smart-Home-Panel

Smart-Home-Panel

Smart Home Panel 2

Stromversorgungssatz & Nabe

Power Kit

Power Ocean

Power Ocean DC

Power Ocean Plus

Power Ocean DC FIT

Generator

Generator

Ein Dual-Fuel-Generator ist derzeit nicht verfügbar, könnte aber implementiert werden, sofern entsprechende Daten vorliegen.

Powerstream & Stream

Powerstream

Stream AC

Stream AC PRO

Stream Ultra

Stromumrichter

Die 800-W-Version ist ebenfalls implementiert; der einzige Unterschied besteht in der maximalen Leistung von 800 W. Versorgungspriorität: 0/falsch = priorisierte Netzversorgung; 1/wahr = priorisierte Batterieversorgung (Laden).

Intelligente Steckdosen

Intelligente Steckdose

Smartmeter-Geräte

Shelly3EM

Smartmeter

Wave Klimaanlage

Welle 2

Welle 3

Wave ist derzeit nicht verfügbar, könnte aber implementiert werden, falls Daten verfügbar sind.

Gletscherkühlschrank

Gletscher

Glacier Classic 55L

Generator

Generator

Ladegerät

Rapid Pro 320W

Nicht unterstützte Geräte

Dieser Abschnitt dient Debugging-Zwecken. Bitte wählen Sie das Gerät (Delta Pro3, Delta3, Delta3 Plus) aus und tragen Sie die Seriennummer in die hinzugefügte Zeile ein. Es wird davon ausgegangen, dass das unbekannte Gerät Protobuf verwendet. Es erzeugt [PROTOBUF unknown]-Meldungen im Log, die das rohe Hex-Telegramm enthalten.

Aufgaben

  • Vergessene Randbedingungen für Befehle prüfen (Befehl unterdrücken oder zusätzlichen Wert)
  • Prüfen Sie den Piepton-Befehl, falls die Umkehrung erforderlich ist.
  • SlaveBattery DM, outWatts Multiplikation mit 10
  • mehr getCmds für SHP-Werte

Haftungsausschluss

Diese Open-Source-Software steht in keiner Verbindung zu Ecoflow und wird von diesem Unternehmen auch nicht unterstützt. Die Nutzung erfolgt auf eigene Gefahr und nach eigenem Ermessen. Ich übernehme keine Haftung für etwaige Schäden oder Probleme, die durch die Nutzung der Software entstehen können. Bitte beachten Sie, dass für die Nutzung dieser Open-Source-Software kein direkter Support oder Garantieleistungen von Ecoflow gewährt werden.

Changelog

WORK IN PROGRESS

  • (foxthefox) new datapoints Delta2max

1.4.9 (npm)

  • (foxthefox) new device Strem Ultra X
  • (foxthefox) delta 3 plus backupReserveSoc in relation to Discharge Limit + 5%
  • (foxthefox) deltapro3 some max values adapted
  • (foxthefox) powerstream timeData
  • (foxthefox) corrections of max values in Stream series

1.4.8 (npm)

  • (foxthefox) new device Glacier Classic 55L support
  • (foxthefox) new device Delta 3 Max Plus support
  • (foxthefox) new device Stream AC support
  • (foxthefox) new device Rapid Pro 320W support #372
  • (foxthefox) enhancements on wave3
  • (foxthefox) corrections in river3plus for data processing
  • (foxthefox) corrections in D2M for command inv.cfgAcEnabled #340
  • (foxthefox) poweroceanplus set hrPwr/fromPv/romBat/fromGrid values to 0 for non transmitted datapoints in HeatingRodEnergyStreamShow
  • (foxthefox) poweroceanplus pcsActPwr max 20kW, pcsXPhase_amp max 60A
  • (foxthefox) corrections in BMSHeartBeatReport for river3/river3plus
  • (foxthefox) powGetSysLoad for streamAC/ACPro/Ultra set to 10kW, powGetSchuko 2100W
  • (foxthefox) new msg counter for received telegrams from EF-cloud (within 10s)
  • (foxthefox) correction of enBeep (dataLen=2) for Delta3/+/max+/pro
  • (foxthefox) correction of AC1/2/3 switching on SHP2 (issue #312)
  • (foxthefox) Stream AC timetask58x exclude
  • (foxthefox) correction of powerocean / powerocean+ (issue #378), new ENERGY_STREAM_DETAIL and switch for missing datapoint -> value = 0
  • (foxthefox) dev dependencies cleanup
  • (foxthefox) #415 powGetPvSum max=3600, sysGridConnectionPower max = 2500
  • (foxthefox) #422 Backup Reserve Soc as level Delta 3 Plus
  • (foxthefox) #417 Delta Pro 3, remainTime max= 12520, dcdcChgReqCur max = 150, invBusVol/llcBusVol mult=0.1

License

MIT License

Copyright (c) 2023-2026 foxthefox foxthefox@wysiwis.net

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.