Funktionen von PV-Monitor

Das PVM-SGW lässt sich auf zwei Arten nutzen: lokal im eigenen Smart Home, ganz ohne Internet-Zwang, oder zusätzlich online mit der PV-Monitor Cloud, die Ihre Anlage überwacht und Sie bei Ausfall oder Störung benachrichtigt. Beides lässt sich auch kombinieren.


Lokal – im eigenen Smart Home, ohne Internet-Zwang

Das PVM-SGW liest den Wechselrichter laufend aus und stellt die Messwerte über eine REST-API in Ihrem WLAN bereit.

So lassen sich aktuelle Werte wie Leistung, Netzspannung, Netzstrom und Gesamtertrag als JSON abfragen und in Home Assistant, ioBroker, openHAB, Node-RED oder andere Smart-Home-Systeme einbinden. Es werden keine Daten ins Internet übertragen und es fallen keine laufenden Kosten an.

Offene Schnittstelle: dokumentierte REST-API

Die Schnittstelle des PVM-SGW ist offen dokumentiert – Ihre Anlagendaten gehören Ihnen:

  • Vollständige OpenAPI-Beschreibung (OpenAPI 3.1) zum Download – alle Endpunkte, Datenformate und Beispiele.
  • Standard HTTP und JSON – kein proprietäres Protokoll, keine spezielle App, kein Treiber.
  • Kein Konto, keine Registrierung, keine Cloud – die Abfrage läuft direkt im eigenen Netz.
  • Frei verwendbar: in Home Assistant, ioBroker, openHAB, Node-RED, evcc oder mit eigenen Skripten (z.B. Python, Shell).

Die wichtigsten Endpunkte:

Endpunkt Inhalt
GET /measurement aktuelle Messwerte als JSON (z.B. Leistung, Netzspannung, Netzstrom, Netzfrequenz, Gesamtertrag, Status, Fehler)
GET /channels alle Kanäle des Wechselrichters mit Name, Gruppe, Einheit und aktuellem Wert
GET /sysinfo Firmware-Version, angeschlossener Wechselrichter (Typ, Seriennummer), WLAN-Signalstärke
GET /log-stream Live-Protokoll des Gateways (Server-Sent Events)

Daneben sind auch Einrichtung (WLAN-Zugangsdaten), Neustart und Firmware-Update über die API möglich und in der OpenAPI-Beschreibung dokumentiert. Mit der OpenAPI-Datei lässt sich die Schnittstelle z.B. im Swagger Editor ansehen oder automatisch ein Client für die eigene Programmiersprache erzeugen.

Zum Testen genügt ein Aufruf im Browser oder auf der Kommandozeile:

curl http://192.168.178.50/measurement

Beispiel einer Abfrage der aktuellen Messwerte (GET /measurement, gekürzt, von einem SMC 9000TL-10):

{
  "Pac": 1185,
  "Uac": 236.5,
  "Iac-Ist": 5.014,
  "Fac": 50.03,
  "Upv-Ist": 420,
  "E-Total": 79394.864,
  "StatusStr": "Mpp",
  "FehlerStr": "-------"
}

Beispiel: SMA-Wechselrichter in Home Assistant

In Home Assistant genügen wenige Zeilen in der configuration.yaml, um aktuelle Leistung und Gesamtertrag des Wechselrichters als Sensoren anzulegen. Der Gesamtertrag kann direkt im Energie-Dashboard von Home Assistant als Solarproduktion verwendet werden.

rest:
  - resource: http://192.168.178.50/measurement   # IP-Adresse des PVM-SGW
    scan_interval: 60
    sensor:
      - name: "PV Leistung"
        value_template: "{{ value_json.Pac }}"
        unit_of_measurement: "W"
        device_class: power
        state_class: measurement
      - name: "PV Gesamtertrag"
        value_template: "{{ value_json['E-Total'] }}"
        unit_of_measurement: "kWh"
        device_class: energy
        state_class: total_increasing

Weitere Werte wie Netzspannung, Netzfrequenz, Status oder Fehlermeldung lassen sich auf die gleiche Weise ergänzen. Alle Endpunkte des PVM-SGW sind in der OpenAPI-Beschreibung dokumentiert (siehe Downloads).

