RTE éCO2mix & EcoWatt Smart-Home-Integration, kostenlos und Open Source

Französisches Stromnetz live: CO₂ pro kWh, Strommix und EcoWatt-Warnungen von RTE.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.2
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Verfolge in Gladys das französische Stromnetz, so wie RTE es als offene Daten veröffentlicht: wie viel CO₂ jede gerade erzeugte Kilowattstunde ausstößt, woher der Strom kommt (Kernenergie, Wind, Sonne, Wasserkraft, Gas…) und das EcoWatt-Signal, das „Stromwetter“, das warnt, wenn das Netz angespannt ist und der Verbrauch sinken sollte.

So startest du Geschirrspüler, Warmwasserspeicher oder das Laden des Autos, wenn der Strom am saubersten ist, und erfährst am Vortag von einem orangen oder roten Tag.

Ohne Zugang zu den RTE-APIs entwickelt: Rückmeldungen willkommen. Diese Integration wurde anhand der von RTE dokumentierten Formate gebaut und getestet (éCO2mix auf ODRÉ, EcoWatt-API v5), ohne EcoWatt-Konto und ohne echten Aufruf. Wenn etwas nicht wie beschrieben funktioniert, sag es im Gladys-Forum oder in den Issues.

Unabhängige Integration, nicht mit RTE verbunden. Die Daten bleiben die von RTE.

Überblick

Die Integration liest zwei Quellen von RTE:

• éCO2mix (offene Daten, ohne Konto und ohne Schlüssel): der Strommix des französischen Festlands im Viertelstundentakt, der landesweite Verbrauch und die CO₂-Intensität in Gramm pro Kilowattstunde.
• EcoWatt (kostenloser Schlüssel, optional): das Signal von heute und den drei folgenden Tagen, Stunde für Stunde. Grün: keine Anspannung. Orange: angespanntes Netz, Energiesparen hilft. Rot: sehr angespanntes Netz, Abschaltungen sind möglich, wenn der Verbrauch nicht sinkt.

Die Integration fügt zwei Geräte, ein Dashboard-Widget und einen Szenen-Auslöser „EcoWatt-Warnung angekündigt“ hinzu.

EcoWatt gibt es schon in Gladys

Gladys zeigt EcoWatt bereits ohne diese Integration und ohne RTE-Schlüssel: das Dashboard-Widget Ecowatt (Frankreich) (das stündliche Signal von heute und den nächsten Tagen) und die Szenen-Bedingung Bedingung für Ecowatt (Frankreich) („Fortsetzen der Szene, wenn das Netzwerk“ in Ordnung, gewarnt oder kritisch ist, für die Stunde, in der die Szene läuft). Gladys holt diese Daten über seine eigenen Server (die von Gladys Plus), ohne Abo und ohne anzulegendes Konto. Ein EcoWatt-Gerät oder einen EcoWatt-Auslöser gibt es in Gladys nicht.

• Um EcoWatt auf dem Dashboard zu sehen, reicht das Gladys-Widget: Hier musst du keinen Schlüssel eintragen.
• Der EcoWatt-Teil dieser Integration ist für alle, die EcoWatt in ihren Szenen wollen: ein Gerät (heute, morgen, aktuelle Stunde) mit Verlauf und dem nativen Auslöser „Ein Gerät ändert seinen Zustand“, und der Auslöser EcoWatt-Warnung angekündigt, der eine Szene startet, sobald ein oranger oder roter Tag angekündigt wird. Er liest RTE direkt mit deinem eigenen Schlüssel, ohne Umweg über die Gladys-Server.
• éCO2mix (CO₂-Intensität, Strommix, landesweiter Verbrauch) gibt es nur in dieser Integration.

Voraussetzungen

• Gladys Assistant 5.1.0 oder neuer.
• Internetzugang für Gladys (die Daten kommen von den Servern von RTE).
• Nur für EcoWatt: ein kostenloses Konto auf data.rte-france.com und eine Anwendung mit Abo der Ecowatt-API:
  1. Lege dein Konto auf data.rte-france.com an und melde dich an.
  2. Öffne im API-Katalog Ecowatt (Version 5), dann API abonnieren: Das Portal schlägt vor, eine Anwendung anzulegen; gib ihr einen Namen (zum Beispiel „Gladys“).
  3. Öffne diese Anwendung unter Meine Anwendungen: Die Anwendung zeigt eine Client-ID und eine Secret-ID. Diese beiden Werte kopierst du in Gladys.

Ohne Schlüssel funktioniert die Integration nur mit éCO2mix.

Konfiguration

