Integrasi Energy Meter Modbus TCP: Register dan Pengujian
Integrasi Energy Meter Modbus TCP untuk Pemantauan Lokal
Modbus TCP memungkinkan aplikasi lokal membaca pengukuran listrik langsung dari energy meter Wi-Fi IAMMETER.
Interface ini cocok untuk:
- sistem PLC dan SCADA;
- Home Assistant dan Node-RED;
- Sistem Manajemen Energi (EMS) lokal;
- Building Management System (BMS);
- pemantauan dan otomasi per detik;
- aplikasi yang harus beroperasi tanpa IAMMETER-Cloud.
IAMMETER energy meter
│
│ Wi-Fi / LAN
│ Modbus TCP
▼
Home Assistant, Node-RED, PLC, SCADA or custom EMS
Klien yang memulai setiap permintaan. Meter mengembalikan nilai register untuk tegangan, arus, daya aktif, energi impor, energi ekspor, faktor daya, frekuensi, dan pengukuran lain yang didukung.
Modbus TCP adalah antarmuka polling lokal. Jika meter perlu memublikasikan data ke broker, gunakan MQTT. Jika meter perlu mengunggah data ke server pelanggan, lihat Menerima Data IAMMETER di Server Anda Sendiri.
1. Mengapa Menggunakan Modbus TCP?
Dibandingkan dengan polling cloud atau unggahan meter secara berkala, Modbus TCP menyediakan:
- akses langsung melalui jaringan lokal;
- tidak bergantung pada IAMMETER-Cloud untuk jalur data;
- antarmuka standar berbasis register;
- polling per detik untuk aplikasi yang didukung;
- nilai daya aktif bertanda untuk pemantauan energi dua arah;
- kompatibilitas dengan perkakas otomasi dan industri yang umum.
Penggunaan tipikal meliputi:
- mengendalikan beban berdasarkan daya grid secara real-time;
- membaca produksi solar, pertukaran dengan grid, atau beban sirkuit secara lokal;
- menambahkan energy meter ke Home Assistant;
- mengumpulkan pengukuran di Node-RED;
- mengintegrasikan data listrik ke PLC, SCADA, EMS, atau BMS.
2. Meter IAMMETER yang Didukung
Model energy meter IAMMETER saat ini mendukung mode Home Assistant dan integrasi terbuka yang tersedia, termasuk Modbus TCP. WEM3162 yang sudah dihentikan produksinya tidak dibahas dalam panduan ini.
Perbedaan utama antar model adalah jumlah dan fungsi kanal pengukuran:
- meter satu kanal mengekspos blok register Fasa A;
- meter dua kanal atau split-phase menggunakan blok kanal yang berlaku;
- meter tiga fasa mengekspos blok Fasa A, B, dan C;
- meter yang didukung juga dapat mengekspos nilai total dan pengukuran reaktif opsional.
Selalu validasi respons register terhadap model dan firmware yang tepat yang digunakan dalam proyek.
WEM3046T dan WEM3046TE
WEM3046T dan WEM3046TE mengukur keluaran sekunder 5 A dari current transformer (CT) eksternal.
Oleh karena itu, nilai arus, daya, dan energi di sisi primer harus menggunakan rasio CT eksternal yang berlaku. Kebutuhan penskalaan ini disebabkan oleh desain input CT 5 A pada meter; ini bukan perilaku Modbus TCP atau perilaku khusus platform tertentu.
Dokumentasikan dan uji pemrosesan rasio CT di mana pun model ini diintegrasikan.
3. Parameter Koneksi
Contoh resmi Modbus Poll dari IAMMETER menggunakan:
| Parameter | Contoh nilai |
|---|---|
| Koneksi | Modbus TCP/IP |
| Host | Alamat IP lokal meter |
| Port TCP | 502 |
| Device / Unit ID | 1 |
| Function code | 03 — Read Holding Registers |
| Response timeout | 1000 ms pada contoh |
Gunakan alamat IP LAN meter sebagai host. Memesan (reserve) alamat tersebut di router dapat mencegah integrasi terputus setelah alamat DHCP berubah.
Nilai di atas adalah parameter yang ditampilkan pada contoh resmi. Konfirmasi firmware dan konfigurasi lokasi yang sebenarnya sebelum meng-hard-code nilai tersebut di perangkat lunak produksi.
4. Uji Cepat dengan Modbus Poll
Untuk memastikan konektivitas sebelum mengonfigurasi platform lengkap:
- hubungkan komputer dan meter IAMMETER ke LAN yang sama;
- temukan alamat IP lokal meter;
- buat koneksi Modbus TCP/IP ke port
502; - atur Device ID ke
1; - pilih Function Code
03; - minta holding register mulai dari alamat
0; - bandingkan nilai mentah yang dikembalikan dengan aturan penskalaan di bawah ini.
Tangkapan layar menggunakan laju pemindaian tampilan 500 ms untuk pengujian. Untuk penggunaan normal, dokumentasi IAMMETER merekomendasikan polling per detik, bukan menjadikan pengaturan klien tercepat sebagai interval produksi yang didukung.
Jika koneksi gagal, periksa:
- apakah meter dan klien berada di jaringan yang sama dan dapat saling dijangkau;
- alamat IP meter;
- port TCP 502 dan aturan firewall;
- Device ID dan function code;
- apakah aplikasi lain sudah mengendalikan alur polling yang dimaksud;
- versi firmware meter.
5. Tipe Data Register dan Penskalaan
IAMMETER menggunakan holding register 16-bit.
Nilai 16-bit
Tegangan, arus, faktor daya, dan frekuensi menggunakan satu register:
| Pengukuran | Tipe mentah | Konversi |
|---|---|---|
| Tegangan | Unsigned 16-bit | V = raw / 100 |
| Arus | Unsigned 16-bit | A = raw / 100 |
| Faktor daya | Unsigned 16-bit | PF = raw / 1000 |
| Frekuensi | Unsigned 16-bit | Hz = raw / 100 |
Nilai 32-bit
Daya aktif, energi kumulatif, dan nilai reaktif menggunakan dua register yang berurutan.
Contoh resmi Modbus Poll menampilkan word 16-bit orde tinggi terlebih dahulu. Gabungkan word tersebut sebagai:
raw32 = (register[n] << 16) | register[n + 1]
Tafsirkan daya aktif dan daya reaktif sebagai nilai 32-bit bertanda. Tafsirkan penghitung pulsa energi kumulatif sebagai nilai 32-bit tanpa tanda.
| Pengukuran | Tipe mentah | Konversi |
|---|---|---|
| Daya aktif | Signed 32-bit | W = raw32 |
| Energi impor/forward | Unsigned 32-bit | kWh = raw32 / 800 |
| Energi ekspor/reverse | Unsigned 32-bit | kWh = raw32 / 800 |
| Daya reaktif | Signed 32-bit | var = raw32 |
| Energi reaktif induktif/kapasitif | Unsigned 32-bit | kvarh = raw32 / 1000 |
Daya aktif bertanda memungkinkan integrasi membedakan arah daya yang berlawanan. Konfirmasi konvensi tanda terhadap orientasi CT dan pengkabelan aplikasi saat commissioning.
6. Peta Register Modbus Inti
Alamat register di bawah ini adalah offset desimal. Klien harus menggunakan Function Code 03.
Fasa A
| Alamat | Panjang | Pengukuran | Konversi |
|---|---|---|---|
| 0 | 1 | Tegangan | Unsigned, /100 V |
| 1 | 1 | Arus | Unsigned, /100 A |
| 2 | 2 | Daya aktif | Signed, W |
| 4 | 2 | Energi impor/forward | Unsigned, /800 kWh |
| 6 | 2 | Energi ekspor/reverse | Unsigned, /800 kWh |
| 8 | 1 | Faktor daya | Unsigned, /1000 |
| 9 | 1 | Pengenal model pada peta lama | Jangan gunakan sebagai satu-satunya katalog model saat ini |
Fasa B
| Alamat | Panjang | Pengukuran | Konversi |
|---|---|---|---|
| 10 | 1 | Tegangan | Unsigned, /100 V |
| 11 | 1 | Arus | Unsigned, /100 A |
| 12 | 2 | Daya aktif | Signed, W |
| 14 | 2 | Energi impor/forward | Unsigned, /800 kWh |
| 16 | 2 | Energi ekspor/reverse | Unsigned, /800 kWh |
| 18 | 1 | Faktor daya | Unsigned, /1000 |
| 19 | 1 | Dicadangkan | Tidak digunakan |
Fasa C
| Alamat | Panjang | Pengukuran | Konversi |
|---|---|---|---|
| 20 | 1 | Tegangan | Unsigned, /100 V |
| 21 | 1 | Arus | Unsigned, /100 A |
| 22 | 2 | Daya aktif | Signed, W |
| 24 | 2 | Energi impor/forward | Unsigned, /800 kWh |
| 26 | 2 | Energi ekspor/reverse | Unsigned, /800 kWh |
| 28 | 1 | Faktor daya | Unsigned, /1000 |
| 29 | 1 | Dicadangkan | Tidak digunakan |
Frekuensi dan nilai total
| Alamat | Panjang | Pengukuran | Konversi |
|---|---|---|---|
| 30 | 1 | Frekuensi | Unsigned, /100 Hz |
| 31 | 1 | Dicadangkan | Tidak digunakan |
| 32 | 2 | Daya aktif total | Signed, W |
| 34 | 2 | Energi impor/forward total | Unsigned, /800 kWh |
| 36 | 2 | Energi ekspor/reverse total | Unsigned, /800 kWh |
Register total paling relevan untuk meter multi-kanal. Untuk integrasi satu kanal, gunakan nilai Fasa A yang berlaku dan validasi nilai total yang dikembalikan.
7. Register Reaktif Opsional
Register reaktif hanya tersedia jika pengukuran reaktif didukung dan diaktifkan oleh meter serta firmware yang berlaku.
| Alamat | Panjang | Pengukuran | Konversi |
|---|---|---|---|
| 38 | 2 | Daya reaktif Fasa A | Signed, var |
| 40 | 2 | Energi reaktif induktif Fasa A | Unsigned, /1000 kvarh |
| 42 | 2 | Energi reaktif kapasitif Fasa A | Unsigned, /1000 kvarh |
| 44 | 2 | Daya reaktif Fasa B | Signed, var |
| 46 | 2 | Energi reaktif induktif Fasa B | Unsigned, /1000 kvarh |
| 48 | 2 | Energi reaktif kapasitif Fasa B | Unsigned, /1000 kvarh |
| 50 | 2 | Daya reaktif Fasa C | Signed, var |
| 52 | 2 | Energi reaktif induktif Fasa C | Unsigned, /1000 kvarh |
| 54 | 2 | Energi reaktif kapasitif Fasa C | Unsigned, /1000 kvarh |
Jangan berasumsi nilai-nilai ini aktif pada setiap instalasi. Konfirmasi model, firmware, dan pengaturan pengukuran reaktif.
8. Register Informasi Perangkat
| Alamat | Panjang | Deskripsi |
|---|---|---|
| 56 | 8 | Nomor seri perangkat |
| 64 | 1 | Runtime dalam detik |
Perlakukan nomor seri dan pengenal perangkat lainnya sebagai data operasional. Hindari memublikasikan nilai yang belum dibersihkan (unsanitized) dalam tangkapan layar, log, atau contoh publik.
9. Contoh Integrasi
Home Assistant
Modbus TCP adalah opsi IAMMETER untuk Home Assistant bagi pengguna yang membutuhkan pembacaan lokal yang cepat dan otomasi.
Gunakan panduan integrasi IAMMETER Home Assistant sebagai pintu masuk utama HA. Panduan ini memisahkan konfigurasi di sisi meter dari konfigurasi Home Assistant dan menautkan ke metode implementasi Modbus terkini.
Video:
Node-RED
Node-RED dapat melakukan polling holding register, menormalkan nilai mentah, dan meneruskan hasil pengukuran ke alur otomasi, basis data, atau dasbor.
PLC, SCADA, EMS, dan BMS
Untuk integrasi industri atau komersial:
- dokumentasikan versi peta register yang digunakan;
- terapkan konversi signed/unsigned yang benar;
- validasi urutan byte dan word;
- konfirmasi orientasi CT dan rasio CT;
- tentukan perilaku timeout dan retry;
- pantau polling terakhir yang berhasil;
- hindari laju polling yang tidak didukung;
- uji gangguan jaringan dan pemulihannya.
Perangkat lunak khusus
Klien Modbus TCP khusus sebaiknya memisahkan:
- logika koneksi dan retry;
- pembacaan register;
- dekode 16-bit dan 32-bit;
- pemetaan model meter dan kanal;
- normalisasi rasio CT jika diperlukan;
- penyimpanan dan logika aplikasi.
10. Modbus TCP atau Antarmuka IAMMETER Lainnya?
| Kebutuhan | Antarmuka yang disarankan |
|---|---|
| Polling lokal per detik | Modbus TCP |
| Pengambilan JSON sederhana melalui LAN | Local HTTP API |
| Memublikasikan data ke banyak konsumen | MQTT |
| Meter mengunggah ke layanan web pelanggan | HTTP/HTTPS |
| Meter mengunggah ke server socket khusus | TCP/TLS |
| Perbandingan platform siap pakai | Panduan integrasi open-source |
Panduan terkait:
- API Lokal dan Antarmuka Terbuka IAMMETER
- Platform Pemantauan Energi Open-Source
- Kembangkan Sistem Pemantauan Energi Anda Sendiri
- Menggunakan IAMMETER Tanpa Internet atau Cloud
11. Firmware
Modbus TCP bukan lagi peningkatan eksperimental yang hanya dijelaskan oleh proses rilis tahun 2022. Untuk instalasi saat ini, gunakan firmware terbaru yang tersedia untuk model meter tersebut:
Catat versi firmware yang digunakan untuk memvalidasi peta register dan perilaku polling.
12. Informasi Rilis Lama
Artikel ini awalnya diterbitkan ketika dukungan Modbus TCP diperkenalkan melalui peningkatan firmware.
Instruksi lama menyebut firmware 75.68 sebagai prasyarat peningkatan versi dan meminta pengguna mengajukan permintaan peningkatan melalui sistem umpan balik. Proses tersebut hanya dipertahankan di sini sebagai konteks historis dan tidak boleh digunakan untuk instalasi baru.
Sumber rilis asli:
Terakhir diperbarui: 16 Juli 2026
