IAMMETER přidává podporu SunSpec Modbus/TCP: mapování modelů a průvodce integrací

Firmware IAMMETER i.91.065.18 přidává do stávající služby Modbus/TCP mapu celočíselných měřicích modelů SunSpec určenou pouze pro čtení. Software, který rozumí modelům SunSpec, tak získává standardní způsob, jak v lokální síti vyhledat měřidlo IAMMETER a přečíst vybrané elektrické hodnoty.

Jde o rozšíření rozhraní, nikoli o náhradu měřicího systému. Měřidlo sbírá data i nadále stejným způsobem. Stávající registry IAMMETER Modbus, HTTP API, datové zprávy MQTT ani nastavení NEM se nemění.

SunSpec definuje standardní informační modely zařízení, které lze namapovat do vyrovnávacích registrů (holding registers) Modbusu. Jeho mapa začíná značkou SunS, po níž následují obecný model (Common) a modely specifické pro zařízení, které klient objeví postupným čtením ID a délky každého modelu. Vzor vyhledávání modelů dokumentuje sada specifikací SunSpec Modbus, včetně umístění v mapě Modbus s indexem od nuly a pravidel pro neimplementované hodnoty. SunSpec Modbus se používá v integracích distribuované energetiky, mimo jiné u měřidel, střídačů a zařízení pro ukládání energie.

IAMMETER implementuje cílenou podmnožinu dat měřiče pouze pro čtení. Tato implementace nemá certifikaci SunSpec. Nepovažujte tuto funkci za certifikaci, plnou shodu se SunSpec nebo záruku, že každý klient SunSpec třetí strany bude fungovat bez konfigurace.

Aktuální mapování modelů ve firmwaru

Tyto řádky popisují aktuální mapování modelů ve firmwaru. Fyzické ověření na zařízení, o němž se zde referuje, se týká pouze modelu WEM3080T; ostatní uvedené modely ještě vyžadují testování na zařízení.

U modelu WEM2067 představuje model 202 skutečné dvoufázové zapojení (split phase). Nejde o to, že by dva nesouvisející jednofázové obvody byly vydávány za stejné elektrické uspořádání.

Kód pro model 204 má pokrytí hostitelskými testy, ale firmware jej u modelu WEM3080TD zatím automaticky nedetekuje ani nevybírá. Tento článek proto dostupnost modelu 204 netvrdí. Ani model WEM3046TE zatím neprošel ověřením identifikace modelu. První vydání poskytuje pouze celočíselné modely: plovoucí (float) modely 211 až 214 nejsou k dispozici.

Co může klient přečíst

Celočíselné měřicí modely zpřístupňují fázové napětí, fázový proud, fázový činný výkon, celkový činný výkon, frekvenci, fázový účiník a akumulátory činné energie pro odběr i dodávku, a to po jednotlivých fázích i v součtu. Obecný model (Common) poskytuje identifikační údaje zařízení, jako je model, verze firmwaru a sériové číslo.

Energie je v mapě SunSpec vyjádřena ve Wh, účiník je vyjádřen jako procento. Body celkové energie využívají stávající součtová pole měřidla a sémantiku NEM. IAMMETER v tomto mapování nepřepočítává trojfázový součet sčítáním fázových akumulátorů. Nastavení NEM ovlivňuje význam těchto akumulátorů, a klient proto nesmí předpokládat, že celková energie je vždy rovna součtu energie jednotlivých fází.

Některá pole v této první verzi záměrně chybí: jalový výkon a jalová energie, zdánlivý výkon a zdánlivá energie, celkový účiník pro více fází a příznaky událostí. Jejich standardní umístění v modelu zůstává a vrací příslušnou značku nedostupné hodnoty. Klient SunSpec musí nedostupné hodnoty rozpoznat a nesmí je vykládat jako naměřené údaje.

Na interpretaci napětí záleží

Fázové hodnoty pocházejí přímo z měřidla. Některé body sdruženého napětí jsou pro potřeby mapování modelu odvozeny:

• Sdružené napětí u modelu 202 je UA + UB.
• Sdružené napětí u modelu 203 je aproximací fázového napětí vynásobeného √3; nejde o přímé měření mezi vodiči. Nesymetrická soustava nebo odchylka fázového úhlu může způsobit chybu.

Tento rozdíl je důležitý pro aplikace, které potřebují přímo měřené sdružené napětí. Před použitím odvozené hodnoty pro řízení nebo rozhodování o souladu s předpisy si ověřte definici daného bodu modelu a způsob zapojení.

Připojení přes Modbus/TCP

Zapněte stávající službu Modbus/TCP v měřidle a poté se připojte na jeho adresu v lokální síti:

Adresy v tomto průvodci jsou adresy požadavků Modbus s indexem od nuly. Některé aplikace zobrazují čísla registrů s indexem od jedné, proto si před konfigurací čtení ověřte jejich konvenci; adresa posunutá o jedničku nevrátí očekávanou značku.

U každého níže uvedeného čtení použijte kód funkce 03. Počty registrů zahrnují ID modelu a délku, pokud se uplatňují.

Jeden požadavek Modbus může přečíst nejvýše 125 registrů, proto obecný model a model měřidla čtěte odděleně. Klienti by měli ID a délky modelů zjišťovat, nikoli natvrdo kódovat předpoklad o budoucím pořadí modelů.

Celočíselné hodnoty a faktory měřítka

Celočíselné body SunSpec používají faktory měřítka. Surové celé číslo převedete takto:

skutečná hodnota = celé číslo registru × 10^faktor měřítka

Například:

W = 12345
W_SF = 1
skutečný činný výkon = 123450 W

Faktory měřítka se mohou měnit v závislosti na rozsahu. V každém cyklu dotazování čtěte celý model měřidla, aby hodnota i její faktor měřítka pocházely ze stejné odpovědi. Neukládejte faktory měřítka do mezipaměti natrvalo.

Ověření a současná omezení

Ověření má dvě samostatné oblasti:

• Ověření implementace: hostitelské testy prošly pro rozložení modelu, převod, přetečení, chování pouze pro čtení a regresní kontroly stávajících registrů. Testovací měřidlo WEM3080T potvrdilo vyhledání modelu 203 a kontinuální čtení, přičemž napětí a výkon byly porovnány se stávajícím rozhraním HTTP a Modbus. Ostatní modely měřidel a jednotliví klienti třetích stran vyžadují další fyzické testování.
• Ověření souboru vydání: firmware i.91.065.18 byl sestaven, nahrán a znovu stažen pro ověření souboru. Přesně tento soubor vydání nebyl v tomto cyklu ověřování nahrán do zařízení; výše uvedené výsledky implementace nelze chápat jako test staženého souboru vydání na zařízení.

Firmware neobsahuje připravované vylepšení rámování TCP. V současnosti očekává jednu kompletní žádost v rámci jedné operace příjmu. Rozdělené nebo sloučené požadavky TCP mohou spojení ukončit. Posílejte vždy jeden požadavek a před dalším počkejte na odpověď, mějte však na paměti, že to neodstraňuje všechna rizika spojená s fragmentací TCP.

Kam to zapadá v instalaci IAMMETER

Při volbě architektury začněte u řešení pro integraci a vlastní hosting IAMMETER. Průvodce lokálními API a otevřeným rozhraním porovnává dostupná rozhraní měřidla.

Mapu SunSpec použijte v případě, že lokální klient je navržen tak, aby vyhledával a četl měřicí modely SunSpec. Stávající mapu registrů IAMMETER Modbus/TCP použijte, když aplikace potřebuje registry specifické pro IAMMETER. Stávající lokální cesta Modbus zůstává užitečná pro integraci energetického měřidla v Home Assistant, zatímco HTTP, MQTT a IAMMETER Cloud zůstávají nezávislými možnostmi.

Stáhněte firmware: i.91.065.18.bin.

Před aktualizací se řiďte pokyny pro aktualizaci firmwaru IAMMETER a zkontrolujte model měřidla, způsob připojení a přístup do lokální sítě. Jde o datové rozhraní pouze pro čtení; neposkytuje ovládání střídače, operace zápisu ani nezakládá nárok na plnou interoperabilitu SunSpec se zařízeními třetích stran.

Sdílejte integraci IAMMETER se SunSpec a získejte 5 000–10 000 Reward Points

K načtení dat z měřiče IAMMETER přes SunSpec použijte skutečné zařízení. Výsledky ze simulátoru nejsou způsobilé.

Účastníci, kteří dodají podrobnou dokumentaci integrace a zveřejní ji na veřejném fóru, mohou po kontrole společností IAMMETER získat 5 000–10 000 Reward Points. Počet bodů závisí na kvalitě a úplnosti dokumentace.

Otevřete stránku aktivity a kliknutím na Apply se zapojte.