Kostal Plenticore Smart-Home-Integration, kostenlos und Open Source

Kostal-Plenticore- und PIKO-IQ-Wechselrichter lokal: Solar, Haus, Netz und Batterie.

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

Auf GitHub ansehenAlle Integrationen

Überblick

Diese Integration liest deinen Kostal PLENTICORE plus, PLENTICORE BI oder PIKO IQ / PIKO MP Wechselrichter in deinem lokalen Netz, über die REST-API, die seine eigene Weboberfläche nutzt. Keine Kostal-Cloud, keine Modbus-Register zu konfigurieren: Du gibst die Adresse des Wechselrichters und das Anlagenbetreiber-Passwort an, und Gladys bekommt ein Gerät mit den echten Daten des Wechselrichters.

• die Solarproduktion, gesamt und pro PV-String;
• den Hausverbrauch und den Austausch mit dem Netz (Bezug und Einspeisung);
• die Batterie, falls vorhanden: Ladestand, Lade- und Entladeleistung, Zyklen;
• die Energiezähler des Tages und seit der Inbetriebnahme, bereit für die Energieüberwachung von Gladys;
• den Status des Wechselrichters und seine Alarme, mit dem Alarmtext des Wechselrichters;
• ein Dashboard-Widget, Szenen-Auslöser (Alarm, Batterie voll, Batterie leer) und, wenn du sie erlaubst, zwei Szenen-Aktionen für die Batterieeinstellungen.

Ohne die Hardware entwickelt: Die Integration stützt sich auf die API, wie sie die Home-Assistant-Integration und die Bibliothek pykoplenti nutzen, und wurde gegen einen simulierten Wechselrichter getestet. Rückmeldungen sind willkommen, im Forum oder in einem GitHub-Issue.

Diese Integration ist nicht mit KOSTAL Solar Electric verbunden. Kostal, PLENTICORE und PIKO sind Marken ihrer Inhaber.

Voraussetzungen

• Gladys 5.1 oder neuer (die Energieüberwachung der Zähler funktioniert am besten mit Gladys 5.2).
• Ein Wechselrichter Kostal PLENTICORE plus, PLENTICORE BI, PIKO IQ oder PIKO MP, per Kabel oder WLAN mit deinem Netz verbunden, mit fester IP-Adresse (eine DHCP-Reservierung im Router genügt).
• Das Anlagenbetreiber-Passwort: das, mit dem du dich an der Weboberfläche des Wechselrichters unter http://<Adresse des Wechselrichters> anmeldest. Falls du es nie festgelegt hast, helfen dir dein Installateur oder die App Kostal Solar. Der Servicecode des Installateurs wird nicht benötigt.
• Gladys und der Wechselrichter im selben Netz: Die Integration spricht direkt mit dem Wechselrichter.

Konfiguration

1. Installiere die Integration aus dem Store (oder Integrationen → Von GitHub installieren mit der Adresse des Repositorys).
2. Im Tab Konfiguration:
   • IP-Adresse: die Adresse des Wechselrichters, zum Beispiel 192.0.2.20. Ein Hostname geht auch.
   • Anlagenbetreiber-Passwort: nur in der Gladys-Konfiguration gespeichert, nie in die Protokolle geschrieben.
   • Aktualisierungsintervall: 10, 15 (Standard), 30 oder 60 Sekunden. Jede Aktualisierung ist eine Anfrage an den Wechselrichter.
   • Sprache der Gerätetexte: Namen des Geräts und seiner Funktionen, Status des Wechselrichters, Alarmtexte (standardmäßig Französisch). Die Namen werden beim Hinzufügen des Geräts festgelegt.
   • Batterie voll ab / Batterie leer ab: die Werte, die die Szenen-Auslöser der Batterie auslösen.
   • Batterieeinstellungen erlauben: standardmäßig aus, siehe „Szenen-Aktionen“.
3. Klicke auf Verbindung testen: Die Integration meldet sich an und zeigt, was sie gefunden hat (Modell, PV-Strings, Batterie, Firmware, Batterieeinstellungen).
4. Öffne den Tab Entdecken und füge den Wechselrichter hinzu. Seine Werte kommen sofort an.

