Aller au contenu principal

Intégration domotique Fluvius (Flanders), gratuite et open source

Intégration Fluvius (Flanders) pour Gladys Assistant

Non officiel : compteur Mijn Fluvius (Flandre) : consommation, injection, pic capacitaire.

Voir sur GitHubToutes les intégrations

Intégration non officielle, sans lien avec Fluvius. Elle lit votre compteur numérique en Flandre par votre espace client Mijn Fluvius et envoie sa consommation d'électricité au suivi énergétique de Gladys.

Jamais testée sur un vrai compte Mijn Fluvius. Elle s'appuie sur le projet sander110419/Fluvius-home-assistant (testé en conditions réelles par son auteur) et sur des réponses d'exemple. Dites sur le forum Gladys ce qui marche et ce qui ne marche pas.

Ce que vous obtenez​

Un appareil par compteur saisi (électricité et/ou gaz).

Électricité :

  • Consumption (30 min) ou Consumption (day) : envoyée au suivi énergétique de Gladys, datée par Fluvius ; les coûts de votre contrat d'énergie sont calculés dessus.
  • Consumption, last published day (kWh) : le total du dernier jour complet publié par Fluvius, pour un tableau de bord.
  • Injection, last published day (kWh) : ce que vous avez renvoyé au réseau (panneaux solaires) ce jour-là. Affichée seulement : jamais comptée comme consommation ni facturée.
  • Monthly peak, capacity tariff (kW) : la plus forte puissance moyenne sur un quart d'heure du dernier mois publié, base du tarif capacitaire flamand.

Gaz : seulement Consumption, last published day (kWh). Le gaz reste hors du suivi énergétique dans cette version : Gladys le rattacherait au compteur électrique principal et le facturerait au tarif de l'électricité, faute de contrats de gaz pour l'instant.

Fluvius publie les relevés après coup, en général le lendemain, parfois plus tard, et en corrige certains. L'intégration lit Mijn Fluvius 4 fois par jour : une fois par jour elle relit les derniers jours (7 par défaut), les autres fois les 3 derniers jours. Gladys garde une valeur par demi-heure (ou par jour) : un relevé relu ou corrigé n'est jamais compté deux fois.

Avant de commencer​

  • Gladys 5.2.0 ou plus récent (consommation datée du suivi énergétique), avec le fuseau horaire Europe/Brussels, Europe/Paris ou Europe/Amsterdam (la même heure qu'en Belgique : les jours de Fluvius correspondent alors à ceux de Gladys).
  • Un compte Mijn Fluvius particulier qui se connecte par e-mail et mot de passe. Les comptes professionnels (itsme / eID) ne sont pas utilisables.
  • Double authentification : l'intégration ne sait pas saisir de code. Si votre connexion en demande un (ou de nouvelles conditions, ou un changement de mot de passe), l'intégration l'indique dans son état : connectez-vous une fois sur mijn.fluvius.be dans un navigateur, ou désactivez la double authentification si Fluvius le permet.
  • L'EAN (18 chiffres, commence par 54) et le numéro de série de chaque compteur (tous deux obligatoires) : ils sont affichés dans Mijn Fluvius et sur vos factures.
  • Pour les relevés détaillés d'électricité : activez les relevés au quart d'heure dans Mijn Fluvius. Sinon, choisissez les relevés journaliers.

Installation​

  1. Installez l'intégration depuis le store de Gladys.
  2. Saisissez l'e-mail et le mot de passe de Mijn Fluvius, puis l'EAN et le numéro de série de votre compteur d'électricité et/ou de gaz.
  3. Choisissez les relevés d'électricité : détaillés (quarts d'heure, envoyés par demi-heure) ou journaliers. À choisir avant de créer l'appareil : le type de la fonctionnalité de consommation est figé à la création (après un changement, supprimez l'appareil et recréez-le ; jusque-là l'état le signale et l'appareil garde ses relevés). Le gaz est toujours lu par jour.
  4. Enregistrez, puis cliquez sur Tester la connexion : elle se connecte et affiche le total d'hier de chaque compteur.
  5. Dans l'onglet Découverte, créez les appareils. Leurs relevés sont lus tout de suite.
  6. Dans les réglages énergie de Gladys, rattachez votre contrat d'énergie à la consommation d'électricité.

