Pengukur Energi Wi-Fi IAMMETER: Panduan Integrasi Lokal & Antarmuka Terbuka

Pengukur Energi Wi-Fi IAMMETER: Panduan Integrasi Lokal & Antarmuka Terbuka

Untuk pengembang dan integrator sistem yang menggunakan meter IAMMETERtanpaIAMMETER-Cloud.

Pengukur energi Wi-Fi IAMMETER dirancang untuk integrasi lokal dan berbasis cloud, menyediakan API terbuka (HTTP, MQTT, Modbus/TCP) yang memungkinkan pengembang membangun Sistem Manajemen Energi (EMS), Sistem Manajemen Bangunan (BMS), atau platform otomasi rumah pintar mereka sendiri.

Firmware IAMMETER terus diperbarui. Dokumen ini mencantumkan semua fitur integrasi lokal dan terbuka yang didukung oleh firmware terbaru.(Terus diperbarui)

1) Pembaruan Firmware

Dapatkan rilis firmware terbaru di sini:

• Halaman Rilis Firmware (imeter.club): https://imeter.club/topic/11

2) Mode Lari (Non-Cloud)

Pilih mode berdasarkan cara Anda mengintegrasikan atau menggunakan perangkat.

Antarmuka Pengguna Firmware Lama

Firmware TerbaruAntarmuka Pengguna Web

(Sisa dokumen Anda tetap sama seperti versi terbarunya.)

3) Integrasi TCP / TLS / MQTT

3.1 TCP dan TLS

Meter dapat mendorong data langsung ke titik akhir TCP/TLS Anda.

🔹 Konfigurasi Firmware Baru

Proses konfigurasi pada firmware terbaru mirip dengan versi sebelumnya.

Mode Lari: TCP

Alamat:

• Untuk server TCP — masukkan{domain}:{port}(misalnya.,abc.com:12345).
• Untuk server TLS — gunakantls://{domain}:{port}(misalnya.,tls://abc.com:12345).

Interval Unggah:Interval unggah minimum adalah2 detik.

🔹 Konfigurasi Firmware Lama

• Memandu:Integrasi Server Pihak Ketiga (TCP/TLS)
• Video:Unggah Data Energi ke Server Pihak Ketiga

3,2 MQTT

🔹 Konfigurasi Firmware Baru

Mode Lari: MQTT Alamat:Masukkan IP atau domain dengan port, misalnya,192.168.11.163:1883 Nama Pengguna / Kata Sandi:Kredensial broker MQTT (opsional jika tidak diperlukan oleh broker)

Interval Unggah:Interval minimum adalah2 detik. Penemuan MQTT HA: Aktifkan penemuan MQTT di Asisten Rumah

🔹 Konfigurasi Firmware Lama

Publikasikan telemetri ke broker MQTT lokal atau publik.

• Memandu:Panduan Integrasi MQTT

4) Integrasi HTTP / HTTPS

🔹 Konfigurasi Firmware Lama

Meter dapat mengirim data langsung ke server khusus Anda.

• Format muatan data identik dengan mode TCP/MQTT.
• Port apa pun dapat digunakan.
• Pelabuhan443mengaktifkan HTTPS secara otomatis.
• Detail:Unggah melalui HTTP/HTTPS

🔹 Konfigurasi Firmware Baru

Alamat:Format masukan sama dengan firmware lama.

• Jika tidak ada port yang ditentukan, port default adalah80.
• Hanya pelabuhan443menggunakan pos HTTPS; semua port lainnya menggunakan pos HTTP.

5) API Lokal (HTTP melalui LAN)

Akses meteran secara lokal melalui IP LAN — tidak diperlukan koneksi cloud.

5.1 DAPATKAN /api/monitorjson

Mengembalikan data pengukuran waktu nyata.Bidang:Tegangan, Arus, Daya Aktif, kWh Maju/Mundur, Frekuensi, Faktor Daya.

Contoh:

{
"metode": "uploadsn",
"mac": "B0F8933C4F94",
"versi": "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]
]
}

📘 Ekstensi Pengukuran Daya Reaktif

5.2 DAPATKAN /api/monitor

Versi lanjutan dariMonitorjson, termasuk info sinyal Wi-Fi:

• SSID(nama AP yang terhubung)
• tanda tangan(kekuatan sinyal)

5.3 DAPATKAN /api/wifidata