Das Gerät

Ein Gerät pro Wechselrichter, benannt nach seinem Modell (zum Beispiel „Kostal PLENTICORE plus 10“). Eine Funktion gibt es nur, wenn der Wechselrichter sie misst: keine Batteriefunktionen ohne Batterie, keine Funktionen pro String bei nur einem String.

Funktion	Bedeutung
Solarproduktion	DC-Leistung aller PV-Strings, in W
PV-String 1, 2, 3	Leistung jedes Strings (ab zwei Strings)
Hausverbrauch	Was das Haus verbraucht, in W
Netz (Bezug +, Einspeisung −)	Austausch mit dem Netz: positiv, wenn das Haus aus dem Netz bezieht, negativ, wenn der Wechselrichter einspeist
AC-Leistung des Wechselrichters	Was der Wechselrichter auf der AC-Seite liefert, in W
Ladestand der Batterie	Ladestand, in %
Batterieladung / Batterieentladung	Leistung in die Batterie und aus ihr heraus, in W
Batteriezyklen	Vom Wechselrichter gezählte Vollzyklen
Produktion heute	Seit Mitternacht erzeugte Energie, in kWh
Gesamtproduktion	Seit der Inbetriebnahme erzeugte Energie, in kWh
Haus aus dem Netz (gesamt)	Energie, die das Haus aus dem Netz bezogen hat, in kWh
Einspeisung (gesamt)	Ins Netz eingespeiste Energie, in kWh (berechnet wie in Home Assistant: Produktion minus der vom Wechselrichter gedeckte Hausverbrauch)
Geladene / Entladene Energie (gesamt)	Zähler der Batterie, in kWh
Wechselrichterstatus	Speist ein, Standby, Abgeregelt, Überhitzung…
Aktive Alarme	Anzahl der aktiven Fehler
Letzter Alarm	Text des letzten aktiven Alarms, wie ihn der Wechselrichter formuliert, oder „Kein Alarm“

Alle Funktionen sind nur lesbar: Nichts auf dem Dashboard kann den Wechselrichter verändern.

Energieüberwachung

„Haus aus dem Netz (gesamt)“ ist ein Energiezähler: Gladys leitet daraus einen Halbstundenverbrauch und dessen Kosten ab, wie bei einem Stromzähler, und hängt ihn an deinen Hauptstromzähler, falls du einen hast. Es ist der einzige Verbrauchszähler des Geräts: Selbst erzeugte Energie wird nie als gekauft gezählt.

Die Produktionszähler („Gesamtproduktion“, „Einspeisung (gesamt)“) und die Batteriezähler werden mit ihrem Verlauf gespeichert und in den Diagrammen angezeigt. Gladys 5.2 wandelt den Produktionszähler einer externen Integration noch nicht in eine Halbstundenproduktion um: Das kommt mit dem Kern.

Dashboard-Widget

Füge das Widget Kostal zu einem Dashboard hinzu. Es zeigt:

• Kacheln für Solarproduktion, Haus, Netz, Batterie und die Produktion des Tages, live;
• die Kurve von Produktion und Verbrauch der letzten 24 Stunden;
• eine Statusliste: Netzbezug oder Einspeisung, Batterie lädt oder entlädt, Status des Wechselrichters, Alarme, Autarkie und Eigenverbrauch des Tages, Hausverbrauch des Tages, die Batterieeinstellungen (wenn erlaubt), die Uhrzeit der letzten Messung.

Das Widget kostet keine Anfrage an den Wechselrichter: Es zeigt die letzte Messung.

Szenen-Auslöser

• Alarm des Kostal-Wechselrichters: Ein neuer Alarm ist am Wechselrichter aufgetreten. Variablen: der Alarmcode, sein Text (in der Sprache der Konfiguration) und seine Kategorie. Derselbe Code löst höchstens alle 10 Minuten einmal aus.
• Kostal-Batterie voll: Der Ladestand hat den Wert „Batterie voll ab“ erreicht. Löst erst nach einem Rückgang um 5 Punkte erneut aus.
• Kostal-Batterie leer: Der Ladestand ist auf den Wert „Batterie leer ab“ gefallen. Löst erst nach einem Anstieg um 5 Punkte erneut aus.

