
SunSpec Model 123 — Immediate Controls
SunSpec Modell 123 ist ein standardisiertes Wechselrichter-Steuerungsmodell der SunSpec Alliance für netzgekoppelte dezentrale Energieerzeugungsanlagen. Diese Modbus-TCP-Vorlage richtet sich an den Immediate-Controls-Block, der von SMA, Fronius, Kostal und anderen SunSpec-zertifizierten Wechselrichtern unterstützt wird. Sie umfasst Netzverbindungssteuerung (conn), Wirkleistungsbegrenzung (wmaxlimpct und wmaxlim_ena), Leistungsfaktorvorgabe (outpfset und outpfset_ena) sowie Blindleistungs-Sollwerte (varwmaxpct, varmaxpct, varavalpct, varpct_ena) einschließlich der zugehörigen Zeitfenster-, Rückkehr- und Rampenregister. Mit dem Import dieser Vorlage in Ihr ModbusCloud-Portal erhalten Sie eine betriebsbereite Schnittstelle für jedes kompatible Gerät, ohne manuelles Registermapping.
- Protokoll
- Modbus TCP
- Anschluss
- Ethernet, Modbus TCP
- Register
- 26, lesen und schreiben
- Marke
- SunSpec
- Zuletzt aktualisiert
Register (26)
26 lesen, 21 schreiben
| Name | Einheit | Zugriff | Adresse (Verborgen bis zur Eingabe Ihrer E-Mail-Adresse) | Funktion (verborgen) | Typ (verborgen) |
|---|---|---|---|---|---|
| id | Lesen | ||||
| l | Lesen | ||||
| conn_wintms | Secs | Lesen und Schreiben | |||
| conn_rvrttms | Secs | Lesen und Schreiben | |||
| conn | Lesen und Schreiben | ||||
| wmaxlimpct | % WMax | Lesen und Schreiben | |||
| wmaxlimpct_wintms | Secs | Lesen und Schreiben | |||
| wmaxlimpct_rvrttms | Secs | Lesen und Schreiben | |||
| wmaxlimpct_rmptms | Secs | Lesen und Schreiben | |||
| wmaxlim_ena | Lesen und Schreiben | ||||
| outpfset | cos() | Lesen und Schreiben | |||
| outpfset_wintms | Secs | Lesen und Schreiben | |||
| outpfset_rvrttms | Secs | Lesen und Schreiben | |||
| outpfset_rmptms | Secs | Lesen und Schreiben | |||
| outpfset_ena | Lesen und Schreiben | ||||
| varwmaxpct | % WMax | Lesen und Schreiben | |||
| varmaxpct | % VArMax | Lesen und Schreiben | |||
| varavalpct | % VArAval | Lesen und Schreiben | |||
| varpct_wintms | Secs | Lesen und Schreiben | |||
| varpct_rvrttms | Secs | Lesen und Schreiben | |||
| varpct_rmptms | Secs | Lesen und Schreiben | |||
| varpct_mod | Lesen und Schreiben | ||||
| varpct_ena | Lesen und Schreiben | ||||
| wmaxlimpct_sf | Lesen | ||||
| outpfset_sf | Lesen | ||||
| varpct_sf | Lesen |
Register werden geladen…
Senden Sie Ihre Geräteliste
Steht ein Gerät noch nicht in der Bibliothek, erstellen wir die Vorlage kostenlos, sobald wir die Register haben.
Anwendungsfälle
- Überwachen Sie den Wirkleistungs-Sollwert (wmaxlimpct), um zu prüfen, ob Abregelungsbefehle eines Netzbetreibers oder EMS korrekt umgesetzt werden.
- Verfolgen Sie den Leistungsfaktor-Sollwert (outpfset) zeitlich, um die Einhaltung lokaler Netzkodeanforderungen für Blindleistung zu bestätigen.
- Richten Sie einen Alert ein, wenn das Netzverbindungsregister (conn) unerwartet wechselt, als Hinweis auf eine ungeplante Wechselrichterabschaltung.
- Vergleichen Sie den Rückkehr-Timeout von wmaxlimpct (wmaxlimpct_rvrttms) mit geplanten Abregelungsfenstern, um verpasste Rückkehrzeitpunkte zu erkennen.
- Prüfen Sie Blindleistungsmodus (varpct_mod) und Aktivierungsstatus (varpct_ena) nach Firmware-Updates, um sicherzustellen, dass Steuerungseinstellungen erhalten geblieben sind.
Installation
Aktivieren Sie Modbus TCP am Wechselrichter oder Gateway im Kommunikations- oder Modbus-Bereich der Weboberfläche, und stellen Sie sicher, dass das SunSpec-Profil aktiv und die Bytereihenfolge auf Big-Endian eingestellt ist.
Verbinden Sie den Wechselrichter oder das Modbus-Gateway mit demselben LAN-Segment wie das ModbusCloud Gateway, und stellen Sie sicher, dass TCP-Port 502 von der IP-Adresse des Gateways erreichbar ist.
Fügen Sie das Gerät im ModbusCloud-Portal hinzu, importieren Sie die SunSpec-Modell-123-Vorlage, und tragen Sie die korrekte Unit-ID Ihres Wechselrichters ein. Ermitteln Sie die zugewiesene Unit-ID über das Inbetriebnahme-Tool des Geräts.
Prüfen Sie im Live-Register-View des Portals das id-Register (Adresse 0): Es muss den Wert 123 anzeigen, um zu bestätigen, dass der richtige Modellblock auf dem Gerät abgefragt wird.
Zu beachten
Das id-Register zeigt einen anderen Wert als 123. Woran liegt das?
Die SunSpec-Registerkarte ist selbstbeschreibend und verkettet: Modell 123 liegt nicht immer an einer festen absoluten Adresse. Die absolute Modbus-Adresse des Modellblocks hängt davon ab, welche Modelle in der Kette vorangehen. Führen Sie einen SunSpec-Model-Discovery-Scan durch oder konsultieren Sie die PICS-Tabelle des Geräts, um die korrekte Startadresse zu ermitteln, und passen Sie danach den Offset in der Vorlage an.
Ich habe wmaxlimpct geschrieben, aber die Ausgangsleistung hat sich nicht geändert. Was nun?
Das alleinige Schreiben des Sollwertregisters reicht nicht aus. Das Register wmaxlim_ena muss nach dem Setzen von wmaxlimpct beschrieben werden, um die Drosselfunktion zu aktivieren. Steuerwerte werden erst wirksam, wenn das zugehörige Enable-Register geschrieben wurde. Stellen Sie sicher, dass wmaxlim_ena auf den korrekten aktivierten Enumerationswert gesetzt ist.
Skalierte Registerwerte weichen um Faktor 10 oder 100 ab. Wie behebe ich das?
SunSpec verwendet Skalierungsfaktor-Register (wmaxlimpct_sf, outpfset_sf, varpct_sf), die einen vorzeichenbehafteten Exponenten als Zehnerpotenz speichern. Liefern diese Skalierungsfaktoren einen von null abweichenden Wert, muss der Rohregisterwert mit 10 hoch diesem Exponenten multipliziert werden. Stellen Sie sicher, dass Ihre ModbusCloud-Vorlage diese Skalierungsfaktoren ausliest und korrekt anwendet.
Schreibregister liefern keine Antwort oder einen Fehler. Was sollte ich prüfen?
Einige Wechselrichterhersteller schützen die Schreibregister von Modell 123 durch einen Entsperrcode oder beschränken den Schreibzugriff auf einen einzigen Modbus-Client gleichzeitig. Prüfen Sie, ob ein anderer Client wie ein EMS oder Datenlogger bereits eine exklusive Sitzung belegt. Beachten Sie auch: Das Schreiben eines nicht unterstützten Werts löst Modbus-Ausnahme 3 aus. Gehen Sie mit Schreibregistern sorgfältig um: Eine Netzabtrennung (conn = 0) oder eine extreme Leistungsbegrenzung kann die Wechselrichterleistung beeinflussen und Vereinbarungen mit dem Netzbetreiber gefährden.
Wissensartikel zu diesem Gerät

SunSpec Modbus: eine Registerkarte für viele Wechselrichter
SunSpec Modbus ist die offene Registerkarte, die SMA, Fronius, Kostal und SolarEdge teilen. Aufbau, int+SF versus float, Ports und gemischte Parks auslesen.
Fronius Modbus: Symo GEN24 über Modbus TCP auslesen
Fronius Modbus auslesen: Modbus TCP an der Symo GEN24 auf Port 502 aktivieren, zwischen int+SF und float wählen, die richtigen SunSpec-Register lesen und korrekt skalieren. Praxisleitfaden für DACH-Installateure.
SMA Modbus: Sunny Boy per Modbus TCP auslesen 2026
SMA Modbus auslesen: Modbus-TCP-Server auf Port 502 aktivieren, zwischen SMA-Profil (Unit ID 3) und SunSpec (Unit ID 126) wählen, die richtigen Register lesen und die NaN-Werte nachts abfangen. Praxisleitfaden für DACH-Installateure.
Selbst sehen, wie es funktioniert?








