Utveckla ditt eget energimätningssystem med IAMMETER

Utveckla ditt eget energimätningssystem med IAMMETER

IAMMETER Wi-Fi-energimätare erbjuder öppna datagränssnitt för utvecklare, systemintegratörer och kunder som bygger sin egen energimätningsprogramvara.

Du kan hämta mätvärden direkt från mätaren, låta mätaren ladda upp data till din server, distribuera en IAMMETER self-hosted-tjänst eller bygga en applikation ovanpå IAMMETER-Cloud API:er.

Denna sida är utvecklarens navigeringsguide för att välja en arkitektur. Den länkar till aktuella protokolldefinitioner och implementeringsdokument snarare än att duplicera varje API-parameter.

Om din första fråga är huruvida en IAMMETER-mätare kan fungera utan internetanslutning eller IAMMETER-Cloud, börja med Använda en Wi-Fi-energimätare utan internet eller moln. För en plattformsorienterad jämförelse, se Self-hosted och open-source-integration.

1. Välj din systemarkitektur

Det finns fyra huvudsakliga sätt att använda IAMMETER-data i din egen applikation.

Arkitektur	Dataflöde	Bäst lämpad för	Krävs IAMMETER-Cloud?
Läs mätaren lokalt	Applikation → Mätare	LAN-instrumentpaneler, automatisering, PLC och SCADA	Nej
Låt mätaren ladda upp data	Mätare → Kundserver eller broker	Anpassat moln, EMS, BMS och IoT-backends	Nej
Distribuera IAMMETER self-hosted-programvara	Mätare → IAMMETER-Docker eller IAMMETER-Central → Applikation	Användare som vill ha lagring och API:er utan att bygga hela backend	Nej
Bygg på IAMMETER-Cloud API:er	Mätare → IAMMETER-Cloud → Applikation	Applikationer som vill återanvända IAMMETER-Cloud-data och -tjänster	Ja

Det rätta valet beror på var data ska lagras, om projektet kräver internetoberoende drift, den nödvändiga uppdateringsfrekvensen och hur mycket backendutveckling du vill underhålla.

2. Läs data direkt från mätaren

Välj denna arkitektur när applikationen och mätaren finns i samma lokala nätverk.

IAMMETER-mätare ← Lokalt HTTP-API eller Modbus TCP ← Din applikation

Din applikation styr pollningsintervallet och lagrar all historik den behöver. Ingen IAMMETER-molntjänst krävs för den lokala datavägen.

2.1 Lokalt HTTP-API

Mätaren erbjuder lokala HTTP-slutpunkter för att hämta mätvärden som spänning, ström, aktiv effekt, importerad energi och exporterad energi.

Vanliga mätslutpunkter inkluderar:

• /api/monitorjson
• /api/monitor

Lokal HTTP-API-åtkomst är en praktisk utgångspunkt för:

• anpassade instrumentpaneler;
• skript som körs på en PC, NAS eller Raspberry Pi;
• lågkodsintegrationer;
• lokala applikationer som inte kräver polling en gång per sekund.

Se IAMMETER lokalt API och gränssnittsguide för aktuella slutpunktsdefinitioner och exempel.

2.2 Modbus TCP

Använd Modbus TCP när projektet kräver:

• lokal polling en gång per sekund;
• PLC- eller SCADA-integration;
• realtidsstyrning av effekt;
• integration med ett industriellt EMS eller BMS;
• ett standardregisterbaserat protokoll.

Se IAMMETER Modbus TCP-register- och integrationsguide.

2.3 Vad din applikation måste tillhandahålla

Direkt lokal läsning returnerar mätarens mätvärden. Din applikation förblir ansvarig för eventuella ytterligare funktioner den kräver, inklusive:

• datalagring;
• timvis, daglig och månatlig aggregering;
• instrumentpaneler och rapporter;
• användare och behörigheter;
• larm och automatiseringslogik;
• säkerhetskopior och lagring.

Om du inte vill bygga dessa backendfunktioner från början, överväg IAMMETER-Docker eller IAMMETER-Central.

3. Ladda upp mätardata direkt till din server

Välj denna arkitektur när mätaren ska initiera anslutningen och skicka data till en slutpunkt som du hanterar.

IAMMETER-mätare → MQTT/MQTTS, HTTP/HTTPS eller TCP/TLS → Din server

Aktuell IAMMETER-firmware stöder flera uppladdningsgränssnitt:

Gränssnitt	Kundens komponent	Typisk tillämpning
MQTT / MQTTS	MQTT-broker och prenumerant	IoT-plattformar, automatisering och meddelandepipelines
HTTP / HTTPS	HTTP-slutpunkt	REST-backend, molntjänst eller anpassat EMS
TCP / TLS	TCP-server	Anpassad insamlare och protokollnivåintegration

Mätaren och din server använder en konsekvent IAMMETER-mätnings-JSON-struktur över alla stödda uppladdningsmetoder. Granska datadefinitionen innan du implementerar din parser.

Implementeringsresurser:

• Publicera IAMMETER-data till din MQTT-broker
• Ladda upp IAMMETER-data till en tredjepartsserver
• IAMMETER mätnings-JSON-definition
• Aktuell firmware, lokala API:er och öppna gränssnitt
• Senaste IAMMETER-firmware och uppgraderingsinformation