Bei der ersten Messung nach einem Start wird nichts ausgelöst: Ein Neustart spielt nie einen alten Alarm erneut ab.

Für eine Schwelle auf einer Leistung (Einspeisung über 2.000 W für 10 Minuten) nutze den Standard-Auslöser „Gerätezustand“ von Gladys auf der Funktion „Netz“: Er hat die Schwelle und die Dauer.

Szenen-Aktionen

Beide Aktionen sind standardmäßig aus: Aktiviere zuerst „Batterieeinstellungen erlauben“ in der Konfiguration. Die Aktionen funktionieren nur, wenn der Wechselrichter dem Anlagenbetreiber die Änderung erlaubt (der Verbindungstest sagt es dir), und jede Änderung schreibt eine Zeile in die Protokolle.

• Reserve der Kostal-Batterie einstellen: der minimale Ladestand, den die Batterie hält, von 5 bis 100 %, in 5-%-Schritten. Die Szene erhält den angewendeten Wert.
• Intelligente Batteriesteuerung von Kostal: schaltet die intelligente Batteriesteuerung von Kostal ein oder aus. Das Einschalten beendet die Zeitsteuerung, wie es die Oberfläche des Wechselrichters auch tut.

Ein falscher Wert ändert die Nutzung deiner Batterie: Prüfe ihn danach in der Weboberfläche des Wechselrichters.

Beispielszenen

• Vor einem Gewitter eine Reserve halten: Bei einer Wetterwarnung „Reserve der Kostal-Batterie einstellen“ auf 50 % ausführen; am nächsten Tag wieder auf 10 % setzen.
• Den Überschuss nutzen: Auslöser „Gerätezustand“ auf „Netz (Bezug +, Einspeisung −)“ unter −2.000 W für 10 Minuten → den Warmwasserbereiter einschalten; ausschalten, wenn der Wert wieder über 0 steigt.
• Bei einer Störung benachrichtigt werden: Auslöser „Alarm des Kostal-Wechselrichters“ → die Nachricht „Wechselrichter-Alarm {{triggerEvent.data.code}}: {{triggerEvent.data.description}}“ senden.
• Batterie mittags voll: Auslöser „Kostal-Batterie voll“ → die Spülmaschine oder das Laden des Autos starten.

Anfragen an den Wechselrichter

• Eine Anfrage pro Aktualisierung (10 bis 60 Sekunden, nach deiner Wahl), mit einer Sitzung, die zwischen den Anfragen bestehen bleibt: eine Anmeldung beim Start, erneut nur, wenn der Wechselrichter neu gestartet ist.
• Alle 30 Minuten lesen vier leichte Anfragen, was der Wechselrichter ist (Firmware-Update, neue Batterie).
• Die Alarmtexte werden nur bei einem aktiven Alarm gelesen; die Batterieeinstellungen alle 5 Minuten, und nur wenn erlaubt.
• Solange das Gerät nicht zu Gladys hinzugefügt ist, wird nichts gelesen, außer für das Widget.
• Ein abgelehntes Passwort wird 15 Minuten lang nicht erneut versucht (oder bis du die Konfiguration speicherst): Der Wechselrichter sperrt das Konto nach mehreren fehlgeschlagenen Anmeldungen.
• Die Integration meldet sich beim Beenden ab: Der Wechselrichter hält nur wenige Sitzungen.

Fehlerbehebung

