IAMMETER tilføjer SunSpec Modbus/TCP-understøttelse: Modelmapping og integrationsguide

IAMMETER-firmware i.91.065.18 tilføjer et skrivebeskyttet SunSpec-heltalsmodelmap for målere til den eksisterende Modbus/TCP-tjeneste. Det giver software, der forstår SunSpec-modeller, en standardiseret måde at finde en IAMMETER-måler og læse udvalgte elektriske værdier over det lokale netværk.

Dette er en udvidelse af grænsefladen, ikke et erstatningsmålesystem. Måleren fortsætter med at indsamle data på samme måde. Eksisterende IAMMETER Modbus-registre, HTTP-API, MQTT-payloads og NEM-indstillinger er uændrede.

SunSpec definerer standardiserede enhedsinformationsmodeller, som kan mappes til Modbus holding-registre. Dets map starter med en SunS-markør, efterfulgt af Common- og enhedsspecifikke modeller, som en klient kan finde ved at læse hvert model-ID og hver længde i rækkefølge. SunSpec Modbus-specifikationspakken dokumenterer mønsteret for modelopdagelse, herunder de 0-baserede placeringer i Modbus-mappet og reglerne for ikke-implementerede værdier. SunSpec Modbus bruges på tværs af integrationer til distribueret energi, herunder målere, invertere og lagerudstyr.

IAMMETER implementerer et fokuseret, skrivebeskyttet undersæt til målerdata. Denne implementering er ikke SunSpec-certificeret. Behandl ikke denne funktion som certificering, fuld SunSpec-overensstemmelse eller garanti for, at enhver tredjeparts SunSpec-klient fungerer uden konfiguration.

Aktuelle firmware-modelmappings

Disse rækker beskriver de aktuelle firmware-modelmappings. Den validering på fysiske enheder, der rapporteres her, dækker kun WEM3080T; de øvrige oplistede modeller kræver stadig test på enheder.

For WEM2067 repræsenterer Model 202 en ægte splitfase-installation. Den beskriver ikke to uafhængige enfasede kredsløb som det samme elektriske arrangement.

Koden til Model 204 har host-testdækning, men firmwaren registrerer og vælger den endnu ikke automatisk for WEM3080TD. Denne artikel hævder derfor ikke, at Model 204 er tilgængelig. WEM3046TE har heller ikke endnu fået en dedikeret verifikation af modelidentifikation. Den første udgivelse leverer kun heltalsmodeller: float-modellerne 211 til 214 er ikke tilgængelige.

Hvad en klient kan læse

Heltalsmodellerne for målere eksponerer fasespænding, fasestrøm, faseaktiv effekt, samlet aktiv effekt, frekvens, fase-effektfaktor samt aktivenergiakkumulatorer for import/eksport pr. fase og samlet. Common Model leverer enhedsidentifikationsdata som model, firmwareversion og serienummer.

Energi er repræsenteret i Wh i SunSpec-mappet; effektfaktor er repræsenteret som en procent. Totalenergipunkterne genbruger målerens eksisterende totalfelter og NEM-semantikken. IAMMETER genberegner ikke en trefaset total ved at lægge faseakkumulatorerne sammen i denne mapping. Da NEM-indstillingen påvirker betydningen af disse akkumulatorer, må en klient ikke antage, at totalenergi altid er lig summen af faseenergi.

Nogle felter er bevidst udeladt i denne første version: reaktiv effekt og reaktiv energi, tilsyneladende effekt og tilsyneladende energi, samlet effektfaktor for flere faser og event-flag. Deres standardplaceringer forbliver i modellen og returnerer den relevante markør for utilgængelig værdi. En SunSpec-klient skal genkende utilgængelige værdier i stedet for at fortolke dem som målinger.

Fortolkning af spænding er vigtig

Faseværdierne kommer fra måleren. Nogle linjespændingspunkter er udledt til modelmappingen:

• Linjespænding i Model 202 er UA + UB.
• Linjespænding i Model 203 er en tilnærmelse af fasespænding ganget med √3; det er ikke en direkte måling mellem to faser. Et ubalanceret system eller afvigelse i fasevinklen kan give fejl.

Denne forskel er vigtig for applikationer, der har brug for en direkte målt linjespænding. Kontroller definitionen af modelpunktet og tilslutningsarrangementet, før en udledt værdi bruges til styring eller beslutninger om overensstemmelse.

