Wi-Fi števci energije IAMMETER lahko pošiljajo merilne podatke neposredno na strežnik, MQTT posrednika ali podatkovno platformo v lasti kupca. To razvijalcem in sistemskim integratorjem omogoča, da zgradijo lasten EMS, BMS, storitev IoT, podatkovno zbirko ali nadzorno ploščo brez uporabe IAMMETER-Cloud kot cilja za podatke.
Ta vodnik obravnava integracijo s strani sprejemnega strežnika:
IAMMETER meter
│
│ HTTP/HTTPS, MQTT/MQTTS or TCP/TLS
▼
Customer ingestion service
│
├── Raw-payload log
├── Time-series or relational database
├── EMS / BMS / ERP
└── Dashboard, report and alarm services
Za zmogljivosti vdelane programske opreme na strani števca in formate naslovov si oglejte Vodnik po lokalnem API-ju in odprtih vmesnikih IAMMETER. Za izbiro arhitekture glejte Razvijte lasten sistem za spremljanje energije.
Števec lahko svoje meritve pošilja prek več prenosnih protokolov. Sprejemni sistem naj izbere eno glavno pot za vnos podatkov.
| Prenos | Komponenta sprejemnika | Dober izhodiščni primer za |
|---|---|---|
| HTTP / HTTPS | Spletna končna točka | Zaledja REST in najpreprostejša prva integracija |
| MQTT / MQTTS | MQTT posrednik in naročnik | Obstoječe platforme IoT in podatkovni cevovodi |
| TCP / TLS | Poslušalec vtičnic (socket listener) | Namenski zbiralniki in storitve po meri za protokole |
HTTP je običajno najlažji način za ogled prvega podatkovnega paketa, ker je uradni testni sprejemnik mogoče zagnati s kratkim primerom v Node.js. MQTT je odlična izbira, kadar je posrednik že del sistema. TCP/TLS zagotavlja integracijo na nižji ravni prek vtičnic, vendar zahteva več inženirskega dela na strani sprejemnika.
Varni prenosi in formati vrat po meri so opisani v trenutnem vodniku po vdelani programski opremi in tukaj niso ponovljeni.
IAMMETER ponuja uradni primer HTTP sprejemnika v Node.js za testiranje integracije.
Primer prenesite s:
Zaženite:
node Server.js
Primer posluša na vratih 8000. Ko prispe zahtevek:
200 z majhnim uspešnim JSON odzivom.Primer je namerno minimalen. Ne zagotavlja preverjanja pristnosti, trajnega shranjevanja, validacije, omejevanja hitrosti ali varnosti za produkcijsko uporabo.
Pred konfiguracijo števca preverite, da:
Za test v lokalnem omrežju lahko števec in sprejemnik uporabljata isto lokalno omrežje brez dostopa do interneta. Za oddaljeni sprejemnik mora lokacija imeti pot do strežnika.
V trenutnem spletnem vmesniku števca izberite način delovanja HTTP in vnesite cilj, na primer:
{server-address}:8000/upload
Končne točke HTTPS lahko uporabljajo privzeta ali po meri izbrana vrata. Trenutna pravila za naslove, vključno z https://host:port, so dokumentirana v razdelku o vdelani programski opremi za HTTP/HTTPS.
Po shranjevanju nastavitve preverite konzolo sprejemnika za pot zahtevka in naloženi JSON. Ta prvi surovi podatkovni paket shranite kot testno napravo (test fixture) za poznejše teste razčlenjevalnika in podatkovne zbirke.
IAMMETER uporablja dosledno osrednjo JSON strukturo meritev pri vseh podprtih prenosnih protokolih. Prenosni protokol spremeni način prihoda podatkovnega paketa, merilni model pa ostaja dosleden.
Podatkovni paket običajno vključuje polja na ravni naprave, kot so:
SN — serijska številka števca za identifikacijo naprave;version — različica vdelane programske opreme števca;method — metoda sporočila ali vrsta podatkovnega paketa;Data ali Datas — merilne matrike.Data se uporablja za en sam merilni kanal. Datas vsebuje več merilnih matrik za večkanalni ali trifazni števec.
Primer strukture enega kanala:
{
"method": "uploadsn",
"mac": "B0F8932A295C",
"version": "i.75.98.71y",
"server": "em",
"SN": "12345678",
"Data": [228.91, 1.61, 225, 15066.47, 0]
}
Ne vgradite v kodo enega fiksnega števila elementov matrike za vse števce. Število kanalov in razpoložljivih polj je odvisno od modela števca in omogočenih merilnih funkcij.
Pri implementaciji razčlenjevalnika uporabite avtoritativno definicijo:
Obdelavo, značilno za model, hranite ločeno od prenosnega sprejemnika.
Na primer, WEM3046T in WEM3046TE merita sekundarni izhod 5 A zunanjega tokovnega transformatorja. Njuni vrednosti je treba pretvoriti z ustreznim razmerjem CT, da dobimo meritev na primarni strani. To je značilnost števca in tokovnega transformatorja, ne razlika med HTTP, MQTT ali TCP.
Praktičen cevovod za vnos podatkov zato ločuje:
Shranite dovolj informacij za reprodukcijo in diagnostiko prvotnega odčitka.
Uporaben minimalni model vključuje:
| Polje | Namen |
|---|---|
| Serijska številka števca (SN) | Poveže podatkovni paket z registrirano napravo |
| Indeks kanala ali faze | Razlikuje enofazne, split-phase in trifazne podatke |
| Čas prejema na strežniku | Zagotavlja dosleden časovni žig vnosa |
| Napetost | Električna meritev |
| Tok | Električna meritev |
| Delovna moč | Vhod za izračun uvozne/izvozne moči ali obremenitve v realnem času |
| Uvožena kWh | Skupna uvožena energija |
| Izvožena kWh | Skupna izvožena energija |
| Različica vdelane programske opreme | Podpira odpravljanje težav in združljivost razčlenjevalnika |
| Surovi podatkovni paket | Omogoča ponovno predvajanje, revizijo in popravke razčlenjevalnika |
Dodatna polja, kot so frekvenca, faktor moči in jalove meritve, shranite, kadar jih zagotavljata izbrani model in konfiguracija.
Za produkcijske sisteme razmislite o ločenem shranjevanju:
Tako je mogoče lažje popraviti logiko razčlenjevanja ali razmerij CT, ne da bi pri tem izgubili prvotni podatkovni paket.
Zabeležite čas, ko je strežnik sprejel podatkovni paket. Če poslovni sistem uporablja tudi časovni žig naprave ali vira, shranite obe vrednosti ločeno, namesto da eno zamenjate z drugo.
Zakasnitve v omrežju, ponovne povezave in obdelava v čakalni vrsti lahko povzročijo, da se čas vnosa razlikuje od časa merjenja. Pred produkcijsko uporabo določite časovni žig, ki ga uporabljajo grafikoni, obračunavanje in alarmi.
Za vnos prek MQTT mora sistem kupca zagotoviti:
IAMMETER objavlja podatke v realnem času pod temo naprave, na primer:
device/{SN}/realtime
Uporabite namenski vodnik za konfiguracijo posrednika, poverilnice, teme in posebnosti MQTTS:
MQTT Discovery za Home Assistant ni potreben za splošno integracijo s strežnikom kupca.
IAMMETER ponuja minimalen TCP poslušalec v Node.js:
Primer posluša na vratih 8000 in izpisuje prejete podatke. Produkcijski TCP sprejemnik mora dodatno zagotavljati:
Ne predpostavljajte, da je en dogodek data vtičnice vedno eno celotno aplikacijsko sporočilo.
Uradni TLS primer prikazuje poslušalec TLS s strežniškim ključem in potrdilom:
Pred produkcijsko uporabo zamenjajte demonstracijska potrdila in nastavitve z odobrenimi potrdili organizacije ter konfiguracijo upravljanja ključev in varnosti. Sprejemnik naj beleži napake TLS ločeno od napak pri validaciji podatkovnih paketov.
Formati naslovov na strani števca za TCP in TLS so opisani v vodniku po vmesnikih vdelane programske opreme.
Trenutna vdelana programska oprema podpira interval pošiljanja tretjim osebam do 2 sekund. Kratek interval je uporaben le, kadar sprejemni sistem, shranjevanje in aplikacija potrebujejo dodatno ločljivost.
Približno število zapisov, ki jih ustvari en števec:
| Interval pošiljanja | Zapisov na števec na dan | 100 števcev na dan | 1.000 števcev na dan |
|---|---|---|---|
| 60 sekund | 1.440 | 144.000 | 1.440.000 |
| 10 sekund | 8.640 | 864.000 | 8.640.000 |
| 2 sekundi | 43.200 | 4.320.000 | 43.200.000 |
Te številke predstavljajo dogodke pošiljanja, ne nujno vrstic v podatkovni zbirki. Trifazni podatkovni paket je mogoče normalizirati v več zapisov kanalov, dejanski obseg podatkovne zbirke pa povečajo indeksi, hramba surovih podatkovnih paketov ali podvojeno shranjevanje.
Načrtovanje zmogljivosti mora vključevati:
Za enosekundni nadzor ali avtomatizacijo v istem lokalnem omrežju razmislite o Modbus TCP namesto o oddaljenem cevovodu za pošiljanje.
Produkcijski sprejemnik mora pričakovati napake v omrežju in aplikacijah.
Preverite vsaj:
Neveljavne podatkovne pakete hranite na nadzorovani diagnostični poti, ne da bi z njimi blokirali delujoče naprave.
Ne predpostavljajte, da vsak interval ustvari natanko en trajno shranjen zapis. Prekinitve omrežja, vedenje ob ponovni povezavi, ponovni poskusi strežnika ali obdelava v aplikaciji lahko povzročijo manjkajoče ali ponovljene dogodke vnosa.
Določite, kako bo poslovni sistem:
Spremljajte več kot samo spletni proces ali proces vtičnic. Uporabni signali vključujejo:
Za sprejemnik, izpostavljen internetu:
Pred izbiro varnostne zasnove preglejte trenutno vedenje vdelane programske opreme za MQTTS, TLS in HTTPS v vodniku po vdelani programski opremi in odprtih vmesnikih.
Prvotna različica tega dokumenta se je osredotočala na konfiguracijo starejše vdelane programske opreme števcev. Ti posnetki zaslona so ohranjeni le za uporabnike, ki prepoznavajo obstoječo namestitev. Za nove integracije uporabite trenutni spletni vmesnik in najnovejšo vdelano programsko opremo.
Starejša dokumentacija o vdelani programski opremi je uporabljala tudi lokalno metodo konfiguracije /api/uploadinterval in opisovala najmanjši interval šestih sekund. Trenutna vdelana programska oprema prikazuje interval v spletnem vmesniku in podpira dokumentiran najmanjši interval 2 sekundi.
Nazadnje posodobljeno: 16. julij 2026
Trifazni Wi-Fi merilnik energije (WEM3080T)
Enofazni Wi-Fi merilnik energije (WEM3080)
Trifazni Wi-Fi merilnik energije (WEM3046T)
Trifazni Wi-Fi merilnik energije (WEM3050T)