Kostenlose Modbus-Vorlage SunSpec Model 501 — Solar Module | ModbusCloud
Modbus TCP
SunSpec Model 501 — Solar Module
SunSpec
Überblick
SunSpec Model 501 ist das Solar-Module-Informationsmodell der SunSpec Alliance, das von PV-Optimierern, modulbasierten Leistungselektroniken und kompatiblen Wechselrichtern genutzt wird, um Daten auf Modulebene per Modbus TCP bereitzustellen. Diese Modbus-Vorlage liest ausgangsseitige Messwerte (Strom, Spannung, Momentanleistung und Energie über outa, outv, outw und outwh), eingangsseitige String-Werte (ina, inv, inw, inwh), Modultemperatur (tmp), einen Sekundenzeitstempel (tms) sowie Standard-Status- und Ereignisregister. Drei Schreibregister (ctl, ctlvend, ctlval) ermöglichen Steuerkommandos auf Modulebene. Der ModbusCloud Gateway verbindet sich mit jedem SunSpec-Model-501-konformen Gerät und stellt alle Daten ohne Programmieraufwand in Ihrem Portal bereit.
Anwendungsfälle
Überwachen Sie die Ausgangsleistung je Modul in Echtzeit, um unterdurchschnittlich produzierende Panels in einer Multi-String-Anlage zu identifizieren.
Vergleichen Sie kumulative Eingangs- und Ausgangsenergie (inwh gegenüber outwh), um den Umwandlungswirkungsgrad des Optimierers über mehrere Saisons zu berechnen.
Richten Sie Alarme auf aktive Ereignis-Bitfelder (evt) ein, um Modulfehler zu erkennen, bevor der Gesamtertrag der Anlage sinkt.
Vergleichen Sie die Modultemperatur (tmp) mit der Ausgangsleistung, um temperaturbedingte Leistungsminderung an heißen Sommertagen zu verifizieren.
Prüfen Sie Lücken im tms-Zeitstempel, um die Datenkontinuität zu bestätigen und Kommunikationsausfälle auf dem Modbus-Segment zu erkennen.
Installation
1Aktivieren Sie Modbus TCP am Hostgerät oder Optimizer-Gateway unter den Kommunikations- oder Modbus-Einstellungen, stellen Sie sicher, dass Port 502 erreichbar ist, und notieren Sie die zugewiesene IP-Adresse.
2Verbinden Sie das Gerät über den Netzwerk-Switch oder direkt mit demselben LAN wie der ModbusCloud Gateway, und stellen Sie sicher, dass keine Firewall-Regel Port 502 blockiert.
3Fügen Sie im ModbusCloud-Portal den Gateway hinzu, legen Sie ein neues Gerät an, wählen Sie die SunSpec-Model-501-Vorlage aus und tragen Sie die IP-Adresse sowie die Unit-ID passend zu Ihrer Hardware ein.
4Verifizieren Sie die Verbindung, indem Sie das id-Register (Adresse 0) auslesen: ein Wert von 501 bestätigt, dass das korrekte Modell adressiert wird und der Gateway erfolgreich abfragt.
Zu beachten
01
Warum liefern id und l unerwartete Werte?
SunSpec-Modelle sind dynamisch in der Registermap eines Geräts positioniert. Adresse 0 in dieser Vorlage ist ein relativer Offset innerhalb des Modellblocks, keine absolute Modbus-Adresse. Sie müssen zunächst die SunSpec-Registerkette ab der Basisadresse des Geräts (üblicherweise 40001) durchlaufen, um den Startpunkt von Model 501 zu ermitteln, und diese Startadresse anschließend im Portal eintragen.
02
Alle float32-Register liefern NaN oder 0xFFFFFFFF. Was ist die Ursache?
SunSpec-Geräte verwenden 0x7FC00000 (NaN für float32), um nicht implementierte oder momentan nicht verfügbare Datenpunkte zu kennzeichnen. Stellen Sie sicher, dass das Modul unter Spannung steht und die Firmware des Hostgeräts Model 501 unterstützt. Achten Sie außerdem darauf, dass im Portal Big-Endian-Bytereihenfolge eingestellt ist, da SunSpec Big-Endian-Registerspeicherung vorschreibt.
03
Der Gateway verbindet sich, aber Leistungs- und Stromwerte werden nicht aktualisiert.
Manche SunSpec-Model-501-Implementierungen veröffentlichen nur dann neue Messwerte, wenn das Modul Energie erzeugt. Nachts oder bei sehr geringer Einstrahlung kann das Gerät den letzten bekannten Wert beibehalten oder NaN zurückgeben. Überprüfen Sie das tms-Register: Wenn der Zeitstempel nicht fortschreitet, aktualisiert das Gerät seinen Datenblock nicht.
04
Ist es sicher, in die Register ctl, ctlvend oder ctlval zu schreiben?
Gehen Sie mit diesen Schreibregistern sorgfältig um. Ein nicht unterstützter oder ungültiger Wert in ctl oder ctlval kann einen Modul-Shutdown auslösen, die Energieerzeugung unterbrechen oder je nach Hersteller die Garantie des Geräts beeinträchtigen. Konsultieren Sie stets die Gerätedokumentation, bevor Sie Steuerkommandos senden, und testen Sie zunächst an einem einzelnen Modul, bevor Sie dies auf einen gesamten String ausweiten.
Register (19)
19 lesen / 3 schreiben
Name
Adresse
Funktion
Typ
Einheit
Zugriff
id
SunSpec model identifier, fixed value 501 for Solar Module.
0
FC03
uint16
R
l
Length of this model block in 16-bit Modbus registers.
1
FC03
uint16
R
stat
Operating status code of the solar module.
2
FC03
uint16
R
statvend
Vendor-defined status code, manufacturer-specific interpretation.
3
FC03
uint16
R
evt
Standard event bitfield reporting module fault and alarm conditions.
4
FC03
uint32
R
evtvend
Vendor-defined event bitfield for manufacturer-specific fault flags.
6
FC03
uint32
R
ctl
Module control command register, write to issue control actions.
8
FC03
uint16
R/W
ctlvend
Vendor-specific control register, qualifier for the ctl command.
9
FC03
uint32
R/W
ctlval
Control value parameter accompanying the ctl command, signed integer.
11
FC03
int32
R/W
tms
Timestamp of last measurement, seconds since epoch.
13
FC03
uint32
Secs
R
outa
Output-side DC current from the module, amperes.
15
FC03
float32
A
R
outv
Output-side DC voltage from the module, volts.
17
FC03
float32
V
R
outwh
Cumulative energy delivered on the output side, watt-hours.
19
FC03
float32
Wh
R
outw
Instantaneous output power from the module, watts.
21
FC03
float32
W
R
tmp
Module temperature, degrees Celsius.
23
FC03
float32
C
R
ina
Input-side DC current entering the module from the PV cell string, amperes.
25
FC03
float32
A
R
inv
Input-side DC voltage from the PV cell string, volts.
27
FC03
float32
V
R
inwh
Cumulative energy received on the input side from the PV string, watt-hours.
29
FC03
float32
Wh
R
inw
Instantaneous input power from the PV cell string, watts.
31
FC03
float32
W
R
Arbeiten Sie häufiger mit Modbus in Ihren Projekten?
ModbusCloud ist die Hardware- und Softwareplattform, mit der Installateure Modbus-Geräte aus einem Portal überwachen, visualisieren und steuern. Diese Vorlage ist eine von hunderten, die Sie sofort einsetzen können.