Tilslutning med Modbus/TCP

Aktivér målerens eksisterende Modbus/TCP-tjeneste, og opret derefter forbindelse til dens LAN-adresse:

Adresserne i denne guide er 0-baserede Modbus-forespørgselsadresser. Nogle applikationer viser 1-baserede registernumre, så verificér deres konvention, før du konfigurerer en læsning; en adresse med off-by-one returnerer ikke den forventede markør.

Brug Function Code 03 til hver læsning nedenfor. Registerantal omfatter model-ID og længde, hvor det er relevant.

En enkelt Modbus-forespørgsel kan ikke læse mere end 125 registre, så læs Common Model og måler-modellen separat. Klienter bør finde model-ID'er og længder i stedet for at hardkode en antagelse om enhver fremtidig modelsekvens.

Heltalsværdier og skalafaktorer

SunSpec-heltalspunkter bruger skalafaktorer. Konvertér et rå heltal med:

faktisk værdi = registerheltal × 10^skalafaktor

For eksempel:

W = 12345
W_SF = 1
faktisk aktiv effekt = 123450 W

Skalafaktorer kan ændre sig med området. Læs en komplet måler-model i hver poll-cyklus, så en værdi og dens skalafaktor kommer fra samme svar. Cache ikke skalafaktorer i det uendelige.

Validering og aktuelle begrænsninger

Valideringen har to separate områder:

• Implementeringsvalidering: host-tests bestod for modellayout, konvertering, overflow, skrivebeskyttet adfærd og regressionstjek af eksisterende registre. En WEM3080T-testmåler bekræftede opdagelse af Model 203 og kontinuerlige læsninger, hvor spænding og effekt blev kontrolleret mod de eksisterende HTTP- og Modbus-grænseflader. Andre målermodeller og individuelle tredjepartsklienter kræver stadig yderligere fysisk test.
• Verificering af release-filen: firmware i.91.065.18 blev bygget, uploadet og downloadet igen til filverificering. Netop denne release-fil blev ikke flash'et i denne valideringscyklus; implementeringsresultaterne ovenfor bør ikke læses som en test af den downloadede release-fil på en enhed.

Firmwaren indeholder ikke den verserende forbedring af TCP-framing. Den forventer i øjeblikket én komplet forespørgsel pr. modtagelsesoperation. Opdelte eller kombinerede TCP-forespørgsler kan lukke forbindelsen. Send én forespørgsel og vent på svaret, før den næste forespørgsel, samtidig med at du erkender, at dette ikke fjerner enhver risiko for TCP-segmentering.

Hvor passer dette ind i en IAMMETER-installation

Start med IAMMETER-integrations- og self-hosting-løsninger, når du skal vælge arkitektur. Guiden til lokale API'er og åbne grænseflader sammenligner de tilgængelige måler-grænseflader.

Brug SunSpec-mappet, når en lokal klient er bygget til at finde og læse SunSpec-målermodeller. Brug det eksisterende IAMMETER Modbus/TCP-registermap, når en applikation har brug for IAMMETER-specifikke registre. Den eksisterende lokale Modbus-vej er fortsat nyttig til integration af energimåler i Home Assistant, mens HTTP, MQTT og IAMMETER Cloud forbliver uafhængige muligheder.

Download firmwaren: i.91.065.18.bin.

Før du opdaterer, følg IAMMETER's instruktioner til firmwareopgradering, og gennemgå din målermodel, tilslutningsmetode og lokale netværksadgang. Dette er en skrivebeskyttet datagrænseflade; den giver ikke inverterstyring, skriveoperationer eller et krav om fuld interoperabilitet med SunSpec hos tredjeparter.

Del din IAMMETER SunSpec-integration, og få 5.000–10.000 Reward Points

Brug rigtigt udstyr til at aflæse data fra en IAMMETER-måler via SunSpec. Resultater fra en simulator er ikke gyldige.

Deltagere, der leverer detaljeret integrationsdokumentation og offentliggør den på et offentligt forum, kan efter IAMMETERs gennemgang få 5.000–10.000 Reward Points. Antallet afhænger af dokumentationens kvalitet og fuldstændighed.

Åbn aktivitetssiden, og klik på Apply for at deltage.