Aller au contenu principal

Intégration domotique E3/DC, gratuite et open source

Intégration E3/DC pour Gladys Assistant

Non officiel : stockage E3/DC (S10, Quattroporte) en local, lecture seule.

Voir sur GitHubToutes les intégrations

Intégration non officielle, sans lien avec E3/DC (HagerEnergy). Elle lit votre système de stockage E3/DC (S10 E, S10 E Pro, S10 X, S10 Mini, Quattroporte…) sur votre réseau local, par RSCP, le protocole local du système, sans cloud : le portail E3/DC n'est jamais contacté.

Jamais testé avec un vrai appareil : l'intégration a été écrite à partir de la bibliothèque pye3dc (MIT), sans système E3/DC sous la main. Vos retours sont les bienvenus.

Lecture seule​

L'intégration ne fait que lire. Elle ne change jamais un réglage, ne lance ni n'arrête jamais une charge, une décharge ou une wallbox, et n'envoie aucune requête qui modifie quoi que ce soit (son code n'en connaît aucune).

Avant de commencer​

Sur l'écran du système : menu principal → Personnaliser → Profil utilisateur → mot de passe RSCP. Définissez un mot de passe RSCP (32 octets au plus, soit 32 caractères sans accent). Il protège les trames échangées sur votre réseau : sans lui, le système ne répond pas.

Il vous faut aussi l'identifiant et le mot de passe de votre compte E3/DC (ceux du portail et de l'application E3/DC) : le système les vérifie lui-même, sur votre réseau.

Donnez au système une adresse fixe dans votre box (réservation DHCP).

Configuration​

ChampÀ saisir
Adresse du systèmeSon adresse IP, ex. 192.168.1.50 (port 5033 sauf si vous en ajoutez un autre).
Identifiant du compte E3/DCL'identifiant du portail et de l'application. Jamais écrit dans les journaux ni affiché dans un état.
Mot de passe du compte E3/DCGardé par Gladys dans sa base, jamais réaffiché, envoyé seulement au système sur votre réseau.
Mot de passe RSCPCelui défini sur l'écran. Gardé par Gladys dans sa base, jamais réaffiché, jamais envoyé : il protège seulement les trames.
Production solaire« Suivi énergétique » (par défaut) ou « Capteur seulement » (voir plus bas).
Fuseau horaireOù la journée des énergies du jour commence à minuit. Europe/Berlin par défaut.
Intervalle de lecture30 s par défaut, de 30 à 300 s.

Cliquez ensuite sur Tester la connexion : le système est lu une fois (jamais plus vite que l'intervalle) et son numéro de série s'affiche avec quelques valeurs.

Ce que vous obtenez​

Un appareil par système, nommé d'après son numéro de série (« E3/DC S10-… ») ; créez-le depuis l'onglet Découverte. Ses fonctions :

  • état de charge (%) ;
  • puissance de la batterie (W, signée comme le système la donne : selon pye3dc, positive en charge, négative en décharge) ;
  • puissance solaire (W), et l'index de production solaire pour le suivi énergétique de Gladys (avec sa production par 30 minutes, calculée par Gladys) ;
  • consommation de la maison (W) ;
  • puissance réseau (W, signée comme le système la donne : selon pye3dc, positive quand elle est prélevée sur le réseau, négative quand elle y est injectée) ;
  • puissance d'une source additionnelle (W, un onduleur externe, signée telle que lue) ;
  • autarcie et autoconsommation (%) ;
  • puissance de la wallbox, totale et solaire (W), en lecture seule ;
  • les énergies du jour (kWh, depuis minuit) : production solaire, charge et décharge de la batterie, prélevé sur le réseau et injecté, consommation de la maison.

Les signes des puissances de la batterie et du réseau ne sont pas confirmés sur un vrai système : chacune est une seule valeur signée, telle que lue, jamais séparée.

Suivi énergétique​

  • Le système ne donne son énergie solaire que sous forme de compteur du jour (sa base de données, depuis minuit). L'intégration en construit un index cumulé (le compteur de chaque jour ajouté aux jours terminés), le vérifie par une garde, et l'envoie comme index de production solaire. Tout doute compte moins, jamais plus : un saut ou une baisse du compteur loin de minuit n'est pas compté (l'état le dit) ; ce que le système produit entre la dernière lecture avant minuit et minuit n'est pas compté.
  • Un saut ou une baisse de l'index construit est retenu : la dernière valeur acceptée est renvoyée et l'état l'affiche. Un saut, s'il est juste, s'accepte en cliquant deux fois sur Accepter l'index retenu (le premier clic liste, le second accepte exactement ce qui a été listé). Une baisse n'est jamais acceptée : elle se corrige seule quand l'index repasse au-dessus de la dernière valeur acceptée, et seule l'énergie au-dessus est comptée. Enregistrer la configuration n'accepte rien.
  • Pas de double comptage : la consommation de la maison et l'énergie prélevée sur le réseau sont déjà comptées par votre compteur principal (Linky…) ; l'intégration les affiche comme de simples valeurs, jamais comme un index. L'énergie injectée n'est jamais comptée comme une consommation.
  • « Capteur seulement » : à choisir si une autre intégration envoie déjà cette production solaire à Gladys (sinon elle serait comptée deux fois). À choisir avant de créer l'appareil. En revenant plus tard au « Suivi énergétique », la première valeur est retenue (deux clics pour l'accepter).

