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.

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.
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.
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.