Confidentialité et sécurité​

  • Le mot de passe est gardé par Gladys dans sa base (masqué dans l'interface, non chiffré), jamais réaffiché, et envoyé seulement à Fluvius (login.fluvius.be) : il n'est posté, en https, qu'au serveur de connexion indiqué par Mijn Fluvius ou à une adresse fluvius.be. L'intégration refuse toute page ou redirection qui sort de Fluvius (ou de son service de connexion Microsoft, b2clogin.com).
  • Le jeton d'accès reste en mémoire : après un redémarrage de l'intégration, elle se reconnecte (une reconnexion à Gladys le garde).
  • Rien n'est envoyé ailleurs. Les journaux ne contiennent jamais l'e-mail, le mot de passe, les jetons ni les adresses appelées.

Limites​

  • Les données viennent de l'espace client, pas d'une API officielle : un changement de Mijn Fluvius peut casser l'intégration jusqu'à sa mise à jour (l'état indique alors « La connexion Fluvius a changé » ; réessai toutes les 6 heures).
  • Un compteur d'électricité et un compteur de gaz par intégration.
  • Le gaz n'est pas dans le suivi énergétique (voir plus haut).
  • L'injection et le pic mensuel sont affichés, pas utilisés par le suivi énergétique : Gladys n'a pas encore de voie datée pour la production d'une intégration.
  • Une demi-heure à laquelle il manque un quart d'heure n'est jamais publiée, sauf si Fluvius la complète dans les jours relus.
  • Si l'intégration (ou Gladys) reste arrêtée plus longtemps que le réglage « Jours relus », les jours d'avant ne sont jamais rattrapés : augmentez le réglage (jusqu'à 31) pendant un jour après un long arrêt.
  • Un pic que Gladys calculerait sur la consommation par demi-heure n'est pas le pic du tarif capacitaire, que Fluvius mesure sur 15 minutes : utilisez le capteur « Monthly peak ».
  • Jours et quarts d'heure suivent l'heure de Bruxelles (journées de 23 et 25 heures comprises).

Dépannage​

  • « a refusé l'e-mail ou le mot de passe » : vérifiez-les dans un navigateur sur mijn.fluvius.be et enregistrez à nouveau. Réessai toutes les 6 heures seulement, pour ne jamais bloquer le compte.
  • « demande une étape que seul un navigateur peut faire » : connectez-vous une fois sur mijn.fluvius.be (code, conditions, mot de passe). Réessai toutes les 6 heures.
  • « a refusé un jeton d'accès tout neuf » ou « La connexion Fluvius a changé » : Mijn Fluvius a changé ; réessai toutes les 6 heures, une mise à jour de l'intégration peut être nécessaire.
  • « a refusé les relevés du compteur… » : vérifiez l'EAN et le numéro de série, et que le compte gère ce compteur.
  • « Aucun relevé détaillé… » : activez les relevés au quart d'heure dans Mijn Fluvius, ou choisissez les relevés journaliers.
  • « a été créé avec les relevés… » : le réglage des relevés d'électricité a changé après la création de l'appareil ; supprimez-le et recréez-le pour le suivre.
  • « demande de ralentir » : rien à faire ; tous les appels attendent le délai demandé par Fluvius (1 minute à 6 heures), même après une reconnexion.
  • « n'a pas pu être lu… nouvel essai dans N min » : un problème passager (réseau, Fluvius en panne) ; réessai après 15, 30, 60, puis toutes les 120 minutes.

Remerciements​

La connexion et la lecture des réponses sont reprises de sander110419/Fluvius-home-assistant (licence MIT). Code source et signalements : LM1LC3N7/gladys-fluvius.

Paramètres de configuration​

Voici les paramètres demandés par Fluvius (Flanders) dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Compte Mijn Fluvius (Flandre, Belgique)sectionNonConnecteur non officiel, sans lien avec Fluvius. Il se connecte à Mijn Fluvius avec votre e-mail et votre mot de passe, comme le site, et lit votre compteur numérique : la consommation d'électricité est envoyée au suivi énergétique de Gladys (par demi-heure ou par jour, avec le retard de Fluvius, en général un jour ou plus), l'injection du dernier jour publié et le pic mensuel du tarif capacitaire sont affichés en capteurs. Le compteur de gaz n'affiche que le total du dernier jour publié (il reste hors du suivi énergétique tant que Gladys ne gère pas les contrats de gaz). Comptes particuliers seulement (les comptes professionnels demandent itsme/eID). La double authentification n'est pas gérée : l'intégration le signale si votre connexion la demande.
E-mail Mijn FluviusstringOui
Mot de passe Mijn FluviussecretOuiGardé par Gladys dans sa base (non chiffré), jamais réaffiché, envoyé seulement à Fluvius (login.fluvius.be).
EAN électricitéstringNonLe code à 18 chiffres du point de raccordement (commence par 54), sur vos factures et dans Mijn Fluvius. Vide : pas de compteur d'électricité.
Numéro de série du compteur d'électricitéstringNonObligatoire avec l'EAN. Affiché dans Mijn Fluvius avec le compteur et imprimé dessus (ex. 1SAG1100000000).
EAN gazstringNonVide : pas de compteur de gaz. L'appareil gaz n'affiche que le total du dernier jour publié : il reste hors du suivi énergétique pour l'instant.
Numéro de série du compteur de gazstringNonObligatoire avec l'EAN. Affiché dans Mijn Fluvius avec le compteur et imprimé dessus.
Relevés électricitéselectNonDétaillés : quarts d'heure, envoyés par demi-heure ; ils doivent être activés dans Mijn Fluvius. Journaliers : une valeur par jour. À choisir avant de créer l'appareil électricité : changer ensuite demande de le supprimer et le recréer. Le gaz est toujours lu par jour.
Jours relusnumberNonUne fois par jour, ces derniers jours sont relus pour rattraper les relevés que Fluvius publie en retard ou corrige (les autres lectures prennent les 3 derniers jours).

Comment installer Fluvius (Flanders) dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Fluvius (Flanders) 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-fluvius: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-fluvius.

Fluvius (Flanders) 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​

Fluvius (Flanders) 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