Wi-Fi měřič energie IAMMETER: Průvodce lokální integrací a otevřeným rozhraním
Wi-Fi měřič energie IAMMETER: Průvodce lokální integrací a otevřeným rozhraním
Pro vývojáře a systémové integrátory používající měřiče IAMMETERbezIAMMETER-Cloud.
Wi-Fi měřiče energie IAMMETER jsou navrženy pro cloudovou i lokální integraci a poskytují otevřená API (HTTP, MQTT, Modbus/TCP), která vývojářům umožňují vytvářet vlastní systémy pro hospodaření s energií (EMS), systémy pro správu budov (BMS) nebo platformy pro automatizaci inteligentní domácnosti.
Firmware IAMMETER je průběžně aktualizován. Tento dokument uvádí všechny funkce lokální a otevřené integrace podporované nejnovějším firmwarem.(Průběžně aktualizováno)
1) Aktualizace firmwaru
Nejnovější verze firmwaru si můžete stáhnout zde:
- Stránka s vydáním firmwaru (imeter.club): https://imeter.club/topic/11
2) Režimy spuštění (mimo cloud)
Vyberte režim na základě toho, jak zařízení integrujete nebo používáte.
| Režim | Popis | Typické použití |
|---|---|---|
| Mrak | Nahrávání dat do IAMMETER-Cloudu | 🚫 Není v tomto článku uvedeno |
| TCP | Nahrávání na servery třetích stran prostřednictvímTCP/TLSneboMQTT | Lokální servery, vlastní brokeři |
| HTTP | Nahrávání na servery třetích stran prostřednictvímHTTP/HTTPS | Vlastní REST API/webové backendy |
| MQTT | Nahrávání dat přímo do MQTT brokera | K dispozici pouze v nejnovějším firmwaru |
| Samostatný | Žádné nahrávání dat; měřič funguje jako lokální server, který reaguje na API nebo klienty Modbus/TCP | K dispozici pouze v nejnovějším firmwaru |
Uživatelské rozhraní staršího firmwaru

Nejnovější firmwareWebové uživatelské rozhraní

(Zbytek dokumentu zůstává nezměněn oproti vaší poslední verzi.)
3) Integrace TCP / TLS / MQTT
3.1 TCP a TLS
Měřiče mohou odesílat data přímo do vašeho koncového bodu TCP/TLS.
🔹 Nová konfigurace firmwaru
Proces konfigurace v nejnovějším firmwaru je podobný jako v předchozích verzích.
Režim běhu: TCP
Adresa:
- Pro TCP server – zadejte
{doména}:{port}(např.,abc.com:12345).
- Pro TLS server – použijte
tls://{doména}:{port}(např.,tls://abc.com:12345).
Interval nahrávání:Minimální interval nahrávání je2 sekundy.
🔹 Konfigurace staršího firmwaru
- Průvodce:Integrace serverů třetích stran (TCP/TLS)
- Video:Nahrávání energetických dat na server třetí strany

3.2 MQTT
🔹 Nová konfigurace firmwaru
Režim běhu: MQTT
Adresa:Zadejte IP adresu nebo doménu s portem, např.192.168.11.163:1883
Uživatelské jméno / Heslo:Přihlašovací údaje brokera MQTT (volitelné, pokud je broker nevyžaduje)
Interval nahrávání:Minimální interval je2 sekundy. Objevování HA MQTT: Povolit vyhledávání MQTT v aplikaci Home Assistant

🔹 Konfigurace staršího firmwaru
Publikujte telemetrii do místního nebo veřejného brokera MQTT.
- Průvodce:Průvodce integrací MQTT

4) Integrace HTTP / HTTPS
🔹 Konfigurace staršího firmwaru
Měřiče mohou odesílat data přímo na váš vlastní server.
- Formát datové zátěže je identický s režimy TCP/MQTT.
- Lze použít jakýkoli port.
- Přístav443automaticky povolí HTTPS.
- Podrobnosti:Nahrávání přes HTTP/HTTPS

🔹 Nová konfigurace firmwaru
Adresa:Vstupní formát je stejný jako u staršího firmwaru.
- Pokud není zadán žádný port, výchozí port je80.
- Pouze port443používá HTTPS post; všechny ostatní porty používají HTTP post.

