Panduan Penyiapan Energy Meter Modbus TCP untuk Home Assistant

Integrasi Energy Meter Modbus TCP dengan Home Assistant

Modbus TCP adalah salah satu cara tercepat untuk menghubungkan energy meter ke Home Assistant. Protokol ini bekerja melalui jaringan lokal, tidak bergantung pada koneksi internet, dan cocok untuk pemantauan daya real-time, otomasi surplus surya, kontrol beban, serta Home Assistant Energy Dashboard.

Semua energy meter IAMMETER saat ini mendukung Modbus TCP. Anda dapat mengintegrasikannya dengan Home Assistant melalui dua cara:

1. Integrasi Modbus HACS IAMMETER — konfigurasi melalui UI, entitas dibuat secara otomatis, dan interval pemindaian dapat diatur.
2. Integrasi Modbus bawaan Home Assistant — konfigurasi YAML dengan kendali langsung atas register dan sensor.

Panduan ini menjelaskan perbedaannya dan membantu Anda memilih metode konfigurasi yang tepat.

HACS Modbus atau Modbus bawaan Home Assistant?

Kedua metode membaca data Modbus TCP lokal yang sama dari meter. Perbedaan utamanya terletak pada cara entitas Home Assistant dikonfigurasi.

Bagi sebagian besar pengguna, integrasi Modbus HACS adalah pilihan yang lebih sederhana. Gunakan integrasi Modbus bawaan Home Assistant saat Anda memerlukan daftar register kustom, skema penamaan entitas, aturan skala, atau interval polling tersendiri untuk setiap sensor.

Jika Anda tidak memerlukan pembaruan cepat, bandingkan alternatif HTTP dan MQTT di ringkasan integrasi energy meter Home Assistant.

Sebelum Anda memulai

Anda memerlukan:

• energy meter IAMMETER yang terhubung ke LAN yang sama dengan Home Assistant;
• alamat IP lokal meter;
• port TCP 502 yang dapat diakses antara Home Assistant dan meter;
• versi firmware meter yang terbaru;
• HACS yang sudah terpasang jika Anda memilih integrasi HACS IAMMETER.

Sebaiknya pesan alamat IP meter di router Anda. Alamat DHCP yang berubah adalah penyebab umum integrasi Modbus yang sebelumnya berjalan menjadi tidak tersedia di kemudian hari.

Metode 1: Konfigurasi Modbus IAMMETER melalui HACS

Integrasi Modbus HACS IAMMETER dirancang untuk pengguna yang menginginkan data lokal yang cepat tanpa harus mendefinisikan setiap register secara manual di YAML.

Langkah 1: Pasang integrasi

1. Buka HACS di Home Assistant.
2. Cari IamMeter Modbus.
3. Pasang rilis terbaru.
4. Mulai ulang Home Assistant jika diminta.

Informasi proyek dan rilis:

• Repositori IAMMETER HACS Modbus
• Rilis IAMMETER HACS Modbus

Gunakan rilis terbaru yang tersedia. Pengaturan interval pemindaian didukung oleh integrasi versi terbaru dan diteruskan ke DataUpdateCoordinator.

Langkah 2: Tambahkan meter di Home Assistant

1. Buka Settings → Devices & services.
2. Pilih Add integration.
3. Cari IamMeter Modbus.
4. Masukkan alamat IP meter dan port Modbus TCP.
5. Pilih jenis meter atau konfigurasi fasa yang sesuai.
6. Atur interval pemindaian, atau biarkan nilai default 3 detik.
7. Kirim formulir dan pastikan perangkat serta entitas berhasil dibuat.

Integrasi ini membuat jumlah entitas yang berbeda untuk meter satu fasa, dua kanal, dan tiga fasa. Daftar entitas yang lebih pendek bukan berarti model satu fasa memiliki dukungan Home Assistant yang terbatas.

Langkah 3: Periksa entitas

Buka perangkat IAMMETER di Settings → Devices & services. Bergantung pada modelnya, entitas yang tersedia dapat mencakup:

• tegangan;
• arus;
• daya aktif;
• faktor daya;
• energi impor;
• energi ekspor;
• daya reaktif atau energi reaktif jika disediakan oleh meter dan set register yang berlaku.

Entitas energi impor dan ekspor menggunakan kWh dan sudah menyertakan metadata energi Home Assistant yang dibutuhkan Energy Dashboard.

Langkah 4: Pilih interval pemindaian yang sesuai

Interval pemindaian default adalah 3 detik. Ini adalah titik awal yang praktis untuk dasbor langsung dan otomasi berbasis daya.

Rekomendasi titik awal:

Pengaturan satu detik adalah permintaan polling, bukan jaminan bahwa setiap dasbor Home Assistant akan terlihat menyegar satu kali per detik. Latensi jaringan, jumlah register, beban recorder, dan perilaku penyegaran frontend juga memengaruhi hasilnya.

Hindari polling yang terlalu agresif tanpa alasan. Untuk sebagian besar otomasi, pembaruan stabil setiap 2–5 detik lebih berguna daripada interval sesingkat mungkin.

Metode 2: Gunakan integrasi Modbus bawaan Home Assistant

Home Assistant menyertakan integrasi Modbus standar. Metode ini sepenuhnya lokal dan tidak memerlukan HACS, tetapi koneksi dan sensor didefinisikan di YAML.

Contoh berikut membaca tegangan dan daya aktif dari meter satu fasa:

modbus:
  - name: iammeter_hub
    type: tcp
    host: 192.168.1.6
    port: 502
    sensors:
      - name: IAMMETER Voltage
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 1
        unit_of_measurement: V
        device_class: voltage
        state_class: measurement
        scan_interval: 5

      - name: IAMMETER Active Power
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        scan_interval: 5

Ganti 192.168.1.6 dengan alamat IP meter yang sebenarnya. Periksa peta register yang berlaku sebelum menambahkan lebih banyak sensor:

• Peta register IAMMETER Modbus TCP
• Dokumentasi Home Assistant Modbus

Register Modbus IAMMETER yang umum

Alamat berikut menggambarkan blok fasa standar yang digunakan oleh meter IAMMETER pada umumnya. Selalu gunakan dokumentasi register terkini sebagai acuan resmi.

Gunakan skala, presisi, dan urutan kata (word order) yang didokumentasikan untuk setiap register. Jangan menyimpulkan skala energi dari contoh tegangan.

Setelah mengedit YAML:

1. jalankan pemeriksaan konfigurasi Home Assistant;
2. mulai ulang Home Assistant;
3. buka Developer tools → States;
4. pastikan entitas baru memiliki nilai dan satuan yang masuk akal.

Tambahkan energi impor dan ekspor ke Energy Dashboard

Home Assistant Energy Dashboard memerlukan entitas energi kumulatif, bukan daya sesaat.

Untuk sensor energi Modbus yang dikonfigurasi secara manual, sertakan metadata yang sesuai:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Lalu buka Settings → Dashboards → Energy dan pilih entitas energi impor sebagai konsumsi grid serta entitas energi ekspor sebagai pengembalian ke grid.

Jangan memilih entitas daya aktif dalam satuan watt untuk bidang energi di Energy Dashboard. Daya menunjukkan laju saat ini; kWh impor/ekspor mencatat energi kumulatif.

Model IAMMETER yang didukung

Semua energy meter IAMMETER saat ini mendukung HACS Modbus dan integrasi Modbus bawaan Home Assistant.

WEM3046T dan WEM3046TE mengukur keluaran sekunder 5 A dari current transformer eksternal. Untuk memperoleh arus, daya, dan energi aktual di sisi primer, rasio CT yang benar harus diterapkan. Ini adalah karakteristik sistem pengukuran CT 5 A, bukan keterbatasan kompatibilitas Home Assistant atau Modbus.

