Nouvelle intégration : EcoFlow (River 2 / River 2 Max / River 2 Pro)
Note : le bloc en bas à gauche est une prise connectée devant le EcoFlow, que j’utilisais avant l’intégration.
Une intégration externe pour surveiller et piloter vos stations EcoFlow de la gamme River 2 directement depuis Gladys, via le cloud EcoFlow (le même que celui utilisé par l’app officielle).
Ce qu’elle fait
Pour chaque appareil détecté, vous obtenez :
- Niveau de batterie (%)
- Puissance de charge AC, puissance de sortie totale, puissance de sortie AC, puissance solaire entrante
- Interrupteurs : sortie AC, X-Boost, sortie DC (allume-cigare), réserve de secours
- Une action « Tester la connexion » pour vérifier qu’un appareil répond
Deux façons de se connecter
- Compte développeur EcoFlow (Open Platform) — la voie officielle et documentée, avec découverte automatique de tous les appareils du compte. Inconvénient : il faut créer un compte développeur et attendre l’approbation d’EcoFlow (~1 semaine), et certains appareils déjà liés à l’app mobile peuvent être refusés côté EcoFlow (« déjà assigné ») — une limitation connue et récurrente de leur plateforme, indépendante de l’intégration.
- Connexion simple (email/mot de passe) — les mêmes identifiants que l’app EcoFlow, sans compte développeur ni attente. Non officielle (points d’accès internes de l’app), donc pas de découverte automatique : le numéro de série de chaque appareil se saisit à la main. C’est la méthode qui débloque les appareils refusés par la voie développeur — testée et fonctionnelle sur un River 2 Pro réel (ce que j’utilise).
Les deux méthodes peuvent tourner en même temps.
Limites connues
- Aucun contrôle local/LAN : même un appareil qui ne quitte jamais votre WiFi passe par le cloud EcoFlow, comme l’app officielle — confirmé par EcoFlow eux-mêmes (seule exception dans tout leur catalogue : l’EZ1, un minuteur d’arrosage sans rapport).
- Pas encore de réglage des limites de charge/décharge ni du niveau de réserve de secours en pourcentage (en lecture seule pour l’instant).
- La méthode simple (2) est basée sur des points d’accès non documentés par EcoFlow : elle peut casser sans préavis si EcoFlow change son app.
Installation
Mode développeur dans Gladys → coller le lien GitHub - LM1LC3N7/gladys-ecoflow · GitHub
Sécurité, maintien et réutilisation
- Communication en HTTPS/MQTT signé uniquement — aucun accès local ni port ouvert sur l’appareil
- Conteneur non-root, système de fichiers en lecture seule,
npm installsans exécution de script (--ignore-scripts) - Identifiants stockés chiffrés par Gladys, jamais transmis ailleurs qu’à EcoFlow
- CI (lint, tests, build) sur chaque changement + mises à jour de dépendances automatiques (Dependabot), publication d’image à chaque évolution
- Signature de requêtes et protocole MQTT recoupés avec deux implémentations déjà utilisées par la communauté (
tolwi/hassio-ecoflow-cloud,rustyy/ecoflow-api), validation via les schémas réels de@ecoflow-api/schemas