Kirim Data Energi Home Assistant ke Cloud | IAMMETER-Link

Kirim Data Energi Home Assistant ke Cloud dengan IAMMETER-Link

Jika sebuah inverter, meter listrik, sistem baterai, atau perangkat energi lain sudah menyediakan entitas sensor di Home Assistant, IAMMETER-Link dapat mengunggah nilai tersebut ke IAMMETER Virtual Meter untuk dasbor cloud, akses jarak jauh, dan analisis energi.

Dengan cara ini Home Assistant berperan sebagai jembatan kompatibilitas:

Perangkat energi → entitas Home Assistant → IAMMETER-Link → Virtual Meter → IAMMETER Cloud

Perangkat sumber tidak harus berupa meter IAMMETER. Perangkat tersebut bisa berupa perangkat apa pun yang sudah diintegrasikan Home Assistant, asalkan entitasnya menyediakan pengukuran energi yang valid dan skalanya benar.

IAMMETER-Link berguna ketika Anda ingin menggabungkan kompatibilitas perangkat Home Assistant yang luas dengan layanan pemantauan energi dan surya dari IAMMETER Cloud.

Apa yang dilakukan IAMMETER-Link—dan apa yang tidak

IAMMETER-Link membaca entitas terpilih dari Home Assistant dan mengunggah nilai aktualnya ke IAMMETER Virtual Meter.

IAMMETER-Link dapat memetakan nilai seperti:

• tegangan dalam V;
• arus dalam A;
• daya aktif dalam W;
• energi impor dalam kWh;
• energi ekspor dalam kWh;
• status pengisian baterai (state of charge) jika didukung oleh model data yang dikonfigurasi.

IAMMETER-Link tidak:

• membaca meter perangkat keras IAMMETER secara langsung melalui HTTP, Modbus, atau MQTT;
• menciptakan pengukuran energi yang belum ada dari entitas daya yang tidak terkait;
• mengubah IAMMETER Cloud menjadi layanan yang sepenuhnya lokal;
• menggantikan integrasi Home Assistant asli untuk perangkat sumber.

Untuk menghubungkan meter perangkat keras IAMMETER ke Home Assistant, gunakan panduan integrasi meter energi Home Assistant. IAMMETER-Link mengirim data ke arah sebaliknya.

Kapan pemantauan energi cloud melalui Home Assistant berguna

Inverter pihak ketiga sudah ada di Home Assistant

Banyak inverter sudah menyediakan daya pembangkitan dan energi kumulatif melalui integrasi Home Assistant. IAMMETER-Link dapat memetakan entitas tersebut ke sebuah Virtual Meter sehingga data inverter dapat dilihat di IAMMETER Cloud tanpa perlu menambahkan meter fisik kedua hanya untuk transfer data.

Data grid dan inverter berasal dari integrasi berbeda

Contohnya:

• sebuah meter IAMMETER memantau impor/ekspor grid;
• integrasi inverter pihak ketiga menyediakan pembangkitan PV di Home Assistant;
• IAMMETER-Link mengunggah entitas inverter tersebut sebagai Virtual Meter;
• IAMMETER Cloud menampilkan data sisi grid dan sisi inverter dalam alur pemantauan surya.

Hal ini sangat berguna ketika satu platform tidak berkomunikasi secara native dengan setiap merek inverter.

Diperlukan akses jarak jauh atau multi-lokasi

Home Assistant dapat tetap menjadi pusat integrasi lokal di setiap instalasi, sementara pengukuran energi terpilih dikirim ke IAMMETER Cloud untuk dasbor jarak jauh dan analisis jangka panjang.

Struktur lokasi dan Virtual Meter harus direncanakan sebelum penerapan. Jangan memetakan beberapa sistem independen ke nomor seri Virtual Meter yang sama.

Persyaratan

Sebelum instalasi, pastikan Anda memiliki:

• instalasi Home Assistant yang berjalan normal;
• entitas sumber yang stabil untuk pengukuran yang dibutuhkan;
• akses internet dari Home Assistant ke IAMMETER Cloud;
• akun IAMMETER Cloud;
• nomor seri IAMMETER Virtual Meter;
• HACS, kecuali Anda memilih instalasi custom component secara manual.

Repositori IAMMETER-Link:

• Repositori GitHub
• Rilis terbaru v1.1.1

Rilis v1.1.1 menyertakan logika unggah yang dioptimalkan serta penanganan status pengisian baterai.

Interval unggah: Basic dan Pro

Interval unggah bergantung pada tingkat layanan IAMMETER Cloud:

IAMMETER-Link ditujukan untuk pelaporan cloud dan pemantauan jarak jauh, bukan untuk loop kontrol beresolusi detik. Pertahankan otomasi cepat di dalam Home Assistant menggunakan entitas lokal asli.

Contohnya:

• gunakan entitas daya Modbus atau MQTT lokal untuk otomasi 2–5 detik;
• gunakan IAMMETER-Link untuk pembaruan dan analisis Cloud setiap satu atau lima menit.

Langkah 1: Instal IAMMETER-Link

Instal dengan HACS

1. Pastikan HACS sudah terpasang.
2. Tambahkan https://github.com/lewei50/ha_iammeter_link sebagai Integration pada repositori kustom HACS jika belum tersedia.
3. Cari dan instal IAMMETER-Link.
4. Mulai ulang Home Assistant bila diperlukan.

Tambahkan integrasi

Buka:

Settings → Devices & services → Add integration

Cari IAMMETER-Link lalu mulai Config Flow.

Langkah 2: Masuk dan pilih Virtual Meter

Masukkan informasi akun IAMMETER Cloud Anda selama proses penyiapan. Jika Anda belum memiliki akun, ikuti opsi pendaftaran yang disediakan oleh alur konfigurasi.

Jika akun tersebut sudah memiliki Virtual Meter yang tersedia, pilih nomor serinya. Jika tidak, ajukan atau buat Virtual Meter yang sesuai melalui alur kerja IAMMETER Cloud yang tersedia.

Perlakukan nomor seri Virtual Meter sebagai identitas tujuan untuk aliran data ini. Hindari mengonfigurasi beberapa klien pengunggah untuk menulis sistem yang berbeda ke Virtual Meter yang sama.

Langkah 3: Pilih satu fase atau tiga fase

Pilih struktur yang sesuai dengan data sumber:

• Single Phase untuk satu kelompok tegangan, arus, daya, Import kWh, dan Export kWh;
• Three Phase untuk pemetaan entitas A, B, dan C yang terpisah.

Untuk data tiga fase, tentukan peran dan pemetaan setiap fase dengan cermat. IAMMETER Cloud menggunakan struktur ini saat menampilkan dan menganalisis nilai yang diunggah.

Jangan memilih tiga fase hanya karena terdapat beberapa sensor di Home Assistant. Entitas tersebut harus mewakili fase listrik atau kanal pengukuran yang sesuai.

Langkah 4: Petakan entitas Home Assistant

IAMMETER-Link memetakan ID entitas Home Assistant ke field Virtual Meter.

Pemetaan satu fase

Pemetaan tiga fase

Petakan field yang sama secara terpisah untuk fase A, B, dan C.

Field yang tidak digunakan dapat diisi 0. Namun, jika sebuah field dipetakan ke entitas dan entitas tersebut tidak dapat dibaca dengan benar saat runtime, proses unggah dapat berhenti. Petakan hanya entitas yang sudah terbukti stabil.

Validasi setiap entitas sebelum pemetaan

Buka Developer tools → States di Home Assistant dan pastikan:

1. entitas tersebut ada;
2. statusnya berupa angka;
3. satuannya benar;
4. nilainya memiliki tanda (positif/negatif) yang diharapkan;
5. entitas tetap tersedia setelah Home Assistant dimulai ulang;
6. energi kumulatif tidak berperilaku seperti daya sesaat.

Daya harus dalam satuan watt

Jika sumber melaporkan dalam kW, buat sensor hasil konversi yang sesuai atau gunakan entitas dengan skala yang benar sebelum pemetaan. Jangan memberi label nilai kW sebagai W tanpa mengalikannya dengan 1.000.

Energi harus berupa kWh kumulatif

Field Import dan Export biasanya harus menggunakan entitas kWh kumulatif. Sensor energi harian yang direset pada tengah malam memiliki makna berbeda dari total seumur pakai dan dapat mengacaukan analisis Cloud jika diperlakukan sebagai energi total.

Pastikan arah impor/ekspor

Berbagai integrasi menggunakan istilah seperti import, consumption, feed-in, return, export, bought, atau sold. Pastikan arah yang diwakili setiap entitas sebelum memetakannya.

Jangan mengarang pengukuran yang tidak tersedia

Jika integrasi inverter menyediakan pembangkitan PV tetapi tidak menyediakan impor/ekspor grid, petakan field pembangkitan yang tersedia ke peran Virtual Meter yang sesuai. Jangan menggunakan entitas daya yang sama sebagai daya pembangkitan sekaligus daya grid hanya demi mengisi semua field.

Langkah 5: Verifikasi data yang diunggah di IAMMETER Cloud

Setelah konfigurasi selesai, tunggu interval unggah Basic atau Pro yang berlaku, lalu buka IAMMETER Cloud.

Periksa:

• Virtual Meter berstatus online;
• tegangan, arus, dan daya memiliki besaran yang masuk akal;
• Import dan Export tidak tertukar;
• fase A/B/C muncul dalam urutan yang diharapkan;
• energi kumulatif bertambah dengan benar;
• stempel waktu terus diperbarui;
• grafik surya atau beban sesuai dengan riwayat Home Assistant sumbernya.

Bandingkan beberapa stempel waktu antara Home Assistant dan IAMMETER Cloud sebelum mengandalkan laporan.

Contoh pemantauan surya

Misalkan sebuah instalasi memiliki:

• meter IAMMETER tiga fase yang mengukur grid;
• inverter tiga fase yang sudah terintegrasi ke Home Assistant;
• tidak ada koneksi data langsung yang didukung antara inverter tersebut dan IAMMETER Cloud.

IAMMETER-Link dapat mengirim entitas daya dan energi inverter dari Home Assistant ke Virtual Meter tiga fase. IAMMETER Cloud kemudian dapat menggunakan:

• meter fisik untuk interaksi dengan grid;
• Virtual Meter untuk produksi inverter;
• kedua sumber data tersebut dalam tampilan pemantauan surya yang lebih luas.

Lihat solusi pemantauan surya IAMMETER dan pemantauan surya Home Assistant untuk kasus penggunaan terkait.

Pemecahan masalah

Tidak ada data yang muncul setelah penyiapan

• Pastikan Home Assistant memiliki akses internet.
• Verifikasi akun IAMMETER Cloud dan nomor seri Virtual Meter.
• Tunggu hingga interval unggah Basic atau Pro terpenuhi sepenuhnya.
• Periksa log Home Assistant untuk mencari error IAMMETER-Link.
• Pastikan setiap entitas yang dipetakan ada dan mengembalikan nilai numerik.

Unggahan berhenti setelah sebelumnya berjalan normal

• Cari entitas yang dipetakan yang menjadi unknown atau unavailable.
• Periksa apakah pembaruan integrasi mengubah nama ID entitas.
• Pastikan sensor template masih menghasilkan angka.
• Tinjau error autentikasi dan jaringan.
• Perbarui ke rilis IAMMETER-Link terbaru.

Nilai 1.000 kali terlalu besar atau terlalu kecil

• Periksa W versus kW.
• Periksa kWh versus Wh.
• Periksa konversi template apa pun yang diterapkan di Home Assistant.
• Pastikan rasio CT eksternal pada sistem metering sumber.

Import dan Export tertukar

• Verifikasi konvensi penamaan integrasi sumber.
• Bandingkan nilainya saat lokasi jelas-jelas sedang mengimpor dari atau mengekspor ke grid.
• Perbaiki pemetaan entitas, bukan mengompensasinya di laporan Cloud.

Grafik tiga fase terlihat salah

• Pastikan pemetaan A/B/C dan peran tiap fase.
• Verifikasi bahwa setiap entitas memang milik fase yang dimaksud.
• Jangan mencampur daya total dengan field khusus per fase.

Kontrol lokal dan pelaporan Cloud harus tetap terpisah

IAMMETER-Link bergantung pada Home Assistant, akses internet, dan IAMMETER Cloud. IAMMETER-Link tidak boleh menjadi jalur umpan balik untuk otomasi yang kritis terhadap keselamatan atau otomasi beresolusi detik.

Gunakan entitas lokal Home Assistant untuk:

• kontrol relay;
• peralihan kelebihan daya surya (solar-surplus switching);
• keputusan pengisian EV;
• alarm yang memerlukan respons segera.

Gunakan IAMMETER-Link dan IAMMETER Cloud untuk:

• visibilitas jarak jauh;
• dasbor jangka panjang;
• analisis biaya listrik dan energi;
• menggabungkan sumber energi terpilih;
• peninjauan operasional multi-lokasi.

Panduan terkait

• Repositori GitHub IAMMETER-Link
• IAMMETER-Link v1.1.1
• IAMMETER Virtual Meter
• IAMMETER Cloud
• Bandingkan integrasi meter energi Home Assistant
• Matriks integrasi Home Assistant

Diperbarui: 22 Juli 2026.