Captures d’écran Extraites du README de MichelFR/ha-ecoflow-iot.
À propos
EcoFlow IoT est une intégration personnalisée qui connecte les appareils EcoFlow à Home Assistant via l'EcoFlow Developer API. Elle dépend du cloud du fabricant, utilise MQTT pour les données en direct et le contrôle, et passe à l'interrogation HTTP lorsque MQTT est indisponible ou obsolète. Elle ajoute des capteurs, des capteurs binaires, des interrupteurs, des nombres, un sélecteur de mode et une lumière LED, couvrant la batterie, le solaire, le réseau et les totaux d'énergie. Des capteurs d'énergie cumulée sont fournis pour le tableau de bord Énergie, et un capteur de connexion indique l'état de MQTT, la source des données et l'heure de la dernière mise à jour. Les options couvrent l'intervalle d'interrogation HTTP, le seuil d'obsolescence de MQTT, un intervalle d'actualisation active de MQTT et un réglage du signe de la puissance réseau pour les unités Stream. La configuration se fait dans l'interface avec une région ainsi qu'une clé d'accès et une clé secrète issues d'un compte développeur EcoFlow.
Résumé automatique du README et du code de MichelFR/ha-ecoflow-iot, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Lumières
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
EcoFlow IoT
- Région
- Access Key
- Secret Key
Également demandé lors d’une nouvelle connexion au compte.
Après la mise en place
- Utiliser MQTT pour les données en direct
- Intervalle d'interrogation HTTP (secondes)Fréquence d'interrogation de l'API HTTP (solution de repli lorsque MQTT est indisponible, et cadence d'actualisation des valeurs disponibles uniquement en HTTP).
- Seuil d'obsolescence de MQTT (secondes)Si aucun message MQTT n'arrive dans ce délai, l'intégration interroge le HTTP.
- Intervalle d'actualisation active de MQTT (secondes)Fréquence à laquelle demander activement un nouvel instantané des données via MQTT (en publiant un get « latestQuotas », comme le fait l'app EcoFlow). Les appareils ralentissent leur envoi lorsqu'ils sont inactifs, donc un abonnement passif devient obsolète même en étant connecté ; ce réglage maintient le flux de données. Mets 0 pour le désactiver et te fier uniquement à ce que l'appareil envoie, plus le repli HTTP.
- Désactiver la vérification du certificat TLS de MQTT (non sécurisé)Se connecte au broker MQTT d'EcoFlow sans vérifier son certificat TLS. Active cette option uniquement si la connexion échoue parce que ton système ne peut pas valider la chaîne de certificats du broker : elle expose les identifiants du broker et toutes les données en direct à une interception. Laisse-la désactivée pour un usage normal.
- Inverser le signe de la puissance réseau StreamCertaines unités Stream indiquent la puissance réseau avec le signe inversé : elles affichent la puissance injectée dans le réseau comme positive au lieu de négative, à l'opposé de la convention de Home Assistant. Cela dépend du modèle et du firmware, donc ce n'est pas détectable automatiquement. Laisse cette option activée (par défaut) et le signe est corrigé : la puissance réseau est négative pendant l'export, et les capteurs d'énergie d'import / export réseau comptent dans le bon sens. Désactive-la uniquement si ton unité correspond déjà à Home Assistant, c'est-à-dire si l'export vers le réseau affiche déjà une puissance réseau négative (import positif, export négatif). Si tu modifies ce réglage, coche aussi « Réinitialiser les totaux d'énergie d'import/export réseau » ci-dessous : les totaux existants ont été cumulés dans le mauvais sens et ne se corrigeront pas d'eux-mêmes.
- Réinitialiser les totaux d'énergie d'import/export réseau et l'historiqueAction unique : coche cette case et enregistre pour réinitialiser complètement les capteurs d'énergie d'import réseau et d'export réseau. Cela remet à zéro les compteurs en direct et supprime leur historique enregistré ainsi que leurs statistiques du tableau de bord Énergie, de sorte que les anciennes données dans le mauvais sens disparaissent et qu'ils repartent de zéro. Recommandé après avoir modifié le réglage du signe ci-dessus. Laisse-la désactivée pour un usage normal.
Textes issus du code de MichelFR/ha-ecoflow-iot. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Entités
- Capteurs binairesChauffage de la batterie, Compteur intelligent connecté, Protection contre les tempêtes, Mode hors réseau, Infiltration d'eau, Problème, Chaîne solaire 1 connectée, Chaîne solaire 2 connectée, Chaîne solaire 3 connectée, Chaîne solaire 4 connectée, Batterie en charge
- LumièresLED
- NombresLimite de charge, Limite de décharge, Limite de puissance d'injection, Réserve de secours
- SélecteursMode de fonctionnement
- CapteursConnexion, Source des données, Dernière mise à jour MQTT, Batterie, Puissance de la batterie, Puissance solaire, Puissance réseau, Énergie solaire, Puissance de la chaîne solaire 1, Puissance de la chaîne solaire 2, Puissance de la chaîne solaire 3, Puissance de la chaîne solaire 4 et 76 autres
- InterrupteursPrise secteur 1, Mode autoalimenté, Injection dans le réseau, Prise secteur 2
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
Extrait du 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…
S’affiche dans Vulpo :
carte Lumière, carte Bascule rapide, carte Sélection, carte Graphique, Apple Watch, centre de contrôle.Informations
- Installations
- 163 partagent leurs statistiques
- Étoiles GitHub
- 15
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v0.50.0,
- Catégorie
- Énergie, Alimentation de secours
- Type
- Intégration de la Marketplace
- Marque
- EcoFlow
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
ecoflow_iot- Problèmes
- Signaler un problème
