Screenshots Uit de README van MichelFR/ha-ecoflow-iot.
Over dit item
EcoFlow IoT is een aangepaste integratie die EcoFlow-apparaten via de EcoFlow Developer API met Home Assistant verbindt. Het maakt gebruik van de cloud van de fabrikant, gebruikt MQTT voor live gegevens en bediening en schakelt over op HTTP-polling wanneer MQTT niet beschikbaar of verouderd is. Het voegt sensoren, binaire sensoren, schakelaars, nummers, een modusselectie en een ledlicht toe, voor accu, zon, net en energietotalen. Cumulatieve energiesensoren zijn beschikbaar voor gebruik met het Energiedashboard en een verbindingssensor toont de MQTT-status, de gegevensbron en het tijdstip van de laatste update. De opties omvatten het HTTP-pollinginterval, de drempel voor verouderde MQTT-gegevens, een actief MQTT-verversingsinterval en een instelling voor het teken van het netvermogen voor Stream-units. De installatie gebeurt in de gebruikersinterface met een regio en een toegangssleutel en geheime sleutel van een EcoFlow-ontwikkelaarsaccount.
Automatische samenvatting van de README en de code van MichelFR/ha-ecoflow-iot, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op
Ondersteunt
Gebruikt de cloud van de aanbieder Heeft een internetverbinding en een account bij de aanbieder nodig.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.
Levert
- Lichten
- Schakelaars
- Sensoren
Instellen
Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.
EcoFlow IoT
- Regio
- Toegangssleutel
- Geheime sleutel
Ook gevraagd bij het opnieuw inloggen.
Na het instellen
- MQTT gebruiken voor live gegevens
- HTTP-pollinginterval (seconden)Hoe vaak de HTTP API wordt opgevraagd (terugvaloptie wanneer MQTT niet beschikbaar is, en de frequentie voor het verversen van waarden die alleen via HTTP beschikbaar zijn).
- Drempel voor verouderde MQTT-gegevens (seconden)Als er binnen dit tijdvenster geen MQTT-bericht binnenkomt, vraagt de integratie HTTP op.
- Actief MQTT-verversingsinterval (seconden)Hoe vaak actief een nieuwe momentopname van de gegevens via MQTT wordt opgevraagd (door een "latestQuotas"-get te publiceren, hetzelfde als wat de EcoFlow-app doet). Apparaten verlagen hun verzendfrequentie wanneer ze inactief zijn, waardoor een passief abonnement verouderd raakt, ook als de verbinding actief is. Hiermee blijven de gegevens binnenkomen. Stel in op 0 om dit uit te schakelen en alleen te vertrouwen op wat het apparaat zelf verzendt plus de HTTP-terugval.
- Verificatie van het MQTT TLS-certificaat uitschakelen (onveilig)Maakt verbinding met de EcoFlow MQTT-broker zonder het TLS-certificaat te verifiëren. Schakel dit alleen in als de verbinding mislukt omdat je systeem de certificaatketen van de broker niet kan valideren. Het stelt de inloggegevens van de broker en alle live gegevens bloot aan onderschepping. Laat dit uit bij normaal gebruik.
- Teken van Stream-netvermogen omkerenSommige Stream-units rapporteren het netvermogen met omgekeerd teken: ze tonen vermogen dat aan het net wordt teruggeleverd als positief in plaats van negatief, het tegenovergestelde van de conventie van Home Assistant. Dit hangt af van het model en de firmware, dus het kan niet automatisch worden gedetecteerd. Laat dit aan staan (de standaardinstelling) en het teken wordt gecorrigeerd: het netvermogen is negatief tijdens teruglevering en de energiesensoren voor netimport / netexport tellen in de juiste richting. Zet dit alleen uit als je unit al overeenkomt met Home Assistant, dus als het netvermogen bij teruglevering al negatief is (import positief, export negatief). Als je deze instelling wijzigt, vink dan hieronder ook "Energietotalen voor netimport/netexport resetten" aan, want de bestaande totalen zijn in de verkeerde richting opgebouwd en corrigeren zichzelf niet.
- Totalen en geschiedenis van netafname/netlevering van energie resettenEenmalige actie: vink dit aan en sla op om de energiesensoren voor netafname en netlevering volledig te resetten. Het zet de live tellers op nul en verwijdert hun opgeslagen geschiedenis en de statistieken van het Energiedashboard, zodat de oude gegevens in de verkeerde richting verdwijnen en ze opnieuw vanaf nul beginnen. Aanbevolen na het wijzigen van de bovenstaande tekeninstelling. Laat dit uit bij normaal gebruik.
Teksten uit de code van MichelFR/ha-ecoflow-iot. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.
Entiteiten
- Binaire sensorenAccuverwarming, Slimme meter verbonden, Stormbeveiliging, Off-grid-modus, Waterindringing, Probleem, Zonnestring 1 verbonden, Zonnestring 2 verbonden, Zonnestring 3 verbonden, Zonnestring 4 verbonden, Accu laadt
- LichtenLED
- NummersLaadlimiet, Ontlaadlimiet, Limiet terugleververmogen, Back-upreserve
- SelectiesBedrijfsmodus
- SensorenVerbinding, Gegevensbron, Laatste MQTT-update, Accu, Accuvermogen, Zonnevermogen, Netvermogen, Zonne-energie, Vermogen zonnestring 1, Vermogen zonnestring 2, Vermogen zonnestring 3, Vermogen zonnestring 4 en nog 76
- SchakelaarsStopcontact 1, Zelfvoorzieningsmodus, Teruglevering aan het net, Stopcontact 2
Probleemoplossing
- DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
Uit de README
A clean, production-ready custom integration for EcoFlow devices built on the official EcoFlow Developer API (the accessKey/secretKey IoT Open Platform). It uses MQTT for live data and control, and automatically falls back to the HTTP REST API when MQTT is unavailable.
It aims for feature parity with the official EcoFlow developer documentation: every supported device's documented quota fields and set-commands are mapped to Home Assistant entities.
- MQTT-first, HTTP fallback — real-time push updates over TLS MQTT; HTTP polling kicks in only when MQTT is disconnected or stale, keeping cloud API usage minimal.
- Control over MQTT with HTTP fallback — set commands are published over MQTT and confirmed via set_reply; if MQTT is down or unacknowledged, the command is retried over HTTP PUT.
- MQTT connection status sensor — an always-available diagnostic sensor per device showing connected / connecting / disconnected, plus the active data source and last MQTT update time.
- Full entity coverage — sensors (battery, solar per-MPPT, grid/AC, inverter, power flow, energy totals), binary sensors, switches, numbers and a mode select.
- Energy Dashboard ready — devices expose cumulative Wh energy sensors (solar production, grid import/export, battery charge/discharge, per-device consumption), derived from live power where the API…
Te zien in Vulpo
Licht-kaart, “Snel wisselen”-kaart, Selectie-kaart, Grafiek-kaart, Apple Watch, Bedieningspaneel.Informatie
- Installaties
- 163 die analysegegevens delen
- GitHub-sterren
- 15
- Verbinding
- Gebruikt de cloud van de aanbieder
- Onderhoud
- Bijgewerkt in de afgelopen 6 maanden
- Versie
- v0.50.0,
- Categorie
- Energie, Noodstroom
- Soort
- Marketplace-integratie
- Merk
- EcoFlow
- Vereist
- Vereist de Marketplace (HACS op 2026.10 en ouder)
- Domein
ecoflow_iot- Problemen
- Probleem melden
















