Home Assistant MQTT Discovery untuk Meter Energi

Home Assistant MQTT Discovery untuk Meter Energi

Home Assistant MQTT Discovery memungkinkan meter energi membuat entitas perangkat dan sensornya secara otomatis. Setelah meter dan Home Assistant terhubung ke broker MQTT yang sama, Home Assistant dapat menemukan meter tersebut tanpa YAML sensor MQTT manual.

IAMMETER mendukung MQTT Discovery pada semua meter energi saat ini. Tergantung modelnya, Home Assistant membuat entitas untuk tegangan, arus, daya aktif, energi impor, energi ekspor, serta pengukuran fasa atau kanal lain yang tersedia.

Gunakan metode ini jika Anda menginginkan:

• pemantauan energi MQTT lokal;
• pembuatan perangkat dan entitas secara otomatis;
• pembaruan yang lebih cepat daripada integrasi HTTP;
• entitas energi impor/ekspor yang kompatibel dengan Dasbor Energi;
• konfigurasi Home Assistant yang minimal.

Jika Anda memerlukan kendali penuh atas topik, template, nama entitas, dan metadata, gunakan panduan MQTT manual untuk meter energi.

MQTT Discovery versus MQTT Manual

Kedua metode memerlukan broker MQTT, tetapi hanya Discovery yang otomatis membuat entitas Home Assistant.

Jangan mengaktifkan Discovery sekaligus mendefinisikan pengukuran yang sama secara manual, kecuali Anda memang menginginkan dua kumpulan entitas yang terpisah.

Persyaratan

Anda memerlukan:

• meter energi IAMMETER dengan firmware i.76.058.8 atau lebih baru;
• broker MQTT yang dapat dijangkau oleh meter dan Home Assistant;
• alamat, port, nama pengguna, dan kata sandi broker;
• Home Assistant dengan Integrasi MQTT yang aktif.

Firmware i.76.058.8 adalah baseline rilis stabil untuk MQTT Discovery. Citra i.76.02 sebelumnya adalah firmware uji dan tidak boleh lagi dipasang atau ditautkan sebagai versi yang direkomendasikan.

Untuk perbaikan terkini dan opsi MQTT terbaru, tingkatkan ke firmware IAMMETER terbaru.

Langkah 1: Hubungkan Home Assistant ke broker MQTT

Jika Home Assistant belum terhubung ke broker:

1. Buka Pengaturan → Perangkat & layanan.
2. Pilih Tambahkan integrasi.
3. Cari MQTT.
4. Masukkan alamat, port, nama pengguna, dan kata sandi broker.
5. Pastikan Integrasi MQTT berhasil terhubung.

Jika Home Assistant sudah menggunakan broker yang dimaksud, pertahankan Integrasi MQTT yang ada. Jangan membuat koneksi broker kedua untuk perangkat IAMMETER.

MQTT Discovery aktif secara default pada penyiapan MQTT Home Assistant yang normal. Jika discovery dinonaktifkan atau digunakan prefiks discovery non-default, pastikan meter dan Home Assistant memakai pengaturan yang kompatibel.

Langkah 2: Konfigurasikan MQTT Discovery di WebUI meter

Buka WebUI lokal meter dan masuk ke Pengaturan. Konfigurasikan:

Simpan pengaturan dan biarkan meter melakukan reboot atau menyambung ulang.

Firmware terbaru menampilkan pengaturan yang diperlukan di WebUI. Tidak perlu memanggil endpoint historis /api/mqttha?x=1.

Opsi HA MQTT Discovery khusus untuk penemuan otomatis Home Assistant. Untuk broker umum, sistem kustom, flow Node-RED, atau konfigurasi MQTT Manual, biarkan nonaktif dan gunakan format publikasi MQTT standar meter sebagai gantinya.

Langkah 3: Pastikan Home Assistant menemukan meter

Setelah meter terhubung ke broker:

1. Buka Pengaturan → Perangkat & layanan → MQTT.
2. Cari perangkat IAMMETER yang baru ditemukan.
3. Buka perangkat dan tinjau entitasnya.
4. Pastikan nilai tegangan, arus, daya, dan energi masuk akal.
5. Periksa bahwa jumlah fasa atau kanal pengukuran yang diharapkan sudah ada.

Konfigurasi discovery dan status pengukuran dikirim melalui topik MQTT yang berbeda. Home Assistant menggunakan konfigurasi discovery untuk membuat entitas, lalu memperbarui nilainya saat pesan status diterima.

Jika perangkat tidak muncul, lakukan restart hanya setelah memeriksa koneksi broker dan topiknya. Restart Home Assistant tidak dapat memperbaiki alamat broker yang salah atau kredensial MQTT yang ditolak.

Dukungan Dasbor Energi

Payload MQTT Discovery IAMMETER saat ini menyertakan metadata yang diperlukan untuk entitas energi impor dan ekspor:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER menggunakan kunci MQTT Discovery ringkas yang sesuai dengan bidang tersebut, termasuk:

{
  "unit_of_meas": "kWh",
  "dev_cla": "energy",
  "stat_cla": "total_increasing"
}

Setelah entitas menerima data yang valid:

1. buka Pengaturan → Dasbor → Energi;
2. pilih entitas energi impor untuk konsumsi dari grid;
3. pilih entitas energi ekspor untuk pengiriman ke grid;
4. simpan konfigurasi Dasbor Energi.

Jangan memilih entitas daya aktif sesaat dalam satuan watt untuk bidang energi. Dasbor Energi memerlukan kWh kumulatif.

Model satu fasa dan tiga fasa membuat entitas energi yang berbeda. Pilih entitas yang sesuai dengan pengkabelan meter dan cara pemasangan mengukur impor/ekspor grid.

Pilih interval pembaruan MQTT

Firmware IAMMETER terbaru mendukung pembaruan MQTT hingga 2 detik. Interval yang lebih pendek memberi Home Assistant pembacaan daya yang lebih segar, tetapi juga menghasilkan lalu lintas broker, pembaruan entitas, dan data recorder yang lebih banyak.

Titik awal yang disarankan:

Gunakan interval terpendek hanya jika otomasi memperoleh manfaat darinya. Total Dasbor Energi umumnya tidak memerlukan pembaruan dua detik.

Kompatibilitas IAMMETER Cloud

MQTT Discovery mengubah Run Mode meter menjadi MQTT. Meter mengirim pengukurannya ke broker yang dikonfigurasi dan tidak sekaligus mengunggahnya ke IAMMETER Cloud.

Jika Anda memerlukan Home Assistant dan IAMMETER Cloud dari meter yang sama, pilih integrasi HTTP lokal atau Modbus TCP. Metode tersebut membaca meter secara lokal sementara unggahan Cloud normalnya tetap berjalan.

Bandingkan opsi-opsinya di ikhtisar integrasi meter energi Home Assistant.

Model IAMMETER yang didukung

Semua meter energi IAMMETER saat ini mendukung MQTT Discovery. Perbedaan utamanya adalah jumlah fasa/kanal dan karenanya jumlah entitas yang dibuat.

WEM3046T dan WEM3046TE mengukur keluaran sekunder 5 A dari transformator arus eksternal. Rasio CT yang benar harus diterapkan untuk memperoleh arus, daya, dan energi sisi primer. Ini adalah persyaratan sistem pengukuran, bukan keterbatasan Home Assistant atau MQTT Discovery.

WEM3162 yang sudah dihentikan tidak termasuk dalam cakupan kompatibilitas saat ini.

Pemecahan masalah MQTT Discovery

Home Assistant tidak menemukan meter

• Pastikan meter dan Home Assistant menggunakan broker yang sama.
• Periksa alamat, port, nama pengguna, dan kata sandi broker.
• Pastikan HA MQTT Discovery aktif di WebUI meter.
• Periksa log broker untuk koneksi yang ditolak atau kesalahan otorisasi.
• Verifikasi bahwa Integrasi MQTT Home Assistant sudah terhubung.
• Berlangganan prefiks discovery Home Assistant pada broker dengan klien MQTT dan periksa apakah pesan konfigurasi ada.

Perangkat muncul, tetapi entitas tidak tersedia

• Pastikan meter tetap memublikasikan pesan status setelah konfigurasi discovery.
• Periksa apakah firewall, VLAN, atau ACL broker mengizinkan topik discovery maupun topik status.
• Verifikasi bahwa meter tidak beralih ke broker lain.
• Tingkatkan ke firmware terbaru lalu sambungkan ulang.

Energi impor/ekspor tidak dapat dipilih di Dasbor Energi

• Pastikan entitas sudah menerima nilai kWh numerik yang valid.
• Buka Alat pengembang → States dan periksa unit, device class, serta state class-nya.
• Hapus entitas usang yang dibuat oleh firmware uji awal sebelum mengevaluasi payload discovery saat ini.
• Pastikan Anda memilih entitas energi, bukan entitas daya aktif.

Entitas MQTT ganda muncul

Duplikat biasanya terjadi ketika:

• YAML MQTT manual dan MQTT Discovery keduanya aktif;
• nomor seri meter atau ID unik discovery berubah;
• firmware awal memublikasikan konfigurasi discovery yang berbeda;
• topik discovery retained dari konfigurasi lama masih tersisa di broker.

Pilih salah satu, MQTT Manual atau MQTT Discovery, untuk pengukuran yang sama, lalu hapus konfigurasi usang tersebut.

Hapus entitas Discovery retained yang lama

Pesan konfigurasi MQTT Discovery umumnya disimpan (retained) oleh broker agar Home Assistant dapat membuat ulang entitas setelah restart. Jika topik konfigurasi lama masih tersisa, menghapus perangkat hanya melalui UI Home Assistant mungkin tidak cukup—entitas dapat muncul kembali saat konfigurasi retained diterima lagi.

Prosedur pembersihan yang aman:

1. Nonaktifkan HA MQTT Discovery pada meter atau putuskan sementara agar meter tidak langsung memublikasikan ulang konfigurasi lama.
2. Gunakan klien MQTT untuk memeriksa prefiks discovery Home Assistant, biasanya homeassistant/#.
3. Identifikasi hanya topik konfigurasi milik nomor seri/perangkat IAMMETER yang terdampak.
4. Publikasikan payload retained kosong ke setiap topik konfigurasi usang.
5. Hapus perangkat/entitas usang dari Home Assistant jika masih tersisa.
6. Aktifkan kembali Discovery pada firmware terkini.
7. Pastikan satu perangkat dan entitas terkini yang diharapkan sudah dibuat.

Jangan menghapus seluruh pohon topik retained homeassistant/# pada broker bersama. Tindakan itu dapat menghapus konfigurasi discovery untuk perangkat lain yang tidak terkait.

Kapan MQTT Manual menjadi pilihan yang lebih baik

Gunakan MQTT Manual sebagai gantinya jika Anda memerlukan:

• nama entitas dan ID unik khusus;
• template atau perhitungan JSON khusus;
• hanya sebagian pengukuran terpilih;
• struktur topik yang dipakai bersama aplikasi non-Home Assistant;
• kendali eksplisit atas device class dan state class;
• kompatibilitas dengan sistem yang sengaja menonaktifkan Home Assistant Discovery.

Panduan terkait

• Konfigurasi MQTT manual meter energi untuk Home Assistant
• Publikasikan data IAMMETER ke broker MQTT
• Bandingkan semua metode integrasi IAMMETER–Home Assistant
• Tingkatkan ke firmware IAMMETER terbaru
• Dokumentasi MQTT Home Assistant

Diperbarui: 19 Juli 2026.