Fluvius (Flanders) Smart-Home-Integration, kostenlos und Open Source

Unofficial: Mijn Fluvius smart meter (Flanders): consumption, injection, capacity peak.

• Veröffentlicht von LM1LC3N7
• Geräte
• Version 0.1.1
• Erfordert Gladys >=5.2.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Unofficial integration, not affiliated with Fluvius. It reads your digital meter in Flanders through your Mijn Fluvius customer account and feeds its electricity consumption to the Gladys energy monitoring.

Never tested on a real Mijn Fluvius account. It is built from the project sander110419/Fluvius-home-assistant (whose author tested it live) and from sample answers. Please report what works and what does not on the Gladys forum.

What you get

One device per meter you enter (electricity and/or gas).

Electricity:

• Consumption (30 min) or Consumption (day): fed to the energy monitoring of Gladys, dated by Fluvius; the costs of your energy contract are computed on it.
• Consumption, last published day (kWh): the total of the latest complete day Fluvius published, for a dashboard.
• Injection, last published day (kWh): what you sent to the grid (solar panels) that day. Shown only: never counted as consumption nor billed.
• Monthly peak, capacity tariff (kW): the highest quarter-hour average power of the latest month Fluvius published, the base of the Flemish capacity tariff.

Gas: only Consumption, last published day (kWh). The gas stays out of the energy monitoring in this version: Gladys would attach it to the main electric meter and price it at the electricity tariff, as it has no gas contracts yet.

Fluvius publishes the readings after the fact, usually the next day, sometimes later, and corrects some. The integration reads Mijn Fluvius 4 times a day: once a day it reads again the last days (7 by default), the other times the last 3 days. Gladys keeps one value per half hour (or per day): a reading read again or corrected never counts twice.

Before you start

• Gladys 5.2.0 or newer (dated consumption of the energy monitoring), with its time zone set to Europe/Brussels, Europe/Paris or Europe/Amsterdam (the same clock as Belgium: the days of Fluvius then match the days of Gladys).
• A personal Mijn Fluvius account that signs in with an e-mail and a password. Professional accounts (itsme / eID) cannot be used.
• Two-step verification: the integration cannot type a code. If your sign-in asks for one (or for new terms, or a password change), the integration says so in its status: sign in once on mijn.fluvius.be in a browser, or turn the two-step verification off if Fluvius lets you.
• The EAN (18 digits, starts with 54) and the serial number of each meter (both required): they are shown in Mijn Fluvius and on your bills.
• For the detailed electricity readings: turn the quarter-hour readings on in Mijn Fluvius. Otherwise, choose the daily readings.

Setup

1. Install the integration from the Gladys store.
2. Fill in the e-mail and the password of Mijn Fluvius, then the EAN and the serial number of your electricity meter and/or your gas meter.
3. Choose the electricity readings: detailed (quarter hours, sent by half hour) or daily. Choose before creating the device: the type of the consumption feature is fixed when the device is created (after a change, delete the device and create it again; until then the status says so and the device keeps its readings). The gas is always read by day.
4. Save, then press Test the connection: it signs in and shows yesterday's total of each meter.
5. In the Discover tab, create the devices. Their readings are read right away.
6. In the energy settings of Gladys, attach your energy contract to the electricity consumption.

Privacy and security

• The password is kept by Gladys in its database (masked in the interface, not encrypted), never shown again, and only sent to Fluvius (login.fluvius.be): it is posted, in https, only to the sign-in server Mijn Fluvius names or to a fluvius.be address. The integration refuses any page or redirect that leaves Fluvius (or its Microsoft sign-in service, b2clogin.com).
• The access token stays in memory: after a restart of the integration, it signs in again (a reconnection to Gladys keeps it).
• Nothing is sent anywhere else. The logs never hold the e-mail, the password, the tokens or the addresses called.

Limits