Anwendung: Solarstrom selbst nutzen – Nulleinspeisung, E-Auto, Wärmepumpe

Besonders gefragt ist derzeit, den selbst erzeugten Solarstrom möglichst selbst zu verbrauchen, statt ihn ins Netz einzuspeisen – bis hin zur Nulleinspeisung. Das lohnt sich vor allem bei älteren Anlagen, deren EEG-Vergütung nach 20 Jahren ausgelaufen ist (Ü20-Anlagen) oder bald ausläuft.

Mit dem PVM-SGW kennt Ihr Smart Home jederzeit die aktuelle Leistung des Wechselrichters. In Kombination mit einer smarten Steuerung (z.B. Home Assistant, ioBroker, openHAB, Node-RED oder evcc) lassen sich Verbraucher genau dann einschalten, wenn die Sonne scheint:

  • Elektroauto mit Solarstrom laden (PV-Überschussladen): Die Wallbox lädt, sobald und so stark, wie die PV-Anlage Strom liefert.
  • Wärmepumpe mit Solarstrom betreiben: z.B. über den SG-Ready-Eingang Warmwasserspeicher oder Haus aufheizen, solange Solarstrom da ist.
  • Weitere Verbraucher: Heizstab, Batteriespeicher, Waschmaschine, Spülmaschine oder Poolpumpe.

Für eine genaue Regelung auf den Überschuss bzw. auf Nulleinspeisung braucht die Steuerung zusätzlich den aktuellen Netzbezug bzw. die Einspeisung am Stromzähler, z.B. über einen Lesekopf am Smart Meter. Das PVM-SGW liefert die Erzeugung, der Zähler den Verbrauch – zusammen ergibt das den Überschuss.


Online – Dashboard und Alarmierung

Mit der PV-Monitor Cloud schickt das PVM-SGW alle 2 Minuten die aktuellen Messwerte an minlux. PV-Monitor überwacht damit Ihre Anlage, benachrichtigt Sie bei Ausfall oder Störung und zeigt alle Daten in einem Dashboard.

Alarmierung bei Ausfall und Störung

Das ist die Funktion, für die PV-Monitor ursprünglich entwickelt wurde: Steht die Anlage still, erfahren Sie es innerhalb kurzer Zeit – nicht erst beim nächsten Blick auf den Zähler. PV-Monitor erkennt zwei Arten von Problemen:

  • Störung am Wechselrichter: Der Wechselrichter meldet selbst einen Fehler, z.B. wenn der FI-Schutzschalter ausgelöst hat. Die Nachricht enthält den Fehlercode des Wechselrichters.
  • Verbindung unterbrochen: Kommen von einem Wechselrichter längere Zeit keine Messwerte mehr, meldet PV-Monitor das mitsamt dem Zeitpunkt der letzten erfolgreichen Aktualisierung.

Geprüft wird nur tagsüber, abhängig von Sonnenauf- und -untergang am Standort Ihrer Anlage – nachts, wenn der Wechselrichter ohnehin abschaltet, gibt es keinen Fehlalarm. Besteht eine Störung weiter, erinnert PV-Monitor in größer werdenden Abständen erneut, bis die Anlage wieder läuft.

Benachrichtigt wird wahlweise per E-Mail und/oder Telegram. Für Telegram schreiben Sie einmal den Bot minlux PVMonitor an und hinterlegen die Kennung, die er Ihnen zurückschickt, in Ihren Einstellungen.

Telegram-Nachrichten des Bots minlux PVMonitor: Störungsmeldung „Mindestens ein Wechselrichter meldet eine Störung! Der Fehlercode lautet: Uac-Bfr“, danach drei Tagesreports mit Ertrag (z.B. 112 kWh / 53 €), Spitzenleistung und Betriebsdauer

Störungsmeldung und Tagesreports per Telegram – von der 27-kW-Anlage aus der Demo.

Dashboard und Historie

Über die Internetseite von PV-Monitor greifen Sie auf aktuelle und historische Daten Ihrer Anlage zu.

PV-Monitor Dashboard, zeigt die Wichtigsten Kennzahlen der Anlage (Momentanleistung, Ertrag, Status)

