IAMMETER voegt SunSpec Modbus/TCP-ondersteuning toe: modeltoewijzing en integratiegids

IAMMETER firmware i.91.065.18 voegt een alleen-lezen SunSpec integer metermodel-map toe aan de bestaande Modbus/TCP-service. Hierdoor krijgen softwarepakketten die SunSpec-modellen begrijpen een standaardmanier om een IAMMETER-meter te detecteren en geselecteerde elektrische waarden via het lokale netwerk uit te lezen.

Dit is een interface-uitbreiding, geen vervanging van het meetsysteem. De meter blijft op dezelfde manier gegevens verzamelen. Bestaande IAMMETER Modbus-registers, HTTP API, MQTT-payloads en NEM-instellingen blijven ongewijzigd.

SunSpec definieert standaard apparaatinformatiemodellen die aan Modbus holding registers kunnen worden toegewezen. De map begint met een SunS-marker, gevolgd door Common- en apparaatspecifieke modellen die een client kan detecteren door achtereenvolgens elke model-ID en lengte te lezen. Het SunSpec Modbus specification package documenteert het patroon voor modeldetectie, inclusief de 0-gebaseerde Modbus-maplocaties en de regels voor niet-geïmplementeerde waarden. SunSpec Modbus wordt gebruikt in gedistribueerde energie-integraties, waaronder meters, omvormers en opslagapparatuur.

IAMMETER implementeert een gerichte, alleen-lezen subset voor metergegevens. Deze implementatie is niet SunSpec-gecertificeerd. Beschouw deze functie niet als certificering, volledige conformiteit met SunSpec of een garantie dat elke SunSpec-client van derden zonder configuratie zal werken.

Huidige firmwaremodeltoewijzingen

Deze rijen beschrijven de huidige firmwaremodeltoewijzingen. De hier gerapporteerde validatie van fysieke apparaten heeft alleen betrekking op de WEM3080T; voor de andere vermelde modellen zijn nog steeds apparaattests vereist.

Voor WEM2067 vertegenwoordigt model 202 een echte split-phase installatie. Het beschrijft niet twee niet-gerelateerde eenfasige circuits als dezelfde elektrische opstelling.

De code voor Model 204 heeft dekking voor hosttests, maar de firmware detecteert en selecteert deze nog niet automatisch voor WEM3080TD. Dit artikel claimt daarom niet de beschikbaarheid van Model 204. WEM3046TE heeft ook nog geen speciale modelidentificatieverificatie ontvangen. De eerste release levert alleen integer-modellen: float-modellen 211 tot en met 214 zijn niet beschikbaar.

Wat een klant kan lezen

De modellen met gehele getallen tonen fasespanning, fasestroom, actief fasevermogen, totaal actief vermogen, frequentie, fasevermogensfactor en actieve-energieaccumulatoren per fase en totaal import/export. Het Common Model levert apparaatidentificatiegegevens zoals model, firmwareversie en serienummer.

Energie wordt weergegeven in Wh op de SunSpec-kaart; De arbeidsfactor wordt weergegeven als percentage. Totaal-energiepunten hergebruiken de bestaande totaalvelden van de meter en NEM-semantiek. IAMMETER herberekent een driefasig totaal niet door de faseaccumulatoren in deze mapping op te tellen. Omdat de NEM-instelling de betekenis van die accu's beïnvloedt, mag een klant er niet van uitgaan dat de totale energie altijd gelijk is aan de som van de fase-energie.

Sommige velden zijn opzettelijk afwezig in deze eerste versie: reactief vermogen en reactieve energie, schijnbaar vermogen en schijnbare energie, meerfasige totale arbeidsfactor en gebeurtenisvlaggen. Hun standaardlocaties blijven in het model en retourneren de juiste niet-beschikbare markering. Een SunSpec-client moet niet-beschikbare waarden herkennen in plaats van deze als metingen te interpreteren.

De interpretatie van spanning is belangrijk

De fasewaarden komen van de meter. Sommige lijnspanningspunten zijn afgeleid voor de modeltoewijzing:

• De lijnspanning van Model 202 is UA + UB.
• De lijnspanning van Model 203 is een benadering van de fasespanning vermenigvuldigd met √3; het is geen directe lijn-tot-lijnmeting. Een ongebalanceerd systeem of een afwijking in de fasehoek kan fouten veroorzaken.

Dit onderscheid is belangrijk voor toepassingen die een direct gemeten lijn-tot-lijnspanning nodig hebben. Controleer de puntdefinitie van het model en de aansluitconfiguratie voordat u een afgeleide waarde gebruikt voor regel- of compliancebeslissingen.

Verbinden met Modbus/TCP

Schakel de bestaande Modbus/TCP-service van de meter in en maak vervolgens verbinding met het LAN-adres:

De adressen in deze handleiding zijn 0-gebaseerde Modbus-verzoekadressen. Sommige toepassingen geven op 1 gebaseerde registernummers weer, dus controleer hun conventie voordat u een leesbewerking configureert; een off-by-one-adres retourneert niet de verwachte markering.

Gebruik functiecode 03 voor elke onderstaande lezing. Registertellingen omvatten, indien van toepassing, de model-ID en lengte.

Eén Modbus-verzoek kan niet meer dan 125 registers lezen, dus lees de Common- en metermodellen afzonderlijk. Klanten moeten de model-ID's en lengtes ontdekken in plaats van een aanname over elke toekomstige modelreeks hard te coderen.

Integer-waarden en schaalfactoren

SunSpec integer-punten gebruiken schaalfactoren. Converteer een ruwe integer met:

werkelijke waarde = register-integer × 10^schaalfactor

Bijvoorbeeld:

W = 12345
W_SF = 1
werkelijk actief vermogen = 123450 W

Schaalfactoren kunnen met het bereik veranderen. Lees elke pollcyclus een volledig metermodel, zodat een waarde en de bijbehorende schaalfactor uit dezelfde respons komen. Cache schaalfactoren niet onbeperkt.

Validatie en huidige limieten

Validatie heeft twee afzonderlijke bereiken:

• Implementatievalidatie: hosttests geslaagd voor modellay-out, conversie, overflow, alleen-lezen-gedrag en regressiecontroles voor bestaande registers. Een WEM3080T-testmeter bevestigde de ontdekking en continue metingen van Model 203, waarbij spanning en vermogen werden gecontroleerd aan de hand van de bestaande HTTP- en Modbus-interfaces. Andere metermodellen en individuele externe klanten moeten nog verder fysiek worden getest.
• Verificatie van releasebestand: firmware i.91.065.18 is gebouwd, geüpload en opnieuw gedownload voor bestandsverificatie. Dit exacte releasebestand is niet geflasht tijdens deze validatiecyclus; de bovenstaande implementatieresultaten mogen niet worden gelezen als een apparaattest van het gedownloade releasebestand.

De firmware bevat niet de aanstaande verbetering van de TCP-framing. Momenteel wordt bij een ontvangstbewerking één volledig verzoek verwacht. Gesplitste of gecombineerde TCP-verzoeken kunnen de verbinding verbreken. Verzend één verzoek en wacht op het antwoord vóór het volgende verzoek, terwijl u beseft dat dit niet elk TCP-segmentatierisico elimineert.

Waar dit past in een IAMMETER-installatie

Begin voor architectuurselectie met IAMMETER-integratie en zelfhostingoplossingen. De lokale API's en open-interfacegids vergelijkt de beschikbare meterinterfaces.

Gebruik de SunSpec-kaart wanneer een lokale client wordt gebouwd om SunSpec-metermodellen te ontdekken en uit te lezen. Gebruik de bestaande IAMMETER Modbus/TCP-registertoewijzing wanneer een toepassing IAMMETER-specifieke registers nodig heeft. Het bestaande lokale Modbus-pad blijft bruikbaar voor Home Assistant energiemeterintegratie, terwijl HTTP, MQTT en IAMMETER Cloud onafhankelijke opties blijven.

Download de firmware: i.91.065.18.bin.

Voordat u gaat updaten, volgt u de IAMMETER firmware-upgrade-instructies en controleert u uw metermodel, verbindingsmethode en lokale netwerktoegang. Dit is een alleen-lezen data-interface; het biedt geen inverterbesturing, schrijfbewerkingen of een claim van volledige SunSpec-interoperabiliteit van derden.

Deel je IAMMETER SunSpec-integratie en verdien 5.000–10.000 Reward Points

Gebruik echte apparatuur om IAMMETER-metergegevens via SunSpec uit te lezen. Resultaten van een simulator komen niet in aanmerking.

Deelnemers die gedetailleerde integratiedocumentatie aanleveren en deze op een openbaar forum publiceren, kunnen na beoordeling door IAMMETER 5.000–10.000 Reward Points ontvangen. Het aantal punten hangt af van de kwaliteit en volledigheid van de documentatie.

Open de activiteitenpagina en klik op Apply om deel te nemen.