Dokumentasi

membaca dan mengontrol cFos Charging Manager melalui Modbus

Selain HTTP dan MQTT, cFos Charging Manager juga menyediakan Modbus API. Ini dimodelkan setelah SunSpec. Anda dapat menentukan parameter port TCP atau port COM dan ID Modbus di bawah "Pengaturan alamat SunSpec" dalam konfigurasi Charging Manager. Hal ini menyebabkan cFos Charging Manager untuk mendengarkan port TCP atau port COM di bawah parameter yang ditentukan dan ke Modbus ID dan Modbus ID + 1. Nilai-nilai umum Charging Manager, parameter, flag, dan variabel tersedia di bawah Modbus ID. Perangkat yang diatur dalam Charging Manager (kotak dinding dan meteran) dapat ditanyakan di bawah ID + 1. Sebagai fungsi Modbus, Anda dapat menggunakan 3 dan 4 untuk membaca dan 6 dan 16 untuk menulis. Perhatian: Pada Raspberry, port TCP di bawah 1024 dicadangkan untuk program dengan hak admin. Oleh karena itu, lebih baik memilih nomor port yang lebih tinggi, misalnya 1502.

Spesifikasi Modbus SunSpec menyatakan bahwa rentang alamat Modbus dimulai dengan pengenal "SunS" dan kemudian berisi apa yang disebut model SunSpec. Setiap model memiliki nomor identifikasi model pada offset 0 dan spesifikasi panjang register yang tersisa milik model pada offset 1. Nilai-nilai model kemudian mengikuti dari offset 2. Penting: Anda harus memindai rentang alamat SunSpec dan selalu memperkirakan panjang pada offset 1. Jangan mengasumsikan panjang tetap atau alamat register tetap, karena kemungkinan besar kita akan menambahkan nilai lebih lanjut pada model dari waktu ke waktu. Model 1 (Umum) selalu menjadi yang pertama, dengan rincian pabrikan, nomor versi, dll. Silakan unduh spesifikasi SunSpec Modbus dari SunSpec Alliance untuk informasi terperinci. Rentang alamat SunSpec untuk cFos Charging Manager dimulai dengan alamat 40000.

cFos Charging Manager pada awalnya menampilkan nilai-nilai berikut sebagai Model 213 (tiga fase meter, mengambang) di bawah Modbus ID setelah model Common:
Konsumsi jaringan
Total konsumen
Total generator
Surplus PV
Daya wallbox yang digunakan
Daya wallbox yang tersedia
Daya gangguan

Ini diikuti oleh model "kustom" 60000 dengan parameter pengaturan cFos Charging Manager: 8 nilai float saat ini mengikuti setelah model dan panjang: Arus total maksimum, cadangan, penarikan berlebih, arus wallbox total maksimum dalam mA per fase, ketidakseimbangan fase maksimum (dalam mA), manajemen beban aktif (1 = aktif, 0 = tidak aktif), ketidakseimbangan termasuk. konsumen (1 = aktif, 0 = tidak aktif), manajemen beban aktif (1 = aktif, 0 = tidak aktif), manajemen beban tidak aktif (1 = aktif, 0 = tidak aktif), ketidakseimbangan termasuk. konsumen (1 = aktif, 0 = tidak aktif). Beban (1 = aktif, 0 = tidak aktif), total arus maksimum dalam persen. Ini adalah parameter Manajer Pengisian daya global yang juga dapat diatur di UI. Perubahan pada nilai-nilai ini disimpan (dengan penundaan maksimum 150 detik). Arus total dalam persen dapat digunakan, misalnya, untuk menyesuaikan daya pengisian daya secara dinamis atas permintaan operator jaringan.

Ini diikuti oleh model "khusus" 60001. 32 register (16bit) mengikuti model dan panjangnya. Ini dapat berisi nilai 0 dan 1 dan membaca atau menulis hingga 32 bendera Manajer Pengisian Daya. Status flag ini kemudian dapat ditanyakan dalam rumus menggunakan CM._flag1 hingga CM._flag32 dan digunakan untuk perhitungan.

Ini diikuti oleh model "khusus" 60002, diikuti oleh variabel Charging Manager yang mungkin setelah model dan panjang. Ada 22 register yang tersedia untuk setiap variabel. 20 register pertama adalah string Modbus untuk nama variabel (nama yang terlalu panjang akan dipotong). Dua register berikut berisi nilai float saat ini dari variabel. Jika Anda menulis nilai float dari variabel Charging Manager, Anda akan menghapus rumus yang ada dan mengatur variabel ke nilai tetap.

Di bawah Modbus ID + 1, meter dan wallbox yang diatur di Charging Manager ditampilkan sebagai berikut. Wallbox dipertukarkan sebagai SunSpec model 113 yang diperluas dengan 2 register 16 bit. Offset 62 berisi status wallbox (1 = menunggu, 2 = dicolokkan, 3 = mengisi daya, 4 = mengisi daya dengan ventilasi, 5 = kesalahan) dan offset 63 berisi ID perangkat. 1 = E1, 2 = E2, dst. Penghitung ditampilkan dengan model 213 yang diperluas dengan 2 register 16 bit. Offset 126 berisi peran pengukur (0 = tampilan, 1 = konsumsi, 2 = generasi, 3 = konsumsi jaringan, 4 = konsumsi mobil listrik, 5 = rumah penyimpanan, 6 = penyimpanan semua), offset 127 berisi ID perangkat (-1 untuk M1, -2 untuk M2, dst.). Jika meteran adalah perangkat penyimpanan (peran 5 atau 6), model 213 diikuti oleh model 124, yang diperluas dengan register 16-bit. Offset 26 sekali lagi berisi ID perangkat. Untuk menampilkan perangkat di bawah Modbus ID + 1, Anda harus mengaktifkan "Publikasikan informasi perangkat melalui Modbus" dalam pengaturan perangkat.