Oben sehen Sie den aktuellen Status der Anlage, die Momentanleistung sowie den Energieertrag des heutigen Tages. Falls ein Vergütungsfaktor hinterlegt ist, wird auch die erzielte Vergütung für den eingespeisten Strom angezeigt. Darunter zeigen Diagramme z.B. Leistung und Ertrag der Anlage – nicht nur für den heutigen Tag, sondern für die komplette Historie Ihrer Anlage.

Tagesreport

Auf Wunsch kommt jeden Abend um 20 Uhr ein kurzer Bericht per E-Mail oder Telegram: Tagesertrag in kWh (mit hinterlegtem Vergütungsfaktor auch in Euro), Spitzenleistung mit Uhrzeit und Betriebsdauer der Anlage.

Voraussetzungen und Kosten

Die PV-Monitor Cloud kostet 2 € pro Wechselrichter und Monat zusätzlich zum PVM-SGW.

Vernetzung von Anlagen mit vorhandenem WLAN

Für die PV-Monitor Cloud benötigen die PVM-SGW Zugriff auf das Internet, d.h. es muss ein WLAN mit Internet Zugang in deren Nähe sein. Im heimischen Umfeld, ist dies in der Regel kein Problem. Ggf. kann mit Repeater gearbeitet werden um das WLAN bis zu den Wechselrichtern zu erweitern. Für abgelegene Anlagen ohne Internetzugang (z.B. auf einer Scheune oder Halle) hat minlux eine Lösung zur Anbindung per Funk – diese bieten wir auf Anfrage an.

Die PV-Monitor Cloud können Sie in der Demo ausprobieren.


Häufige Fragen

Brauche ich für das PVM-SGW Internet oder die minlux-Cloud?
Nein. Das PVM-SGW stellt die Messwerte des Wechselrichters lokal per REST-API im eigenen WLAN bereit – ohne Cloud und ohne laufende Kosten. Nur wer zusätzlich die PV-Monitor Cloud mit Dashboard, Historie und Alarmierung nutzen möchte, braucht einen Internetzugang (2 € pro Wechselrichter und Monat).
Kann ich meinen SMA-Wechselrichter mit dem PVM-SGW in Home Assistant, ioBroker oder openHAB einbinden?
Ja. Das PVM-SGW liefert über HTTP die aktuellen Messwerte als JSON (z.B. Leistung, Netzspannung, Netzstrom, Gesamtertrag). In Home Assistant genügen dafür wenige Zeilen YAML (RESTful-Sensor); der Gesamtertrag lässt sich direkt im Energie-Dashboard verwenden. Ebenso funktionieren ioBroker, openHAB, Node-RED oder jedes andere System, das HTTP/JSON abfragen kann.
Ist die Schnittstelle des PVM-SGW offen dokumentiert?
Ja. Die REST-API des PVM-SGW ist vollständig als OpenAPI-Beschreibung (OpenAPI 3.1) dokumentiert und steht auf dieser Seite zum Download bereit. Sie nutzt Standard HTTP und JSON, benötigt kein Konto und keine Cloud und kann frei in eigene Anwendungen, Skripte oder Smart-Home-Systeme eingebunden werden.
Kann ich mit dem PVM-SGW eine Nulleinspeisung umsetzen oder mein Elektroauto mit Solarstrom laden?
Ja, in Kombination mit einer smarten Steuerung wie Home Assistant, ioBroker, openHAB, Node-RED oder evcc. Das PVM-SGW liefert die aktuelle Leistung des Wechselrichters; die Steuerung schaltet damit Verbraucher wie Wallbox, Wärmepumpe (z.B. per SG-Ready) oder Heizstab genau dann ein, wenn Solarstrom da ist – so wird der selbst erzeugte Strom selbst verbraucht statt eingespeist. Für eine genaue Regelung auf Überschuss bzw. Nulleinspeisung braucht die Steuerung zusätzlich den Netzbezug bzw. die Einspeisung am Stromzähler, z.B. über einen Lesekopf am Smart Meter. Das PVM-SGW liest den Wechselrichter nur aus, es begrenzt nicht dessen Leistung.