Erreurs et pauses​

  • Connexion refusée (identifiant ou mot de passe), ou pas de réponse lisible à la connexion deux fois de suite (le plus souvent un mauvais mot de passe RSCP ; le second essai vient 15 minutes après le premier, pour qu'un système qui redémarre n'arrête pas les lectures) : les lectures s'arrêtent, même après un redémarrage, jusqu'à ce que vous corrigiez la configuration et l'enregistriez. L'intégration ne réessaie jamais seule ; le bouton Tester la connexion fait un essai par clic (jamais plus vite que l'intervalle).
  • Injoignable : nouvel essai après l'intervalle de lecture (1 minute au moins), puis après le double, et ainsi de suite jusqu'à 15 minutes (ou l'intervalle, s'il est plus long).
  • Énergies du jour non lues : seules elles manquent ; l'état le dit.
  • Un autre numéro de série à l'adresse : son propre appareil apparaît dans la Découverte ; les valeurs ne vont jamais à l'appareil d'un autre numéro de série.
  • Une seule connexion à la fois, jamais une lecture plus rapide que l'intervalle (reconnexion, enregistrement d'un formulaire inchangé, redémarrage, bouton de test) ; seuls une nouvelle adresse ou de nouveaux identifiants, enregistrés par vous, sont lus tout de suite.

Confidentialité​

Rien ne sort de votre réseau. L'identifiant, le mot de passe et le mot de passe RSCP ne sont jamais écrits dans les journaux, dans les données de l'intégration ni dans un état. Tant qu'une connexion est refusée, les données de l'intégration gardent seulement une empreinte de 8 bits de ce qui a été refusé (pour savoir, après un redémarrage, si la configuration a changé) ; elle ne permet de confirmer aucun mot de passe et s'efface à la connexion réussie suivante.

Paramètres de configuration​

Voici les paramètres demandés par E3/DC dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Système de stockage E3/DCsectionNonConnecteur non officiel, sans lien avec E3/DC (HagerEnergy). Il lit votre système E3/DC (S10 E, S10 X, S10 Mini, Quattroporte…) sur votre réseau par RSCP, son protocole local, toutes les 30 s par défaut : état de charge, batterie, solaire, maison, réseau, wallbox, autarcie, énergies du jour, et un index de production solaire pour le suivi énergétique de Gladys. Sans cloud : le portail E3/DC n'est jamais contacté. Lecture seule : il ne change jamais un réglage du système. Jamais testé avec un vrai appareil.
Adresse du systèmestringOuiL'adresse IP du système E3/DC sur votre réseau (visible dans votre box ou sur son écran), avec un port seulement s'il n'est pas 5033. Donnez-lui de préférence une adresse fixe dans votre box.
Identifiant du compte E3/DCstringOuiL'identifiant de votre compte E3/DC (celui du portail et de l'application E3/DC). Le système le vérifie lui-même sur votre réseau : le portail n'est jamais contacté. Il n'est jamais écrit dans les journaux ni affiché dans un état.
Mot de passe du compte E3/DCsecretOuiLe mot de passe de ce compte. Gardé par Gladys dans sa base, jamais réaffiché, envoyé seulement au système E3/DC sur votre réseau.
Mot de passe RSCPsecretOuiLe mot de passe RSCP que vous avez défini sur l'écran du système (menu principal, Personnaliser, Profil utilisateur, mot de passe RSCP), 32 octets au plus, soit 32 caractères sans accent. Gardé par Gladys dans sa base, jamais réaffiché, jamais envoyé : il protège seulement les trames échangées avec le système.
Production solaireselectNon« Suivi énergétique » : la production solaire du système va au suivi énergétique de Gladys sous forme d'index. « Capteur seulement » : seulement affichée, jamais comptée ; choisissez-le si une autre intégration envoie déjà cette production à Gladys (sinon comptée deux fois). À choisir avant de créer l'appareil.
Fuseau horairestringNonOù la journée des énergies du jour commence à minuit (un nom IANA). Europe/Berlin par défaut, le même minuit que Vienne, Zurich et Paris.
Intervalle de lecture (secondes)numberNonFréquence de lecture du système, de 30 à 300 secondes. Jamais plus vite, sauf juste après l'enregistrement d'une nouvelle adresse ou de nouveaux identifiants.

Comment installer E3/DC dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : E3/DC apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-e3dc:0.1.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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-e3dc.

E3/DC nécessite Gladys >=5.2.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​

E3/DC 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 LM1LC3N7, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le