Aufstellung Start-Addressen der Modelle:
Modbus ID:
Model: 1, Addr: 40002
Model: 213, Addr: 40070, Netzbezugszähler
Model: 213, Addr: 40196, Summe Verbraucher
Model: 213, Addr: 40322, Sume Erzeuger
Model: 213, Addr: 40448, PV Überschuss
Model: 213, Addr: 40574, Genutzte Wallboxleistung
Model: 213, Addr: 40700, Verfügbare Wallboxleistung
Model: 213, Addr: 40826, Fehler-Leistung
Model: 60000, Addr: 40952
Model: 60001, Addr: 40970
Model: 60002, Addr: 41004
Die konkreten Start-Addressen können bei späteren Versionen des cFos Charging Managers variieren, daher sollte der Register-Bereich, wie oben beschrieben, gescannt werden.
Modbus ID + 1:
Modelle und Startadressen hängen von den eingeblendeten Geräten ab.

Daftar nilai untuk model 213:
Offset 0: 213
Offset 1: Panjang
Offset 2: Total arus L1-L3 (A)
Offset 4: Arus L1 (A)
Offset 6: Arus L2 (A)
Offset 8: Arus L3 (A)
Offset 10: Tegangan (V)
Offset 12: Tegangan L1 (V)
Offset 14: Tegangan L2 (V)
Offset 16: Tegangan L3 (V)
Offset 26: 50 Hz
Offset 28: Daya (W)
Offset 30: Daya L1 (W)
Offset 32: Daya L2 (W)
Offset 34: Daya L3 (W)
Offset 36: Daya semu (VA)
Offset 38: Daya semu L1 (VA)
Offset 40: Daya semu L2 (VA)
Offset 42: Daya semu L3 (VA)
Offset 44: Daya reaktif (VAr)
Offset 60: Ekspor, daya aktif (Wh)
Offset 68: Impor, daya aktif (Wh)
Offset 126: Peran (untuk Modbus ID + 1)
Offset 127: ID Perangkat (untuk Modbus ID + 1)

Daftar nilai untuk model 113:
Offset 0: 113
Offset 1: Panjang
Offset 2: Total arus L1-L3 (A)
Offset 4: Arus L1 (A)
Offset 6: Arus L2 (A)
Offset 8: Arus L3 (A)
Offset 16: Tegangan L1 (V)
Offset 18: Tegangan L2 (V)
Offset 20: Tegangan L3 (V)
Offset 22: Daya (W)
Offset 24: 50 Hz
Offset 26: Daya nyata (VA)
Offset 32: Impor, daya aktif (Wh)
Offset 62: Status (untuk Modbus ID + 1)
Offset 63: ID Perangkat (untuk Modbus ID + 1)

Daftar nilai untuk model 124:
Offset 0: 124
Offset 1: Panjang
Offset 2: Daya pengisian/pengosongan maksimum (W)
Offset 3: Persen batas daya pengisian saat ini
Offset 4: Persen batas daya pengosongan saat ini
Offset 8: Status pengisian dalam persen
Offset 18: Faktor penskalaan untuk offset 2
Offset 19: Faktor penskalaan untuk offset 3 dan 4
Offset 26: ID perangkat (untuk Modbus ID + 1)

Daftar nilai untuk model 60000:
Semua nilai dalam float, akses baca/tulis, menyebabkan flash diperbarui, yaitu jangan sering berubah untuk menghindari kerusakan.yaitu jangan sering mengganti untuk menghindari kerusakan.
Offset 0: 60000 (unt16, hanya-baca)
Offset 1: Panjang (uint16, hanya-baca)
Offset 2: Maks. Arus total (mA)
Offset 4: Cadangan Daya (mA)
Offset 6: Penarikan berlebih (mA)
Offset 8: Arus total kotak dinding maks (mA)
Offset 10: Maks. Ketidakseimbangan fasa (mA)
Offset 12: 1 = Manajemen beban aktif, 0 = tidak aktif
Offset 14: 1 = Tambahkan konsumsi rumah ke ketidakseimbangan, 0 = tidak aktif
Offset 16: Persen dari maks. total arus, tidak disimpan, dapat sering diubah.

Daftar nilai untuk model 60001:
Semua nilai 0 atau 1, int16, akses baca/tulis, tidak disimpan, dapat sering diubah.
Offset 0: 60001 (uint16, hanya-baca)
Offset 1: Panjang (uint16, hanya-baca)
Offset 2: CM._flag1
...
Offset 33: CM._flag32

Daftar nilai untuk model 60002:
Semua nilai mengambang, akses baca/tulis, tidak disimpan, dapat sering diubah. Offset 0: 60002 (uint16, hanya-baca)
Offset 1: Panjang (uint16, hanya-baca)
Offset 2..22: Nama Variabel Manajer Pengisian 1
Offset 23..24: Nilai Variabel Manajer Pengisian 1
Offset 25..45: Nama Variabel Manajer Pengisian 2
Offset 46..47: Nilai Variabel Manajer Pengisian 2
...