IAMMETER Wi-Fi Energy Meter: API Lokal dan Antarmuka Terbuka

IAMMETER Wi-Fi Energy Meter: API Lokal dan Antarmuka Terbuka

Meter energi Wi-Fi IAMMETER mendukung IAMMETER-Cloud serta integrasi lokal dan pihak ketiga.

Antarmuka yang tersedia meliputi:

• API HTTP lokal melalui LAN
• Publikasi MQTT dan MQTTS
• Modbus TCP
• Unggah TCP/TLS
• Unggah HTTP/HTTPS
• Operasi lokal mandiri

Antarmuka ini memungkinkan meter IAMMETER berperan sebagai sumber data terbuka untuk:

• Home Assistant dan platform rumah pintar lainnya
• Otomasi Node-RED
• Dasbor yang di-host sendiri
• Sistem PLC dan SCADA
• Sistem Manajemen Energi (EMS) kustom
• Sistem Manajemen Bangunan (BMS) kustom
• Server data pihak ketiga

Panduan ini menjelaskan firmware dan WebUI terkini terlebih dahulu. Tangkapan layar dan metode konfigurasi untuk firmware lama disimpan pada bagian Warisan (Legacy) di akhir artikel.

Untuk aplikasi siap pakai yang dibangun di atas kemampuan ini, lihat Pemantauan Energi Rumah, Pemantauan Energi Surya, atau pemantauan lokal tanpa akses Internet.

1) Perbarui ke Firmware Terbaru

Firmware IAMMETER diperbarui secara berkelanjutan. Sebelum mengonfigurasi integrasi, periksa rilis terkini dan kompatibilitas model:

• Halaman Rilis Firmware IAMMETER

WebUI firmware terbaru menampilkan opsi konfigurasi yang umum digunakan secara langsung. Panggilan API konfigurasi manual yang disimpan di bagian selanjutnya artikel ini terutama berguna saat memelihara instalasi lama.

2) Pilih Mode Operasi pada WebUI Terkini

Pilih mode operasi sesuai tujuan pengiriman data meter atau cara meter harus beroperasi secara lokal.

Mode operasi mengendalikan perilaku pengunggahan data. Ketersediaan API lokal dan Modbus TCP tetap harus diperiksa sesuai model meter, firmware, dan integrasi yang dipilih.

3) Mengapa Antarmuka Terbuka Itu Penting

Antarmuka terbuka memungkinkan pengguna menentukan di mana data kelistrikan diproses dan disimpan.

Alasan umumnya antara lain:

• Menjaga hasil pengukuran tetap berada di dalam jaringan lokal
• Mengirim telemetri ke server yang sudah ada
• Menghubungkan data energi dengan Home Assistant atau Node-RED
• Membangun dasbor dan alarm kustom
• Menggabungkan data kelistrikan dengan tarif, tenaga surya, atau logika kontrol beban
• Beroperasi di lokasi dengan akses Internet terbatas atau tidak stabil

Akses cloud dan lokal tidak selalu saling meniadakan. Arsitektur yang sesuai bergantung pada apakah proyek membutuhkan laporan IAMMETER-Cloud, platform lokal, server pihak ketiga, atau kombinasi.

4) Kirim Data ke Server Pihak Ketiga

4.1 TCP dan TLS

IAMMETER dapat mengirim data meter ke endpoint TCP atau TLS.

Pada WebUI terkini:

1. Pilih mode operasi TCP.
2. Masukkan alamat tujuan.
3. Konfigurasikan interval unggah.
4. Simpan pengaturan dan verifikasi data di server penerima.

Untuk server TCP, gunakan:

{domain-atau-ip}:{port}

Contoh:

abc.com:12345

Untuk server TLS, gunakan:

tls://{domain-atau-ip}:{port}

Contoh:

tls://abc.com:12345

Ikhtisar firmware terkini mendokumentasikan interval unggah minimum 2 detik. Pastikan firmware terkini dan kapasitas server penerima sebelum memilih interval yang singkat.

4.2 MQTT dan MQTTS

IAMMETER dapat mempublikasikan telemetri langsung ke broker MQTT biasa atau menggunakan MQTTS untuk transportasi terenkripsi pada firmware yang mendukung.

Pada WebUI terkini:

1. Pilih mode operasi MQTT.
2. Masukkan alamat IP atau domain broker beserta port dengan format MQTT atau MQTTS yang sesuai.
3. Masukkan nama pengguna dan kata sandi broker jika autentikasi diperlukan.
4. Konfigurasikan interval unggah.
5. Simpan dan verifikasi bahwa pesan tiba di broker.

Untuk MQTT biasa, masukkan alamat dan port broker tanpa awalan mqtt://:

192.168.11.163:1883

Untuk MQTTS, sertakan awalan mqtts://:

mqtts://{alamat-broker-mqtt}:{port}

Contoh:

mqtts://broker.example.com:8883

