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 yang terfokus dan hanya dapat dibaca untuk data meteran. Implementasi ini tidak bersertifikat SunSpec. Jangan menganggap fitur ini sebagai sertifikasi, kepatuhan penuh SunSpec, atau jaminan bahwa setiap klien SunSpec pihak ketiga akan bekerja tanpa konfigurasi.
Pemetaan model firmware saat ini
| meteran IAMMETER | Model meteran bilangan bulat SunSpec | Interpretasi kelistrikan |
|---|---|---|
| WEM3080 | 201 | Fase tunggal |
| WEM2067 | 202 | Split phase (Fase terpisah) |
| WEM3050T | 203 | Wye tiga fase |
| WEM3080T | 203 | Wye tiga fase |
| WEM3046T | 203 | Wye tiga fase |
| WEM3063T | 203 | Wye tiga fase |
Baris ini menjelaskan pemetaan model firmware saat ini. Validasi perangkat fisik yang dilaporkan di sini hanya mencakup WEM3080T; model lain yang terdaftar masih memerlukan pengujian perangkat.
Untuk WEM2067, Model 202 mewakili instalasi fase terpisah yang asli. Ini tidak menggambarkan dua rangkaian fase tunggal yang tidak berhubungan sebagai susunan listrik yang sama.
Kode untuk Model 204 memiliki cakupan pengujian host, namun firmware belum secara otomatis mendeteksi dan memilihnya untuk WEM3080TD. Oleh 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 bilangan bulat memperlihatkan tegangan fasa, arus fasa, daya aktif fasa, daya aktif total, frekuensi, faktor daya fasa, dan akumulator energi aktif per fasa dan total impor/ekspor. Model Umum menyediakan data identifikasi perangkat seperti model, versi firmware, dan nomor seri.
Energi direpresentasikan dalam Wh di peta SunSpec; faktor daya direpresentasikan sebagai persentase. Titik energi total menggunakan kembali bidang total meteran yang ada dan semantik NEM. IAMMETER tidak menghitung ulang total tiga fase dengan menambahkan akumulator fase dalam pemetaan ini. Karena pengaturan NEM mempengaruhi arti akumulator tersebut, klien tidak boleh berasumsi bahwa energi total selalu sama dengan jumlah energi fasa.
Beberapa bidang sengaja dihilangkan dalam versi pertama ini: daya reaktif dan energi reaktif, daya semu dan energi semu, faktor daya total multi-fasa, dan tanda peristiwa. Lokasi standarnya tetap ada dalam model dan mengembalikan penanda yang tidak tersedia. Klien SunSpec harus mengenali nilai yang tidak tersedia daripada menafsirkannya sebagai 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.
Terhubung dengan Modbus/TCP
Aktifkan layanan Modbus/TCP meter yang ada, lalu sambungkan ke alamat LAN-nya:
| Barang | Pengaturan |
|---|---|
| Tuan rumah | Alamat IP LAN meteran |
| Pelabuhan TCP | 502 |
| Fungsi baca | 03 — Read Holding Registers |
| Alamat awal SunSpec | 40000 |
| Akses tulis | Tidak didukung oleh peta IAMMETER SunSpec |
Alamat dalam panduan ini adalah alamat permintaan Modbus berbasis 0. Beberapa aplikasi menampilkan nomor register berbasis 1, jadi verifikasi konvensinya sebelum mengonfigurasi pembacaan; alamat off-by-one tidak akan mengembalikan penanda yang diharapkan.
Gunakan Kode Fungsi 03 untuk setiap pembacaan di bawah ini. Jumlah register mencakup ID model dan panjangnya jika berlaku.
| Baca | Alamat awal (berbasis 0) | Jumlah pendaftaran | Hasil yang diharapkan |
|---|---|---|---|
| Penanda SunSpec | 40000 |
2 | 0x5375, 0x6E53 (SunS) |
| Model Umum | 40002 |
68 | ID Model 1, panjang 66, informasi perangkat |
| Model meteran | 40070 |
107 | ID Model 201, 202 atau 203, panjang 105, data meter |
| Penanda akhir | 40177 |
2 | ID Model 0xFFFF, panjang 0 |
Satu permintaan Modbus dapat membaca tidak lebih dari 125 register, jadi baca model Common dan meteran secara terpisah. Klien harus menemukan ID dan panjang model, bukan membuat asumsi tentang setiap rangkaian 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
Validasi memiliki dua cakupan terpisah:
- Validasi implementasi: pengujian host yang lulus untuk tata letak model, konversi, luapan, perilaku baca-saja, dan pemeriksaan regresi untuk register yang ada. Pengukur uji WEM3080T mengonfirmasi penemuan Model 203 dan pembacaan berkelanjutan, dengan voltase dan daya diperiksa berdasarkan antarmuka HTTP dan Modbus yang ada. Model meteran lainnya dan masing-masing klien pihak ketiga masih memerlukan pengujian fisik lebih lanjut.
- Verifikasi file rilis: firmware
i.91.065.18dibuat, diunggah dan diunduh lagi untuk verifikasi file. File rilis persis ini tidak di-flash selama siklus validasi ini; hasil implementasi di atas tidak boleh dibaca sebagai pengujian perangkat dari file rilis yang diunduh.
Firmware tidak menyertakan perbaikan framing TCP yang tertunda. Saat ini ia mengharapkan satu permintaan lengkap dalam operasi penerimaan. Permintaan TCP terpisah atau gabungan dapat menutup koneksi. Kirim satu permintaan dan tunggu balasannya sebelum permintaan berikutnya, sambil menyadari bahwa hal ini tidak menghilangkan setiap risiko segmentasi TCP.
Jika ini cocok dengan instalasi IAMMETER
Untuk pemilihan arsitektur, mulailah dengan integrasi IAMMETER dan solusi hosting mandiri. API lokal dan panduan antarmuka terbuka membandingkan antarmuka meteran yang tersedia.
Gunakan peta SunSpec ketika klien lokal dibuat untuk menemukan dan membaca model meteran SunSpec. Gunakan Peta register IAMMETER Modbus/TCP yang ada saat aplikasi memerlukan register khusus IAMMETER. Jalur Modbus lokal yang ada tetap berguna untuk integrasi pengukur energi Asisten Rumah, sementara HTTP, MQTT, dan IAMMETER Cloud tetap menjadi opsi independen.
Unduh firmware: i.91.065.18.bin.
Sebelum memperbarui, ikuti instruksi peningkatan firmware IAMMETER dan tinjau model meteran Anda, metode koneksi, dan akses jaringan lokal. Ini adalah antarmuka data hanya-baca; itu tidak menyediakan kontrol inverter, operasi penulisan atau klaim interoperabilitas penuh SunSpec pihak ketiga.
Bagikan Integrasi SunSpec IAMMETER Anda dan Raih 5.000–10.000 Reward Points
Gunakan perangkat nyata untuk membaca data meter IAMMETER melalui SunSpec. Hasil dari simulator tidak memenuhi syarat.
Peserta yang memberikan dokumentasi integrasi terperinci dan memublikasikannya di forum publik dapat menerima 5.000–10.000 Reward Points setelah ditinjau oleh IAMMETER. Jumlah poin bergantung pada kualitas dan kelengkapan dokumentasi.