MQTT Energy Meter: Publikasikan Data IAMMETER ke MQTT Broker Anda

Publikasikan Data Energi IAMMETER ke MQTT Broker

Energy meter Wi-Fi IAMMETER dapat berfungsi sebagai MQTT energy meter dan memublikasikan data tegangan, arus, daya aktif, dan energi secara real-time langsung ke MQTT broker Anda sendiri. Ini memberikan cara yang lokal dan terbuka untuk mengintegrasikan IAMMETER dengan sistem pemantauan khusus, platform otomasi, atau Home Assistant.

Firmware IAMMETER terbaru memungkinkan Anda mengonfigurasi koneksi MQTT langsung dari WebUI lokal meter.

1. Konfigurasikan Publikasi MQTT

1.1 Pengaturan MQTT

Buka WebUI lokal meter dan masuk ke halaman Settings. Konfigurasikan koneksi MQTT menggunakan kolom seperti yang ditunjukkan di bawah ini:

Pengaturan	Konfigurasi
Run Mode	Pilih MQTT
Address	Masukkan alamat dan port MQTT broker
Username/Password	Masukkan kredensial broker; biarkan kosong hanya jika koneksi anonim diizinkan
HA MQTT Discovery	Aktifkan hanya untuk discovery otomatis Home Assistant
Real-time topic	device/{SN}/realtime

Setelah menyelesaikan pengaturan, klik Save. Meter akan terhubung ke broker yang dikonfigurasi dan memublikasikan data pengukurannya sebagai klien MQTT.

WebUI firmware terbaru mendukung pengaturan MQTT yang dijelaskan di atas. Tidak perlu mengonfigurasi username dan password broker melalui API lokal.

1.2 Kapan Mengaktifkan HA MQTT Discovery

HA MQTT Discovery hanya digunakan untuk discovery otomatis Home Assistant.

• Jika Anda memublikasikan data ke MQTT broker umum atau sistem pihak ketiga lainnya, biarkan HA MQTT Discovery nonaktif.
• Jika Home Assistant terhubung ke MQTT broker yang sama dan Anda ingin Home Assistant secara otomatis menemukan meter IAMMETER serta membuat entitas perangkat dan sensor yang sesuai, aktifkan HA MQTT Discovery.
• Mengaktifkan publikasi MQTT tidak mengharuskan Anda mengaktifkan HA MQTT Discovery. Keduanya adalah fungsi yang terkait tetapi terpisah.

Untuk prosedur discovery selengkapnya, lihat Aktifkan MQTT Discovery di Home Assistant dengan IAMMETER. Untuk membandingkan MQTT Discovery dengan metode integrasi Home Assistant IAMMETER lainnya, termasuk integrasi resmi, Modbus/TCP, dan konfigurasi MQTT manual, mulailah dari panduan integrasi IAMMETER Home Assistant.

2. Topik dan Payload MQTT

2.1 Berlangganan Topik Real-time

Topic: device/{SN}/realtime

Ganti {SN} dengan nomor seri meter IAMMETER Anda. Setelah meter berhasil terhubung ke MQTT broker, klien MQTT dapat berlangganan topik ini untuk menerima data pengukuran real-time.

2.2 Menafsirkan Payload JSON

Terlepas dari apakah meter dikonfigurasi untuk mengunggah data ke server pihak ketiga menggunakan HTTP/HTTPS, TCP/TLS, atau MQTT, maupun data pengukuran diambil melalui API lokal, format JSON pengukuran tetap konsisten.

Sebagai contoh, meter satu fasa memublikasikan array Data yang berisi tegangan, arus, daya aktif, energi aktif forward, dan energi aktif reverse:

{
  "method": "uploadsn",
  "mac": "B0F8932A295C",
  "version": "i.75.98.71y",
  "server": "em",
  "SN": "12345678",
  "Data": [228.91, 1.61, 225, 15066.47, 0]
}

Meter tiga fasa menggunakan array Datas dengan array pengukuran terpisah untuk fasa A, B, dan C. Lihat definisi lengkap data JSON IAMMETER sebelum mengurai payload di aplikasi pihak ketiga.

3. Panduan Terkait

• Tingkatkan ke firmware IAMMETER terbaru
• Aktifkan MQTT Discovery di Home Assistant dengan IAMMETER
• Format data JSON MQTT IAMMETER
• Cara lain mengintegrasikan IAMMETER dengan server pihak ketiga

4. Konfigurasi untuk Firmware Lama

Instruksi di bawah ini dipertahankan untuk meter yang masih menggunakan versi firmware lama dan tidak menyediakan opsi konfigurasi MQTT terkini di WebUI.

Jika WebUI meter Anda terlihat seperti tangkapan layar di bawah ini, ikuti prosedur lama ini. Sebagai alternatif, tingkatkan ke firmware terbaru dan gunakan prosedur WebUI pada Bagian 1.

4.1 Konfigurasi Perangkat Lama

Konfigurasikan mode upload dan alamat MQTT broker sebagai berikut:

• Run Mode: TCP
• TCP Address: mqtt://[URL server MQTT Anda]:[port]

4.2 Konfigurasi Username dan Password Lama

Konfigurasi username dan password memerlukan firmware i.75.97.5 atau yang lebih baru.

Dalam mode ini, energy meter Wi-Fi berfungsi sebagai klien MQTT dan mendukung metode autentikasi broker berikut:

1. Username dan password
2. Client ID, menggunakan nomor seri meter sebagai Client ID
3. Koneksi anonim

Pada firmware lama, atur username dan password MQTT melalui API lokal meter:

http://{IP lokal energy meter}/api/mqtt?user=laoliu&pwd=123456

Ganti laoliu dan 123456 dengan username dan password MQTT broker yang sebenarnya.

Catatan konfigurasi lama:

• Panjang maksimum username maupun password adalah 20 karakter.
• Karakter & tidak didukung pada username atau password.

Untuk mengambil pengaturan autentikasi MQTT yang berlaku saat ini, gunakan:

http://{IP lokal energy meter}/api/mqtt

API tidak mengembalikan password MQTT itu sendiri; API hanya mengembalikan panjang password.