Kaunter yang ditentukan pengguna

Nota: Pengurus Pengecasan cFos boleh membaca kebanyakan penyongsang solar menggunakan SunSpec (jenis peranti "Penyongsang / Meter Suria SunSpec"). Dalam kes ini, anda tidak perlu mencipta definisi kaunter anda sendiri.

Pengurus Pengecasan cFos membolehkan anda mencipta definisi meter anda sendiri untuk menyokong meter yang tiada dalam himpunan standard. Pada masa ini terdapat tiga jenis: kaunter Modbus, kaunter HTTP/JSON dan kaunter MQTT/JSON. Fail definisi untuk kaunter ini sangat serupa. Meter Modbus membaca data mereka melalui Modbus daripada daftar tertentu, manakala meter HTTP/JSON mendapatkan data mereka melalui permintaan HTTP dan menghuraikan JSON sebagai tindak balas. Untuk meter MQTT/JSON, Pengurus Pengecasan cFos melanggan topik MQTT dan menghuraikan mesej yang diterbitkan di bawah topik sebagai JSON. Pengurus Pengecasan cFos menggunakan "bahasa pertanyaan" kecil untuk menghuraikan. Berikut ialah dokumentasi keupayaan MQTT dalam Pengurus Pengecasan cFos.

Sebagai tambahan kepada beberapa pembolehubah yang dipratentukan, seperti arus dan voltan, meter yang ditakrifkan pengguna juga boleh membaca pembolehubah yang ditakrifkan pengguna, input pertanyaan dan output yang ditetapkan. Membaca dalam pembolehubah dan output tetapan membolehkan penilaian formula. Dalam kombinasi dengan pembolehubah Pengurus Pengecasan dan output Pengurus Pengecasan global yang diterangkan di bawah, ini merupakan ciri yang berkuasa dan malah membenarkan tugas automasi rumah tertentu dan kawalan peranti luaran seperti storan bateri. Jika anda melaksanakan tugas kawalan dengan ini, sila berikan maklum balas kepada kami. Kami sangat berminat dengan perkara yang dikawal oleh orang ramai dengan Pengurus Pengecasan cFos dan ia membantu kami mengembangkan lagi Pengurus Pengecasan mengikut keperluan pelanggan.

Berikut adalah definisi contoh untuk Modbus dan satu untuk HTTP/JSON:
Muat turun definisi sampel untuk meter Modbus
Muat turun definisi sampel untuk meter/

Pengecas Pengecas sudah dilengkapi dengan beberapa fail seperti itu, tetapi anda boleh memuat naik fail anda sendiri di bawah "Konfigurasi sistem" dan juga menghapusnya lagi.
Di sini anda akan menemui sebahagian besar definisi kaunter yang kami sediakan:
Muat turun definisi meter yang dibekalkan

Sekiranya anda telah membuat fail kaunter anda sendiri dan mungkin relevan untuk pengguna lain, kami akan sangat berterima kasih sekiranya anda dapat membuatnya tersedia untuk kami. Kemudian kami akan menyampaikannya dengan Pengurus Pengecasan versi yang akan datang.

Muat turun definisi kaunter untuk lebih banyak kaunter

Struktur fail definisi:

Takrifan balas ialah fail JSON dengan Objek JSON global yang mempunyai sifat dan sub-objek. 'rtype' menentukan jenis operasi baca: 0 = Modbus, 1 = HTTP/JSON, 2 = MQTT/JSON. Anda boleh menentukan nombor dalam perpuluhan atau hex dengan awalan 0x. Di samping itu, komen satu baris menggunakan // dibenarkan. Kami mengesyorkan menjalankan fail definisi anda melalui pengesah JSON5, contohnya pengesah JSON5 ini

Pastikan anda membaca bab Rumus untuk memahami nilai yang boleh digunakan dalam formula dalam rujukan berikut.

Takrifan Modbus mempunyai objek 'rtu' dengan sifat berikut:

silence_period, dalam msec. menentukan panjang jeda sebelum akses Modbus RTU supaya peranti mengenali permulaan mesej.
silence_same_slave, true: Jeda dikekalkan walaupun dengan berbilang akses kepada peranti yang sama.
cuba semula : Bilangan percubaan semula jika peranti tidak bertindak balas.
rcv_timeout: dalam msec. masa menunggu maksimum bagi setiap akses sehingga peranti bertindak balas.

Sifat global ini digunakan untuk Modbus TCP dan RTU:

modbus_read: Nombor fungsi perintah baca Modbus, biasanya 3 atau 4.
modbus_read_max_registers: Bilangan maksimum daftar yang boleh dibaca sekali gus.
modbus_allow_gaps: true = Kawasan daftar yang tidak digunakan boleh dibaca dalam operasi baca.

Untuk Modbus TCP dan HTTP/JSON terdapat objek 'tcp' dengan sifat berikut:

connect_timeout: ialah msec. masa menunggu maksimum untuk sambungan TCP.
delay_after_connect: dalam msec. Jeda selepas mewujudkan sambungan sebelum menghantar arahan pertama.

Kedua-dua jenis definisi (Modbus dan HTTP/JSON) juga mempunyai sifat berikut:

upd_delay: dalam msec. menentukan selang waktu peranti boleh dibaca. Sesetengah peranti menjadi lebih muatan apabila ditinjau terlalu kerap.
pengilang: Rentetan, nama pengilang. Ini ditunjukkan dalam maklumat lanjutan jubin.
delay_accumulated: true = Nilai terkumpul (kWj) hanya disoal setiap 3 saat atau apabila terdapat kuasa yang mencukupi. false = Nilai-nilai ini sentiasa disoal.
ui_addr: URL, jika berbeza daripada alamat peranti untuk memanggil antara muka web.
terpelihara: Tatasusunan dengan nilai ditafsirkan sebagai 0 (berguna jika peranti menyokong nilai tertentu bergantung pada model).

Jika anda meninggalkan sifat yang disenaraikan di atas, Pengurus Pengecasan cFos akan menggunakan nilai lalai, yang berfungsi dengan baik dalam kebanyakan kes.

Langkah seterusnya dalam definisi JSON ialah definisi pembolehubah yang digunakan oleh meter untuk membaca atau mengira nilai untuk arus, voltan, dsb. Pengurus Pengecasan mengenali pembolehubah berikut:
type_designation, version, firmware_version, serial: Ini membentuk penetapan model seperti yang ditunjukkan dalam maklumat lanjutan jubin. Ini disoal sekali apabila menyediakan atau menetapkan semula kaunter.
voltan_l1..voltan_l3, arus_l1..arus_l3, kuasa_w, kuasa_var, kuasa_va, kuasa_w_l1..kuasa_w_l3: Pengurus Pengecasan cFos cuba mengira arus_l1..l3, kuasa_w dan kuasa_va yang ditandatangani daripada nilai ini untuk voltan_l1..l3. Anda tidak perlu menentukan semua pembolehubah. Pengurus Pengecasan cFos cuba mengira nilai daripada pembolehubah sedia ada.
import_wh, export_wh: Pengurus Pengecasan menggunakan pembolehubah ini untuk mengira import_wh dan export_wh. Anda tidak perlu menentukan semua pembolehubah. Pengurus Pengecasan cFos cuba mengira nilai daripada pembolehubah sedia ada.

Di samping itu, anda boleh menentukan pembolehubah lain dengan nama yang berbeza, yang dibaca dengan setiap kemas kini atau dikira menggunakan formula.

Definisi pembolehubah:

Objek dinamakan sempena pembolehubah yang disenaraikan di atas dan mempunyai sifat berikut:
tetap: Rentetan dengan nilai tetap. Berguna jika, sebagai contoh, tiada nilai boleh ditentukan, contohnya untuk jenis_penetapan atau voltan.
expr: String, pembolehubah tidak dibaca tetapi dinilai sebagai formula.
jenis: Jika tidak tetap atau expr, jenis pembolehubah: int16, int32, float, int64, rentetan. Ini penting untuk Modbus membaca daftar dalam format yang betul. Dengan JSON/HTTP anda kebanyakannya boleh menggunakan apungan.
resolusi: terapung, nilai baca didarab dengan 'resolusi'. Nilai untuk voltan mestilah dalam volt, arus dalam miliamp, kuasa dalam watt, tenaga dalam watt-jam (Wh). Dengan 'resolusi' negatif anda boleh menyongsangkan nilai jika ia mempunyai tanda yang bertentangan.
alamat: nombor (Modbus) atau rentetan (HTTP/JSON), nombor daftar Modbus atau URL HTTP nilai yang akan dibaca.
pertanyaan: String, dengan HTTP JSON spesifikasi dalam bahasa pertanyaan Pengurus Pengecasan yang mana ia mendapati nilai untuk dibaca dalam respons JSON.
tertib: Rentetan, untuk Modbus tertib bait, sama ada "hl" atau "lh", di mana nilainya ada. panjang: nombor, dengan Modbus panjang rentetan dalam daftar. Untuk pembolehubah 'versi' dan 'versi_firmware', 'panjang' digunakan untuk membuat rentetan dengan titik daripada versi angka. Nilai 2 atau 4 dibenarkan untuk 'panjang', yang kemudiannya menghasilkan format versi ab, dan abcd. Dengan 'panjang' 2 dan taip 'int16', Pengurus Pengecasan memisahkan bait rendah dan tinggi dengan titik, dengan perkataan rendah dan tinggi int32, dengan perkataan rendah dan tinggi 'int64'. Dengan 'lenth' 4 dan 'int32', pengurus pengecasan membahagikan nilai kepada 4 bait yang dipisahkan oleh titik. Dengan 'int64' 4 perkataan yang sesuai.

Definisi input:

Pengurus Pengecasan boleh membuat pertanyaan sehingga 32 nilai input daripada daftar berbeza atau elemen JSON bagi setiap peranti. Sifat "Input" ialah tatasusunan JSON. Anda mesti menentukan sifat berikut untuk setiap input:
alamat: alamat (daftar Modbus atau URL).
count: bilangan bit input dibaca dengan permintaan ini.
pertanyaan: Untuk HTTP/JSON, bahasa pertanyaan untuk mencari nilai dalam respons.

Dengan setiap kemas kini, Pengurus Pengecasan cFos membaca semua input yang ditakrifkan dengan cara ini dan meletakkan bit secara dalaman dalam tatasusunan yang kemudiannya boleh ditanya dalam formula, Input1..InputN.

Definisi output:

Pengurus Pengecasan boleh menukar sehingga 32 output bagi setiap peranti. Semua output ditukar pada akhir setiap kitaran kemas kini jika status output masing-masing telah berubah.
Anda mesti menentukan sifat berikut untuk setiap input:
alamat: URL HTTP dengan kaedah HTTP pilihan, cth.//http://www.example.com?output1=${var1}. Untuk menetapkan daftar Modbus, anda boleh menggunakan API HTTP Pengurus Pengecasan cFos. Pengurus Pengecasan mengiktiraf akses yang sesuai kepada localhost dan mengubah hala permintaan kepada pengendali dalaman supaya anda tidak memerlukan kebenaran, seperti akses API HTTP luaran.
body: Badan HTTP pilihan untuk POST atau PUT.
Dalam URL dan kandungan, anda boleh menggunakan formula ${expr} yang merujuk pembolehubah Pengurus Pengecasan global atau daripada meter masing-masing. Formula 'expr' dinilai apabila output ditetapkan dan digantikan dalam teks URL atau kandungan. Dalam contoh di atas, jika http://www.example.com?output1=1 menetapkan output dan//mengosongkannya, anda boleh mentakrifkan pembolehubah '//' dan menetapkannya kepada 1 seperti yang dikehendaki atau tetapkan 0. Dengan cara ini, anda juga boleh menulis nilai berangka untuk mengawal prestasi memori dalam daftar Modbus yang anda simpan sebelum ini dalam pembolehubah menggunakan formula.
Jika, daripada menghantar nilai angka dalam URL, anda perlu menggantikan teks dengan yang lain bergantung pada formula, seperti dengan soket WLAN Shelly, anda boleh menulisnya seperti ini: ${if expr`text1`text2}. "apostrof" ialah tanda belakang (kod ASCII 96). Jika 'expr' != 0, text1 digunakan, sebaliknya text2. URL untuk soket WLAN Shelly kelihatan seperti ini, contohnya: http://<ip-addr>/relay/0?turn=${if expr`on`off}, iaitu jika expr != 0 the Charging Manager maka memanggil http ://<ip-addr>/geganti/0?turn=on, jika tidak http://<ip-addr>/relay/0?turn=off.

Jika anda memasukkan laluan relatif sebagai URL, Pengurus Pengecasan menggunakan alamat yang dikonfigurasikan untuk peranti masing-masing. Jika anda memasukkan 'localhost' sebagai domain, Pengurus Pengecasan mengambil alamat peranti yang ia sedang berjalan. Jika ia mengesan akses kepada APInya sendiri, ia menggunakan pengendali dalaman dan bukannya melaksanakan akses HTTP penuh, supaya anda tidak perlu menyimpan nama pengguna dan kata laluan dalam definisi meter. URL yang bermula dengan * menyebabkan Pengurus Pengecasan sentiasa melaksanakan akses HTTP penuh.

Definisi bahasa pertanyaan:

Pada masa ini, nama ahli dan pengendali "." boleh digunakan dalam ungkapan carian "pertanyaan". dan "[]" digunakan, contoh:

ujianElemen bernama "ujian"
nama1.nama2Elemen bernama "name2" dalam objek kanak-kanak "name1"
nama [idx]Elemen "idx" elemen objek "nama". "idx" boleh berupa angka, misalnya untuk tatasusunan atau rentetan
nama ["u2"]Elemen "u2" elemen objek "nama" sesuai dengan "name.u2"
nama[{"el1": "v1", "el2": 3}].nilaiPilih elemen tatasusunan yang memenuhi syarat tatatanda objek dan nilaikan elemen bernama 'nilai'. Di sini, sebagai contoh, elemen dipilih dalam tatasusunan 'nama' yang mempunyai elemen objek 'el1' dengan nilai 'v1' dan 'el2' dengan nilai 3 dan kemudian nilai elemen 'nilai' dikembalikan daripada objek ini .

Pembolehubah Pengurus Pengecasan Global:

Anda boleh membuat pembolehubah dalam konfigurasi Pengurus Pengecasan. Anda boleh menggunakan nilai tetap atau formula sebagai nilai. Pada akhir setiap kitaran kemas kini, Pengurus Pengecasan mengira semula nilai pembolehubah ini jika perlu. Anda kemudian boleh menggunakan ini dalam (tertentu) parameter pengurus pengecasan, peraturan pengecasan atau untuk mengawal output. Anda juga boleh menulis E x.member atau M x.member sebagai pembolehubah. Di sini E x dan M x ialah ID peranti bagi kotak dinding atau meter yang disediakan dalam Pengurus Pengecasan. ahli ialah pembolehubah "ditakrifkan pengguna" yang disimpan dalam peranti yang sepadan. Sesetengah pembolehubah boleh mempunyai makna istimewa: Dengan KEBA "out1" ialah output pensuisan, dengan ABB B23 meter "out1" dan "out2" ialah output pensuisan (untuk model yang menyokong ini). A 1 menukar output, 0 mematikannya semula.

Output Pengurus Pengecasan Global:

Dalam konfigurasi Pengurus Pengecasan, anda boleh mengkonfigurasi output global seperti yang diterangkan di atas dalam definisi meter di bawah 'Output'. Ini ditetapkan pada penghujung setiap kitaran kemas kini jika statusnya telah berubah. Jika anda ingin mengawal output pensuisan dalam peranti yang ditentukan pengguna, konvensyen di atas disyorkan (lihat pembolehubah Pengurus Pengecasan): Anda menetapkan pembolehubah dengan nama "out1", "out2", dll. dalam meter yang ditentukan pengguna dan sediakan output dalam meter yang ditentukan pengguna yang berada dalam Tukar output bergantung pada nilai pembolehubah ini.

API Modbus Global Pengurus Pengecasan:

Modbus API Pengurus Pengecasan digunakan untuk mengawal peranti Modbus yang mempunyai sebarang alamat Modbus RTU atau TCP (yang boleh dicapai oleh Pengurus Pengecasan). Masukkan COMx,bd,8,p,s sebagai alamat untuk Modbus RTU, seperti dalam konfigurasi peranti individu, dengan x ialah nombor port COM, bd ialah kadar baud, p ialah pariti ('N', ' E' atau ' O') dan s ialah bilangan bit henti (1 atau 2). Dengan Modbus TCP, alamat ialah alamat IP peranti dalam rangkaian Pengurus Pengecasan termasuk nombor port.
URL (untuk HTTP GET) API Modbus ialah:
/cnf?cmd=modbus_get atau /cnf?cmd=modbus_set
Pengurus Pengecasan cFos menyokong parameter pertanyaan tambahan berikut:
addr: Alamat peranti Modbus RTU atau TCP di atas.
func: Nombor fungsi Modbus, cth. 3 atau 4 untuk membaca, 6 atau 16 untuk menulis.
id: ID Peranti peranti Modbus.
reg: Nombor daftar Modbus. Nilai boleh ditentukan dalam perpuluhan atau hex (dengan awalan 0x).
val: nombor, nilai untuk ditulis ke dalam daftar. ketinggalan semasa membaca.
jenis: 'w' 16bit (lalai), d = 32bit, f = float, q = 64bit, s = rentetan.
cnt: nombor, panjang maksimum rentetan dalam daftar, tinggalkan untuk jenis lain atau tetapkan kepada 1.
tertib: Rentetan yang mengandungi susunan bait, sama ada "hl" atau "lh".

Nota: Jika 'Meter' anda digunakan terutamanya untuk tujuan kawalan, anda boleh menyemak pilihan 'Sembunyikan peranti' dalam tetapan jubin ini supaya peranti ini tidak muncul pada halaman mula.

Nota: Beberapa meter dibaca melalui HTTP memerlukan nama pengguna/kata laluan sebagai kebenaran. Anda boleh menentukan ini dalam alamat untuk akses HTTP, contohnya dengan http://username:password@192.168.2.111. Jika nama pengguna atau kata laluan anda mengandungi "@", anda mesti menggantikannya dengan "%40".