Dokumentasi

Baca dan kawal Pengurus Pengecasan cFos melalui Modbus

Selain HTTP dan MQTT, Pengurus Pengecasan cFos juga menyediakan API Modbus. Ini dimodelkan selepas SunSpec. Di bawah konfigurasi Pengurus Pengecasan anda boleh menentukan port TCP atau parameter port COM serta ID Modbus di bawah "tetapan alamat SunSpec. Ini bermakna Pengurus Pengecasan cFos mendengar port TCP atau port COM di bawah parameter yang ditentukan dan kepada ID Modbus dan ID Modbus + 1. Nilai Pengurus Pengecasan Umum, parameter, bendera dan pembolehubah tersedia di bawah ID Modbus. Peranti (kotak dinding dan meter) yang disediakan dalam Pengurus Pengecasan boleh ditanya di bawah ID + 1. Sebagai fungsi Modbus anda boleh menggunakan 3 dan Gunakan 4 untuk membaca dan 6 dan 16 untuk menulis . Perhatian: Pada Raspberry, port TCP di bawah 1024 dikhaskan untuk program dengan hak pentadbir. Oleh itu, adalah lebih baik untuk memilih nombor port yang lebih tinggi, mis. 1502.

Spesifikasi SunSpec Modbus menyatakan bahawa julat alamat Modbus bermula dengan pengecam "SunS" dan kemudian mengandungi model yang dipanggil SunSpec. Setiap model mempunyai nombor kunci model pada offset 0 dan panjang baki daftar kepunyaan model pada offset 1. Nilai model kemudian mengikuti dari offset 2. Penting: Anda harus mengimbas julat alamat SunSpec dan sentiasa melebihi panjang pada offset 1. Jangan menganggap panjang tetap atau alamat daftar tetap, kerana kemungkinan besar kami akan menambah nilai tambahan pada model dari masa ke masa. Model 1 (Biasa) sentiasa didahulukan dengan butiran pengilang, nombor versi, dll. Sila muat turun spesifikasi SunSpec Modbus daripada SunSpec Alliance untuk mendapatkan maklumat terperinci. Julat alamat SunSpec untuk Pengurus Pengecasan cFos bermula dengan alamat 40000.

Pengurus Pengecasan cFos pada mulanya memaparkan nilai berikut di bawah ID Modbus mengikut model biasa sebagai model 213 (meter tiga fasa, terapung):
Rujukan grid
Jumlah pengguna
Jumlah pengeluar
Lebihan PV
Kuasa kotak dinding digunakan
Prestasi kotak dinding yang tersedia
Prestasi ralat

Kemudian mengikuti model "tersuai" 60000 dengan parameter tetapan Pengurus Pengecasan cFos: Mengikut model dan panjang, pada masa ini terdapat 8 nilai apungan: jumlah arus maksimum, rizab, overdraf, jumlah arus maksimum kotak dinding dalam mA setiap fasa, condong fasa maksimum (dalam mA), pengurusan beban aktif (1 = aktif, 0 = tidak aktif), condong termasuk pengguna (1 = aktif, 0 = tidak aktif), jumlah arus maksimum dalam peratus. Ini ialah parameter Pengurus Pengecasan global yang juga boleh ditetapkan dalam UI. Perubahan kepada nilai ini disimpan (dengan kelewatan maksimum 150 saat). Peratusan jumlah arus boleh digunakan untuk melaraskan kuasa pengecasan secara dinamik, contohnya atas permintaan pengendali rangkaian.

Ini diikuti oleh model "tersuai" 60001. 32 daftar (16 bit) mengikut model dan panjang. Ini boleh mengandungi nilai 0 dan 1 dan membaca atau menulis sehingga 32 bendera Pengurus Pengecasan. Keadaan bendera ini kemudiannya boleh disoal dalam formula menggunakan CM._flag1 hingga CM._flag32 dan digunakan untuk pengiraan.

Kemudian mengikuti model "tersuai" 60002. Kemungkinan pembolehubah pengurus pengecasan mengikut model dan panjang. Terdapat 22 daftar tersedia untuk setiap pembolehubah. 20 daftar pertama ialah rentetan Modbus untuk nama pembolehubah (nama yang terlalu panjang akan dipotong). 2 daftar berikut mengandungi nilai apungan semasa pembolehubah. Apabila anda menulis nilai apungan pembolehubah Pengurus Pengecasan, anda memadamkan sebarang formula sedia ada dan menetapkan pembolehubah itu kepada nilai tetap.