• The data comes from the customer portal, not from an official API: a change of Mijn Fluvius can break the integration until it is updated (the status then says "The Fluvius login changed"; tried again every 6 hours).
• One electricity meter and one gas meter per integration.
• The gas is not in the energy monitoring (see above).
• The injection and the monthly peak are shown, not used by the energy monitoring: Gladys has no dated production path for an integration yet.
• A half hour with one quarter hour missing is never published, unless Fluvius completes it within the days read again.
• If the integration (or Gladys) stays stopped longer than the "Days read again" setting, the days before that window are never filled in: raise the setting (up to 31) for a day after a long stop.
• A peak Gladys may compute from the 30-minute consumption is not the peak of the capacity tariff, which Fluvius measures over 15 minutes: use the "Monthly peak" sensor.
• Days and quarter hours follow the Brussels time (23- and 25-hour days included).

Troubleshooting

• "refused the e-mail or the password": check them in a browser on mijn.fluvius.be and save again. Tried again every 6 hours only, so that the account is never locked.
• "asks for a step only a browser can do": sign in once on mijn.fluvius.be (code, terms, password change). Tried again every 6 hours.
• "refused a fresh access token" or "The Fluvius login changed": Mijn Fluvius changed; tried again every 6 hours, an update of the integration may be needed.
• "refused the readings of the … meter": check the EAN and the serial number, and that the account manages this meter.
• "No detailed readings…": turn the quarter-hour readings on in Mijn Fluvius, or choose the daily readings.
• "was created with … readings": the electricity readings setting changed after the device was created; delete the device and create it again to follow it.
• "asked to slow down": nothing to do; every call waits for the time Fluvius asked (1 minute to 6 hours), even across a reconnection.
• "could not be read… new try in N min": a passing problem (network, Fluvius down); tried again after 15, 30, 60, then every 120 minutes.

Credits

The sign-in and the reading of the answers are ported from sander110419/Fluvius-home-assistant (MIT license). Source code and issues: LM1LC3N7/gladys-fluvius.

Konfigurationseinstellungen

Diese Einstellungen fragt Fluvius (Flanders) in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Mijn Fluvius account (Flanders, Belgium)	section	Nein	Unofficial connector, not affiliated with Fluvius. It signs in to Mijn Fluvius with your e-mail and password, like the website, and reads your digital meter: the electricity consumption is sent to the Gladys energy monitoring (by half hour or by day, with the delay of Fluvius, usually a day or more), the injection of the last published day and the monthly peak of the capacity tariff are shown as sensors. The gas meter only shows the total of the last published day (it stays out of the energy monitoring until Gladys handles gas contracts). Personal accounts only (professional accounts need itsme/eID). Two-step verification cannot be handled: the integration says so if your login asks for it.
Mijn Fluvius e-mail	string	Ja
Mijn Fluvius password	secret	Ja	Kept by Gladys in its database (not encrypted), never shown again, only sent to Fluvius (login.fluvius.be).
Electricity EAN	string	Nein	The 18-digit code of the connection point (starts with 54), on your bills and in Mijn Fluvius. Empty: no electricity meter.
Electricity meter serial number	string	Nein	Required with the EAN. Shown in Mijn Fluvius with the meter and printed on it (e.g. 1SAG1100000000).
Gas EAN	string	Nein	Empty: no gas meter. The gas device only shows the total of the last published day: it stays out of the energy monitoring for now.
Gas meter serial number	string	Nein	Required with the EAN. Shown in Mijn Fluvius with the meter and printed on it.
Electricity readings	select	Nein	Detailed: quarter hours, sent by half hour; they must be turned on in Mijn Fluvius. Daily: one value per day. Chosen before creating the electricity device: changing it later needs the device deleted and created again. The gas is always read by day.
Days read again	number	Nein	Once a day, these last days are read again to catch the readings Fluvius publishes late or corrects (the other reads take the last 3 days).

So installierst du Fluvius (Flanders) in Gladys

1. Öffne in Gladys Integrationen: Fluvius (Flanders) erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/lm1lc3n7/gladys-fluvius:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-fluvius.

Fluvius (Flanders) benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Fluvius (Flanders) ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