Bisakah Modbus dan IAMMETER Cloud berjalan bersamaan?

Ya. Home Assistant membaca Modbus TCP secara lokal sementara meter tetap dapat mengunggah data ke IAMMETER Cloud. Anda tidak perlu mengubah meter ke mode unggah MQTT untuk menggunakan Modbus.

Ini memberi Anda dua sudut pandang yang saling melengkapi:

• data lokal yang cepat dan otomasi di Home Assistant;
• laporan jangka panjang, analisis biaya listrik, analisis surya, dan akses jarak jauh di IAMMETER Cloud.

Hindari beberapa klien Modbus frekuensi tinggi

Gunakan satu klien polling Modbus TCP aktif per meter sebagai model penerapan yang aman. Jangan konfigurasikan Home Assistant, Node-RED, PLC, dan logger lain untuk melakukan polling ke meter yang sama secara mandiri dengan frekuensi tinggi.

Jika beberapa sistem memerlukan pengukuran live yang sama, biarkan satu sistem membaca Modbus lalu mendistribusikan datanya, atau gunakan arsitektur MQTT di mana beberapa konsumen berlangganan ke satu broker.

Pemecahan masalah

Home Assistant tidak dapat terhubung ke port 502

• Pastikan Home Assistant dan meter berada di jaringan yang sama dan dapat saling dijangkau.
• Verifikasi alamat IP meter dan pesan alamat tersebut di router.
• Periksa apakah port TCP 502 diblokir oleh firewall atau aturan VLAN.
• Pastikan tidak ada klien Modbus lain yang menahan atau berulang kali membuka ulang koneksi.

Entitas tidak tersedia atau nilainya tidak berubah

• Pastikan jenis meter/fasa yang dipilih pada integrasi HACS sudah benar.
• Pada konfigurasi YAML, verifikasi slave ID, alamat register, jenis data, skala, dan urutan kata.
• Tingkatkan interval pemindaian untuk sementara guna menyingkirkan kemungkinan polling yang terlalu agresif.
• Mulai ulang integrasi setelah mengubah alamat IP meter.

Nilai terlalu tinggi atau terlalu rendah secara tidak wajar

• Periksa skala register dan jenis datanya.
• Untuk WEM3046T/WEM3046TE, verifikasi rasio CT eksternal.
• Pastikan entitas tersebut sesuai dengan fasa atau kanal pengukuran yang diharapkan.

Entitas energi tidak muncul di Energy Dashboard

• Gunakan energi impor/ekspor kumulatif dalam kWh.
• Pastikan device_class: energy.
• Pastikan state_class: total_increasing.
• Jangan gunakan entitas daya dalam satuan watt.

Bangun otomasi dengan data daya real-time

Setelah entitas Modbus berfungsi, Home Assistant dapat menggunakan daya aktif atau daya ekspor ke grid untuk mengendalikan perangkat lain. Contohnya:

• mengendalikan relay dari data daya Modbus real-time;
• mengisi daya EV saat ekspor surya melewati ambang tertentu;
• memanaskan air dengan surplus surya yang tersedia;
• memberi notifikasi kepada pengguna saat kebutuhan rumah tangga melewati batas;
• mengurangi beban yang dapat dikendalikan sebelum mengimpor listrik berbiaya puncak yang mahal.

Jaga agar panduan integrasi ini tetap berfokus pada penyediaan data yang andal terlebih dahulu. Tambahkan logika kontrol hanya setelah memeriksa konvensi tanda, satuan, interval pembaruan, dan perilaku saat meter menjadi tidak tersedia.

Panduan Home Assistant terkait

• Bandingkan semua metode integrasi IAMMETER–Home Assistant
• Konfigurasikan energy meter dengan server MQTT
• Home Assistant MQTT Discovery untuk energy meter
• Pemantauan energi surya Home Assistant
• Home Assistant dan Grafana