Corrently GrünstromIndex Smart-Home-Integration, kostenlos und Open Source
Inoffizieller Konnektor: Corrently GrünstromIndex, wie grün der Strom je Postleitzahl ist.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.3.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Unofficial connector, not affiliated with Corrently or STROMDAO. Never tested with a real Gladys installation yet: it was tested against the live Corrently API and a simulated Gladys.
The GrünstromIndex (green power index) tells, from 0 to 100, how much of the power around a German postcode comes from renewables, hour by hour, about five days ahead. Use it to run the washing machine, the heat pump or the car charge in the greenest hours.
Setup
- Enter your German postcode (five digits, leading zero included, e.g.
01067). - Save, then open the device
GrünstromIndex <postcode>in the integration's devices page.
What you get
| Feature | Meaning |
|---|---|
| GrünstromIndex | The index of the current hour (0-100) |
| GrünstromIndex next hour | The index of the next hour |
| GrünstromIndex best of 24 h | The highest index of the 24 hours starting with the current one |
| Hours until the greenest hour | Hours from now to that greenest hour (0: now; the earliest on a tie) |
An hour the forecast does not cover stays unknown (no value is published); the best of 24 h stays unknown unless all 24 hours are known. A forecast computed more than 72 hours ago is not used (its date is the time Corrently computed it, which a cached copy can put a few hours back).
Energy calendar green-power-index-de: every half hour gets a level, low (index 0-33),
medium (34-66) or high (67-100), up to seven days ahead. A tariff template of the Gladys energy
contracts (community catalogue or another integration) can read it. These bounds never change.
Reads and fair use
- One read per hour at most, as the Corrently fair-use policy asks. The time of each attempt is saved
in
/databefore the request, so a restart, a configuration save or a new postcode does not read sooner. A configuration saved during a read keeps its answer. - The Read the forecast button reads only when the last read is an hour old; otherwise it shows the forecast in memory and the time of the next read.
- After a failure, the wait doubles: 1 h, 2 h, 4 h, then 6 h. A
429answer with a longerRetry-Afteris obeyed (24 h at most). - If
/datacannot be read or written, the module does not read Corrently (it could not keep the hourly spacing) and retries/dataevery 10 seconds.
Not included
- Corrently tariff. The answer has an
energypricefield, but it is a signed value of a few cents (often negative) that is not documented as a retail tariff: it is never published as a price, and the module offers no energy contract template. - A Corrently token. The module reads without one, as Corrently allows at one read per hour. Corrently announces the end of the access without token; the token will come back once Corrently documents how to send it outside the address.
- The CO2 fields of the answer (often empty) and the solar forecast.
Data and licence
Data: Corrently / STROMDAO GmbH, licence
CC BY-NC-SA 4.0. The data is
adapted by this module (index rounded to an integer, levels low / medium / high computed from
it); the levels of the calendar are shared under the same licence. Non-commercial use only: a
commercial use needs a licence from Corrently
(corrently.energy).
Documentation: corrently.io/books/grunstromindex. The
module itself is Apache-2.0.
Konfigurationseinstellungen
Diese Einstellungen fragt Corrently GrünstromIndex in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Corrently GrünstromIndex | section | Nein | Inoffizieller Konnektor, ohne Verbindung zu Corrently oder STROMDAO. Er liest die offizielle GrünstromIndex-Prognose (0 bis 100: Anteil erneuerbaren Stroms rund um eine Postleitzahl, stündlich, etwa fünf Tage im Voraus) höchstens einmal pro Stunde, wie es die Fair-Use-Regel von Corrently verlangt. Ein Gerät mit dem Index jetzt, in der nächsten Stunde, dem besten der nächsten 24 Stunden und den Stunden bis dahin, dazu der Gladys-Energiekalender green-power-index-de (low, medium, high je halbe Stunde). Daten: Corrently (STROMDAO GmbH), CC BY-NC-SA 4.0, bearbeitet (Index gerundet, Stufen von diesem Modul berechnet); eine kommerzielle Nutzung erfordert eine Lizenz von Corrently. |
| Postleitzahl | string | Ja | Fünf Ziffern, mit führender Null. Eine Änderung legt ein neues Gerät an. |
So installierst du Corrently GrünstromIndex in Gladys
- Öffne in Gladys Integrationen: Corrently GrünstromIndex erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-corrently:0.1.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/LM1LC3N7/gladys-corrently.
Corrently GrünstromIndex benötigt Gladys >=5.3.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
Corrently GrünstromIndex 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