myenergi Smart-Home-Integration, kostenlos und Open Source
zappi, eddi, harvi und libbi von myenergi: Laden, Warmwasser, Solarüberschuss und Boosts.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verfolge und steuere deine myenergi-Geräte aus Gladys: die Ladestation zappi, den Warmwasser-Überschussregler eddi, den kabellosen Zangensensor harvi und die Batterie libbi. Gladys liest sie über die myenergi-Cloud, denselben Dienst wie die myenergi-App: Solar- und Netzleistung, Zustand und Energie des Ladevorgangs, mit Solarüberschuss geheiztes Warmwasser, Batteriestand. Gladys ändert den Lademodus der zappi, startet und stoppt die Boosts und löst eine Szene aus, wenn eine Ladung beendet ist.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration wurde mit den Antworten der myenergi-Cloud gebaut und getestet, die die Bibliothek pymyenergi veröffentlicht, nicht mit echten Geräten. Wenn etwas nicht wie beschrieben funktioniert, melde es im Gladys-Forum oder in den Issues.
Diese Integration ist nicht mit myenergi Ltd. verbunden.
Was du brauchst
- Gladys Assistant 5.2.0 oder neuer.
- Einen myenergi-Hub (oder eine zappi oder einen eddi, die ihn ersetzen), mit dem Internet verbunden, mit deinen Geräten in der myenergi-App gekoppelt.
- Die Seriennummer des Hubs und einen API-Schlüssel. Melde dich in deinem myenergi-Konto an und öffne Produkte: Die Seriennummer steht neben dem Hub, mit einer Schaltfläche, um einen API-Schlüssel zu erzeugen (myenergi-Artikel: How do I get an API key?). Der Schlüssel wird nur einmal angezeigt: Kopiere ihn.
Einrichtung
- Installiere die Integration aus dem Gladys-Katalog.
- Gib unter Konfiguration die Seriennummer des Hubs (nur Ziffern) und den API-Schlüssel ein und speichere.
- Klicke auf Verbindung testen: Die Meldung unter der Schaltfläche listet die gefundenen Geräte und den myenergi-Server deines Kontos auf.
- Öffne den Tab Erkennung: ein Gerät für die Anlage, dazu eines pro zappi, eddi, harvi und libbi. Klicke auf Hinzufügen, wähle einen Raum, speichere. Nur die hinzugefügten Geräte werden verfolgt.
Optionen:
- Aktualisierungsintervall: wie oft die myenergi-Cloud gelesen wird, von 1 Minute (Standard) bis 10 Minuten.
- Sprache der Texte: Englisch, Französisch (Standard), Deutsch oder Spanisch. Für die Namen der Funktionen (beim Hinzufügen eines Geräts vergeben), die Statustexte und die Meldungen der Szenen.
Die Geräte
Anlage
Das Gerät mit dem Namen deines Standorts in der myenergi-App.
| Funktion | Was es ist |
|---|---|
| Netzleistung | Mit dem Netz ausgetauschte Leistung, in W: positiv beim Bezug, negativ bei der Einspeisung |
| Solarleistung | Leistung deiner Solarmodule, in W |
| Netzspannung | Von einer zappi, einem eddi oder einer libbi gemessene Spannung, in V |
Die Netz- und Solarwerte sind die der Zangen vom Typ Grid und Generation in der myenergi-App, über alle Geräte summiert, wie die myenergi-App sie berechnet.
zappi
| Funktion | Was es ist |
|---|---|
| Anschluss | Verfügbar (kein Auto), Belegt (Auto angeschlossen) oder Fehler |
| Ladevorgang | Lädt, Fahrzeug verbunden, Angehalten (Fahrzeug), Angehalten (Ladestation: wartet auf Überschuss, oder Modus Stopp), Inaktiv (Ladung beendet, oder kein Auto) |
| Auto angeschlossen | Ja / nein: der einfachste Weg, beim Anstecken eine Szene zu starten |
| Lademodus | Befehl: Schnell, Eco, Eco+ (nur Solarüberschuss) oder Stopp |
| Ladeleistung | An das Auto gesendete Leistung, in kW |
| Energie der Sitzung | Seit dem Anstecken ins Auto geladene Energie, in kWh |
| Energie heute | Heute von der zappi gelieferte Energie (Solar und Netz), in kWh |
| Gesamtenergie | Seit dem Hinzufügen der zappi gelieferte Energie, kumuliert, in kWh |
| Zange n (…) | Von jeder in der myenergi-App zugeordneten Zange gelesene Leistung, in W |
Die Gesamtenergie ist ein Zählerstand, den Gladys für seine
Energieverfolgung nutzt: Es berechnet daraus den Verbrauch jeder halben
Stunde und seine Kosten nach deinem Energievertrag. Die myenergi-Cloud hat
keinen Lebenszeitzähler: Die Integration addiert den Tagesverlauf, Tag für
Tag, und speichert das Ergebnis unter /data.
eddi
| Funktion | Was es ist |
|---|---|
| Status | Wartet auf Überschuss, Leitet um, Boost läuft, Höchsttemperatur erreicht oder Gestoppt |
| Heizvorgang | Ja, solange der eddi das Wasser heizt (Überschuss oder Boost) |
| Heizleistung | An den Heizstab gesendete Leistung, in W |
| Heute umgeleitet | Heute ins Wasser umgeleiteter Solarüberschuss, in kWh |
| Gesamtenergie | Kumulierte Energie des eddi (Überschuss und Boost), in kWh, wie bei der zappi |
| Überschussumleitung | Befehl: an (Normalmodus) oder gestoppt |
| Boost | Ja, solange ein Boost läuft |
| Verbleibender Boost | Verbleibende Minuten des laufenden Boosts |
| Temperatur Fühler 1, Temperatur Fühler 2 | Die Temperaturfühler des Speichers, wenn sie angeschlossen sind |
| Zange n (…) | Von jeder zugeordneten Zange gelesene Leistung, in W |
Boosts werden aus dem Widget oder einer Szene für eine feste Dauer gestartet: Es gibt absichtlich keinen Ein/Aus-Schalter für das Heizen (ein Boost endet immer von selbst).
harvi
Eine Leistungsfunktion pro in der myenergi-App zugeordneter Zange, in W. Ein harvi ohne zugeordnete Zange wird nicht veröffentlicht.
libbi
| Funktion | Was es ist |
|---|---|
| Batteriestand | Ladezustand, in % |
| Ladeleistung | In die Batterie fließende Leistung, in W |
| Entladeleistung | Aus der Batterie fließende Leistung, in W |
| Status | Lädt, Entlädt, Bereit, Batterie voll, Gestoppt, Fehler… |
| Zange n (…) | Von jeder zugeordneten Zange gelesene Leistung, in W |
Die libbi wird nur gelesen: Modi und Ladeziel der libbi brauchen das Konto der myenergi-App (nicht den API-Schlüssel), das diese Integration nicht nutzt.
Dashboard-Widget
Füge das Widget myenergi zu einem Dashboard hinzu. Es zeigt vier Kacheln (Solar, Netz, Leistung der zappi, Leistung des eddi), den Zustand der zappi und des eddi, die Energie der Sitzung und die heute umgeleitete Energie. Wähle in seinen Einstellungen eine zappi und einen eddi, wenn du mehrere hast.
Schaltflächen:
- Auto-Boost: fragt nach der zu ladenden Energie in kWh und optional nach der Uhrzeit, zu der sie fertig sein muss (Smart Boost). Nur in den Modi Eco und Eco+ angezeigt: Im Modus Schnell lädt die zappi bereits mit voller Leistung.
- Warmwasser-Boost: fragt nach einer Dauer (1 bis 240 Minuten) und dem Heizstab.
- Boost stoppen: stoppt alle laufenden Boosts, nach einer Bestätigung. Angezeigt, solange ein Boost läuft.
Die Kacheln folgen live den Werten der zu Gladys hinzugefügten Geräte. Wenn die myenergi-Cloud nicht antwortet, zeigt das Widget die letzte Messung und sagt es.
Szenen
Auslöser
- zappi-Ladung beendet: Die zappi hat das Laden des Autos beendet. Optionaler Filter: die zappi. Variablen: die Energie der Sitzung (kWh) und der Name der zappi, für eine Nachricht.
Für die anderen Ereignisse (Auto angeschlossen, Solarleistung über einem Schwellenwert, Batteriestand…) nutze den üblichen Auslöser Gerätezustand auf den Funktionen oben.
Aktionen
- Lademodus der zappi ändern: Schnell, Eco, Eco+ oder Stopp.
- Boost der zappi starten: lädt diese Energie (1 bis 99 kWh) aus dem
Netz, sofort oder bis zu einer Uhrzeit (
07:30) mit einem Smart Boost. Nur in den Modi Eco und Eco+. - Boost der zappi stoppen.
- Boost des eddi starten: heizt das Wasser 1 bis 240 Minuten aus dem Netz, über Heizstab 1 oder 2.
- Boost des eddi stoppen: bricht den Boost beider Heizstäbe ab.
Szenenideen
- Günstiger Nachttarif: um 23:00 Lademodus der zappi ändern auf Schnell; um 06:30 zurück auf Eco+.
- Auto bereit für eine Fahrt: bei einem Kalendereintrag „Fahrt“ Boost der
zappi starten mit 30 kWh bis
07:00. - Ladung fertig: bei zappi-Ladung beendet „Das Auto ist geladen:
{{triggerEvent.data.energy_kwh}}kWh geladen“ an dein Handy senden. - Bewölkter Tag: um 17:00, wenn Heute umgeleitet unter 2 kWh liegt, Boost des eddi starten für 60 Minuten.
Aktualisierung und API-Nutzung
- Eine Anfrage an die myenergi-Cloud liest alle Geräte, im Aktualisierungsintervall (standardmäßig 1 Minute, nie schneller). Der stündliche Verlauf (Energie des Tages, Gesamtenergie) wird alle 10 Minuten pro zu Gladys hinzugefügter zappi und eddi gelesen, und einmal mehr kurz nach Mitternacht, um den Tag abzuschließen.
- Solange kein Gerät hinzugefügt ist, wird nichts gelesen, außer wenn du auf Verbindung testen klickst oder im Tab Erkennung suchst.
- Ein Befehl (Modus, Boost) ist eine Anfrage, gefolgt von einer Messung 5 Sekunden später, um zu zeigen, was das Gerät übernommen hat.
- Die API ist die der myenergi-App; myenergi veröffentlicht kein Kontingent dafür. Wenn sie „zu viele Anfragen“ antwortet, erhöhe das Intervall.
Fehlerbehebung
- Seriennummer oder API-Schlüssel von myenergi abgelehnt: Prüfe die Seriennummer (nur Ziffern, die des Hubs) und erzeuge einen neuen API-Schlüssel; ein neuer Hub braucht einen neuen Schlüssel.
- Die myenergi-Cloud antwortet nicht: Die Integration versucht es in jedem Intervall erneut und sagt, wenn sie wieder antwortet; das Widget zeigt so lange die letzte Messung. Die myenergi-App läuft über dieselbe Cloud: Prüfe sie.
- Die Gesamtenergie beginnt niedrig: Der Zähler startet bei der Energie des Tages, an dem das Gerät hinzugefügt wird. Gladys verfolgt die Zunahmen, nicht den Startwert.
- Eine Zange erscheint oder verschwindet: Zangen werden so veröffentlicht, wie sie in der myenergi-App zugeordnet sind; nach einer Änderung dort bietet der Tab Erkennung an, das Gerät zu aktualisieren.
- Mehr Details: Setze die Umgebungsvariable
LOG_LEVEL=debugder Integration und lies ihre Protokolle. Der API-Schlüssel erscheint dort nie.
Grenzen
- Ohne die Hardware entwickelt: Die Werte und Befehle folgen den von pymyenergi dokumentierten Antworten; einige Felder (die Ladeleistung der zappi, das Vorzeichen der libbi-Leistung) sind interpretiert, nicht an einem Gerät geprüft.
- Nur Cloud: keine lokale Steuerung, und nichts funktioniert, wenn die myenergi-Cloud oder deine Internetverbindung ausfällt.
- Nicht unterstützt: das Entsperren der zappi (absichtlich weggelassen, aus Sicherheitsgründen), die Geräteprioritäten, der minimale Grünanteil, die Modi und das Ladeziel der libbi (sie brauchen das App-Konto).
- Die Gesamtenergie wird von Gladys zum Tarif deines Vertrags bewertet, Solaranteil eingeschlossen: Es sind die Kosten, die die Energie aus dem Netz gehabt hätte.
- Die angezeigten Seriennummern kommen aus der Cloud; die Namen sind die in der myenergi-App vergebenen, alle 6 Stunden neu gelesen.
Konfigurationseinstellungen
Diese Einstellungen fragt myenergi in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| myenergi-Konto | section | Nein | Gladys liest deine Geräte über die myenergi-Cloud, wie die myenergi-App. Du brauchst die Seriennummer deines Hubs und einen API-Schlüssel: Melde dich in deinem myenergi-Konto an, öffne Produkte und erzeuge neben dem Hub einen API-Schlüssel. Er wird nur einmal angezeigt. |
| Seriennummer des Hubs | string | Ja | Nur Ziffern, wie unter Produkte im myenergi-Konto angezeigt. |
| API-Schlüssel | secret | Ja | In der myenergi-App erzeugt. In Gladys gespeichert, nie in die Protokolle geschrieben. |
| Aktualisierungsintervall | select | Nein | Wie oft die myenergi-Cloud gelesen wird. Höchstens jede Minute, wie die myenergi-App. |
| Sprache der Texte | select | Nein | Namen der Funktionen (beim Hinzufügen eines Geräts vergeben), Szenenmeldungen, Statustexte. |
So installierst du myenergi in Gladys
- Öffne in Gladys Integrationen: myenergi erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-myenergi: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-myenergi.
myenergi 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
myenergi 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