Dukungan MQTTS yang didokumentasikan pada pembaruan firmware November 2025 memiliki batasan berikut saat ini:

• Mendukung TLS 1.2 dan versi di bawahnya.
• Mengunggah sertifikat CA kustom tidak didukung.
• Verifikasi nama host tidak didukung.
• Sertifikat sisi klien untuk autentikasi mutual TLS tidak didukung.

Batasan ini penting saat memilih broker dan mengevaluasi kebutuhan keamanan penerapan.

Ikhtisar firmware terkini mendokumentasikan interval unggah minimum 2 detik.

MQTT Discovery untuk Home Assistant adalah fungsi penemuan tambahan Home Assistant; fitur ini tidak diperlukan untuk setiap integrasi MQTT. Lihat:

• Panduan Integrasi MQTT IAMMETER
• MQTT Discovery di Home Assistant

Ubah uploadInterval dari Jarak Jauh melalui MQTT/MQTTS

Dengan firmware yang dijelaskan pada pembaruan November 2025, meter yang berjalan dalam mode MQTT otomatis berlangganan ke:

device/{sn}/config

Publikasikan JSON berikut dari klien MQTT lain untuk mengubah interval unggah dari jarak jauh:

{"uploadInterval": 10}

Ganti 10 dengan interval yang diinginkan dalam satuan detik dan {sn} dengan nomor seri meter pada topik.

Konfigurasi MQTT jarak jauh ini berbeda dari metode lokal lama /api/uploadinterval yang disimpan pada bagian Warisan (Legacy).

4.3 HTTP dan HTTPS

IAMMETER dapat mengirim data ke server HTTP/HTTPS kustom.

Pada WebUI terkini:

1. Pilih mode operasi HTTP.
2. Masukkan alamat dan port server.
3. Konfigurasikan interval unggah.
4. Simpan dan verifikasi permintaan di server.

Firmware terkini mendukung port HTTPS bawaan maupun port HTTPS kustom.

Gunakan salah satu format berikut:

• HTTP biasa tanpa port eksplisit: {alamat} — menggunakan port 80 secara bawaan.
• HTTP biasa dengan port kustom: {alamat}:{port}.
• HTTPS tanpa port eksplisit: https://{alamat} — menggunakan port 443 secara bawaan.
• HTTPS dengan port kustom: https://{alamat}:{port} — menggunakan port yang ditentukan.

Awalan https:// memilih HTTPS. Port 443 bukan lagi satu-satunya port yang tersedia untuk HTTPS.

Contoh:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Lihat Firmware Baru Menambahkan MQTTS, Konfigurasi Jarak Jauh, dan Port HTTPS Kustom untuk catatan rilis firmware.

Untuk penanganan payload di sisi server, lihat juga Integrasikan IAMMETER dengan Server Pihak Ketiga.

5) Baca Data secara Lokal melalui HTTP

Hubungkan meter ke LAN dan minta data dari alamat IP lokalnya. Permintaan ini tidak memerlukan IAMMETER-Cloud.

Uji API secara interaktif: Buka IAMMETER Local API Explorer, masukkan alamat IP lokal meter dan pilih halaman uji WEM API. Explorer bergaya Swagger ini menampilkan API lokal yang tersedia dan memungkinkan Anda mengirim permintaan uji langsung dari browser. Browser Anda dan meter IAMMETER harus berada pada LAN yang sama.

5.1 GET /api/monitorjson

Mengembalikan pengukuran kelistrikan secara real-time.

Data standar mencakup nilai seperti:

• Tegangan
• Arus
• Daya aktif
• kWh maju/impor
• kWh balik/ekspor
• Frekuensi
• Faktor daya

Contoh respons:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [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]
  ]
}

Jumlah larik pengukuran bergantung pada model meter dan jumlah kanal.

Jika pengukuran daya reaktif diaktifkan pada model/firmware yang didukung, format respons dapat memuat kolom tambahan. Lihat Format Data Pengukuran Daya Reaktif.

5.2 GET /api/monitor

Mengembalikan respons real-time yang diperluas dan juga mencakup informasi Wi-Fi seperti:

• ssid — nama titik akses yang terhubung
• sig — kekuatan sinyal Wi-Fi

Gunakan endpoint ini jika integrasi membutuhkan pengukuran kelistrikan sekaligus status Wi-Fi dasar.

5.3 GET /api/wifidata

Mengembalikan informasi firmware, perangkat, dan konfigurasi jaringan.

Contoh:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

Jangan mempublikasikan respons yang memuat nomor seri perangkat, alamat MAC, pengalamatan internal, atau informasi Wi-Fi kecuali nilainya sudah disanitasi.

6) Format JSON di Seluruh Mode Unggah

IAMMETER menggunakan struktur JSON inti pengukuran yang konsisten di seluruh HTTP, TCP, MQTT, dan API lokal. Hal ini mengurangi pekerjaan yang diperlukan ketika satu sistem penerima mendukung beberapa metode transportasi.