Mengembalikan Wi-Fi dan konfigurasi jaringan.

{
"versi":"i.75.97.9","SN":"3E0BAF87","mac":"B0F8933C4F94",
"jenis":"PM","ssid":"CMCC-laohe","ip":"192.168.11.62",
"mask":"255.255.255.0","gw":"192.168.11.253",
"dns": "114.114.114.114", "dhcp": 1", "runMode": "tcp", "uploadinterval": 60
}

5.4 DAPATKAN /api/uploadinterval?x=<detik>

Mengatur interval unggah (dalam detik).

Bekerja dalam mode non-Cloud (TCP/HTTP/MQTT).

Di dalamFirmware Terbaru, parameter ini sekarang dapat dikonfigurasi langsung dariAntarmuka WebUI, tanpa memanggil API secara manual.

5.5 DAPATKAN /api/mqtt

Mengonfigurasi kredensial MQTT. 📘Dokumen API Konfigurasi MQTT

Di dalamFirmware Terbaru, parameter ini sekarang dapat dikonfigurasi langsung dariAntarmuka WebUI, tanpa memanggil API secara manual.

5.6 DAPATKAN /api/netmetri

BeralihPengukuran Energi Bersih (NEM)modus. 📘Aktifkan Mode NEM

Di dalamFirmware Terbaru, parameter ini sekarang dapat dikonfigurasi langsung dariAntarmuka WebUI, tanpa memanggil API secara manual.

5.7 DAPATKAN /api/ctcratio

MenyesuaikanPengganda fase Cuntuk skenario fase terbagi/seimbang.

• x=2menggandakan pembacaan Fase C (arus, daya, kWh). 📘Penjelasan Rasio CTC

Di dalamFirmware Terbaru, parameter ini sekarang dapat dikonfigurasi langsung dariAntarmuka WebUI, tanpa memanggil API secara manual.

5.8 DAPATKAN /api/reaktif

Mengaktifkan atau menonaktifkanDaya Reaktif (Q)danEnergi Reaktif (kVARh)pengukuran. 📘Dokumentasi Daya Reaktif

Di dalamFirmware Terbaru, parameter ini sekarang dapat dikonfigurasi langsung dariAntarmuka WebUI, tanpa memanggil API secara manual.

5.9 DAPATKAN /api/rasio (hanya tersedia untuk WEM3046T)

SejakWEM3046Tmenggunakan CT eksternal denganOutput sekunder 5A(misalnya, 1000:5, 1500:5, 2000:5, dst.), nilai terukur (arus, daya, energi) harus dikalikan dengan rasio CT.

Contoh:

/api/rasio?x=400

• Tetapkan rasio: /api/rasio?x={ct_ratio}
• Rasio kueri: /api/rasio

HanyaWEM3046Tmendukung CT 5A eksternal — API ini tidak berlaku untuk model lain.

6) Konsistensi Format JSON

Semua mode komunikasi —HTTP, TCP, MQTT, API Lokal— menggunakan struktur JSON yang sama. 📘Definisi Data JSON

7) Dukungan Modbus/TCP

Meter IAMMETER secara native mendukungModbus/TCP, memungkinkan integrasi langsung denganAsisten Rumah, PLC, atauSCADAsistem.

• Ikhtisar Modbus/TCP
• Contoh Modbus Asisten Rumah

8) Skenario Integrasi yang Didukung

9) Sumber Daya

• Rilis Firmware
• Video tutorial
• Definisi JSON
• Ikhtisar Modbus/TCP
• Kembangkan Sistem Anda Sendiri

10) Ringkasan Pengembang

| Kemampuan | Akses | Catatan | | --------------------- | ------------------- | ---------------------------------- | | Data lokal waktu nyata | API Lokal |/api/monitorjson, /api/monitor| | Unggahan pihak ketiga | TCP/TLS, HTTP/HTTPS | Skema muatan yang sama | | Publikasi MQTT | Broker MQTT |/api/mqttuntuk mengatur kredensial | | Pengukuran bersih | API Lokal |/api/netmetri| | Daya/energi reaktif | API Lokal |/api/reaktif| | Pengganda Fase-C | API Lokal |/api/ctcratio?x=1 | | Rasio CT (WEM3046T) | API Lokal |/api/ratio?x=` | | Modbus/TCP | Klien Modbus | Kompatibel dengan HA/PLC/SCADA |

Terakhir diperbarui: 15 Oktober 2025