IAMMETER Menambahkan Dukungan SunSpec Modbus/TCP: Panduan Pemetaan Model dan Integrasi

IAMMETER firmware i.91.065.18 menambahkan peta model meter integer SunSpec yang hanya-baca ke layanan Modbus/TCP yang sudah ada. Fitur ini memberi perangkat lunak yang memahami model SunSpec cara standar untuk menemukan meter IAMMETER dan membaca nilai kelistrikan tertentu melalui jaringan lokal.

Ini adalah penambahan antarmuka, bukan penggantian sistem pengukuran. Meter tetap mengumpulkan data dengan cara yang sama. Register Modbus IAMMETER yang ada, HTTP API, payload MQTT, dan pengaturan NEM tetap tidak berubah.

SunSpec mendefinisikan model informasi perangkat standar yang dapat dipetakan ke register holding Modbus. Petanya dimulai dengan penanda SunS, diikuti model Common dan model khusus perangkat yang dapat ditemukan klien dengan membaca ID dan panjang setiap model secara berurutan. Paket spesifikasi SunSpec Modbus mendokumentasikan pola penemuan model, termasuk lokasi peta Modbus berbasis 0 dan aturan nilai yang tidak diimplementasikan. SunSpec Modbus digunakan di berbagai integrasi energi terdistribusi, termasuk meter, inverter, dan peralatan penyimpanan.

IAMMETER mengimplementasikan subset terfokus yang hanya-baca untuk data meter. Firmware ini belum diajukan untuk sertifikasi SunSpec. Jangan menganggap fitur ini sebagai sertifikasi, kesesuaian SunSpec penuh, atau jaminan bahwa setiap klien SunSpec pihak ketiga akan berfungsi tanpa konfigurasi.

Model IAMMETER yang didukung dan pemetaan meter

Untuk WEM2067, Model 202 merepresentasikan instalasi split phase yang sesungguhnya. Model ini tidak menggambarkan dua sirkuit satu fase yang tidak berhubungan sebagai susunan kelistrikan yang sama.

Kode untuk Model 204 memiliki cakupan pengujian host, tetapi firmware belum mendeteksi dan memilihnya secara otomatis untuk WEM3080TD. Karena itu, artikel ini tidak mengklaim ketersediaan Model 204. WEM3046TE juga belum menerima verifikasi identifikasi model khusus. Rilis pertama hanya menyediakan model integer: model float 211 hingga 214 tidak tersedia.

Apa yang dapat dibaca klien

Model meter integer mengekspos tegangan fase, arus fase, daya aktif fase, daya aktif total, frekuensi, faktor daya fase, serta akumulator energi aktif impor/ekspor per fase dan total. Model Common menyediakan data identifikasi perangkat seperti model, versi firmware, dan nomor seri.

Energi direpresentasikan dalam Wh pada peta SunSpec; faktor daya direpresentasikan sebagai persentase. Titik energi total menggunakan kembali bidang total meter yang ada dan semantik NEM. IAMMETER tidak menghitung ulang total tiga fase dengan menjumlahkan akumulator fase dalam pemetaan ini. Karena pengaturan NEM memengaruhi makna akumulator tersebut, klien tidak boleh mengasumsikan bahwa energi total selalu sama dengan jumlah energi fase.

Beberapa bidang sengaja tidak ada pada versi pertama ini: daya reaktif dan energi reaktif, daya semu dan energi semu, faktor daya total multi-fase, serta event flag. Lokasi standarnya tetap ada di dalam model dan mengembalikan penanda tidak tersedia yang sesuai. Klien SunSpec harus mengenali nilai yang tidak tersedia, bukan menafsirkannya sebagai hasil pengukuran.

Interpretasi tegangan itu penting

Nilai fase berasal dari meter. Beberapa titik tegangan line diturunkan untuk pemetaan model:

• Tegangan line Model 202 adalah UA + UB.
• Tegangan line Model 203 adalah pendekatan tegangan fase dikalikan √3; ini bukan pengukuran langsung antar-fase (line-to-line). Sistem yang tidak seimbang atau penyimpangan sudut fase dapat menimbulkan galat.

Perbedaan ini penting bagi aplikasi yang memerlukan tegangan line-to-line yang diukur secara langsung. Periksa definisi titik model dan susunan koneksi sebelum menggunakan nilai turunan untuk keputusan kontrol atau kepatuhan.

Menghubungkan dengan Modbus/TCP

Aktifkan layanan Modbus/TCP meter yang ada, lalu hubungkan ke alamat LAN-nya:

Alamat dalam panduan ini adalah alamat permintaan Modbus berbasis 0. Sebagian aplikasi menampilkan nomor register berbasis 1, jadi verifikasi konvensinya sebelum mengonfigurasi pembacaan; alamat yang bergeser satu tidak akan mengembalikan penanda yang diharapkan.

Gunakan urutan penemuan berikut:

1. Baca dua register pada alamat 40000. Word yang diharapkan adalah 0x5375 dan 0x6E53, yaitu penanda ASCII SunS.
2. Baca Common Model 1 mulai dari 40002.
3. Baca model meter mulai dari 40070. Membaca 107 register akan memperoleh ID model, panjang, dan seluruh wilayah datanya.
4. Baca penanda akhir pada 40177.

Satu permintaan Modbus tidak dapat membaca lebih dari 125 register, jadi baca model Common dan model meter secara terpisah. Klien sebaiknya menemukan ID dan panjang model, bukan meng-hard-code asumsi tentang setiap urutan model di masa depan.

Nilai integer dan faktor skala

Titik integer SunSpec menggunakan faktor skala. Konversi integer mentah dengan:

actual value = register integer × 10^scale factor

Contoh:

W = 12345
W_SF = 1
actual active power = 123450 W

Faktor skala dapat berubah sesuai rentang. Baca model meter secara lengkap pada setiap siklus polling agar nilai dan faktor skalanya berasal dari respons yang sama. Jangan menyimpan faktor skala dalam cache tanpa batas waktu.

Validasi dan batasan saat ini

Pengujian host mencakup tata letak model, konversi, overflow, perilaku hanya-baca, dan pemeriksaan regresi untuk register yang ada. Meter uji WEM3080T telah mengonfirmasi penemuan Model 203 dan pembacaan berkelanjutan, dengan tegangan dan daya diverifikasi terhadap antarmuka HTTP dan Modbus yang ada.

Model meter lain dan masing-masing klien pihak ketiga masih memerlukan pengujian fisik lebih lanjut. Firmware i.91.065.18 dibuat, diunggah, lalu diunduh kembali untuk verifikasi berkas; berkas rilis ini sendiri tidak di-flash selama siklus validasi ini.

Firmware tidak menyertakan perbaikan framing TCP yang masih tertunda. Saat ini firmware mengharapkan satu permintaan lengkap dalam satu operasi penerimaan. Permintaan TCP yang terpecah atau tergabung dapat menutup koneksi. Kirim satu permintaan dan tunggu balasannya sebelum permintaan berikutnya, sambil menyadari bahwa ini tidak menghilangkan semua risiko segmentasi TCP.

Posisi fitur ini dalam instalasi IAMMETER

Gunakan peta SunSpec ketika klien lokal dibangun untuk menemukan dan membaca model meter SunSpec. Gunakan peta register IAMMETER Modbus/TCP yang ada ketika aplikasi memerlukan register khusus IAMMETER. Jalur Modbus lokal yang ada tetap berguna untuk integrasi meter energi Home Assistant, sementara HTTP, MQTT, dan IAMMETER Cloud tetap menjadi opsi independen.

Unduh firmware: i.91.065.18.bin.

Sebelum memperbarui, tinjau model meter, metode koneksi, dan akses jaringan lokal Anda. Ini adalah antarmuka data hanya-baca; fitur ini tidak menyediakan kontrol inverter, operasi tulis, atau klaim interoperabilitas SunSpec pihak ketiga secara penuh.