En server i samma LAN kan fungera utan internetanslutning. En fjärrslutpunkt kräver fortfarande en fungerande väg genom internet, ett privat WAN eller ett VPN.

4. Använd IAMMETER self-hosted-programvara

IAMMETER tillhandahåller två self-hosted-alternativ för användare som vill ha privat datadistribution utan att själva implementera varje backendkomponent.

4.1 IAMMETER-Docker

IAMMETER-Docker är ett open-source, self-hosted energimätningssystem. Det tillhandahåller lokal datainsamling, grundläggande mätfunktioner, diagram och API:er.

Det är generellt lämpligt för:

• individer och utvecklare;
• Raspberry Pi-, mini-PC- och NAS-distributioner;
• hemmenergi- eller solcellsmätning i ett privat nätverk;
• projekt som behöver ett fungerande gränssnitt såväl som API:er;
• användare som vill utveckla ett anpassat gränssnitt ovanpå en färdig backend.

Fortsätt med:

• Distribuera IAMMETER-Docker
• IAMMETER-Docker avancerade funktioner
• Offline-dataloggerläge

4.2 IAMMETER-Central

IAMMETER-Central är self-hosted datamellanprogram för företagsanvändare, installatörer och systemintegratörer.

Det fokuserar på:

• att registrera och hantera IAMMETER-enheter;
• att lagra mätarens mätvärden i en kundkontrollerad databas;
• att tillhandahålla standardiserade API:er för en kundapplikation;
• att separera enhetsdatainsamling från kundens ERP, EMS, BMS eller frontend.

IAMMETER-Central försöker inte tillhandahålla den fullständiga affärslogiken för en energihanteringsapplikation. Det är användbart när kunden vill ha ett underhållet datamellanprogram och kommer att bygga sitt eget användargränssnitt eller sina egna affärsfunktioner.

Se IAMMETER self-hosting-alternativ för en jämförelse av IAMMETER-Docker, IAMMETER-Central, open-source-plattformar och direkt serverintegration.

5. Bygg på IAMMETER-Cloud API:er

Att använda IAMMETER-Cloud är ett annat sätt att utveckla en anpassad instrumentpanel eller applikation. I denna arkitektur laddar mätaren upp data till IAMMETER-Cloud och din applikation hämtar den data som exponeras av IAMMETER-Cloud API:er.

IAMMETER-mätare → IAMMETER-Cloud → Cloud API → Din applikation

Detta alternativ kan minska enhetssidig och datainsamlingsutveckling, men det är inte en offline- eller molnberoende oberoende arkitektur.

Det är lämpligt när:

• mätaren redan rapporterar till IAMMETER-Cloud;
• din applikation vill återanvända molnvärd data;
• internetanslutning finns tillgänglig;
• det inte krävs att hela datapipelinen hålls inom det lokala nätverket.

Se IAMMETER-Cloud API-dokumentation för stödda API-operationer och autentiseringskrav.

6. Integrera med en befintlig open-source-plattform

Innan du bygger ett komplett mätsystem, kontrollera om en befintlig plattform redan tillhandahåller de lagrings-, instrumentpanel- och automatiseringsfunktioner du behöver.

IAMMETER kan integreras med:

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

Dessa plattformsspecifika sidor är implementeringsguiderna. För en bredare jämförelse, använd Self-hosted och open-source-integrationsöversikt.

7. Välj bästa utgångspunkt

Projektkrav	Rekommenderad utgångspunkt
Enkelt LAN-skript eller instrumentpanel	Lokalt HTTP-API
Lokal data per sekund eller industriell styrning	Modbus TCP
Befintlig MQTT-infrastruktur	MQTT- eller MQTTS-uppladdning
Befintlig webbbackend	HTTP- eller HTTPS-uppladdning
Anpassad socket-insamlare	TCP- eller TLS-uppladdning
Färdigatt använda privat mätning för en enskild användare	IAMMETER-Docker
Företagsmellanprogram för ERP, EMS eller BMS	IAMMETER-Central
Smart-heminstrumentpanel och automatisering	Home Assistant
Applikation byggd på befintlig IAMMETER-Cloud-data	IAMMETER-Cloud API

8. Utvecklingschecklista

Innan implementering, bekräfta:

1. vilka mätvärden och faser den valda mätaren tillhandahåller;
2. om data kommer att hämtas (pollen) eller skickas (pushed);
3. det nödvändiga uppdateringsintervallet;
4. om systemet måste fungera under ett internetavbrott;
5. var historisk data kommer att lagras;
6. om TLS-skyddad transport krävs;
7. hur applikationen ska autentisera användare och enheter;
8. om IAMMETER-Cloud ska förbli en del av arkitekturen;
9. firmwareversionen som används för validering;
10. hur konfiguration, loggar och data ska säkerhetskopieras.

9. Relaterad dokumentation

• Använda IAMMETER utan internet eller IAMMETER-Cloud
• IAMMETER lokala API:er och öppna gränssnitt
• Self-hosted och open-source-integrationsöversikt
• Ladda upp data till en tredjepartsserver
• MQTT-energimätarintegration
• Modbus TCP-energimätarintegration
• IAMMETER self-hosting-alternativ

Senast uppdaterad: 16 juli 2026