Metode transportasi dan envelope tetap dapat memengaruhi cara penerima terhubung, melakukan autentikasi, atau membingkai pesan. Implementasikan sistem penerima sesuai format yang didokumentasikan untuk mode yang dipilih.

• Definisi Data JSON Meter Energi IAMMETER

7) Modbus TCP

Meter IAMMETER mendukung Modbus TCP untuk integrasi langsung melalui LAN dengan klien yang kompatibel.

Klien yang umum digunakan antara lain:

• Home Assistant
• PLC
• Sistem SCADA
• Gateway industri
• Aplikasi Modbus kustom

Referensi:

• Ikhtisar Modbus TCP IAMMETER
• Ikhtisar Integrasi Home Assistant

Pastikan model meter, firmware, definisi register, interval polling, dan perilaku klien sebelum penerapan.

8) Skenario Integrasi

9) Ringkasan Antarmuka Terkini dan Sumber Daya

Sumber daya tambahan:

• Firmware Terbaru
• Catatan Firmware MQTTS dan Port HTTPS Kustom
• Tutorial Video
• Definisi Data JSON
• Ikhtisar Modbus TCP
• Kembangkan Sistem Anda Sendiri
• Pemantauan tanpa Akses Internet

API lokal dan protokol terbuka IAMMETER memungkinkan Anda memulai dengan pemantauan real-time lalu menambahkan EMS kustom, dasbor yang di-host sendiri, atau alur kerja otomasi.

10) Halaman Firmware Warisan dan Metode Konfigurasi

Materi berikut hanya disimpan untuk meter yang masih menjalankan firmware lama atau bagi pengguna yang memelihara integrasi yang sudah ada. Untuk instalasi baru, perbarui ke firmware terbaru dan gunakan WebUI terkini di mana pun opsi yang diperlukan tersedia.

10.1 Halaman Mode Operasi Warisan

Firmware lama menggunakan halaman pemilihan mode operasi berikut:

Tata letak dan nama opsi mungkin tidak sesuai dengan WebUI terkini yang ditampilkan sebelumnya dalam panduan ini.

10.2 Halaman TCP/TLS Warisan

Integrasi firmware lama mungkin merujuk pada halaman konfigurasi TCP/TLS dan panduan terkait berikut:

• Panduan Integrasi Server Pihak Ketiga (Warisan)
• Video Unggah ke Server (Warisan)

10.3 Halaman MQTT Warisan

Dokumentasi MQTT lama menggunakan antarmuka konfigurasi berikut:

Untuk alur kerja terkini, gunakan petunjuk WebUI terkini pada bagian sebelumnya artikel ini dan Panduan Integrasi MQTT yang telah diperbarui.

10.4 Halaman HTTP/HTTPS Warisan

Firmware lama menggunakan halaman tujuan HTTP/HTTPS berikut:

Panduan integrasi warisan disimpan di Unggah melalui HTTP/HTTPS.

Pada alur kerja lama ini, HTTPS dikaitkan dengan port bawaan 443 dan tidak memerlukan awalan https://. Firmware terkini justru menggunakan awalan https:// untuk memilih HTTPS dan mendukung port bawaan 443 maupun port kustom yang ditentukan secara eksplisit.

10.5 API Konfigurasi Warisan

Panggilan API lokal berikut muncul pada alur kerja konfigurasi sebelumnya. Pada firmware terkini, pengaturan terkait biasanya harus dikonfigurasi melalui WebUI jika opsi tersebut tersedia.

/api/uploadinterval?x=<detik>

Metode warisan untuk mengatur interval unggah non-Cloud.

/api/mqtt

Metode warisan untuk mengonfigurasi kredensial MQTT.

/api/netmetring

Metode warisan untuk mengaktifkan atau menonaktifkan mode Net Energy Metering.

• Referensi Net Energy Metering

/api/ctcratio

Metode warisan untuk menerapkan pengali Fase-C yang didokumentasikan pada skenario split-phase atau seimbang tertentu.

• Referensi CTC Ratio

/api/reactive

Metode warisan untuk mengaktifkan atau menonaktifkan pengukuran daya reaktif dan energi reaktif pada firmware/model yang didukung.

• Referensi Daya Reaktif

/api/ratio — hanya WEM3046T

WEM3046T menggunakan CT eksternal dengan keluaran sekunder 5 A. Petunjuk konfigurasi lama menetapkan rasio CT dengan:

/api/ratio?x={ct_ratio}

Contoh:

/api/ratio?x=400

Endpoint ini khusus untuk WEM3046T dan tidak berlaku untuk model IAMMETER lainnya. Untuk firmware terkini, gunakan konfigurasi WebUI model terkini jika tersedia.

Materi warisan disimpan sebagai referensi ke belakang; instalasi terkini sebaiknya mengikuti WebUI firmware terbaru.