Meter dan kotak dinding yang disediakan dalam Pengurus Pengecasan dipaparkan seperti berikut di bawah Modbus ID + 1. Sebagai Model SunSpec 113, kotak dinding dikembangkan untuk memasukkan dua daftar 16-bit. Offset 62 menunjukkan status kotak dinding (1=menunggu, 2=dipalamkan, 3=mengecas, 4=mengecas dengan pengudaraan, 5=ralat) dan mengimbangi 63 menunjukkan ID peranti. 1 = E1, 2 = E2, dsb. Pembilang diwakili dengan model 213 yang dikembangkan oleh 2 daftar 16-bit. Pada offset 126 ialah peranan kaunter (0=paparan, 1=penggunaan, 2=pengeluaran, 3=bekalan grid, 4=E-kereta penggunaan, 5=rumah simpanan, 6=simpan segala-galanya), pada offset 127 ialah ID peranti (-1 untuk M1, -2 untuk M2, dsb.). Jika pembilang ialah memori (peranan 5 atau 6), model 213 diikuti oleh model 124, yang dikembangkan dengan daftar 16-bit. ID peranti sekali lagi berada pada offset 26. Untuk membolehkan peranti dipaparkan di bawah Modbus ID + 1, anda mesti mengaktifkan "Terbitkan maklumat peranti melalui Modbus" dalam tetapan peranti.

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.

Senarai nilai untuk model 213:
Offset 0: 213
Offset 1: Panjang
Offset 2: Jumlah arus L1-L3 (A)
Offset 4: L1 (A) Semasa
Offset 6: L2 (A) Semasa
Offset 8: L3 (A) Semasa
Offset 10: Voltan (V)
Offset 12: Voltan L1 (V)
Offset 14: Voltan L2 (V)
Offset 16: Voltan L3 (V)
Offset 26: 50Hz
Offset 28: Kuasa (W)
Offset 30: Kuasa L1 (W)
Offset 32: Kuasa L2 (W)
Offset 34: Kuasa L3 (W)
Offset 36: Kuasa ketara (VA)
Offset 38: Kuasa ketara L1 (VA)
Offset 40: Kuasa ketara L2 (VA)
Offset 42: Kuasa ketara L3 (VA)
Offset 44: Kuasa reaktif (VAr)
Offset 60: Eksport, kuasa aktif (Wh)
Offset 68: Import, kuasa aktif (Wh)
Offset 126: Peranan (dengan Modbus ID + 1)
Offset 127: ID Peranti (untuk Modbus ID + 1)

Senarai nilai untuk model 113:
Offset 0: 113
Offset 1: Panjang
Offset 2: Jumlah arus L1-L3 (A)
Offset 4: L1 (A) Semasa
Offset 6: L2 (A) Semasa
Offset 8: L3 (A) Semasa
Offset 16: Voltan L1 (V)
Offset 18: Voltan L2 (V)
Offset 20: Voltan L3 (V)
Offset 22: Kuasa (W)
Offset 24: 50Hz
Offset 26: Kuasa ketara (VA)
Offset 32: Import, kuasa aktif (Wh)
Offset 62: Keadaan (dengan ID Modbus + 1)
Offset 63: ID Peranti (untuk Modbus ID + 1)

Senarai nilai untuk model 124:
Offset 0: 124
Offset 1: Panjang
Offset 2: Kuasa pengecasan/nyahcas keluar maksimum (W)
Offset 3: Peratusan had kuasa pengecasan semasa
Offset 4: Peratusan had kuasa nyahcas semasa
Offset 8: Keadaan Pengecasan dalam peratus
Offset 18: Faktor penskalaan untuk offset 2
Offset 19: Faktor penskalaan untuk offset 3 dan 4
Offset 26: ID Peranti (untuk Modbus ID + 1)

Senarai nilai untuk model 60000:
Semua nilai dalam apungan, akses baca/tulis, menyebabkan flash dikemas kini, iaitu, tidak sering berubah untuk mengelakkan kerosakan.
Offset 0: 60000 (unt16, baca sahaja)
Offset 1: Panjang (uint16, baca sahaja)
Offset 2: Jumlah arus maksimum (mA)
Offset 4: Rizab Kuasa (mA)
Offset 6: Overdraf (mA)
Offset 8: Jumlah arus kotak dinding maksimum (mA)
Offset 10: Lencong fasa maksimum (mA)
Offset 12: 1 = pengurusan beban aktif, 0 = tidak aktif
Offset 14: 1 = Tambahkan penggunaan rumah kepada ketidakseimbangan, 0 = tidak aktif
Offset 16: Peratus daripada jumlah arus maksimum, tidak disimpan, boleh ditukar selalu.

Senarai nilai untuk model 60001:
Semua nilai 0 atau 1, int16, akses baca/tulis, tidak disimpan, boleh ditukar selalu.
Offset 0: 60001 (uint16, baca sahaja)
Offset 1: Panjang (uint16, baca sahaja)
Offset 2: CM._flag1
...
Offset 33: CM._flag32

Senarai nilai untuk model 60002:
Semua nilai terapung, akses baca/tulis, tidak disimpan, boleh ditukar selalu. Offset 0: 60002 (uint16, baca sahaja)
Offset 1: Panjang (uint16, baca sahaja)
Offset 2..22: Pembolehubah Pengurus Pengecasan Nama 1
Offset 23..24: Pembolehubah Pengurus Pengecasan Nilai 1
Offset 25..45: Pembolehubah Pengurus Pengecasan Nama 2
Offset 46..47: Pembolehubah Pengurus Pengecasan Nilai 2
...