Meter Energi Home Assistant: MQTT, Modbus TCP & IAMMETER

Integrasi Meter Energi Home Assistant: MQTT, Modbus TCP, dan IAMMETER-Link

Meter energi IAMMETER dapat diintegrasikan dengan Home Assistant melalui HTTP lokal, Modbus TCP, atau MQTT. Metode terbaik bergantung pada apakah Anda lebih menyukai integrasi resmi, penyiapan berbasis UI, pembaruan lokal yang cepat, penemuan otomatis MQTT, atau tetap menggunakan IAMMETER Cloud.

Panduan ini membandingkan metode yang tersedia dan mengarahkan Anda ke panduan penyiapan yang sesuai. Panduan ini mencakup semua meter energi IAMMETER saat ini. WEM3162 yang sudah dihentikan tidak disertakan.

Integrasi Home Assistant mana yang sebaiknya saya gunakan?

Metode	Penyiapan di sisi meter	Penyiapan Home Assistant	Interval pembaruan umum	Sepenuhnya lokal	IAMMETER Cloud pada saat yang sama	Penemuan otomatis	Paling cocok untuk
Home Assistant Core	Jaga meter tetap dapat diakses di LAN	Tambahkan integrasi bawaan IAMMETER di YAML	30 detik	Ya	Ya	Tidak	Pengguna yang lebih menyukai integrasi bawaan resmi
Home Assistant Modbus	Aktifkan Modbus TCP di LAN	Konfigurasikan integrasi Modbus bawaan dan sensor di YAML	Dapat dikonfigurasi; umumnya 1–5 detik	Ya	Ya	Tidak	Pemantauan cepat dan otomatisasi waktu nyata
MQTT Manual	Konfigurasikan broker MQTT di WebUI meter	Aktifkan integrasi MQTT dan tentukan sensor di YAML	Dapat dikonfigurasi; firmware terbaru mendukung hingga 2 detik	Ya, dengan broker lokal	Tidak	Tidak	Pengguna yang memerlukan topik dan sensor khusus
HACS HTTP	Jaga meter tetap dapat diakses di LAN	Pasang IAMMETER HTTP melalui HACS dan konfigurasikan di UI	60 detik	Ya	Ya	Dibantu SSDP	Penyiapan UI tanpa YAML
HACS Modbus	Aktifkan Modbus TCP di LAN	Pasang IAMMETER Modbus melalui HACS dan konfigurasikan di UI	Dapat dikonfigurasi; bawaan 3 detik	Ya	Ya	Dibantu SSDP	Pembaruan lokal cepat dengan konfigurasi UI
MQTT Discovery	Konfigurasikan broker dan aktifkan HA MQTT Discovery di WebUI meter	Aktifkan integrasi MQTT; sensor dibuat secara otomatis	Dapat dikonfigurasi; firmware terbaru mendukung hingga 2 detik	Ya, dengan broker lokal	Tidak	Ya	Penyiapan MQTT paling sederhana

Rekomendasi cepat:

• Pilih Home Assistant Core jika Anda menginginkan integrasi bawaan resmi dan interval pembaruan 30 detik sudah cukup.
• Pilih HACS HTTP jika Anda lebih menyukai konfigurasi UI dan tidak memerlukan pembaruan cepat.
• Pilih HACS Modbus jika Anda menginginkan konfigurasi UI dengan data lokal yang lebih cepat untuk dasbor dan otomatisasi.
• Pilih Home Assistant Modbus jika Anda nyaman dengan YAML dan menginginkan kendali penuh atas register, sensor, dan interval polling.
• Pilih MQTT Discovery jika Anda sudah menggunakan MQTT dan ingin Home Assistant membuat perangkat serta entitasnya secara otomatis.
• Pilih MQTT Manual jika Anda memerlukan kendali penuh atas topik MQTT, template, dan definisi entitas.

MQTT Manual dan MQTT Discovery mengubah mode unggah meter menjadi MQTT. Dalam mode ini, meter tidak mengunggah pengukuran ke IAMMETER Cloud secara bersamaan. Integrasi HTTP lokal dan Modbus TCP tetap dapat berfungsi saat meter mengunggah ke IAMMETER Cloud.

1. Integrasi resmi Home Assistant Core

Integrasi resmi IAMMETER sudah disertakan dalam Home Assistant dan membaca API HTTP lokal meter. Integrasi ini tidak memerlukan HACS atau koneksi internet antara Home Assistant dan meter.

Karakteristik utama:

• dikonfigurasi di configuration.yaml;
• polling HTTP lokal setiap 30 detik;
• dapat digunakan bersama IAMMETER Cloud;
• entitas energi impor dan ekspor menyertakan metadata yang diperlukan oleh Home Assistant Energy Dashboard;
• tidak ada penemuan perangkat otomatis.

Gunakan metode ini jika stabilitas dan dukungan resmi Home Assistant lebih penting daripada kecepatan pembaruan yang tinggi.

• Integrasi resmi IAMMETER di Home Assistant

2. Integrasi Modbus TCP Home Assistant

Integrasi Modbus bawaan Home Assistant membaca register Modbus TCP lokal meter. Integrasi ini cocok untuk otomatisasi berbasis daya, kontrol surplus surya, dan aplikasi lain yang membutuhkan pembaruan lebih cepat.

Karakteristik utama:

• dikonfigurasi di YAML;
• scan_interval dapat dikonfigurasi, umumnya 1–5 detik untuk otomatisasi waktu nyata;
• sepenuhnya lokal dan tidak bergantung pada internet;
• dapat digunakan bersama IAMMETER Cloud;
• memerlukan alamat register, tipe data, skala, dan metadata Energy Dashboard yang benar.

Gunakan interval polling yang lebih panjang bila data per detik tidak diperlukan. Hindari menjalankan beberapa klien Modbus frekuensi tinggi pada meter yang sama.

• Panduan meter energi Modbus TCP Home Assistant
• Peta register Modbus TCP IAMMETER

3. Integrasi HACS HTTP

Integrasi kustom IAMMETER HTTP menyediakan alternatif berbasis UI untuk integrasi YAML resmi. Integrasi ini membaca /monitorjson melalui jaringan lokal dan membuat entitas Home Assistant yang sesuai.

Karakteristik utama:

• dipasang melalui HACS;
• dikonfigurasi melalui UI Devices & Services Home Assistant;
• polling HTTP lokal setiap 60 detik;
• SSDP dapat membantu penemuan perangkat;
• kompatibel dengan IAMMETER Cloud dan Energy Dashboard.

Gunakan metode ini jika Anda lebih menyukai konfigurasi UI dan interval pembaruan satu menit sudah cukup.

• Integrasi IAMMETER HACS HTTP
• Panduan penyiapan HACS HTTP

4. Integrasi HACS Modbus

Integrasi kustom IAMMETER Modbus menggabungkan polling Modbus TCP lokal dengan konfigurasi UI Home Assistant. Ini adalah opsi paling praktis bagi pengguna yang membutuhkan pembaruan lebih cepat tetapi tidak ingin mendefinisikan setiap register di YAML.

Karakteristik utama:

• dipasang melalui HACS dan dikonfigurasi di UI;

• interval pemindaian dapat dikonfigurasi, dengan bawaan 3 detik pada integrasi yang diperbarui;

• operasi lokal dan kompatibilitas dengan IAMMETER Cloud;

• membuat entitas daya serta energi impor/ekspor dengan metadata Home Assistant yang sesuai;

• mendukung semua meter IAMMETER saat ini, dengan jumlah entitas yang berbeda untuk model satu fasa dan tiga fasa.

• Integrasi IAMMETER HACS Modbus

• Panduan penyiapan HACS Modbus

5. Integrasi MQTT Manual

Dalam mode MQTT Manual, meter memublikasikan data pengukuran ke broker MQTT Anda dan Anda menentukan sensor yang sesuai di Home Assistant.

Konfigurasi di sisi meter dan konfigurasi Home Assistant terpisah:

1. Konfigurasikan alamat broker, port, nama pengguna, dan kata sandi di WebUI meter terbaru.
2. Aktifkan integrasi MQTT di Home Assistant.
3. Tentukan sensor MQTT dan template JSON yang diperlukan di YAML.

Metode ini berguna bila beberapa aplikasi perlu berlangganan pengukuran yang sama, atau bila Anda memerlukan topik dan definisi entitas khusus.

• Konfigurasikan meter energi IAMMETER dengan server MQTT
• Penyiapan meter energi MQTT Manual untuk Home Assistant

6. Home Assistant MQTT Discovery

MQTT Discovery ditujukan bagi pengguna yang menginginkan konfigurasi manual seminimal mungkin. Setelah Anda mengonfigurasi broker dan mengaktifkan HA MQTT Discovery di WebUI meter, Home Assistant otomatis membuat perangkat IAMMETER dan entitasnya.

Entitas energi impor dan ekspor yang dihasilkan mencakup:

• unit_of_measurement: kWh;
• device_class: energy;
• state_class: total_increasing.

Atribut ini menyediakan metadata yang diperlukan untuk digunakan di Home Assistant Energy Dashboard.

MQTT Discovery didukung oleh semua meter energi IAMMETER saat ini. Model satu fasa dan tiga fasa membuat jumlah entitas yang berbeda sesuai saluran pengukurannya.

• Penyiapan Home Assistant MQTT Discovery
• Panduan IAMMETER MQTT Discovery
• Tingkatkan ke firmware IAMMETER terbaru

Meter energi IAMMETER yang didukung

Semua meter energi IAMMETER saat ini mendukung metode integrasi yang dijelaskan di atas. Perbedaan utama di Home Assistant adalah jumlah fasa atau saluran pengukuran, dan karenanya jumlah entitas yang dibuat.

Model	Aplikasi umum	Dukungan Home Assistant	Catatan penting
WEM3080	Pemantauan energi satu fasa	Semua metode	Entitas satu fasa
WEM2067	Pemantauan surya rumah satu fasa	Semua metode	Dua saluran pengukuran
WEM3080T	Pemantauan energi tiga fasa	Semua metode	Entitas tiga fasa
WEM3050T	Pemantauan rumah tiga fasa atau split-phase	Semua metode	Tiga saluran pengukuran
WEM3080TD	Aplikasi tiga fasa/tiga kabel dan pengkabelan khusus	Semua metode	Penafsiran entitas bergantung pada mode pengkabelan
WEM3046T / WEM3046TE	Pengukuran tiga fasa dengan CT 5 A eksternal	Semua metode	Terapkan rasio CT eksternal untuk mendapatkan nilai sisi primer

WEM3046T dan WEM3046TE mengukur keluaran sekunder 5 A dari transformator arus eksternal. Menerapkan rasio CT adalah persyaratan dari konfigurasi pengukuran ini, bukan keterbatasan kompatibilitas Home Assistant.

Gunakan entitas energi IAMMETER di Energy Dashboard

Energy Dashboard Home Assistant memerlukan entitas energi impor dan ekspor kumulatif dalam kWh, biasanya dengan:

• device_class: energy;
• state_class: total_increasing.

Integrasi Core, HACS HTTP, HACS Modbus, dan MQTT Discovery saat ini menyediakan metadata yang diperlukan untuk entitas energi impor/ekspornya. Dengan konfigurasi Modbus manual atau MQTT Manual, Anda harus menambahkan satuan, device class, dan state class yang benar sendiri.

Jangan gunakan entitas daya sesaat dalam watt sebagai pengganti entitas energi kumulatif dalam kWh.

Kirim data energi Home Assistant yang sudah ada ke IAMMETER Cloud

Metode di atas membawa data meter IAMMETER ke dalam Home Assistant. IAMMETER-Link bekerja ke arah sebaliknya: mengunggah entitas energi yang sudah ada di Home Assistant ke IAMMETER Virtual Meter dan IAMMETER Cloud.

Ini berguna bila inverter atau meter pihak ketiga sudah memiliki integrasi Home Assistant, tetapi Anda juga menginginkan dasbor, laporan, atau akses multi-situs IAMMETER Cloud.

IAMMETER-Link saat ini menyediakan:

• konfigurasi berbasis HACS dan UI;

• pemetaan meter virtual satu fasa dan tiga fasa;

• interval unggah 300 detik dengan IAMMETER Basic;

• interval unggah 60 detik dengan IAMMETER Pro.

• Hubungkan perangkat energi Home Assistant ke IAMMETER Cloud

• Repositori GitHub IAMMETER-Link

Contoh pemantauan energi Home Assistant

Setelah meter terintegrasi, data daya waktu nyata dan energi kumulatifnya dapat digunakan untuk:

• pemantauan pembangkitan surya, konsumsi rumah tangga, dan impor/ekspor jaringan;
• kontrol relai waktu nyata menggunakan Modbus TCP;
• dasbor Home Assistant dan Grafana;
• pengisian kendaraan listrik dengan surplus surya;
• pemanasan air dengan surplus surya.

Butuh bantuan?

Jika Anda memiliki pertanyaan tentang firmware, konfigurasi entitas, penyiapan Energy Dashboard, atau memilih metode integrasi, kunjungi forum komunitas IAMMETER.