Intégration domotique Emporia Vue, gratuite et open source
Moniteurs Emporia Vue, prises et bornes Emporia : puissance et énergie par circuit.
Publiée par guim31
- Appareils
- Version 1.0.1
- Nécessite Gladys >=5.1.0
- ★ 0
Présentation
Cette intégration amène dans Gladys les moniteurs d’énergie Emporia Vue (Vue 2, Vue 3 et leurs capteurs par circuit), les prises connectées Emporia et les bornes de recharge Emporia, par le cloud Emporia — le même compte que l’appli Emporia Energy.
- Puissance de toute la maison et de chaque circuit (jusqu’à 16 par Vue), rafraîchie chaque minute.
- Index d’énergie cumulés (kWh), total et par circuit, que Gladys transforme en consommation et en coût par demi-heure dans son suivi d’énergie.
- Production solaire et injection sur le réseau quand le Vue est configuré pour le solaire.
- Prises : marche/arrêt, puissance, énergie. Bornes : état du connecteur et de la charge, puissance, énergie et — seulement si vous l’autorisez — marche/arrêt et intensité de consigne.
- Un widget de tableau de bord, un déclencheur et une action de scène.
Développée sans le matériel : vos retours sont bienvenus. Sans lien avec Emporia Energy.
Prérequis
- Gladys Assistant 5.1.0 ou plus récent (les contrats et le calcul du coût arrivent avec Gladys 5.2).
- Un compte Emporia avec e-mail et mot de passe, dont les appareils sont installés dans l’appli Emporia Energy. Les comptes connectés par Google ou Apple, et les comptes protégés par une authentification à plusieurs facteurs (MFA), ne sont pas pris en charge.
- Un accès Internet depuis Gladys : tout passe par le cloud Emporia, il n’y a pas d’API locale.
Configuration
- Dans Gladys, ouvrez Intégrations → Installer depuis GitHub et installez
https://github.com/guim31/gladys-emporia, ou trouvez Emporia Vue dans le catalogue. - Renseignez l’e-mail et le mot de passe de votre compte Emporia et enregistrez. L’état passe à connecté dès qu’Emporia les accepte.
- Langue des noms de fonctionnalités : le français par défaut ; les noms sont figés à l’ajout d’un appareil.
- Autoriser le pilotage des bornes : désactivé par défaut (voir plus bas).
- Ouvrez l’onglet Découverte et ajoutez les appareils voulus. Rien n’est lu chez Emporia pour un appareil que vous n’avez pas ajouté.
Le mot de passe reste dans la configuration de Gladys ; les jetons de connexion sont gardés dans
le volume /data de l’intégration, pour qu’un redémarrage ne refasse pas la connexion.
Appareils
Emporia Vue
Un appareil Gladys par Vue, nommé comme dans l’appli Emporia.
| Fonctionnalité | Type | Unité |
|---|---|---|
| Puissance totale | energy-sensor / power | W |
| Index total | energy-sensor / index | kWh |
| Circuit – puissance (une par circuit) | energy-sensor / power | W |
| Circuit – index (un par circuit) | energy-sensor / index | kWh |
| Puissance non suivie | energy-sensor / power (signée) | W |
| Échange réseau (Vue solaire) | grid-sensor / power (signée) | W |
| Index import réseau (Vue solaire) | energy-sensor / index | kWh |
| Index export réseau (Vue solaire) | grid-sensor / output-index | kWh |
| Circuit – production (solaire) | energy-production-sensor / power | W |
| Circuit – index production | energy-production-sensor / index | kWh |
Les circuits prennent les noms donnés dans l’appli Emporia ; un circuit sans nom s’appelle « Circuit n », et deux circuits de même nom reçoivent leur numéro. La puissance non suivie est ce que les capteurs de circuit ne voient pas (secteur moins circuits).
Prises
Marche/arrêt (pilotable), puissance (W) et index d’énergie (kWh).
Bornes de recharge
| Fonctionnalité | Valeurs |
|---|---|
| Connecteur | disponible, occupé (véhicule branché), indisponible, en défaut |
| État de la charge | en charge, véhicule connecté, en pause côté véhicule ou côté borne |
| Borne activée | marche/arrêt |
| Intensité de consigne | de 6 A au maximum de la borne |
| Puissance de charge | W |
| Index | kWh |
Le pilotage des bornes est désactivé par défaut : Borne activée et Intensité de consigne sont en lecture seule, et une commande est refusée. Activez Autoriser le pilotage des bornes dans la configuration, puis utilisez Mettre à jour dans l’onglet Découverte, pour les rendre pilotables. Une mauvaise commande peut arrêter une charge dont vous avez besoin le matin : réfléchissez avant de l’automatiser.
Suivi d’énergie et signe des valeurs
Emporia donne l’énergie d’une période, pas un index de compteur. L’intégration construit l’index
elle-même : la somme des journées terminées, relues chez Emporia à la toute fin de chaque jour,
plus l’énergie du jour en cours. L’index correspond donc à l’appli Emporia, ne recule jamais, et
rattrape les jours manqués pendant un arrêt de Gladys (31 jours au plus). Il est mis à jour toutes
les 5 minutes et conservé dans /data/energy.json.
Gladys dérive de chaque index la consommation par demi-heure et le coût (suivi d’énergie de Gladys 5.x). Dans les réglages d’énergie, choisissez l’Index total (ou l’Index import réseau d’un Vue solaire) comme compteur principal ; les index des circuits, des prises et des bornes deviennent des sous-compteurs. Une prise ou une borne branchée sur un circuit mesuré est aussi comptée dans ce circuit : organisez la hiérarchie pour ne pas la compter deux fois.
Conventions de signe :
- Emporia compte la production en négatif. Un circuit de type Solar/Generation est publié en production positive (puissance et index de production).
- Sur un Vue solaire, le secteur est l’échange net avec le réseau : l’Échange réseau est positif en import et négatif en injection. L’index de consommation vient alors du canal d’import réseau et l’injection du canal d’export, quand Emporia les fournit.
- Un circuit bidirectionnel (une batterie…) garde son signe et n’a pas d’index, car son total du jour peut être négatif. De même pour la puissance non suivie.
- Tout autre circuit est publié en valeur positive, comme l’appli Emporia l’affiche.
Widget
Puissance Emporia affiche la puissance totale d’un Vue (en direct), sa production solaire s’il en a, et les cinq circuits qui consomment le plus en ce moment, avec leur part du total (sauf sur un Vue solaire, dont le secteur est un échange net). Choisissez le Vue dans les réglages du widget ; vide, il affiche le premier Vue ajouté à Gladys.
Déclencheur de scène
Appareil Emporia hors ligne ou de retour : un Vue, une prise ou une borne a perdu (ou retrouvé) sa liaison au cloud Emporia. Hors ligne, ses mesures s’arrêtent : rien d’autre dans Gladys ne vous le dit. Filtres : l’appareil, et le changement (passe hors ligne / revient en ligne). Variables : nom de l’appareil, nouvel état.
Action de scène
Énergie Emporia du jour : pour l’appareil choisi, renvoie l’énergie prise au réseau aujourd’hui (kWh), la production solaire du jour (kWh), le circuit le plus gourmand du jour et son énergie, et la puissance actuelle (W). Les valeurs viennent des dernières mesures (5 minutes au plus).
La configuration propose aussi un bouton Lister mes appareils Emporia, qui montre ce que contient le compte (Vue avec leur nombre de circuits, prises, bornes).
Exemples de scènes
- Bilan du soir : chaque jour à 21 h → Énergie Emporia du jour sur le Vue → envoyer le message « Aujourd’hui : {{energy_today_kwh}} kWh du réseau, {{production_today_kwh}} kWh de solaire ; en tête : {{top_circuit}} ({{top_circuit_kwh}} kWh) ».
- Appareil oublié : quand Four – puissance reste au-dessus de 1500 W et que personne n’est à la maison → notifier.
- Mesure aveugle : quand le Vue passe hors ligne → envoyer « L’Emporia Vue ne remonte plus rien, vérifiez son Wi-Fi ».
- Surplus solaire : quand l’Échange réseau passe sous −1500 W (injection) → allumer la prise du chauffe-eau.
Rafraîchissement et usage de l’API Emporia
L’API Emporia n’est pas publique et n’a pas de quota publié ; l’intégration reste proche de ce que font l’appli Emporia et l’intégration Home Assistant :
- chaque minute, une requête pour la puissance de tous les canaux de tous les appareils
(
getDeviceListUsages, moyenne sur 1 minute) et une pour les prises, bornes et la connexion ; - toutes les 5 minutes, une requête pour l’énergie du jour (et une par journée terminée à clôturer) ;
- chaque heure, la liste des appareils (noms, circuits).
Rien n’est lu tant qu’aucun appareil Emporia n’est ajouté à Gladys. Seules les valeurs qui changent sont envoyées à Gladys, plus une valeur inchangée toutes les 6 heures pour qu’elle ne paraisse jamais ancienne. Un mot de passe refusé n’est jamais réessayé seul, pour ne pas bloquer le compte.
Dépannage
- « Emporia refuse cet e-mail ou ce mot de passe » : vérifiez-les dans l’appli Emporia, puis enregistrez à nouveau la configuration (c’est ce qui relance l’essai).
- « Votre compte Emporia demande une étape… » : MFA ou changement de mot de passe imposé. Connectez-vous une fois dans l’appli Emporia ; un compte MFA n’est pas utilisable.
- « Le cloud Emporia ne répond pas » : l’intégration réessaie chaque minute et signale le retour ; vérifiez l’accès Internet de Gladys, et l’état d’Emporia dans son appli.
- Un circuit n’a pas de valeur : Emporia n’envoie pas de mesure pour un capteur inutilisé. Nommez et configurez le circuit dans l’appli Emporia.
- Noms dans la mauvaise langue : changez la langue, puis supprimez et ajoutez à nouveau l’appareil (les noms sont figés à la création).
- Journaux : la page de l’intégration les affiche ;
LOG_LEVEL=debugdétaille chaque cycle.
Limites
- Développée sans le matériel ni compte Emporia : testée contre le comportement publié de l’API (PyEmVue et son simulateur), pas contre de vrais appareils. Vos retours sont bienvenus.
- Cloud uniquement : aucune mesure quand Internet ou le cloud Emporia sont coupés. La puissance minute est une moyenne sur 1 minute, pas une valeur instantanée.
- L’index est mis à jour toutes les 5 minutes, n’est pas lu pendant les 30 premières minutes après minuit (l’API Emporia peut encore répondre la veille), et un arrêt de plus de 31 jours perd les jours d’avant.
- Sur un Vue solaire dont Emporia ne fournit pas le canal d’import réseau, il n’y a pas d’index de consommation pour toute la maison (les circuits gardent le leur).
- Les comptes connectés par Google, Apple ou MFA ne sont pas pris en charge. Les batteries, thermostats et véhicules Emporia ne sont pas pris en charge.
- Sans lien avec Emporia Energy ; « Emporia » et « Vue » sont leurs marques.
Paramètres de configuration
Voici les paramètres demandés par Emporia Vue dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte Emporia | section | Non | Utilisez l’e-mail et le mot de passe de l’appli Emporia Energy. L’intégration lit le cloud Emporia une fois par minute. Les comptes connectés par Google ou Apple, ou protégés par MFA, ne sont pas pris en charge. Sans lien avec Emporia Energy. |
string | Oui | ||
| Mot de passe | secret | Oui | |
| Langue des noms de fonctionnalités | select | Non | Les noms sont figés à l’ajout d’un appareil dans Gladys. |
| Autoriser le pilotage des bornes | boolean | Non | Désactivé : les bornes sont en lecture seule. Activé : Gladys peut les couper et régler l’intensité de consigne (6 A minimum). |
Comment installer Emporia Vue dans Gladys
- Dans Gladys, ouvrez Intégrations : Emporia Vue 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-emporia:1.0.1), 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-emporia.
Emporia Vue nécessite Gladys >=5.1.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
Emporia Vue 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, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation