Kehitä oma energianseurantajärjestelmänne IAMMETERin avulla

Kehitä oma energianseurantajärjestelmänne IAMMETERin avulla

IAMMETERin Wi-Fi-energiamittarit tarjoavat avoimet datarajapinnat kehittäjille, järjestelmäintegraattoreille ja asiakkaille, jotka rakentavat omaa energianseurantaohjelmistoaan.

Voitte hakea mittaukset suoraan mittarista, antaa mittarin lähettää tiedot omalle palvelimellenne, ottaa käyttöön IAMMETERin itse ylläpidettävän palvelun tai rakentaa sovelluksen IAMMETER-Cloud-rajapintojen päälle.

Tämä sivu on kehittäjille suunnattu navigointiopas arkkitehtuurin valintaan. Se linkittää nykyisiin protokollamäärittelyihin ja toteutusdokumentteihin sen sijaan, että toistaisi jokaisen API-parametrin.

Jos ensimmäinen kysymyksenne on, voiko IAMMETER-mittari toimia ilman Internet-yhteyttä tai IAMMETER-Cloudia, aloita kohdasta Wi-Fi-energiamittarin käyttö ilman Internetiä tai pilveä. Alustojen vertailua varten katso Itse ylläpidetty ja avoimen lähdekoodin integraatio.

1. Valitse järjestelmäarkkitehtuurinne

IAMMETER-tietoja voi käyttää omassa sovelluksessa neljällä päätavalla.

Arkkitehtuuri	Datan kulku	Sopii parhaiten	Vaatiiko IAMMETER-Cloudin?
Lue mittaria paikallisesti	Sovellus → mittari	LAN-kojelaudat, automaatio, PLC ja SCADA	Ei
Anna mittarin lähettää tiedot	Mittari → asiakkaan palvelin tai broker	Mukautettu pilvi, EMS, BMS ja IoT-taustajärjestelmät	Ei
Ota käyttöön IAMMETERin itse ylläpidettävä ohjelmisto	Mittari → IAMMETER-Docker tai IAMMETER-Central → sovellus	Käyttäjät, jotka haluavat tallennuksen ja rajapinnat rakentamatta koko taustajärjestelmää	Ei
Rakenna IAMMETER-Cloud-rajapintojen varaan	Mittari → IAMMETER-Cloud → sovellus	Sovellukset, jotka haluavat käyttää uudelleen IAMMETER-Cloudin tietoja ja palveluita	Kyllä

Oikea valinta riippuu siitä, mihin tiedot tulisi tallentaa, tarvitseeko projekti Internetistä riippumatonta toimintaa, vaaditusta päivitysnopeudesta ja siitä, kuinka paljon taustajärjestelmän kehitystä haluatte ylläpitää.

2. Lue tiedot suoraan mittarista

Valitse tämä arkkitehtuuri, kun sovellus ja mittari ovat samassa lähiverkossa.

IAMMETER meter ← Local HTTP API or Modbus TCP ← Your application

Sovelluksenne hallitsee kyselyväliä ja tallentaa tarvitsemansa historian. Paikallista datapolkua varten ei tarvita IAMMETER-pilvipalvelua.

2.1 Paikallinen HTTP-rajapinta

Mittari tarjoaa paikallisia HTTP-päätepisteitä mittausten hakemiseen, kuten jännite, virta, pätöteho, tuotu energia ja viety energia.

Yleisiä mittauspäätepisteitä ovat:

• /api/monitorjson
• /api/monitor

Paikallinen HTTP-rajapinta on käytännöllinen lähtökohta:

• mukautetuille kojelaudoille;
• PC:llä, NAS:lla tai Raspberry Pi:llä suoritettaville skripteille;
• matalan koodauksen integraatioille;
• paikallisille sovelluksille, jotka eivät vaadi sekunnin tarkkuudella tapahtuvaa kyselyä.

Katso nykyiset päätepistemäärittelyt ja esimerkit kohdasta IAMMETERin paikallisen API:n ja avoimen rajapinnan opas.

2.2 Modbus TCP

Käytä Modbus TCP:tä, kun projekti vaatii:

• sekunnin tarkkuudella tapahtuvaa paikallista kyselyä;
• PLC- tai SCADA-integraatiota;
• reaaliaikaista tehonsäätöä;
• integraatiota teolliseen EMS- tai BMS-järjestelmään;
• standardipohjaista rekisteriprotokollaa.

Katso IAMMETERin Modbus TCP -rekisteri- ja integraatio-opas.

2.3 Mitä sovelluksenne on tarjottava

Suora paikallinen luku palauttaa mittarin mittaukset. Sovelluksenne vastaa edelleen kaikista lisätoiminnoista, joita se tarvitsee, mukaan lukien:

• tiedontallennus;
• tunti-, päivä- ja kuukausikohtainen aggregointi;
• kojelaudat ja raportit;
• käyttäjät ja käyttöoikeudet;
• hälytykset ja automaatiologiikka;
• varmuuskopiot ja säilytys.

Jos ette halua rakentaa näitä taustatoimintoja alusta alkaen, harkitse IAMMETER-Dockeria tai IAMMETER-Centralia.

3. Lähetä mittarin tiedot suoraan palvelimellenne

Valitse tämä arkkitehtuuri, kun mittarin tulee aloittaa yhteys ja lähettää tiedot teidän hallinnoimaanne päätepisteeseen.

IAMMETER meter → MQTT/MQTTS, HTTP/HTTPS or TCP/TLS → Your server

Nykyinen IAMMETER-laiteohjelmisto tukee useita lähetysrajapintoja:

Rajapinta	Asiakkaan puolen komponentti	Tyypillinen käyttötarkoitus
MQTT / MQTTS	MQTT-broker ja tilaaja	IoT-alustat, automaatio ja viestiputket
HTTP / HTTPS	HTTP-päätepiste	REST-taustajärjestelmä, pilvipalvelu tai mukautettu EMS
TCP / TLS	TCP-palvelin	Mukautettu keräin ja protokollatason integraatio

Mittari ja palvelimenne käyttävät yhtenäistä IAMMETER-mittaus-JSON-rakennetta kaikissa tuetuissa lähetystavoissa. Tutustu datamäärittelyyn ennen kuin toteutatte jäsentimen.

Toteutusresursseja:

• IAMMETER-tietojen julkaiseminen omalle MQTT-brokerillesi
• IAMMETER-tietojen lähettäminen kolmannen osapuolen palvelimelle
• IAMMETER-mittauksen JSON-määrittely
• Nykyinen laiteohjelmisto, paikalliset rajapinnat ja avoimet liitännät
• Uusin IAMMETER-laiteohjelmisto ja päivitystiedot

Samassa lähiverkossa oleva palvelin voi toimia ilman Internet-yhteyttä. Etäpäätepiste vaatii silti toimivan reitin Internetin, yksityisen WAN-verkon tai VPN:n kautta.

4. Käytä IAMMETERin itse ylläpidettävää ohjelmistoa

IAMMETER tarjoaa kaksi itse ylläpidettävää vaihtoehtoa käyttäjille, jotka haluavat yksityisen datan käyttöönoton ilman, että heidän tarvitsee toteuttaa jokaista taustakomponenttia itse.

4.1 IAMMETER-Docker

IAMMETER-Docker on avoimen lähdekoodin, itse ylläpidettävä energianseurantajärjestelmä. Se tarjoaa paikallisen tiedonkeruun, perusvalvontatoiminnot, kaaviot ja rajapinnat.

Se soveltuu yleensä:

• yksityishenkilöille ja kehittäjille;
• Raspberry Pi-, mini-PC- ja NAS-käyttöönotoille;
• kodin energia- tai aurinkovoiman seurantaan yksityisessä verkossa;
• projekteille, jotka tarvitsevat toimivan käyttöliittymän sekä rajapinnat;
• käyttäjille, jotka haluavat kehittää mukautetun käyttöliittymän valmiin taustajärjestelmän päälle.

Jatkakaa lukemalla:

• IAMMETER-Dockerin käyttöönotto
• IAMMETER-Dockerin lisäominaisuudet
• Offline-dataloggeritila

4.2 IAMMETER-Central

IAMMETER-Central on itse ylläpidettävä dataväliohjelmisto yrityskäyttäjille, asentajille ja järjestelmäintegraattoreille.

Se keskittyy:

• IAMMETER-laitteiden rekisteröintiin ja hallintaan;
• mittarin mittausten tallentamiseen asiakkaan hallinnoimaan tietokantaan;
• standardoitujen rajapintojen tarjoamiseen asiakassovellukselle;
• laitedatan vastaanoton erottamiseen asiakkaan ERP-, EMS-, BMS- tai etuliittymästä.

IAMMETER-Central ei pyri tarjoamaan energianhallintasovelluksen täydellistä liiketoimintalogiikkaa. Se on hyödyllinen, kun asiakas haluaa ylläpidetyn datavälityskerroksen ja rakentaa itse oman käyttöliittymänsä tai liiketoimintatoimintonsa.

Katso IAMMETERin itse ylläpidettävät vaihtoehdot IAMMETER-Dockerin, IAMMETER-Centralin, avoimen lähdekoodin alustojen ja suoran palvelinintegraation vertailua varten.

5. Rakenna IAMMETER-Cloud-rajapintojen varaan

IAMMETER-Cloudin käyttäminen on toinen tapa kehittää mukautettu kojelauta tai sovellus. Tässä arkkitehtuurissa mittari lähettää tiedot IAMMETER-Cloudiin ja sovelluksenne hakee IAMMETER-Cloud-rajapintojen tarjoamat tiedot.

IAMMETER meter → IAMMETER-Cloud → Cloud API → Your application

Tämä vaihtoehto voi vähentää laitepuolen ja tiedonkeruun kehitystyötä, mutta se ei ole offline- tai pilviriippumaton arkkitehtuuri.

Se soveltuu, kun:

• mittari raportoi jo IAMMETER-Cloudiin;
• sovelluksenne haluaa käyttää uudelleen pilvessä olevia tietoja;
• Internet-yhteys on käytettävissä;
• koko dataputkea ei tarvitse pitää paikallisessa verkossa.

Katso IAMMETER-Cloud API -dokumentaatio tuetuista API-toiminnoista ja todennusvaatimuksista.

6. Integroi olemassa olevaan avoimen lähdekoodin alustaan

Ennen kuin rakennatte täydellisen seurantajärjestelmän, tarkistakaa, tarjoaako olemassa oleva alusta jo tarvitsemanne tallennuksen, kojelaudan ja automaatiotoiminnot.

IAMMETER voidaan integroida seuraaviin:

• Home Assistant
• Node-RED
• OpenHAB
• ioBroker
• Zabbix
• ThingsBoard

Nämä alustakohtaiset sivut ovat toteutusoppaita. Laajempaa vertailua varten käyttäkää Itse ylläpidetyn ja avoimen lähdekoodin integraation yleiskatsausta.

7. Valitse paras lähtökohta

Projektin vaatimus	Suositeltu lähtökohta
Yksinkertainen LAN-skripti tai kojelauta	Paikallinen HTTP-rajapinta
Sekunnin tarkkuudella tapahtuva paikallinen data tai teollisuusohjaus	Modbus TCP
Olemassa oleva MQTT-infrastruktuuri	MQTT- tai MQTTS-lähetys
Olemassa oleva verkkotaustajärjestelmä	HTTP- tai HTTPS-lähetys
Mukautettu socket-keräin	TCP- tai TLS-lähetys
Käyttövalmis yksityinen seuranta yksityiskäyttäjälle	IAMMETER-Docker
Yritysväliohjelmisto ERP-, EMS- tai BMS-järjestelmiin	IAMMETER-Central
Älykodin kojelauta ja automaatio	Home Assistant
Sovellus, joka on rakennettu olemassa olevan IAMMETER-Cloud-datan varaan	IAMMETER-Cloud API

8. Kehityksen tarkistuslista

Ennen toteutusta varmistakaa:

1. mitkä mittaukset ja vaiheet valittu mittari tarjoaa;
2. kyselläänkö tiedot vai lähetetäänkö ne;
3. vaadittu päivitysväli;
4. onko järjestelmän toimittava myös Internet-katkoksen aikana;
5. mihin historiatiedot tallennetaan;
6. vaaditaanko TLS-suojattua tiedonsiirtoa;
7. miten sovellus todentaa käyttäjät ja laitteet;
8. pitäisikö IAMMETER-Cloudin pysyä osana arkkitehtuuria;
9. laiteohjelmistoversio, jota käytetään vahvistamiseen;
10. miten kokoonpano, lokit ja tiedot varmuuskopioidaan.

9. Aiheeseen liittyvä dokumentaatio

• IAMMETERin käyttö ilman Internetiä tai IAMMETER-Cloudia
• IAMMETERin paikalliset rajapinnat ja avoimet liitännät
• Itse ylläpidetyn ja avoimen lähdekoodin integraation yleiskatsaus
• Tietojen lähettäminen kolmannen osapuolen palvelimelle
• MQTT-energiamittarin integraatio
• Modbus TCP -energiamittarin integraatio
• IAMMETERin itse ylläpidettävät vaihtoehdot

Päivitetty viimeksi: 16. heinäkuuta 2026