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 firmware is niet ingediend voor SunSpec-certificering. Beschouw deze functie niet als certificering, volledige SunSpec-conformiteit of een garantie dat elke SunSpec-client van derden zonder configuratie werkt.

Ondersteunde IAMMETER-modellen en meter-toewijzingen

Voor WEM2067 vertegenwoordigt Model 202 een echte split-phase-installatie. Het beschrijft niet twee losse enkelfasige circuits als dezelfde elektrische configuratie.

De code voor Model 204 heeft dekking in host-tests, maar de firmware detecteert en selecteert dit model nog niet automatisch voor de WEM3080TD. Daarom claimt dit artikel geen beschikbaarheid van Model 204. De WEM3046TE heeft ook nog geen specifieke verificatie van modelidentificatie ondergaan. De eerste release levert alleen integer-modellen: float-modellen 211 tot en met 214 zijn niet beschikbaar.

Wat een client kan uitlezen

De integer metermodellen bieden fasespanning, fasestroom, fase-actiefvermogen, totaal actief vermogen, frequentie, fase-vermogensfactor en accumulatoren voor import/export van actieve energie per fase en in totaal. Het Common Model levert apparaatidentificatiegegevens zoals model, firmwareversie en serienummer.

Energie wordt in de SunSpec-map weergegeven in Wh; de vermogensfactor wordt weergegeven als een percentage. De punten voor totale energie hergebruiken de bestaande totaalvelden en de NEM-semantiek van de meter. IAMMETER herberekent in deze toewijzing niet een driefasig totaal door de fase-accumulatoren op te tellen. Omdat de NEM-instelling de betekenis van die accumulatoren beïnvloedt, mag een client niet aannemen dat de totale energie altijd gelijk is aan de som van de fase-energie.

Sommige velden ontbreken bewust in deze eerste versie: reactief vermogen en reactieve energie, schijnbaar vermogen en schijnbare energie, driefasige totale vermogensfactor en gebeurtenisvlaggen. Hun standaardlocaties blijven in het model aanwezig en retourneren de juiste marker voor niet-beschikbaar. Een SunSpec-client moet niet-beschikbare waarden herkennen in plaats van ze 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 via Modbus/TCP

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

De adressen in deze gids zijn 0-gebaseerde Modbus-verzoekadressen. Sommige applicaties tonen 1-gebaseerde registernummers, dus verifieer hun conventie voordat u een read configureert; een adres dat één positie afwijkt levert niet de verwachte marker op.

Gebruik de volgende detectiereeks:

1. Lees twee registers op adres 40000. De verwachte woorden zijn 0x5375 en 0x6E53, de ASCII-marker SunS.
2. Lees het Common Model 1 vanaf 40002.
3. Lees het metermodel vanaf 40070. Het lezen van 107 registers levert de model-ID, de lengte en het volledige gegevensgebied op.
4. Lees de eindmarker op 40177.

Eén Modbus-verzoek kan niet meer dan 125 registers lezen, dus lees het Common-model en het metermodel apart. Clients moeten de model-ID's en lengtes detecteren 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 beperkingen

Host-tests dekken de modellay-out, conversie, overflow, alleen-lezen gedrag en regressiecontroles voor bestaande registers. Een WEM3080T-testmeter heeft de detectie en continue uitlezing van Model 203 bevestigd, waarbij spanning en vermogen zijn gecontroleerd tegen de bestaande HTTP- en Modbus-interfaces.

Andere metermodellen en individuele clients van derden behoeven nog fysieke tests. Firmware i.91.065.18 is gebouwd, geüpload en opnieuw gedownload voor bestandsverificatie; dit releasebestand zelf is tijdens deze validatiecyclus niet geflasht.

De firmware bevat niet de nog openstaande verbetering van TCP-framing. Op dit moment wordt één volledig verzoek per ontvangstoperatie verwacht. Gesplitste of gecombineerde TCP-verzoeken kunnen de verbinding verbreken. Stuur één verzoek en wacht op het antwoord voordat u het volgende verzoek stuurt, met de wetenschap dat dit niet elk risico op TCP-segmentatie wegneemt.

Waar dit past in een IAMMETER-installatie

Gebruik de SunSpec-map wanneer een lokale client is gebouwd om SunSpec-metermodellen te detecteren en uit te lezen. Gebruik de bestaande IAMMETER Modbus/TCP-registermap wanneer een toepassing IAMMETER-specifieke registers nodig heeft. Het bestaande lokale Modbus-pad blijft nuttig voor Home Assistant energy-meter integration, terwijl HTTP, MQTT en IAMMETER Cloud onafhankelijke opties blijven.

Download de firmware: i.91.065.18.bin.

Controleer vóór het bijwerken uw metermodel, verbindingsmethode en lokale netwerktoegang. Dit is een alleen-lezen data-interface; deze biedt geen omvormerbesturing, geen schrijfbewerkingen en geen claim van volledige SunSpec-interoperabiliteit met derden.