• „Der Wechselrichter antwortet nicht“: Prüfe die Adresse (öffne http://<Adresse> in einem Browser im selben Netz), ob der Wechselrichter im Netz ist und ob Gladys ihn erreicht.
• „Der Wechselrichter hat das Passwort abgelehnt“: Gib das Anlagenbetreiber-Passwort der Weboberfläche ein (nicht den Servicecode des Installateurs, nicht das Passwort des Kostal-Solar-Portals). Speichere die Konfiguration, um es sofort erneut zu versuchen.
• „Der Wechselrichter hat das Anlagenbetreiber-Konto gesperrt“: Warte, bis es entsperrt ist (die Weboberfläche zeigt es dir), und speichere die Konfiguration dann erneut.
• Eine Funktion fehlt: Der Wechselrichter listet die Messung nicht (keine Batterie, nur ein String, eine ältere Firmware). Starte „Verbindung testen“ und nach einem Firmware-Update „Aktualisieren“ im Tab Entdecken.
• Die Vorzeichen von Netz oder Batterie wirken vertauscht: Melde es im Forum mit deinem Modell und deiner Firmware: Die Vorzeichen wurden nur anhand der Dokumentation geprüft.
• Mehr Details: Setze die Umgebungsvariable LOG_LEVEL der Integration auf debug. Die Protokolle enthalten nie das Passwort oder die Sitzung.

Grenzen

• Ohne die Hardware entwickelt: Die Vorzeichen (Netz, Batterie), die genaue Liste der Messwerte jedes Modells und die änderbaren Einstellungen stammen aus der Dokumentation und der Home-Assistant-Integration, nicht aus einem Test an einem echten Wechselrichter.
• Nur Anlagenbetreiber-Zugang: Einstellungen, die den Servicecode des Installateurs (und den Master-Key) erfordern, werden nicht unterstützt.
• Ein Wechselrichter pro Installation der Integration.
• Der Einspeisezähler ist berechnet (Produktion minus der vom Wechselrichter gedeckte Hausverbrauch), wie in Home Assistant.
• Keine Halbstundenproduktion in der Energieüberwachung, solange der Gladys-Kern sie für externe Integrationen nicht unterstützt.
• PIKO IQ / MP und PLENTICORE BI sollten wie der PLENTICORE plus antworten (gleiche Plattform); ein fehlender Messwert bedeutet einfach eine fehlende Funktion.

Konfigurationseinstellungen

Diese Einstellungen fragt Kostal Plenticore in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Deinen Kostal-Wechselrichter verbinden	section	Nein	Gib die IP-Adresse des Wechselrichters ein (in deinem Router oder auf dem Display des Wechselrichters zu sehen) und das Anlagenbetreiber-Passwort, mit dem du dich an seiner Weboberfläche anmeldest. Gladys liest den Wechselrichter im lokalen Netz, ohne die Kostal-Cloud. Öffne dann den Tab „Entdecken“.
IP-Adresse	string	Ja	Des Wechselrichters. Ein Hostname geht auch.
Anlagenbetreiber-Passwort	secret	Ja	Das Passwort des Anlagenbetreiber-Kontos der Weboberfläche des Wechselrichters. Der Servicecode des Installateurs wird nicht benötigt.
Aktualisierungsintervall	select	Nein	Wie oft der Wechselrichter gelesen wird: jeweils eine Anfrage.
Sprache der Gerätetexte	select	Nein	Namen des neuen Geräts und seiner Funktionen, Statustexte des Wechselrichters und der Alarme.
Batterie voll ab (%)	number	Nein	Ladestand, der den Szenen-Auslöser „Batterie voll“ auslöst.
Batterie leer ab (%)	number	Nein	Ladestand, der den Szenen-Auslöser „Batterie leer“ auslöst: meist der am Wechselrichter eingestellte minimale Ladestand.
Batterieeinstellungen (erweitert)	section	Nein	Standardmäßig aus. Wenn erlaubt, können zwei Szenen-Aktionen den minimalen Ladestand ändern und die intelligente Batteriesteuerung schalten, sofern der Wechselrichter es dem Anlagenbetreiber erlaubt. Ein falscher Wert ändert die Nutzung deiner Batterie: Prüfe ihn danach in der Weboberfläche des Wechselrichters.
Batterieeinstellungen erlauben	boolean	Nein	Erlaubt den Szenen-Aktionen, auf den Wechselrichter zu schreiben.

So installierst du Kostal Plenticore in Gladys

1. Öffne in Gladys Integrationen: Kostal Plenticore 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-kostal:1.0.1) 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-kostal.

Kostal Plenticore 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

Kostal Plenticore 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 🙂