5) Lokální API (HTTP přes LAN)
Přístup k měřiči je lokální přes jeho LAN IP adresu – není nutné žádné cloudové připojení.
5.1 GET /api/monitorjson
Vrací naměřená data v reálném čase.Pole:Napětí, proud, činný výkon, kWh vpřed/vzad, frekvence, účiník.
Příklad:
{
„metoda“: „uploadsn“,
„mac“: „B0F8933C4F94“,
„verze“: „i.75.97.9“,
„server“: „em“,
„SN“: „3E0BAF87“,
„Data“: [
[220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
[222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
[263.5, 9.99, 1213] 10,975, 10,846, 49,99, 0,55]
]
}
📘 Rozšíření pro měření jalového výkonu
5.2 GET /api/monitor
Pokročilá verzeMonitorjson, obsahuje informace o signálu Wi-Fi:
SSID(název připojeného přístupového bodu)podpis(síla signálu)
5.3 GET /api/wifidata
Vrátí konfiguraci Wi-Fi a sítě.
{
„verze“: „i.75.97.9“, „SN“: „3E0BAF87“, „mac“: „B0F8933C4F94“,
„typ“: „PM“, „ssid“: „CMCC-laohe“, „ip“: „192.168.11.62“,
„maska sítě“: „255.255.255.0“, „gw“: „192.168.11.253“,
„dns“: „114.114.114.114“, „dhcp“: 1, „runMode“: „tcp“, „uploadinterval“: 60
}
5.4 GET /api/uploadinterval?x=
Nastavuje interval nahrávání (v sekundách).
Funguje v režimech mimo cloud (TCP/HTTP/MQTT).
VNejnovější firmware, tento parametr lze nyní konfigurovat přímo zWebUI rozhraní, bez ručního volání API.
5.5 GET /api/mqtt
Konfiguruje přihlašovací údaje MQTT. 📘Dokumentace k konfiguračnímu API MQTT
VNejnovější firmware, tento parametr lze nyní konfigurovat přímo zWebUI rozhraní, bez ručního volání API.
5.6 GET /api/netmetring
PřepínáMěření čisté energie (NEM)režim. 📘Povolit režim NEM
VNejnovější firmware, tento parametr lze nyní konfigurovat přímo zWebUI rozhraní, bez ručního volání API.
5.7 GET /api/ctcratio
UpravujeNásobič fáze Cpro scénáře s rozdělenou fází/vyváženou fází.
x=2zdvojnásobuje hodnoty fáze C (proud, výkon, kWh). 📘Vysvětlení poměru CTC
VNejnovější firmware, tento parametr lze nyní konfigurovat přímo zWebUI rozhraní, bez ručního volání API.
5.8 GET /api/reaktivní
Povolí nebo zakážeReaktivní výkon (Q)aReaktivní energie (kVARh)měření. 📘Dokumentace jalového výkonu
VNejnovější firmware, tento parametr lze nyní konfigurovat přímo zWebUI rozhraní, bez ručního volání API.
5.9 GET /api/ratio (k dispozici pouze pro WEM3046T)
Vzhledem k tomu,WEM3046Tpoužívá externí CT s5A sekundární výstupy(např. 1000:5, 1500:5, 2000:5 atd.), naměřené hodnoty (proud, výkon, energie) musí být vynásobeny převodem proudového transformátoru.
Příklad:
/api/poměr?x=400
- Nastavený poměr:
/api/ratio?x={ct_ratio} - Poměr dotazů:
/api/poměr
PouzeWEM3046Tpodporuje externí 5A proudové transformátory – toto API není platné pro ostatní modely.
6) Konzistence formátu JSON
Všechny komunikační režimy —HTTP, TCP, MQTT, lokální API— použijte stejnou strukturu JSON. 📘Definice dat JSON
7) Podpora Modbusu/TCP
Měřiče IAMMETER nativně podporujíModbus/TCP, což umožňuje přímou integraci sDomácí asistent, PLCneboSCADAsystémy.
8) Podporované scénáře integrace
| Systém | Protokol(y) | Příklad použití | Odkaz |
|---|---|---|---|
| Domácí asistent | HTTP / Modbus / MQTT | Řídicí panel a automatizace | Průvodce |
| Uzel-ČERVENÝ | HTTP / Modbus / MQTT | Automatizační toky | Průvodce |
| OpenHAB / ioBroker | HTTP | Místní dashboardy | Integrace |
| Zabbix | HTTP | Monitorovací dashboardy | Integrace |
| Thingsboard | HTTP | Vizualizace IoT | Integrace |
| Vlastní servery | HTTP / MQTT / TCP | Podnikové nebo lokální příjem dat | Vytvořte si vlastní systém |
9) Zdroje
10) Shrnutí pro vývojáře
| Schopnosti | Přístup | Poznámky |
| --------------------- | ------------------- | ---------------------------------- |
| Lokální data v reálném čase | Lokální API |/api/monitorjson, /api/monitor|
| Nahrávání třetí stranou | TCP/TLS, HTTP/HTTPS | Stejné schéma dat |
| Publikování MQTT | Broker MQTT |/api/mqttnastavení přihlašovacích údajů |
| Měření sítě | Lokální API |/api/netmetring|
| Jalový výkon/energie | Místní API |/api/reactive|
| Násobič fáze C | Lokální API |/api/ctcratio?x=1 | | Poměr CT (WEM3046T) | Lokální API |/api/ratio?x=` |
| Modbus/TCP | Klient Modbus | Kompatibilní s HA/PLC/SCADA |
Poslední aktualizace: 15. října 2025