IAMMETER unterstützt jetzt SunSpec Modbus/TCP: Modellzuordnung und Integrationsanleitung
Die IAMMETER-Firmware i.91.065.18 ergänzt den bestehenden Modbus/TCP-Dienst um eine schreibgeschützte SunSpec-Zuordnung für ganzzahlige Zählermodelle. Software, die SunSpec-Modelle versteht, erhält damit eine standardisierte Möglichkeit, einen IAMMETER-Zähler zu erkennen und ausgewählte elektrische Werte über das lokale Netzwerk zu lesen.
Dies ist eine zusätzliche Schnittstelle, kein Ersatz für das bestehende Messsystem. Der Zähler erfasst die Daten weiterhin auf dieselbe Weise. Die vorhandenen IAMMETER-Modbus-Register, die HTTP-API, die MQTT-Nutzlasten und die NEM-Einstellungen bleiben unverändert.
SunSpec definiert standardisierte Geräteinformationsmodelle, die auf Modbus-Holding-Register abgebildet werden können. Die Zuordnung beginnt mit einer Kennung SunS, gefolgt von Common- und gerätespezifischen Modellen, die ein Client durch sequenzielles Lesen der jeweiligen Modell-ID und Länge ermitteln kann. Das SunSpec-Modbus-Spezifikationspaket dokumentiert das Muster der Modellerkennung, einschließlich der 0-basierten Positionen in der Modbus-Zuordnung und der Regeln für nicht implementierte Werte. SunSpec Modbus wird in zahlreichen Integrationen im Bereich der verteilten Energieerzeugung eingesetzt, darunter Zähler, Wechselrichter und Speichergeräte.
IAMMETER implementiert eine fokussierte, schreibgeschützte Teilmenge für Zählerdaten. Diese Implementierung ist nicht SunSpec-zertifiziert. Betrachten Sie diese Funktion nicht als Zertifizierung, vollständige SunSpec-Konformität oder als Garantie dafür, dass jeder SunSpec-Client eines Drittanbieters ohne Konfiguration funktioniert.
Aktuelle Firmware-Modellzuordnungen
| IAMMETER-Meter | SunSpec Integer-Meter-Modell | Elektrische Interpretation |
|---|---|---|
| WEM3080 | 201 | Einphasig |
| WEM2067 | 202 | Split phase (Geteilte Phase) |
| WEM3050T | 203 | Dreiphasen-Stern |
| WEM3080T | 203 | Dreiphasen-Stern |
| WEM3046T | 203 | Dreiphasen-Stern |
| WEM3063T | 203 | Dreiphasen-Stern |
Diese Zeilen beschreiben die aktuellen Firmware-Modellzuordnungen. Die hier berichtete Validierung physischer Geräte deckt nur WEM3080T ab; Bei den anderen aufgeführten Modellen ist noch eine Geräteprüfung erforderlich.
Für WEM2067 stellt Modell 202 eine echte Split-Phase-Installation dar. Es beschreibt nicht zwei unabhängige einphasige Stromkreise als dieselbe elektrische Anordnung.
Der Code für Modell 204 verfügt über eine Host-Testabdeckung, die Firmware erkennt WEM3080TD jedoch noch nicht automatisch und wählt Model 204 dafür noch nicht automatisch aus. Dieser Artikel erhebt daher keinen Anspruch auf die Verfügbarkeit des Modells 204. Auch der WEM3046TE hat noch keine spezielle Modellidentifikationsüberprüfung erhalten. Die erste Version bietet nur Ganzzahlmodelle: Die Float-Modelle 211 bis 214 sind nicht verfügbar.
Was ein Kunde lesen kann
Die Integer-Meter-Modelle zeigen Phasenspannung, Phasenstrom, Phasenwirkleistung, Gesamtwirkleistung, Frequenz, Phasenleistungsfaktor sowie pro Phase und Gesamt-Import/Export-Wirkenergiespeicher an. Das Common Model liefert Geräteidentifikationsdaten wie Modell, Firmware-Version und Seriennummer.
Energie wird in der SunSpec-Karte in Wh dargestellt; Der Leistungsfaktor wird als Prozentsatz dargestellt. Gesamtenergiepunkte verwenden die vorhandenen Gesamtfelder des Messgeräts und NEM-Semantik. IAMMETER berechnet keine dreiphasige Gesamtsumme neu, indem es die Phasenakkumulatoren in dieser Zuordnung hinzufügt. Da die NEM-Einstellung die Bedeutung dieser Akkumulatoren beeinflusst, darf ein Kunde nicht davon ausgehen, dass die Gesamtenergie immer der Summe der Phasenenergie entspricht.
Einige Felder fehlen in dieser ersten Version bewusst: Blindleistung und Blindenergie, Scheinleistung und Scheinenergie, Mehrphasen-Gesamtleistungsfaktor und Ereignisflags. Ihre Standardpositionen bleiben im Modell erhalten und geben die entsprechende Nichtverfügbarkeitsmarkierung zurück. Ein SunSpec-Client muss nicht verfügbare Werte erkennen, anstatt sie als Messungen zu interpretieren.
Die Spannungsinterpretation ist entscheidend
Die Phasenwerte stammen direkt vom Zähler. Einige Außenleiterspannungs-Punkte werden für die Modellzuordnung abgeleitet:
- Die Außenleiterspannung von Modell 202 ist
UA + UB. - Die Außenleiterspannung von Modell 203 ist eine Näherung der Phasenspannung multipliziert mit
√3; sie ist keine direkte Messung zwischen zwei Außenleitern. Ein unsymmetrisches System oder eine Abweichung des Phasenwinkels kann Fehler verursachen.
Diese Unterscheidung ist wichtig für Anwendungen, die eine direkt gemessene Außenleiterspannung benötigen. Prüfen Sie die Punktdefinition des Modells und die Anschlusskonfiguration, bevor Sie einen abgeleiteten Wert für Steuerungs- oder Konformitätsentscheidungen verwenden.
Mit Modbus/TCP verbinden
Aktivieren Sie den vorhandenen Modbus/TCP-Dienst des Messgeräts und stellen Sie dann eine Verbindung zu seiner LAN-Adresse her:
| Artikel | Einstellung |
|---|---|
| Gastgeber | Messgerät-LAN-IP-Adresse |
| TCP-Port | 502 |
| Lesefunktion | 03 — Read Holding Registers |
| SunSpec-Startadresse | 40000 |
| Schreibzugriff | Wird von der IAMMETER SunSpec-Karte nicht unterstützt |
Die Adressen in diesem Handbuch sind 0-basierte Modbus-Anforderungsadressen. Einige Anwendungen zeigen 1-basierte Registernummern an. Überprüfen Sie daher deren Konvention, bevor Sie einen Lesevorgang konfigurieren. Eine Off-by-One-Adresse gibt nicht die erwartete Markierung zurück.
Verwenden Sie den Funktionscode 03 für jeden der folgenden Messwerte. Die Registeranzahl umfasst gegebenenfalls die Modell-ID und die Länge.
| Lesen | Startadresse (0-basiert) | Registeranzahl | Erwartetes Ergebnis |
|---|---|---|---|
| SunSpec-Marker | 40000 |
2 | 0x5375, 0x6E53 (SunS) |
| Gemeinsames Modell | 40002 |
68 | Modell-ID 1, Länge 66, Geräteinformationen |
| Zählermodell | 40070 |
107 | Modell-ID 201, 202 oder 203, Länge 105, Zählerdaten |
| Endmarkierung | 40177 |
2 | Modell-ID 0xFFFF, Länge 0 |
Eine Modbus-Anfrage kann nicht mehr als 125 Register lesen. Lesen Sie daher die Common- und Zählermodelle separat. Kunden sollten die Modell-IDs und -Längen ermitteln, anstatt eine Annahme über jede zukünftige Modellsequenz fest zu codieren.
Ganzzahlige Werte und Skalierungsfaktoren
SunSpec-Integer-Punkte verwenden Skalierungsfaktoren. Rechnen Sie einen Rohwert wie folgt um:
tatsächlicher Wert = Register-Ganzzahl × 10^Skalierungsfaktor
Zum Beispiel:
W = 12345
W_SF = 1
tatsächliche Wirkleistung = 123450 W
Skalierungsfaktoren können sich mit dem Bereich ändern. Lesen Sie in jedem Abfragezyklus ein vollständiges Zählermodell, damit ein Wert und sein Skalierungsfaktor aus derselben Antwort stammen. Skalierungsfaktoren dürfen nicht dauerhaft zwischengespeichert werden.
Validierung und aktuelle Grenzwerte
Die Validierung hat zwei separate Bereiche:
- Implementierungsvalidierung: Host-Tests für Modelllayout, Konvertierung, Überlauf, schreibgeschütztes Verhalten und Regressionsprüfungen für vorhandene Register bestanden. Ein WEM3080T-Testmessgerät bestätigte die Erkennung und kontinuierliche Messung des Modells 203, wobei Spannung und Strom mit den vorhandenen HTTP- und Modbus-Schnittstellen verglichen wurden. Andere Messgerätemodelle und einzelne Drittanbieter-Clients erfordern noch weitere physische Tests.
- Überprüfung der Versionsdatei: Firmware
i.91.065.18wurde erstellt, hochgeladen und erneut zur Dateiüberprüfung heruntergeladen. Diese genaue Release-Datei wurde während dieses Validierungszyklus nicht geflasht; Die obigen Implementierungsergebnisse sollten nicht als Gerätetest der heruntergeladenen Release-Datei gelesen werden.
Die Firmware enthält nicht die ausstehende TCP-Framing-Verbesserung. Derzeit wird eine vollständige Anfrage in einem Empfangsvorgang erwartet. Geteilte oder kombinierte TCP-Anfragen können die Verbindung schließen. Senden Sie eine Anfrage und warten Sie vor der nächsten Anfrage auf deren Antwort. Beachten Sie jedoch, dass dadurch nicht jedes TCP-Segmentierungsrisiko beseitigt wird.
Wo das in eine IAMMETER-Installation passt
Beginnen Sie für die Architekturauswahl mit IAMMETER-Integrations- und Selbsthosting-Lösungen. Der Leitfaden zu lokalen APIs und offenen Schnittstellen vergleicht die verfügbaren Zählerschnittstellen.
Verwenden Sie die SunSpec-Karte, wenn ein lokaler Client erstellt wird, um SunSpec-Messgerätemodelle zu erkennen und auszulesen. Verwenden Sie die vorhandene IAMMETER Modbus/TCP-Registerzuordnung, wenn eine Anwendung IAMMETER-spezifische Register benötigt. Der vorhandene lokale Modbus-Pfad bleibt für die Home Assistant-Energiezähler-Integration nützlich, während HTTP, MQTT und IAMMETER Cloud unabhängige Optionen bleiben.
Laden Sie die Firmware herunter: i.91.065.18.bin.
Befolgen Sie vor dem Update die Anweisungen zum Upgrade der IAMMETER-Firmware und überprüfen Sie Ihr Messgerätmodell, Ihre Verbindungsmethode und Ihren lokalen Netzwerkzugriff. Dies ist eine schreibgeschützte Datenschnittstelle; Es bietet keine Wechselrichtersteuerung, keine Schreibvorgänge oder den Anspruch auf vollständige SunSpec-Interoperabilität von Drittanbietern.
Teile deine IAMMETER-SunSpec-Integration und verdiene 5.000–10.000 Reward Points
Verwende reale Geräte, um IAMMETER-Zählerdaten über SunSpec auszulesen. Ergebnisse aus einem Simulator sind nicht teilnahmeberechtigt.
Teilnehmende, die eine ausführliche Integrationsdokumentation bereitstellen und in einem öffentlichen Forum veröffentlichen, können nach Prüfung durch IAMMETER 5.000–10.000 Reward Points erhalten. Die Anzahl richtet sich nach Qualität und Vollständigkeit der Dokumentation.