Écocompteur Legrand Smart-Home-Integration, kostenlos und Open Source
Reads the Legrand eco-meter (ref. 412000) on your local network.
Veröffentlicht von goldorakiller
- Geräte
- Version 1.3.0
- Erfordert Gladys >=5.1.0
- ★ 1
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
This integration reads the Legrand eco-meter (ref. 412000) directly on your local network, with no account and no third-party service. The device exposes two HTTP endpoints (/inst.json and /data.json) that the integration polls at a configurable interval.
What shows up in Gladys
- Instantaneous power of the 5 measurement channels, in watts. Feature names come from the labels you set in the eco-meter's own interface: if input 1 is named "Heating" there, it is named "Heating" in Gladys.
- Meter indexes read from the teleinformation stream: off-peak/peak, the 6 Tempo colour indexes, or the base index depending on your tariff option (detected automatically). Reported in kWh.
- Tariff option and current tariff period as readable text ("HC/HP", "Tempo", "Heure Pleine Bleu"...) rather than a raw numeric code.
- Energy consumed per channel, in kWh ("Heating (énergie)"...), see below.
- Pulse inputs (gas, water): only the ones enabled on the device are created, with their volume in m³.
Energy per channel
The eco-meter only reports the instantaneous power of its channels, never a cumulative meter. The integration therefore builds an energy index for each channel by integrating the power between two readings. Like the teleinformation indexes, these indexes automatically get their "30-minute consumption" and "30-minute cost": you can track the cost of your heat pump or your EV charger on its own.
Good to know:
- The index starts at 0 when the integration is installed: it is a relative total, not the real lifetime history of the circuit. Gladys only looks at differences, so consumption and cost are not affected.
- It is an approximation: an appliance that switches on and off between two readings is counted more or less accurately. The shorter the refresh interval, the more accurate the result.
- If the eco-meter stays unreachable for more than 5 minutes, that period is not counted: the integration would rather under-count than invent consumption.
- The total is saved and survives a restart of the integration.
"Live power" widget
The integration provides a dashboard widget (Gladys 5.1 or later). Add it from the dashboard editor, in the integration's section. It shows:
- the power of the 5 channels, updated live;
- their total;
- the current tariff period, coloured by period (blue, white or red with Tempo, green for off-peak, orange for peak).
Consumption and cost tracking (Tempo option)
Every index feature (off-peak, peak, or any of the 6 Tempo combinations) is a real Gladys "Index" feature: the Gladys core automatically adds a matching "30-minute consumption" and "30-minute cost" feature for it, no extra configuration needed on the integration side — you only need a price table in Settings → Energy for the cost to compute.
With the Tempo option, that means 6 separate indexes, each with its own consumption/cost tracking:
| Index | Period |
|---|---|
| Index Heures Creuses Bleu | Off-peak, blue day |
| Index Heures Pleines Bleu | Peak, blue day |
| Index Heures Creuses Blanc | Off-peak, white day |
| Index Heures Pleines Blanc | Peak, white day |
| Index Heures Creuses Rouge | Off-peak, red day |
| Index Heures Pleines Rouge | Peak, red day |
Gladys knows the official Tempo day calendar itself: it does not need the eco-meter to tell it which colour applies on a given day, only the prices for each colour/period combination.
Configuration
- Give the eco-meter a fixed DHCP lease on your router. Its address is used as the device identifier: changing it would create a new device in Gladys.
- Enter that address in the configuration field (for example
192.168.1.140). - Adjust the refresh interval if needed (60 seconds by default, from 1 second to 60 seconds).
- Use the Test the connection button to check that the device answers before running a discovery.
Notes
- The eco-meter returns its indexes with leading zeros, which is not valid JSON; the integration normalizes the payload before parsing it.
- Channel labels are taken from the eco-meter when the device is created in Gladys. Once the device exists, its names belong to Gladys (like the device name or its room): renaming an input on the eco-meter afterwards does not update them. Rename the feature directly in Gladys, or delete and re-create the device from the Discovery tab (which loses its history).
- An unwired channel reports 0 W permanently. You can delete the matching feature in Gladys if it gets in the way.
Konfigurationseinstellungen
Diese Einstellungen fragt Écocompteur Legrand in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Getting started | section | Nein | The eco-meter exposes its data locally, with no account and no API key. Give it a fixed DHCP lease: its address identifies the device in Gladys. |
| Eco-meter address | string | Ja | IP address or hostname on your local network, e.g. 192.168.1.140 |
| Refresh interval | select | Nein | How often the eco-meter is polled. Gladys only allows these fixed values (device poll_frequency is an enum, in milliseconds). |
| Publish meter indexes | boolean | Nein | Adds the off-peak/peak (or base) indexes read from the meter's teleinformation. |
So installierst du Écocompteur Legrand in Gladys
- Öffne in Gladys Integrationen: Écocompteur Legrand erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/goldorakiller/gladys-integration-ecocompteur:1.3.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/goldorakiller/gladys-integration-ecocompteur.
Écocompteur Legrand benötigt Gladys >=5.1.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
Écocompteur Legrand 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 goldorakiller veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle externen Integrationen durchsuchen
- Die nativen Integrationen entdecken, die in Gladys eingebaut sind
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation