PV-Monitor für SMA-Wechselrichter

Das WLAN-Gateway PVM-SGW von minlux bringt ältere SMA-Wechselrichter (Sunny Boy, Sunny Mini Central) ins Smart Home – z.B. in Home Assistant, ioBroker oder openHAB. Es wird direkt in den Wechselrichter gesteckt – an die Stelle, an der sonst ein SMA Piggy-Back sitzt – und stellt die Daten Ihrer Photovoltaik-Anlage lokal über eine offen dokumentierte REST-API bereit, ganz ohne Cloud. Wer seine Anlage zusätzlich überwachen lassen möchte, nutzt optional die PV-Monitor Cloud: Dashboard mit kompletter Historie, Benachrichtigung bei Ausfall oder Störung und täglicher Bericht per Telegram oder E-Mail.

PVM-SGW – WLAN-Gateway für ältere SMA-Wechselrichter

Das PVM-SGW (PV-Monitor SMA-Gateway) ist ein kleines WLAN-Modul, das per Adapterplatine direkt auf den Piggy-Back-Steckplatz des Wechselrichters gesteckt wird. Es ersetzt damit den SMA Piggy-Back (RS232, RS485 oder Powerline) samt Datenlogger wie Sunny WebBox oder PC mit Sunny Data – ein zusätzliches Gerät ist nicht nötig. 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:

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.

Pro Wechselrichter wird ein PVM-SGW benötigt. Preis: 50 € pro Stück.

Einbau

Das PVM-SGW wird einfach auf den Piggy-Back-Steckplatz des Wechselrichters gesteckt. Dafür muss der Wechselrichter jedoch geöffnet werden. Arbeiten im Wechselrichter dürfen nur von einer Elektrofachkraft durchgeführt werden (Wechselrichter AC- und DC-seitig freischalten, ESD-Schutz beachten).

Unterstützte Wechselrichter

Das PVM-SGW ist für SMA-Wechselrichter der Classic-Reihe mit Piggy-Back-Steckplatz (ca. Baujahr 1999–2012) ausgelegt. Im Dauereinsatz ist es aktuell an einem SMC 9000TL-10. Die folgenden Geräte nutzen dieselbe Schnittstelle:

• Sunny Boy: SB 1100, SB 1200, SB 1700, SB 1600TL-10, SB 2100TL, SB 2500, SB 2800i, SB 3000, SB 3300, SB 3800, SB 3300-11, SB 3800-11, SB 3300TL, SB 4200TL, SB 5000TL, SB 3300TL HC, SB 4200TL HC, SB 5000TL HC
• Sunny Mini Central: SMC 4600A, SMC 5000, SMC 5000A, SMC 6000, SMC 6000A, SMC 4600A-11, SMC 5000A-11, SMC 6000A-11, SMC 7000HV, SMC 7000HV-11, SMC 6000TL, SMC 7000TL, SMC 8000TL, SMC 9000TL-10, SMC 10000TL-10, SMC 11000TL-10, SMC 9000TLRP-10, SMC 10000TLRP-10, SMC 11000TLRP-10

Ihr Modell ist nicht dabei oder Sie sind unsicher? Fragen Sie einfach nach. Neuere SMA-Wechselrichter der „New Generation“ (z.B. SB …TL-20/-21, SB …HF-30, Sunny Tripower STP …TL-10) werden nicht unterstützt.

Optional: PV-Monitor Cloud

Mit der PV-Monitor Cloud sendet das PVM-SGW die Messwerte zusätzlich etwa einmal pro Minute an minlux. PV-Monitor stellt Ihnen dann zum Einen eine Internetseite zur Verfügung, über die Sie auf aktuelle und historische Daten Ihrer Anlage zugreifen können. Zum Anderen überwacht PV-Monitor selbstständig den Zustand Ihrer Photovoltaik Anlage und informiert Sie bei Ausfall oder Störung (wahlweise per Telegram und/oder E-Mail).

Über die Internetseite sehen Sie oben 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 werden verschiedene Diagramme z.B. Leistung und Ertrag der Anlage angezeigt. Hier können Sie nicht nur die Daten des heutige Tages ansehen, sondern hier haben Sie Zugriff auf die komplette Historie Ihrer Anlage. Auf Wunsch erhalten Sie täglich um 20:00 Uhr eine kurze Zusammenfassung mit den wichtigsten Kennzahlen des Tages.

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.

Demo

Die PV-Monitor Cloud finden Sie unter minlux.de/pvmonitor/ . Mit Benutzername demo und Passwort minlux erhalten Sie Demo-Zugang und können sich weiter informieren.

Preise

• PVM-SGW: 50 € pro Stück (ein PVM-SGW pro Wechselrichter). Im lokalen Betrieb (REST-API, Smart Home) fallen keine weiteren Kosten an.
• PV-Monitor Cloud (optional): zusätzlich 2 € pro Wechselrichter und Monat für Dashboard, komplette Historie, Alarmierung und Tagesbericht per Telegram oder E-Mail.

Gemäß § 19 UStG (Kleinunternehmerregelung) wird keine Umsatzsteuer berechnet.

Häufige Fragen

Welche SMA-Wechselrichter werden unterstützt?

Das PVM-SGW passt in SMA-Wechselrichter der Classic-Reihe mit Piggy-Back-Steckplatz, also ältere Sunny Boy (SB) und Sunny Mini Central (SMC), etwa Baujahr 1999 bis 2012. Im Dauereinsatz ist es derzeit an einem SMC 9000TL-10. Neuere Geräte der „New Generation“ (z.B. SB …TL-20/-21, SB …HF-30, Sunny Tripower STP …TL-10) werden nicht unterstützt.

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.

Ist das PVM-SGW ein Ersatz für Sunny WebBox, Sunny Data oder einen SMA Piggy-Back?

Ja, für ältere SMA-Wechselrichter. Das PVM-SGW sitzt auf dem Steckplatz, auf dem sonst ein SMA Piggy-Back (RS232, RS485 oder Powerline) steckt, und bindet den Wechselrichter direkt per WLAN an – ein zusätzlicher Datenlogger oder PC ist nicht nötig.

Wer baut das PVM-SGW ein?

Für den Einbau muss der Wechselrichter geöffnet werden. Das darf nur eine Elektrofachkraft tun (Wechselrichter AC- und DC-seitig freischalten, ESD-Schutz beachten). Der Einbau selbst ist einfach: Modul auf den Piggy-Back-Steckplatz stecken, Wechselrichter schließen, WLAN einrichten.

Was kosten PVM-SGW und PV-Monitor Cloud?

Das PVM-SGW kostet 50 € pro Stück; im lokalen Betrieb fallen keine weiteren Kosten an. Für die optionale PV-Monitor Cloud mit Dashboard, kompletter Historie, Alarmierung und Tagesbericht per Telegram oder E-Mail kommen 2 € pro Wechselrichter und Monat hinzu. Pro Wechselrichter wird ein PVM-SGW benötigt. Gemäß § 19 UStG wird keine Umsatzsteuer berechnet.

Downloads

• openapi.yaml – OpenAPI-Beschreibung der REST-API des PVM-SGW
• onboarding.txt – Anleitung: PVM-SGW mit dem WLAN verbinden (Einrichtung)