1. Installiere die Integration aus dem Gladys-Katalog (oder über Integrationen → Von GitHub installieren mit der Adresse dieses Repositorys).
2. Füge unter Konfiguration bei Bedarf die EcoWatt-Client-ID und das EcoWatt-Client-Secret ein. Das Secret bleibt in Gladys und erscheint nie in den Logs.
3. Wähle die Sprache der Funktionsnamen (standardmäßig Französisch). Die Namen werden beim Hinzufügen eines Geräts vergeben und ändern sich danach nicht mehr.
4. Speichere und öffne den Tab Erkennung: Füge Französisches Stromnetz und, mit Schlüssel, EcoWatt hinzu.

Schaltfläche „Verbindung zu RTE testen“

Liest éCO2mix sofort und zeigt die CO₂-Intensität der zuletzt veröffentlichten Viertelstunde. Mit Schlüssel prüft sie auch, ob RTE ihn akzeptiert, und nennt das EcoWatt-Signal des Tages. RTE erlaubt nur einen Aufruf der EcoWatt-Signale pro Viertelstunde: Ist der letzte zu frisch, prüft die Schaltfläche nur den Schlüssel und sagt, in wie vielen Minuten die Signale erneut gelesen werden.

Die Geräte

Französisches Stromnetz

Viertelstündlich aktualisiert, im Takt der Daten von RTE:

Funktion	Was sie misst
CO₂-Intensität	Gramm CO₂ pro in Frankreich erzeugter Kilowattstunde (g CO₂eq/kWh)
Landesweiter Verbrauch	Der Verbrauch des französischen Festlands, in kW (Gladys kennt kein GW)
CO₂-armer Anteil	Kernenergie und Erneuerbare, in % der Erzeugung
Erneuerbarer Anteil	Wasserkraft, Wind, Solar und Bioenergie, in % der Erzeugung
Anteil Kernenergie, Windkraft…	Der Anteil jeder Quelle an der Erzeugung, in ganzen %
Austausch (Import + / Export −)	Was die Nachbarländer liefern (+) oder abnehmen (−), in % des Verbrauchs

In Frankreich liegt die CO₂-Intensität meist zwischen 15 und 80 g/kWh; sie steigt, wenn Gas- oder Kohlekraftwerke laufen, meist an Winterabenden. Gladys färbt das Badge: grün unter 150, orange bis 400, rot darüber.

EcoWatt

Mit Schlüssel geben drei Funktionen das EcoWatt-Signal so an, wie RTE es nummeriert:

Funktion	Werte
EcoWatt heute	1 grün, 2 orange, 3 rot
EcoWatt morgen	1 grün, 2 orange, 3 rot
EcoWatt aktuelle Stunde	0 CO₂-freie Erzeugung, 1 grün, 2 orange, 3 rot

Gladys zeigt sie als Risikostufe: 0 „Kein Risiko“, 1 „Niedrig“, 2 „Mittel“, 3 „Hoch“. Ein grüner Tag erscheint also als gelbes Badge „Niedrig“: Das ist die Gladys-Farbe für ein niedriges Risiko, keine Warnung. Die aktuelle Stunde wechselt zu jeder vollen Stunde.

Widget

Das Widget Französisches Stromnetz kommt aufs Dashboard. Es zeigt:

• die CO₂-Intensität, den landesweiten Verbrauch in GW und den CO₂-armen Anteil;
• mit Schlüssel das EcoWatt-Signal von heute und morgen, in Grün, Orange oder Rot;
• die CO₂-Kurve über 24 Stunden als Balken, sobald das Gerät hinzugefügt ist (Gladys speichert den Verlauf);
• den Strommix als Balken, Quelle für Quelle, mit Importen oder Exporten;
• die Uhrzeit der angezeigten Viertelstunde.

Szenen-Auslöser

EcoWatt-Warnung angekündigt (Kategorie Integrationen im Szenen-Editor): RTE kündigt einen orangen oder roten Tag an, heute oder in den nächsten drei Tagen. Der Auslöser feuert einmal pro Ankündigung: wenn ein Tag orange wird, dann erneut, wenn er rot wird, nie bei jedem Lesen, auch nicht nach einem Neustart.

Filter (leer gelassen passt alles): das Signal (orange, rot) und der Betroffene Tag (heute, morgen, in zwei oder drei Tagen).

An die Aktionen der Szene weitergegebene Informationen: das Signal (orange oder red), die EcoWatt-Stufe (2 oder 3), das Datum des betroffenen Tages, in wie vielen Tagen, und die Nachricht von RTE.

Um auf die CO₂-Intensität zu reagieren, braucht es keinen eigenen Auslöser: Der native Gladys-Auslöser „Ein Gerät ändert seinen Zustand“ vergleicht die Funktion CO₂-Intensität schon mit einem Schwellenwert.

Szenen-Beispiele

• Wenig CO₂ → Geschirrspüler oder Laden starten. Auslöser: „Ein Gerät ändert seinen Zustand“, CO₂-Intensität unter 40 g/kWh. Bedingung: zwischen 10 und 16 Uhr (oder in deinen Nebenzeiten). Aktion: die Steckdose des morgens eingeräumten Geschirrspülers oder die Ladestation einschalten.
• Morgen roter Tag → den Haushalt informieren. Auslöser: EcoWatt-Warnung angekündigt, Signal rot, betroffener Tag morgen. Aktion: eine Nachricht senden „Morgen roter EcoWatt-Tag: kein Backofen und keine Waschmaschine von 8 bis 13 und von 18 bis 20 Uhr“.
• Orange oder rote Stunde → Laden des Autos verschieben. Auslöser: „Ein Gerät ändert seinen Zustand“, EcoWatt aktuelle Stunde größer oder gleich 2. Aktion: die Ladesteckdose ausschalten. Eine zweite Szene schaltet sie wieder ein, wenn der Wert unter 2 fällt.

Lesetakt und Kontingente

• éCO2mix wird viertelstündlich gelesen, nur wenn das Gerät hinzugefügt oder das Widget angezeigt ist: höchstens 96 Aufrufe pro Tag, ohne Schlüssel. RTE veröffentlicht jede Viertelstunde mit etwa einer Stunde Verzögerung: Die angezeigten Werte sind oft eine Stunde alt.
• EcoWatt wird alle 30 Minuten gelesen. RTE erlaubt nur einen Aufruf der Signale alle 15 Minuten pro Anwendung: Die Integration ruft nie öfter auf, merkt sich das nach einem Neustart (in /data) und wartet so lange, wie RTE es verlangt, wenn es „zu viele Anfragen“ antwortet.
• Nur Änderungen werden an Gladys gesendet, und jeder Wert wird mindestens alle 6 Stunden erneut gesendet, damit er aktuell datiert bleibt.

Die Nutzung der Daten folgt den Bedingungen von RTE: die offene Lizenz von ODRÉ für éCO2mix, die Nutzungsbedingungen des Portals data.rte-france.com für EcoWatt.

Fehlerbehebung

• „EcoWatt lehnt Client-ID und Secret ab“ auf der Konfigurationsseite: Kopiere beide Werte erneut aus Meine Anwendungen auf data.rte-france.com, ohne Leerzeichen, und prüfe, ob die Anwendung die Ecowatt-API abonniert hat.
• „éCO2mix (RTE) antwortet nicht“: Der Dienst von RTE ist nicht verfügbar oder Gladys hat keinen Internetzugang. Die Integration versucht es viertelstündlich von selbst erneut.
• Kein Wert beim Stromnetz: Ein Wert, der älter als drei Stunden ist, wird nicht gesendet (lieber kein Wert als ein falscher). Nutze die Schaltfläche Verbindung zu RTE testen.
• Mehr Details: Die Logs der Integration (Tab Supervision) zeigen nur die nützlichen Ereignisse. Um alles zu sehen, setze die Variable LOG_LEVEL=debug.

Grenzen

• Nur das französische Festland (ohne Korsika und Überseegebiete), wie éCO2mix.
• Die Anteile pro Quelle sind ganze Prozentwerte; das Widget zeigt unter 10 % eine Nachkommastelle.
• Der Verbrauch steht im Gerät in kW: Gladys kennt weder MW noch GW. Das Widget zeigt GW.
• Heizöl (unter 1 % der Erzeugung) hat keine eigene Funktion; es erscheint im Widget ab 0,5 %.
• Die an Szenen weitergegebene Nachricht von RTE ist auf Französisch, so wie RTE sie veröffentlicht.
• EcoWatt liefert keine CO₂-Prognose: Diese Integration enthält keine Vorhersage der CO₂-Intensität.

Konfigurationseinstellungen

Diese Einstellungen fragt RTE éCO2mix & EcoWatt in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Offene Daten von RTE	section	Nein	Der Strommix und das CO₂ des französischen Netzes (éCO2mix) brauchen nichts und werden alle 15 Minuten gelesen. Das EcoWatt-Signal braucht einen kostenlosen Schlüssel vom Datenportal von RTE. Nicht mit RTE verbunden.
EcoWatt-Client-ID	string	Nein	Optional. Auf data.rte-france.com: Meine Anwendungen, dann die Anwendung mit Abo der EcoWatt-API.
EcoWatt-Client-Secret	secret	Nein	Optional, zusammen mit der Client-ID. Bleibt in Gladys, steht nie in den Logs.
Sprache der Funktionsnamen	select	Nein	Namen der Funktionen beim Hinzufügen eines Geräts und Texte der Konfigurationsseite.

So installierst du RTE éCO2mix & EcoWatt in Gladys

1. Öffne in Gladys Integrationen: RTE éCO2mix & EcoWatt erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-rte:1.0.2) 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/guim31/gladys-rte.

RTE éCO2mix & EcoWatt 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

RTE éCO2mix & EcoWatt 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 guim31 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 🙂