Überblick
EcoFlow BLE (Unofficial) verbindet Home Assistant über Bluetooth LE ohne die Cloud mit EcoFlow-Geräten. Es unterstützt EcoFlow-Powerstations, E-Auto-Ladegeräte und Zubehör und arbeitet lokal, ohne dass eine Internetverbindung nötig ist. Es fügt Sensoren für Akkustand, Energiefluss und Gerätestatus hinzu, dazu Schalter, Zahlen, Auswahlen, Tasten und eine Klima-Entität für Ausgänge, Ladegrenzen und Modi. Unterstützte Geräte werden per Bluetooth-Erkennung gefunden und zum Hinzufügen angeboten, und die Einrichtung läuft in der Oberfläche mit einer Anmeldung beim EcoFlow-Konto. Zu den Optionen gehören ein Aktualisierungsintervall, ein Verbindungs-Timeout, eine Verbindungsverzögerung zum Verteilen der Geräte auf Bluetooth-Proxys und das Freischalten niedrigerer Mindestwerte für die AC- und DC-Ladegeschwindigkeit. Für Fehlerberichte stehen ein Diagnose-Download und detaillierte Protokolleinstellungen zur Verfügung.
Zusammenfassung der README und des Codes von rabits/ha-ef-ble, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Klima
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
EcoFlow-Gerät hinzufügen
- BLE-Gerät
Konfiguration des erkannten Geräts
- EcoFlow-Benutzer-ID
- BLE-Gerät
- AktualisierungsintervallAnzahl der Sekunden, die gewartet wird, bevor das nächste Geräte-Update verarbeitet wird. Der Wert 0 bedeutet, dass alle Updates sofort verarbeitet werden (das führt zu vielen Schreibvorgängen in der Datenbank).
- E-Mail / Telefon
- Passwort
- RegionWähle den EcoFlow-API-Host, der zu deinem Konto passt. Auto verwendet api.ecoflow.com für E-Mail-Adressen und api-cn für Telefonnummern. Dein Konto kann auf einem anderen Host liegen als deiner tatsächlichen geografischen Region. Wenn du die Meldung "Account does not exist" erhältst, wähle den Host daher ausdrücklich aus.
- Sensible Informationen maskieren (nützlich, wenn du Protokolle öffentlich teilst)
- Verbindungsanfragen und Antworten des Geräts protokollieren
- Deserialisierte Update-Nachrichten des Geräts protokollieren
- Paketobjekte protokollieren
- Verschlüsselte Payloads protokollieren
- Entschlüsselte Payloads protokollieren
- Debug-Protokollstufe von bleak aktivieren (nicht maskiert und nicht auf dieses Gerät gefiltert)
- Verbindungs-TimeoutAnzahl der Sekunden, die gewartet wird, bis sich das Gerät verbindet und authentifiziert.
- VerbindungsverzögerungAnzahl der Sekunden, die vor dem Verbinden gewartet wird, wenn sich gerade ein anderes EcoFlow-Gerät verbunden hat. Home Assistant wählt aus, über welchen Bluetooth-Proxy jede Verbindung läuft, und benachteiligt Proxys, die gerade mit Verbinden beschäftigt sind. Geräte, die gleichzeitig starten, können deshalb für den Rest der Sitzung bei einem weiter entfernten Proxy landen. Wenn du sie zeitlich versetzt, hat jedes Gerät eine bessere Chance, über den nächstgelegenen Proxy verbunden zu werden. Ein Gerät, das nicht zusammen mit einem anderen startet, wird nie verzögert. Setze den Wert auf 0, um das für das Gerät zu deaktivieren.
Wird auch beim Bestätigen des Geräts abgefragt.
Konfigurationsoptionen
- EcoFlow-Benutzer-ID
- AktualisierungsintervallAnzahl der Sekunden, die gewartet wird, bevor das nächste Geräte-Update verarbeitet wird. Der Standardwert 0 bedeutet, dass alle Updates sofort verarbeitet werden (das kann zu vielen Schreibvorgängen in der Datenbank führen).
- PaketversionVersion der zu verwendenden Pakete. Sie hängt von der Generation und der Firmware dieses Geräts ab. Probiere eine andere Version aus, wenn die Verbindung oder Authentifizierung fehlschlägt. Beachte, dass einige Geräte eine Paketversion verwenden, die diese Integration noch nicht unterstützt.
- E-Mail / Telefon
- Passwort
- RegionWähle den EcoFlow-API-Host, der zu deinem Konto passt. Auto verwendet api.ecoflow.com für E-Mail-Adressen und api-cn für Telefonnummern. Dein Konto kann auf einem anderen Host liegen als deiner tatsächlichen geografischen Region. Wenn du die Meldung "Account does not exist" erhältst, wähle den Host daher ausdrücklich aus.
- Sensible Informationen maskieren (nützlich, wenn du Protokolle öffentlich teilst)
- Verbindungsanfragen und Antworten des Geräts protokollieren
- Deserialisierte Update-Nachrichten des Geräts protokollieren
- Paketobjekte protokollieren
- Verschlüsselte Payloads protokollieren
- Entschlüsselte Payloads protokollieren
- bleak-Debug-Loglevel aktivieren (nicht maskiert und nicht auf dieses Gerät gefiltert)
- Verbindungs-TimeoutAnzahl der Sekunden, die auf die Verbindung und Authentifizierung des Geräts gewartet wird.
- VerbindungsverzögerungAnzahl der Sekunden, die vor dem Verbinden gewartet wird, wenn sich gerade ein anderes EcoFlow-Gerät verbunden hat. Home Assistant wählt aus, über welchen Bluetooth-Proxy jede Verbindung läuft, und benachteiligt Proxys, die bereits mit einem Verbindungsaufbau beschäftigt sind. Dadurch können Geräte, die gleichzeitig starten, für den Rest der Sitzung bei einem weiter entfernten Proxy landen. Wenn du sie zeitlich versetzt, hat jedes Gerät eine bessere Chance, über den nächstgelegenen Proxy verbunden zu werden. Ein Gerät, das nicht zusammen mit einem anderen startet, wird nie verzögert. Setze den Wert auf 0, um dies für das Gerät zu deaktivieren.
Verbindung ändern
- EcoFlow-Benutzer-ID
- Aktivierte Zusatzbatterien
Nach der Einrichtung
- AktualisierungsintervallAnzahl der Sekunden, die gewartet wird, bevor das nächste Geräte-Update verarbeitet wird. Der Wert 0 bedeutet, dass alle Updates sofort verarbeitet werden (das führt zu vielen Schreibvorgängen in der Datenbank).
- Minimum der AC-Ladegeschwindigkeit freigebenErlaubt es, die AC-Ladegeschwindigkeit unter das Minimum zu setzen, das die EcoFlow-App vorgibt. Mit 1 W bezieht das Gerät keinen Strom mehr aus dem Netz, ohne dass du es vom Netz trennen musst. Das brauchen Automationen für Solarüberschuss. So langsames Laden ist weniger effizient und kann zusätzliche Wärme erzeugen.
- Minimum der DC-Ladegeschwindigkeit freigeben⚠️ WARNUNG: Das kann dein Gerät beschädigen. Die Grenzen der EcoFlow-App gibt es wahrscheinlich aus gutem Grund, und ein längerer Betrieb des DC-Eingangs unterhalb dieser Grenzen kann die Bauteile abnutzen. Dadurch entstandene Schäden sind möglicherweise nicht durch die Garantie gedeckt. Die Nutzung erfolgt auf eigenes Risiko. Erlaubt es, die DC-Ladegeschwindigkeit unter das Minimum zu setzen, das die EcoFlow-App vorgibt, bis hinunter auf 0 A. 0 A bedeutet nicht aus: Das Gerät kann weiterhin einen kleinen Strom vom Eingang beziehen. Der Wert begrenzt den Strom, der vom DC-Eingang bezogen wird. Ein niedrigerer Wert hält das Gerät innerhalb dessen, was eine schwache Quelle liefern kann, etwa eine abgesicherte Autosteckdose, ein kleines Netzteil oder ein einzelnes Solarmodul, statt es durch eine zu hohe Anforderung ins Stocken zu bringen.
- Diagnose bei Ausnahme speichernWenn aktiviert, werden Pakete ab dem Beginn jedes Verbindungsversuchs gesammelt. Tritt ein Verbindungsfehler auf, werden die gesammelten Daten zur Fehlersuche automatisch auf dem Datenträger gespeichert.
- Paketsammlung aktivierenWenn du diese Option aktivierst, werden Pakete für die Diagnoseinformationen gespeichert. Warte nach dem Aktivieren eine Minute, bevor du die Diagnoseinformationen herunterlädst, und vergiss nicht, die Option wieder auszuschalten. Manche Geräte können in ihren Nachrichten identifizierende Informationen wie deinen genauen Standort enthalten. Stelle sicher, dass die Verschlüsselung aktiviert ist, bevor du die Daten weitergibst.
- Anzahl der zu speichernden Pakete
- Diagnosedaten verschlüsselnWenn aktiviert, werden sensible Diagnosedaten (Pakete, Sitzungsschlüssel, Herstellerdaten) verschlüsselt, bevor sie in den Diagnose-Download aufgenommen werden. Deaktiviere dies nur, wenn du Rohdaten für die lokale Fehlersuche brauchst.
- Sensible Informationen maskieren (nützlich, wenn du Logs öffentlich teilst)
- Verbindungsanfragen und Antworten des Geräts protokollieren
- Deserialisierte Geräte-Update-Nachrichten protokollieren
- Paketobjekte protokollieren
- Verschlüsselte Payloads protokollieren
- Entschlüsselte Payloads protokollieren
- bleak-Debug-Loglevel aktivieren (nicht maskiert und nicht auf dieses Gerät gefiltert)
- Verbindungs-TimeoutAnzahl der Sekunden, die auf die Verbindung und Authentifizierung des Geräts gewartet wird.
Texte aus dem Code von rabits/ha-ef-ble. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- BinärsensorenAktiviert, Fehler, AC angeschlossen, Batterie verbunden, Solar verbunden, Ventilator läuft, Sturmmodus, Netz unter Spannung, Netzstatus, BMS-Betriebszustand, Fehler aufgetreten, Lädt und 6 weitere
- TastenAusschalten, Solar fortsetzen
- KlimaKlima
- ZahlenBackup-Reserve, Ladelimit, Entladelimit, Batterie-Ladelimit, Batterie-Entladelimit, AC-Ladegeschwindigkeit, AC-C20-Ladeleistung, Einspeiseleistungslimit, Grundlast, Lastleistung, Netzeingangsleistungslimit, Ladeleistungslimit und 7 weitere
- AuswahlfelderLED, DC-Ladetyp, DC-Modus, Leistungsmodus, Gaseinheit, Lademodus, Entlademodus, Smart-Backup-Modus, Betriebsmodus, Energiestrategie, Energieüberwachung und 2 weitere
- SensorenDiagnosedaten werden gesammelt, Batteriestand, LCD-Batteriestand, BMS-Batteriestand, Verbleibende Batteriezeit, Hauptbatteriestand, Eingangsleistung, Ausgangsleistung, Verbleibende Ladezeit, Verbleibende Entladezeit, AC-Anschlussstatus und 126 weitere
- SchalterAnschluss, EPS-Modus, Storm Guard, DC-Anschlüsse, AC-Anschlüsse, AC-Laden, AC-LV-Anschluss, AC-HV-Anschluss, DC-12-V-Anschluss, Backup-Reserve, USB-Anschlüsse und 11 weitere
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
Aus der README
Unofficial Bluetooth LE Integration for Home Assistant
Monitor and control your EcoFlow devices locally via Bluetooth
Erscheint in Vulpo
Schnellumschalterkarte, Klimasteuerungs-Karte, Tastenkarte, Auswahl-Karte, Apple Watch, Kontrollzentrum, Klima-Live-Aktivität.Informationen
- Installationen
- 1.370 teilen Analysedaten
- GitHub-Sterne
- 427
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v1.3.0,
- Kategorie
- Energie, Notstrom
- Art
- Marketplace-Integration
- Marke
- EcoFlow
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
ef_ble- Probleme
- Problem melden













