IAMMETER dodaje obsługę SunSpec Modbus/TCP: mapowanie modeli i przewodnik integracji
Firmware IAMMETER i.91.065.18 dodaje mapę modeli liczników SunSpec w wersji całkowitej (tylko do odczytu) do istniejącej usługi Modbus/TCP. Dzięki temu oprogramowanie rozumiejące modele SunSpec zyskuje standardowy sposób wykrywania licznika IAMMETER i odczytu wybranych wartości elektrycznych w sieci lokalnej.
To rozszerzenie interfejsu, a nie zamiennik systemu pomiarowego. Licznik nadal zbiera dane w ten sam sposób. Istniejące rejestry Modbus IAMMETER, API HTTP, payloady MQTT i ustawienia NEM pozostają bez zmian.
SunSpec definiuje standardowe modele informacji o urządzeniu, które można mapować na rejestry typu holding w Modbus. Jej mapa zaczyna się znacznikiem SunS, po którym następują model Common oraz modele specyficzne dla urządzenia, które klient może wykryć, odczytując kolejno identyfikator i długość każdego modelu. Pakiet specyfikacji SunSpec Modbus opisuje wzorzec wykrywania modeli, w tym adresy mapy Modbus liczone od 0 oraz zasady wartości niezaimplementowanych. SunSpec Modbus jest stosowany w integracjach rozproszonej energetyki, między innymi w licznikach, falownikach i urządzeniach magazynowania energii.
IAMMETER implementuje skupiony podzbiór danych licznika tylko do odczytu. Ta implementacja nie posiada certyfikatu SunSpec. Nie traktuj tej funkcji jako certyfikacji, pełnej zgodności z SunSpec lub gwarancji, że każdy klient SunSpec innej firmy będzie działał bez konfiguracji.
Aktualne mapowania modelu oprogramowania sprzętowego
| Miernik IAMMETER | Model licznika całkowitego SunSpec | Interpretacja elektryczna |
|---|---|---|
| WEM3080 | 201 | Jednofazowy |
| WEM2067 | 202 | Split phase (Faza podziału) |
| WEM3050T | 203 | Trójfazowy gwiazda |
| WEM3080T | 203 | Trójfazowy gwiazda |
| WEM3046T | 203 | Trójfazowy gwiazda |
| WEM3063T | 203 | Trójfazowy gwiazda |
Te wiersze opisują bieżące mapowania modelu oprogramowania sprzętowego. Zgłoszona tutaj walidacja urządzenia fizycznego obejmuje tylko WEM3080T; pozostałe wymienione modele nadal wymagają testowania urządzenia.
W przypadku WEM2067 Model 202 reprezentuje prawdziwą instalację dwufazową. Nie opisuje dwóch niepowiązanych obwodów jednofazowych jako tego samego układu elektrycznego.
Kod dla Modelu 204 jest objęty testem hosta, ale oprogramowanie sprzętowe nie wykrywa go jeszcze automatycznie i nie wybiera go dla WEM3080TD. Dlatego też ten artykuł nie zastrzega dostępności Modelu 204. WEM3046TE również nie otrzymał jeszcze dedykowanej weryfikacji identyfikacji modelu. Pierwsza wersja dostarcza tylko modele całkowite: modele zmiennoprzecinkowe od 211 do 214 nie są dostępne.
Co klient może przeczytać
Modele liczników całkowitych ujawniają napięcie fazowe, prąd fazowy, fazową moc czynną, całkowitą moc czynną, częstotliwość, fazowy współczynnik mocy oraz akumulatory energii czynnej na fazę i całkowity import/eksport energii czynnej. Model wspólny dostarcza dane identyfikacyjne urządzenia, takie jak model, wersja oprogramowania sprzętowego i numer seryjny.
Energia jest reprezentowana w Wh na mapie SunSpec; współczynnik mocy jest przedstawiany jako procent. Punkty energii całkowitej ponownie wykorzystują istniejące pola całkowite licznika i semantykę NEM. IAMMETER nie przelicza sumy trójfazowej poprzez dodanie akumulatorów fazowych w tym mapowaniu. Ponieważ ustawienie NEM wpływa na znaczenie tych akumulatorów, klient nie może zakładać, że energia całkowita jest zawsze równa sumie energii fazowej.
W pierwszej wersji celowo pominięto niektóre pola: moc bierną i energię bierną, moc pozorną i energię pozorną, wielofazowy współczynnik mocy całkowitej i flagi zdarzeń. Ich standardowe lokalizacje pozostają w modelu i zwracają odpowiedni niedostępny znacznik. Klient SunSpec musi rozpoznawać niedostępne wartości, a nie interpretować je jako pomiary.
Interpretacja napięcia ma znaczenie
Wartości fazowe pochodzą z licznika. Część punktów napięcia międzyfazowego jest wyliczana na potrzeby mapowania modeli:
- Napięcie międzyfazowe w modelu 202 to
UA + UB. - Napięcie międzyfazowe w modelu 203 to przybliżenie napięcia fazowego pomnożonego przez
√3; nie jest to bezpośredni pomiar międzyfazowy. Układ niesymetryczny lub odchylenie kąta fazowego może powodować błąd.
To rozróżnienie jest istotne dla aplikacji wymagających bezpośrednio mierzonego napięcia międzyfazowego. Przed użyciem wartości wyliczonej do decyzji sterujących lub zgodnościowych sprawdź definicję punktu modelu oraz sposób podłączenia.
Połącz się z Modbus/TCP
Włącz istniejącą usługę Modbus/TCP licznika, a następnie połącz się z jego adresem LAN:
| Pozycja | Ustawienie |
|---|---|
| Gospodarz | Adres IP miernika w sieci LAN |
| Port TCP | 502 |
| Czytaj funkcję | 03 — Read Holding Registers |
| Adres początkowy SunSpec | 40000 |
| Dostęp do zapisu | Nieobsługiwane przez mapę IAMMETER SunSpec |
Adresy w tym przewodniku to adresy żądań Modbus oparte na 0. Niektóre aplikacje wyświetlają numery rejestrów oparte na jedynce, więc przed skonfigurowaniem odczytu sprawdź ich konwencję; adres inny niż jeden nie zwróci oczekiwanego znacznika.
Użyj kodu funkcji 03 dla każdego odczytu poniżej. Liczba rejestrów obejmuje identyfikator modelu i długość, jeśli ma to zastosowanie.
| Przeczytaj | Adres początkowy (od 0) | Liczba rejestrów | Oczekiwany wynik |
|---|---|---|---|
| Znacznik SunSpec | 40000 |
2 | 0x5375, 0x6E53 (SunS) |
| Wspólny model | 40002 |
68 | Identyfikator modelu 1, długość 66, informacje o urządzeniu |
| Model miernika | 40070 |
107 | Identyfikator modelu 201, 202 lub 203, długość 105, dane licznika |
| Znacznik końca | 40177 |
2 | Identyfikator modelu 0xFFFF, długość 0 |
Jedno żądanie Modbus może odczytać nie więcej niż 125 rejestrów, dlatego należy czytać modele wspólne i liczniki osobno. Klienci powinni odkryć identyfikatory i długości modeli, a nie narzucać na stałe założenia dotyczące każdej przyszłej sekwencji modeli.
Wartości całkowite i współczynniki skali
Całkowite punkty SunSpec wykorzystują współczynniki skali. Wartość surową przelicza się wzorem:
wartość rzeczywista = liczba całkowita z rejestru × 10^współczynnik skali
Na przykład:
W = 12345
W_SF = 1
rzeczywista moc czynna = 123450 W
Współczynniki skali mogą zmieniać się wraz z zakresem. Odczytuj cały model licznika w każdym cyklu odpytywania, aby wartość i jej współczynnik skali pochodziły z tej samej odpowiedzi. Nie buforuj współczynników skali bezterminowo.
Walidacja i aktualne limity
Walidacja ma dwa oddzielne zakresy:
- Weryfikacja wdrożenia: zaliczone testy hosta pod kątem układu modelu, konwersji, przepełnienia, zachowania tylko do odczytu i kontroli regresji dla istniejących rejestrów. Miernik testowy WEM3080T potwierdził odkrycie Modelu 203 i ciągłe odczyty, po sprawdzeniu napięcia i mocy z istniejącymi interfejsami HTTP i Modbus. Inne modele liczników i indywidualni klienci zewnętrzni nadal wymagają dalszych testów fizycznych.
- Weryfikacja pliku wydania: oprogramowanie sprzętowe
i.91.065.18zostało zbudowane, przesłane i pobrane ponownie w celu weryfikacji pliku. Dokładny plik wersji nie został przesłany podczas tego cyklu sprawdzania poprawności; powyższych wyników implementacji nie należy czytać jako testu urządzenia pobranego pliku wersji.
Oprogramowanie sprzętowe nie zawiera oczekujących ulepszeń ramek TCP. Obecnie oczekuje jednego kompletnego żądania w operacji odbierania. Podzielone lub połączone żądania TCP mogą zamknąć połączenie. Wyślij jedno żądanie i poczekaj na jego odpowiedź przed kolejnym żądaniem, mając świadomość, że nie eliminuje to każdego ryzyka związanego z segmentacją TCP.
Gdzie to pasuje do instalacji IAMMETER
Aby wybrać architekturę, zacznij od Integracja IAMMETER i rozwiązania do samodzielnego hostingu. Przewodnik po lokalnych interfejsach API i otwartym interfejsie porównuje dostępne interfejsy liczników.
Użyj mapy SunSpec, gdy tworzony jest klient lokalny w celu odkrywania i odczytywania modeli liczników SunSpec. Użyj istniejącej mapy rejestrów IAMMETER Modbus/TCP, gdy aplikacja potrzebuje rejestrów specyficznych dla IAMMETER. Istniejąca lokalna ścieżka Modbus pozostaje użyteczna dla integracji licznika energii Home Assistant, podczas gdy HTTP, MQTT i IAMMETER Cloud pozostają niezależnymi opcjami.
Pobierz oprogramowanie: i.91.065.18.bin.
Przed aktualizacją postępuj zgodnie z instrukcjami aktualizacji oprogramowania sprzętowego IAMMETER i sprawdź model licznika, metodę połączenia i dostęp do sieci lokalnej. Jest to interfejs danych tylko do odczytu; nie zapewnia sterowania falownikiem, operacji zapisu ani zapewnienia pełnej interoperacyjności SunSpec innych firm.
Podziel się integracją IAMMETER z SunSpec i zdobądź 5 000–10 000 Reward Points
Użyj rzeczywistych urządzeń, aby odczytać dane licznika IAMMETER przez SunSpec. Wyniki z symulatora nie kwalifikują się.
Uczestnicy, którzy przygotują szczegółową dokumentację integracji i opublikują ją na publicznym forum, mogą po weryfikacji przez IAMMETER otrzymać 5 000–10 000 Reward Points. Liczba punktów zależy od jakości i kompletności dokumentacji.