Intégration ecojoko pour Gladys Assistant
Puissance en direct, consommation du jour et capteurs d'ambiance de votre assistant ecojoko.
Publiée par guim31
- Appareils
- Version 1.0.2
- Nécessite Gladys >=4.86.0
- ★ 0
Ramenez dans Gladys les mesures de votre assistant d'énergie ecojoko : la puissance consommée en direct, la consommation du jour et, si votre afficheur les remonte, la température et l'humidité. L'intégration fabrique aussi un index cumulé à partir des totaux journaliers, ce qui permet à Gladys de construire son tableau de bord énergie (consommation par demi-heure et coût selon votre contrat).
| Capteur | Unité | Ce qu'il indique |
|---|---|---|
| Puissance instantanée | W | Ce que la maison tire du réseau à l'instant |
| Index de consommation | kWh | Compteur cumulé depuis l'installation (base du tableau de bord) |
| Consommation du jour | kWh | Le total du jour, remis à zéro chaque nuit |
| Période du jour | kWh | Idem par période tarifaire (HC/HP, couleurs Tempo…), optionnel |
| Surplus solaire du jour | kWh | Énergie injectée au réseau, si ecojoko la mesure chez vous |
| Température / humidité | °C, % | Intérieure (afficheur) et extérieure, dans un second appareil |
Prérequis
- Un capteur ecojoko installé et relié au cloud ecojoko.
- Les identifiants de votre compte ecojoko (ceux de l'application mobile ou de service.ecojoko.com).
Configuration
- Saisissez votre e-mail et votre mot de passe ecojoko, puis enregistrez.
- Cliquez sur Tester la connexion : le message confirme la passerelle trouvée, la puissance du moment et ce que votre compte expose (périodes tarifaires, surplus solaire, capteur d'ambiance).
- Allez dans Appareils de l'intégration et ajoutez l'appareil
ecojoko(etecojoko (ambiance)s'il apparaît). - Pour le tableau de bord énergie, choisissez dans les réglages énergie de Gladys la fonctionnalité Index de consommation comme compteur principal et renseignez votre contrat.
Les deux fréquences se règlent dans la configuration : la puissance instantanée (30 s par défaut) et les statistiques du jour (5 min par défaut). Chaque lecture est une requête vers le cloud ecojoko : inutile de descendre en dessous de quelques secondes, l'afficheur lui-même n'est pas plus rapide.
Afficher la puissance en jauge
La puissance est publiée comme un échange réseau signé : positive quand vous tirez du courant, négative quand vos panneaux injectent. L'échelle déclarée va de −12 000 à +12 000 W, donc 0 W tombe au milieu.
Sur un tableau de bord Gladys, ajoutez une boîte Jauge, choisissez la fonctionnalité Puissance instantanée, puis activez les couleurs personnalisées :
- seuil bas à 0 et couleur basse en vert : toute valeur négative, donc toute surproduction, s'affiche en vert ;
- seuil haut à la puissance que vous jugez élevée (3 000 W par exemple) et couleur haute en rouge ;
- la couleur intermédiaire s'applique entre les deux.
Si vous produisez
Quand votre compte ecojoko remonte un surplus solaire, deux capteurs supplémentaires apparaissent : le surplus du jour, remis à zéro chaque nuit, et un index de production injectée, cumulé et jamais remis à zéro. Le second est le format que Gladys suivra pour la production, comme il le fait déjà pour la consommation.
Le tableau de bord énergie
La consommation par tranche de 30 minutes et son coût ne sont pas calculés par l'intégration : Gladys les dérive lui-même de l'Index de consommation. Deux conditions pour qu'ils se remplissent, sans quoi la vignette affiche « Pas de valeur récente » :
- un contrat d'électricité renseigné dans les réglages énergie de Gladys ;
- au moins 30 minutes d'index déjà remontées, le temps qu'un premier écart soit mesurable.
À savoir
- Aucune API officielle. ecojoko n'en publie pas ; l'intégration utilise l'interface de sa propre application web, comme le font les intégrations communautaires pour Home Assistant. Elle peut cesser de fonctionner si ecojoko la modifie. Rien n'est jamais écrit sur votre compte.
- L'index part de zéro à l'installation, pas de la valeur de votre Linky : ecojoko n'expose pas l'index du compteur. Seules les différences comptent pour Gladys. L'état est conservé dans le volume de l'intégration : un redémarrage ne le remet pas à zéro, et les jours manqués pendant un arrêt sont rattrapés depuis les statistiques hebdomadaires d'ecojoko.
- Les périodes tarifaires viennent du tarif que vous avez déclaré dans l'application ecojoko. Si vous le changez, enregistrez à nouveau la configuration : les nouveaux capteurs apparaîtront dans Appareils.
- Un seul compte, une seule passerelle : si plusieurs passerelles sont rattachées au compte, seule la première est prise en charge.
- Les capteurs du jour se remettent à zéro à minuit (heure de Paris), comme dans l'application ecojoko. Seul l'index cumulé continue de croître.
Dépannage
- « ecojoko refuse l'identifiant ou le mot de passe » : vérifiez-les sur service.ecojoko.com. L'intégration s'arrête volontairement tant que la configuration n'est pas corrigée, pour ne pas bloquer votre compte.
- « Le cloud ecojoko ne répond pas » : incident côté ecojoko ou coupure Internet ; les tentatives reprennent d'elles-mêmes. Les valeurs reprennent sans intervention.
- Pas d'appareil « ambiance » : votre compte ne remonte pas de capteur température/humidité, ou l'option est désactivée dans la configuration.
Projet communautaire indépendant, sans lien avec la société ecojoko.
Paramètres de configuration
Voici les paramètres demandés par ecojoko dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Votre capteur ecojoko envoie ses mesures au cloud ecojoko ; cette intégration les relit avec votre compte ecojoko (celui de l'application mobile). ecojoko ne publie pas d'API officielle : c'est l'interface de sa propre application web qui est utilisée, elle peut changer sans préavis. Rien n'est jamais écrit sur votre compte. |
| E-mail ecojoko | string | Oui | |
| Mot de passe ecojoko | secret | Oui | |
| Rafraîchissement de la puissance (s) | number | Non | Secondes entre deux lectures de la puissance instantanée. Restez raisonnable : chaque lecture est une requête vers le cloud ecojoko. |
| Rafraîchissement des statistiques du jour (s) | number | Non | Secondes entre deux mises à jour de la consommation du jour, de l'index cumulé et des capteurs d'ambiance. |
| Un capteur par période tarifaire | boolean | Non | Ajoute les kWh du jour par période remontée par ecojoko (heures creuses/pleines, couleurs Tempo) quand votre tarif en déclare. |
| Température et humidité ambiantes | boolean | Non | Publie la température et l'humidité intérieures/extérieures de l'afficheur ecojoko comme second appareil. |
Comment installer ecojoko dans Gladys
- Dans Gladys, ouvrez Intégrations : ecojoko apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-ecojoko:1.0.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-ecojoko.
ecojoko nécessite Gladys >=4.86.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
ecojoko est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation