Octopus Energy France Smart-Home-Integration, kostenlos und Open Source
Linky- und Gazpar-Verbrauch, Kosten, Kontostand und Nebenzeiten deines Octopus-Energy-Vertrags.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verfolge deinen Vertrag bei Octopus Energy France (Strom und Gas, früher Plüm Énergie) in Gladys: den Verbrauch, den dein Linky- oder Gazpar-Zähler meldet, seine Kosten, deinen Kontostand, die nächste Zahlung und vor allem die Nebenzeiten (heures creuses) deines Vertrags, auf die Minute genau, um den Warmwasserspeicher oder das Laden des Autos zur richtigen Zeit zu starten.
Der Strom fließt außerdem Tag für Tag in die Energieüberwachung von Gladys 5.2, an dem Datum, an dem er wirklich verbraucht wurde, auch wenn Enedis die Messwerte ein bis zwei Tage später liefert.
Nicht mit Octopus Energy verbunden. Developed without the hardware: feedback welcome — ohne Octopus-Energy-Konto entwickelt: deine Rückmeldungen sind willkommen (GitHub-Issues oder Gladys-Forum). Der Austausch mit Octopus folgt der freien Home-Assistant-Integration ha-octopus-french, konnte aber nicht mit einem echten Konto getestet werden.
Überblick
- Ein Gladys-Gerät pro Lieferpunkt: ein Stromzähler (die PRM-Nummer deines Linky) und ein Gaszähler (die PCE-Nummer deines Gazpar), wenn dein Vertrag beides umfasst.
- Strom: der datierte Verbrauch geht in die Energieüberwachung von Gladys; dazu Verbrauch und Kosten des letzten gelesenen Tages und des Monats, der Kontostand, die nächste Zahlung, der Name des Tarifs und die aktuelle Tarifzeit (Haupt- oder Nebenzeit) mit ihrem Preis.
- Gas: dieselben Übersichten in kWh und Euro, der Kontostand und die nächste Zahlung.
- Ein Dashboard-Widget, drei Szenen-Auslöser und eine Szenen-Aktion.
- Das Konto wird alle 3 Stunden gelesen. Die Nebenzeiten werden auf die Minute verfolgt, ohne Verbindung zu Octopus.
Voraussetzungen
- Gladys 5.2.0 oder neuer (Import eines in der Vergangenheit datierten Verbrauchs).
- Ein Strom- oder Gasvertrag bei Octopus Energy France und Zugang zu deinem Kundenbereich (E-Mail-Adresse und Passwort). Octopus-Kunden im Vereinigten Königreich, in Deutschland oder einem anderen Land sind nicht betroffen: ihre Plattform ist eine andere.
- Ein intelligenter Zähler (Linky, Gazpar) für den Tagesverbrauch. Ohne ihn werden nur Kontostand, Zahlung und Vertrag angezeigt.
- Internetzugang für dein Gladys: die Integration spricht mit der API von
Octopus Energy France (
api.oefr-kraken.energy).
Konfiguration
Installiere die Integration über Integrationen → Von GitHub installieren (oder aus dem Store) und fülle dann aus:
| Feld | Was einzutragen ist |
|---|---|
| E-Mail-Adresse | Die Anmeldeadresse deines Octopus-Energy-Kundenbereichs |
| Passwort | Das Passwort dieses Kundenbereichs |
| Zu importierender Verlauf | Stromtage, die beim ersten Lesen an die Energieüberwachung gehen (7 Tage bis 1 Jahr) |
| Sprache der Gerätenamen | Sprache der Funktionsnamen (standardmäßig Französisch), beim Hinzufügen festgelegt |
Speichere: die Integration meldet sich an, liest das Konto und bietet deine Zähler im Tab Entdeckung an. Füge sie hinzu; ihre Werte kommen sofort.
Der Knopf Anmelden und jetzt aktualisieren liest das Konto erneut, ohne auf den 3-Stunden-Zyklus zu warten (höchstens einmal pro Viertelstunde).
Lehnt Octopus die Adresse oder das Passwort ab, hält die Integration an und versucht es nicht erneut, bis du die Konfiguration korrigierst: zu viele Fehlversuche könnten dein Konto sperren.
Geräte
Jeder Zähler ist ein Gerät, benannt nach seiner Energie und den letzten vier Ziffern seiner Nummer, zum Beispiel „Octopus Strom …0123“.
Stromzähler
| Funktion | Einheit | Was es ist |
|---|---|---|
| Tagesverbrauch | kWh | Der Verbrauch jedes Tages, datiert, für die Energieüberwachung von Gladys |
| Verbrauch letzter Tag | kWh | Der letzte vollständige, von Enedis gelesene Tag (oft vorgestern) |
| Kosten letzter Tag | € | Seine Bruttokosten laut Octopus, ohne Grundgebühr |
| Verbrauch Monat | kWh | Der Monat des letzten Messwerts, bis zu diesem Tag |
| Kosten Monat | € | Seine Bruttokosten ohne Grundgebühr, nur wenn jeder Tag des Monats Kosten hat |
| Kontostand | € | Der Stand deines Stromkontos bei Octopus: positiv zu deinen Gunsten, negativ bei Schulden |
| Nächste Zahlung | € | Der Betrag der nächsten geplanten Lastschrift |
| Datum der nächsten Zahlung | Text | Das Datum dieser Zahlung |
| Tarif | Text | Der Name deines Tarifs |
| Nebenzeit aktiv | ja/nein | 1 während der Nebenzeiten deines Vertrags, sonst 0 |
| Tarifzeit | Text | „Nebenzeit“, „Hauptzeit“ oder „Einheitstarif“ |
| Aktueller Preis pro kWh | € | Der Bruttopreis pro kWh der aktuellen Tarifzeit |
| Nebenzeiten des Vertrags | Text | Die Zeitfenster der Nebenzeit, zum Beispiel „22:00–06:00“ |
Gaszähler
Dieselben Übersichten, ohne Tagesverbrauch und ohne Nebenzeiten: Verbrauch letzter Tag, Kosten letzter Tag, Verbrauch Monat, Kosten Monat (in kWh, wie auf deinen Rechnungen), Kontostand, Nächste Zahlung, Datum der nächsten Zahlung und Tarif. Octopus liefert zu den Gas-Messwerten keine Kosten, sie werden daher mit dem Bruttopreis pro kWh deines Vertrags berechnet, ohne Grundgebühr. Ein Gazpar, der nur einen Monatswert sendet, zeigt nur den Monat.
Energieüberwachung
Enedis liefert die Linky-Messwerte ein bis zwei Tage später an Octopus. Gladys 5.2 kann einen in der Vergangenheit datierten Verbrauch importieren: die Integration sendet jeden Tag an seinem echten Datum über den eigenen Endpunkt des Kerns und sendet bei jedem Lesen die letzten drei Tage erneut (Enedis korrigiert manchmal seine jüngsten Messwerte; Gladys schreibt nur, was sich geändert hat). Die Energiediagramme von Gladys und die aus deinem Vertrag berechneten Kosten stimmen also trotz der Verzögerung.
Absichtlich wird kein kumulierter Zählerstand veröffentlicht: Gladys würde einen einen Tag zu spät erhaltenen Zählerstand in eine einzige halbe Stunde Verbrauch verwandeln.
Damit Gladys die Kosten berechnet, wähle die Funktion Tagesverbrauch deines Stromzählers als Hauptzähler in den Energieeinstellungen und lege dort deinen Vertrag an. Die Funktionen Kosten letzter Tag und Kosten Monat kommen von Octopus und hängen nicht von diesem Vertrag ab.
Gas geht nicht in die Energieüberwachung: Gladys 5.2 bepreist nur Strom, und ein Gasverbrauch würde zum Stromverbrauch addiert.
Nebenzeiten und Tarifzeit
Die Integration liest die Nebenzeiten deines Vertrags, von der genauesten zur ungenauesten Quelle:
- die Zeitfenster des Nebenzeit-Tarifs deines Octopus-Vertrags;
- der Lieferantenkalender deines Zählers;
- die Nebenzeiten, die der Linky ankündigt („HC (22H00-6H00)“).
Jede Minute, ohne Verbindung zu Octopus, ermittelt sie daraus die aktuelle Tarifzeit in französischer Ortszeit (Zeitumstellungen inbegriffen), veröffentlicht Nebenzeit aktiv, Tarifzeit und Aktueller Preis pro kWh und löst beim Wechsel der Tarifzeit die Szenen aus.
- Tarif Base: eine einzige Tarifzeit, den ganzen Tag.
- Tarif Haupt- / Nebenzeit: die Tarifzeit und ihr Preis.
- Tarif mit zwei Jahreszeiten (Haupt- und Nebenzeit im Sommer und Winter): die Zeitfenster und der Preis der aktuellen Jahreszeit.
- Tarif nach Art von Tempo: die Tarifzeit wird angegeben, aber nicht der Preis, der von der Farbe des Tages abhängt, die Octopus im Konto nicht ankündigt.
Dashboard-Widget
Octopus Energy zeigt für einen Zähler (den ersten Stromzähler, wenn du keinen wählst): das Datum des letzten Messwerts, den Verbrauch dieses Tages und des Monats, ihre Kosten, die letzten 14 Tage als Balken, die aktuelle Tarifzeit und bis wann sie gilt, den Preis pro kWh, den Kontostand und die nächste Zahlung. Es wird bei jedem Lesen und bei jedem Wechsel der Tarifzeit aktualisiert. Fehlt die Konfiguration oder wird das Passwort abgelehnt, sagt das Widget es.
Szenen-Auslöser und Aktion
- Beginn der Nebenzeit (Auslöser): löst in der Minute aus, in der die
Nebenzeit deines Vertrags beginnt. Wähle optional den Zähler. Variablen:
das Ende der Nebenzeit (
until, HH:MM) und der Preis in der Nebenzeit (price, €/kWh). - Ende der Nebenzeit (Auslöser): löst in der Minute aus, in der sie
endet und die Hauptzeit beginnt. Variablen: die Uhrzeit der nächsten
Nebenzeit (
until) und der Preis in der Hauptzeit (price). - Neuer Tag mit Messwerten (Auslöser): Octopus hat einen neuen
vollständigen Tag vom Linky oder Gazpar erhalten, oft ein bis zwei Tage
später. Filtere optional nach Zähler oder Energie. Variablen: der Tag
(
date, JJJJ-MM-TT), sein Verbrauch (consumption, kWh) und seine Kosten (cost), Verbrauch und Kosten des Monats (month_consumption,month_cost), die Energie (energy:electricityodergas). Einmal pro neuem Tag ausgelöst; das erste Lesen nach der Installation setzt nur den Ausgangspunkt. - Übersicht eines Octopus-Zählers lesen (Aktion): liefert den letzten
gelesenen Tag, seinen Verbrauch und seine Kosten, Verbrauch und Kosten des
Monats, den Kontostand, die nächste Zahlung und ihr Datum, die Tarifzeit
(
base,peakoderoff_peak) und den aktuellen Preis, für die nächsten Aktionen der Szene. Ein unbekannter Wert bleibt leer.
Warum Auslöser zusätzlich zu Nebenzeit aktiv? Der Zustand wird regelmäßig (alle 6 Stunden) erneut veröffentlicht, damit Gladys ihn nicht für veraltet hält: eine Szene „wenn der Zustand 1 ist“ könnte erneut starten. Die Auslöser feuern nur einmal, beim Wechsel der Tarifzeit, und nie bei einem Neustart. Nutze den Zustand als Bedingung („nur in der Nebenzeit“) und die Auslöser, um eine Szene zu starten.
Szenenbeispiele
- Warmwasserspeicher in der Nebenzeit: Auslöser Beginn der Nebenzeit → die Steckdose des Warmwasserspeichers einschalten; Auslöser Ende der Nebenzeit → sie ausschalten.
- Laden des Autos: Auslöser Beginn der Nebenzeit → die Ladestation einschalten, „Laden gestartet bis {{triggerEvent.data.until}}“ senden.
- Verzögerte Waschmaschine: wenn der Knopf „später starten“ gedrückt wird, Bedingung Nebenzeit aktiv = 1 → sofort starten, sonst auf den Auslöser warten.
- Tagesbericht: Auslöser Neuer Tag mit Messwerten (Energie: Strom) → Nachricht „{{triggerEvent.data.date}}: {{triggerEvent.data.consumption}} kWh, {{triggerEvent.data.cost}} €. Monat: {{triggerEvent.data.month_cost}} €.“
- Wochenbericht: eine sonntags geplante Szene → Übersicht eines Octopus-Zählers lesen → Nachricht mit den Monatskosten und dem Kontostand.
Aktualisierung und Kontingente
- Ein Lesen des Kontos alle 3 Stunden; ein neuer Versuch nach einer Stunde, wenn Octopus nicht antwortet oder um weniger Anfragen bittet (Anfragelimit der API, Fehler KT-CT-1199).
- Ein Lesen kostet etwa zehn Anfragen: die Anmeldung (das Zugriffstoken gilt eine Stunde, das Erneuerungstoken eine Woche, ohne das Passwort erneut zu senden), die Liste der Konten, das Konto und die Messwerte jedes Zählers. Das erste Lesen importiert den gewählten Verlauf: vier Anfragen mehr für ein Jahr. Die Home-Assistant-Integration liest stündlich: das hier ist dreimal weniger.
- Die Nebenzeiten werden in Gladys berechnet, ohne Anfrage.
- Die Integration fragt selbst ab: sie hängt nicht von der Abfrage durch Gladys ab.
- Die Nutzungsbedingungen von Octopus Energy gelten für dein Konto: diese Integration liest nur deine eigenen Daten, nur lesend.
Fehlerbehebung
- „Octopus Energy lehnt die E-Mail-Adresse oder das Passwort ab“: prüfe sie, indem du dich in deinem Octopus-Kundenbereich anmeldest, und korrigiere dann die Konfiguration (die Integration versucht es dann sofort erneut).
- „Octopus Energy ist gerade nicht erreichbar“: die API hat nicht geantwortet; ein neuer Versuch innerhalb einer Stunde. Hält das an, hat Octopus vielleicht seine API geändert: eröffne ein GitHub-Issue mit den Protokollen.
- Kein Zähler angeboten: das Konto hat noch keinen aktiven Lieferpunkt (ein gekündigter Zähler wird nicht angeboten).
- Der letzte Tag ist von vorgestern: normal, Enedis und GRDF liefern die Messwerte verspätet.
- Kein Tagesverbrauch: dein Zähler ist vielleicht kein intelligenter, oder du hast die Erhebung deiner Verbrauchsdaten im Kundenbereich nicht erlaubt.
- Keine Tarifzeit: Octopus hat weder die Zeitfenster der Nebenzeit des Vertrags noch die des Zählers geliefert. Melde es mit dem Namen deines Tarifs.
- Protokolle: setze
LOG_LEVEL=debug, um jedes Lesen zu sehen. Die Protokolle zeigen nie die E-Mail-Adresse, das Passwort oder die Token.
Grenzen
- Developed without the hardware: feedback welcome — ohne Octopus-Konto entwickelt. Die Anfragen folgen denen der Home-Assistant-Integration ha-octopus-french, nicht einem echten Test: die ersten echten Einsätze können Unterschiede zeigen.
- Die Messwerte sind ein bis zwei Tage alt: keine Momentanleistung, kein „heute“. Für Echtzeit nutze ein Teleinformation-Modul an deinem Linky.
- Die Energieüberwachung erhält Tage, keine halben Stunden: ein in Gladys angelegter Vertrag mit Haupt- und Nebenzeit kann einen Tag nicht auf seine zwei Preise aufteilen. Die Kostenfunktionen von Octopus tun es.
- Gas bleibt außerhalb der Energieüberwachung.
- Tempo-Tarife: kein aktueller Preis und keine Farbe des Tages. Gesteuerte Tarife (Octopus Intelligent, Laden von Fahrzeugen) werden nicht unterstützt.
- Die Gaskosten werden mit dem kWh-Preis deines Vertrags geschätzt; die Kosten enthalten nie die Grundgebühr.
- Eine Anmeldung pro Integration; alle Konten und Zähler dieser Anmeldung werden angeboten.
- Keine Steuerung: die Integration steuert nichts bei Octopus.
Datenschutz und Daten
E-Mail-Adresse und Passwort bleiben in der Konfiguration von Gladys. Die
Datei /data/octopus-state.json speichert das Erneuerungstoken von Octopus
(damit das Passwort nicht bei jedem Lesen gesendet wird) und für jeden
Zähler, bis wohin die Energieüberwachung versorgt wurde. Nur die Integration
kann sie lesen. Nichts wird anderswohin gesendet als an die API von Octopus
Energy France und an dein Gladys.
Danksagung
Die GraphQL-Anfragen und das Lesen der Antworten von Octopus Energy France sind übernommen aus ha-octopus-french von domodom30 (MIT-Lizenz), der Home-Assistant-Integration für Octopus Energy France; ihre Tests lieferten die Antwortformen, die hier in den Tests verwendet werden. Octopus Energy, Linky, Gazpar, Enedis und GRDF sind Marken ihrer jeweiligen Inhaber.
Konfigurationseinstellungen
Diese Einstellungen fragt Octopus Energy France in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Octopus-Energy-Kundenbereich | section | Nein | Melde dich mit E-Mail-Adresse und Passwort deines Kundenbereichs bei Octopus Energy France an. Linky- und Gazpar-Werte kommen ein bis zwei Tage später und werden alle 3 Stunden gelesen. Nicht mit Octopus Energy verbunden. |
| E-Mail-Adresse | string | Ja | |
| Passwort | secret | Ja | |
| Zu importierender Verlauf | select | Nein | Stromtage, die beim ersten Lesen an die Energieüberwachung von Gladys gehen. |
| Sprache der Gerätenamen | select | Nein | Die Namen werden beim Hinzufügen eines Zählers zu Gladys festgelegt. |
So installierst du Octopus Energy France in Gladys
- Öffne in Gladys Integrationen: Octopus Energy France erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-octopus-fr:1.0.1) 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/guim31/gladys-octopus-fr.
Octopus Energy France 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
Octopus Energy France 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