www.pyramid.tech
FX4
Manual Pengaturcara FX4
ID Dokumen: 2711715845
Versi: v3
Pengaturcara FX4
ID Dokumen: 2711715845
FX4 – Manual Pengaturcara FX4
ID Dokumen: 2711650310
| Pengarang | Matthew Nicholas |
| Pemilik | Ketua Projek |
| Tujuan | Terangkan konsep pengaturcaraan yang diperlukan untuk menggunakan API dan melanjutkan produk melalui aplikasi luaran. |
| Skop | Konsep pengaturcaraan berkaitan FX4. |
| Khalayak yang Dimaksudkan | Pembangun perisian berminat menggunakan produk. |
| Proses | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Proses |
| Latihan | TIDAK BERKAITAN |
Kawalan Versi
| Versi | Penerangan | Disimpan oleh | Disimpan pada | Status |
| v3 | Menambah lebih ringkasview dan banyak lagi bekasamples. | Matthew Nicholas | 6 Mac 2025 10:29 malam | DILULUSKAN |
| v2 | Menambahkan antara muka dan rujukan IO digital kembali ke IGX. | Matthew Nicholas | 3 Mei 2024 7:39 PTG | DILULUSKAN |
| v1 | Keluaran awal, masih dalam proses. | Matthew Nicholas | 21 Feb 2024 11:25 PTG | DILULUSKAN |
Kawalan dokumen Bukan Reviewed
Versi dokumen semasa: v.1
Tiada semulaviewditugaskan.
1.1 Tandatangan
untuk versi dokumen terkini
Jumaat, 7 Mac 2025, 10:33 MLM UTC
Matthew Nichols menandatangani ; maksud: Review
Rujukan
| Dokumen | ID Dokumen | Pengarang | Versi |
| IGX – Manual Pengaturcara | 2439249921 | Matthew Nicholas | 1 |
Pengaturcaraan FX4 Selesaiview
Pemproses FX4 berjalan pada persekitaran yang dipanggil IGX, yang dibina pada sistem pengendalian masa nyata kebolehpercayaan tinggi QNX daripada BlackBerry (QNX Webtapak¹). IGX menyediakan antara muka pengaturcaraan aplikasi (API) yang fleksibel dan komprehensif untuk pengguna yang ingin menulis perisian komputer hos mereka sendiri.
Persekitaran IGX dikongsi merentasi produk Pyramid lain, membolehkan penyelesaian perisian yang dibangunkan untuk satu produk mudah dipindahkan kepada yang lain.
Pengaturcara boleh merujuk kepada dokumentasi lengkap untuk IGX yang terdapat pada Piramid webtapak di: IGX | Rangka Kerja Sistem Kawalan Modular Moden untuk Web-Aplikasi yang didayakan²
Bahagian ini menyediakan pengenalan kepada menguji dua kaedah API: HTTP menggunakan format JSON dan EPICS. Untuk kesederhanaan, Python (Ular sawa Webtapak³) digunakan sebagai bekasampbahasa komputer hos, yang boleh diakses dan mudah digunakan untuk pengaturcara bukan profesional.
3.1 Menggunakan Python dan HTTP
Sebagai bekasample, andaikan anda mahu membaca jumlah arus yang diukur dengan Python. Anda memerlukan URL untuk IO tertentu itu. FX4 web GUI menyediakan cara mudah untuk mencari ini: hanya klik kanan dalam medan dan pilih 'Salin HTTP URL' untuk menyalin rentetan ke papan keratan.
Kini anda boleh menggunakan Python untuk menguji ketersambungan kepada perisian pengguna melalui HTTP dan JSON. Anda mungkin perlu mengimport permintaan dan perpustakaan json untuk mengendalikan permintaan HTTP dan penghuraian data.
1 Simple Python HTTP Cthample
3.2 Menggunakan EPICS
Proses untuk menyambungkan FX4 melalui EPICS (Fizik Eksperimen dan Sistem Kawalan Perindustrian) adalah serupa. EPICS ialah satu set alat perisian dan aplikasi yang digunakan untuk membangun dan melaksanakan sistem kawalan teragih, digunakan secara meluas dalam kemudahan saintifik.
- Dapatkan nama pembolehubah proses (PV) EPICS untuk IO yang dikehendaki.
- Import perpustakaan EPICS dan baca nilainya.
2 Dapatkan Nama PV EPICS
3 Epik Python Mudah Cthample
Selain itu, Pyramid mencipta utiliti (EPICS Connect⁴) yang membolehkan anda memantau pembolehubah proses EPICS dalam masa nyata. Alat ini berguna untuk mengesahkan sama ada nama PV EPICS adalah betul dan FX4 menyediakan PV dengan betul pada rangkaian anda.
4 PTC EPICS Connect
API Pengaturcaraan FX4
Konsep dan kaedah yang diterangkan dalam manual ini dibina berdasarkan konsep yang ditetapkan dalam IGX – Manual Pengaturcara. Sila lihat dokumen itu untuk penjelasan dan contohampmempelajari cara pengaturcaraan dan antara muka asas IGX berfungsi. Manual ini hanya akan merangkumi IO khusus peranti dan kefungsian yang unik kepada FX4.
4.1 Input Analog IO
IO ini berkaitan dengan mengkonfigurasi dan mengumpul data pada input semasa analog FX4. Unit input saluran adalah berdasarkan tetapan boleh dikonfigurasikan pengguna yang dipanggil "Sample Units", pilihan yang sah termasuk pA, nA, uA, mA dan A.
Kesemua 4 saluran menggunakan antara muka IO yang sama dan dikawal secara bebas. Gantikan channel_x dengan channel_1 , channel_2 , channel_3 atau channel_4 masing-masing.
| Laluan IO | Penerangan |
| /fx4/adc/channel_x | NOMBOR BACA Input semasa yang diukur. |
| /fx4/adc/channel_x/scalar | NUMBER Skalar tanpa unit mudah digunakan pada saluran, 1 secara lalai. |
| /fx4/adc/channel_x/zero_offset | NUMBER Offset semasa dalam nA untuk saluran. |
IO berikut tidak bebas saluran dan digunakan pada semua saluran secara serentak.
| Laluan IO | Penerangan |
| /fx4/channel_sum | NOMBOR BACA Jumlah saluran input semasa. |
| /fx4/adc_unit | STRING Menetapkan unit pengguna semasa untuk setiap saluran dan jumlah. Pilihan: “pa”, “na”, “ua”, “ma”, “a” |
| /fx4/julat | STRING Menetapkan julat input semasa. Lihat GUI untuk mengetahui cara setiap kod julat sepadan dengan had input semasa maksimum dan BW. Pilihan: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7” |
| /fx4/adc/sample_frequency | NUMBER Kekerapan dalam Hz yang sample data akan dipuratakan kepada. Ini mengawal isyarat kepada hingar dan kadar data untuk semua saluran. |
| /fx4/adc/conversion_frequency | NOMBOR Kekerapan dalam Hz yang ADC akan menukar nilai analog kepada digital pada. Secara lalai, ini ialah 100kHz, dan anda jarang perlu menukar nilai ini. |
| /fx4/adc/offset_correction | READONLY NUMBER Jumlah semua offset semasa saluran. |
4.2 IO Output Analog
IO ini berkaitan dengan konfigurasi output analog tujuan umum FX4 yang terdapat di bawah input analog pada panel hadapan. Kesemua 4 saluran menggunakan antara muka IO yang sama dan dikawal secara bebas. Gantikan channel_x dengan channel_1 , channel_2 , channel_3 atau channel_4 masing-masing.
| Laluan IO | Penerangan |
| /fx4/dac /channel_x | NUMBER Perintah jldtage keluaran. Nilai ini hanya boleh ditulis apabila mod output ditetapkan kepada manual. |
| /fx4/dac/channel_x/readback | NOMBOR BACA SAHAJA Diukur voltagkeluaran e. Ini amat membantu apabila menggunakan mod output ekspresi. |
| /fx4/dac/channel_x/output_mode | STRING Menetapkan mod output untuk saluran. Pilihan: “manual”, “expression”, “process_control” |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Mendayakan atau melumpuhkan pengehadan kadar slew. |
| /fx4/dac/channel_ x/slew_rate | NUMBER Kadar slew dalam V/s untuk saluran. |
| /fx4/dac/channel_x/upper_limit | NUMBER Perintah maksimum yang dibenarkan voltage untuk saluran. Terpakai kepada semua mod operasi. |
| /fx4/dac/channel _ x/lower_limit | NUMBER Perintah minimum yang dibenarkan voltage untuk saluran. Terpakai kepada semua mod operasi. |
| /fx4/dac/channel _ x/ output _ ungkapan | STRING Menetapkan rentetan ungkapan yang digunakan oleh saluran apabila ia berada dalam mod output ungkapan. |
| /fx4/dac/saluran _ x/butang_semula | BUTTON Menetapkan semula arahan voltage hingga 0. |
4.3 Input dan Output Digital
IO ini berkaitan dengan mengawal pelbagai input dan output digital tujuan umum yang terdapat pada FX4.
| Laluan IO | Penerangan |
| /fx4/fr1 | READONLY BOOL Penerima gentian 1. |
| /fx4/ft1 | Pemancar gentian BOOL 1. |
| /fx4/fr2 | READONLY BOOL Penerima gentian 2. |
| /fx4/ft2 | Pemancar gentian BOOL 2. |
| /fx4/fr3 | READONLY BOOL Penerima gentian 3. |
| /fx4/ft3 | Pemancar gentian BOOL 3. |
| /fx4/digital_expansion/d1 | IO pengembangan digital dwiarah BOOL D1. |
| /fx4/digital_expansion/d2 | IO pengembangan digital dwiarah BOOL D2. |
| /fx4/digital_expansion/d3 | IO pengembangan digital dwiarah BOOL D3. |
| /fx4/digital_expansion/d4 | IO pengembangan digital dwiarah BOOL D4. |
4.3.1 Konfigurasi IO Digital
Semua digital mempunyai IO anak untuk mengkonfigurasi tingkah laku mereka termasuk mod pengendalian yang mengawal cara digital itu akan beroperasi. Setiap digital akan mempunyai set pilihan yang berbeza yang tersedia. Lihat GUI untuk butiran tentang pilihan yang tersedia untuk apa IO.
| Laluan IO Kanak-kanak | Penerangan |
| …/mod | STRING Mod operasi untuk digital. Pilihan: “input“, “output”, “pwm”, “timer”, “encoder”, “capture”, “uart_rx”, “uart_tx”, “can_rx”, “can_tx”, “pru_input”, atau “pru_output” |
| …/isyarat_proses | STRING Nama isyarat kawalan proses, jika ada. |
| …/mod_tarik | STRING Mod tarik atas/bawah untuk input digital. Pilihan: "atas", "bawah", atau "lumpuhkan" |
4.4 Kawalan Geganti
Kedua-dua geganti dikawal secara bebas dan berkongsi jenis antara muka yang sama. Gantikan relay_x dengan relay_a atau relay_b masing-masing.
| Laluan IO | Penerangan |
| /fx4/relay _ x/permit / arahan _ pengguna | BOOL Mengarahkan geganti dibuka atau ditutup. Arahan benar akan cuba menutup geganti jika saling kunci diberikan, dan perintah palsu akan sentiasa membuka geganti. |
| /fx4/geganti _ x/keadaan | READONLY STRING Keadaan semasa geganti. Geganti berkunci dibuka tetapi tidak boleh ditutup kerana saling kunci. Negeri: "dibuka", "ditutup", atau "dikunci" |
| /fx4/geganti _ x/secara automatik _ tutup | BOOL Apabila ditetapkan kepada benar, geganti akan ditutup secara automatik apabila saling kunci diberikan. Palsu secara lalai. |
| /fx4/geganti _ x/ kitaran _ kiraan | NOMBOR BACA Bilangan kitaran geganti sejak tetapan semula terakhir. Berguna untuk menjejaki seumur hidup geganti. |
4.5 Vol Tinggitage Modul
Lihat IGX – Manual Pengaturcara untuk butiran mengenai vol tinggi FX4tage antara muka. Laluan induk komponen ialah /fx4/high_votlage .
4.6 Pengawal Dos
Lihat IGX – Manual Pengaturcara untuk butiran mengenai antara muka pengawal dos FX4. Laluan induk komponen ialah /fx4/dose_controller .
FX4 Python Examples
5.1 Logger Data menggunakan HTTP
bekas iniample menunjukkan cara menangkap beberapa bacaan dan menyimpannya ke CSV file. Dengan memilih kelewatan yang lama antara bacaan, anda boleh melakukan pengelogan data jangka panjang walaupun FX4 sampkadar ling ditetapkan lebih tinggi. Ini membolehkan anda mengumpul dan menyimpan ukuran secara berterusan dalam tempoh yang panjang tanpa membebankan sistem, memastikan data ditangkap pada selang masa yang sesuai untuk analisis anda. Kelewatan antara bacaan membantu mengawal kadar data dilog, membolehkan penyimpanan yang cekap dan mengurangkan risiko kehilangan titik data sambil masih mendapat manfaat daripada s kelajuan tinggiampling untuk pengukuran masa nyata.
5.2 GUI Python Mudah
Bekas keduaample menggunakan alat GUI Tkinter, yang dibina untuk Python, untuk mencipta paparan arus yang diukur. Antara muka ini membolehkan anda menggambarkan bacaan semasa dalam format grafik yang mesra pengguna. Paparan boleh diubah saiznya untuk menjadikannya cukup besar untuk dibaca dari seberang bilik, menjadikannya sesuai untuk senario di mana pemantauan masa nyata diperlukan dalam ruang yang lebih besar. Tkinter menyediakan cara mudah untuk mencipta antara muka interaktif, dan dengan menyepadukannya dengan FX4, anda boleh dengan cepat membina paparan visual arus yang diukur yang boleh disesuaikan untuk memenuhi keperluan khusus anda.
5.3 Mudah WebSoket Cthample
bekas iniample menunjukkan WebAntara muka soket, yang merupakan kaedah pilihan untuk membaca data daripada FX4 apabila lebar jalur maksimum diperlukan. WebSoket menyediakan saluran komunikasi masa nyata dupleks penuh, membolehkan pemindahan data yang lebih pantas dan lebih cekap berbanding kaedah lain.
bekas ituample membaca siri samples, melaporkan purata masa setiap sample dan kependaman maksimum, dan menyimpan data ke CSV file untuk analisis nanti. Persediaan ini membolehkan pemantauan masa nyata yang cekap dan penyimpanan data yang mudah untuk pemprosesan pasca.
Prestasi khusus yang boleh dicapai dengan WebSoket bergantung pada kebolehpercayaan antara muka Ethernet anda dan keutamaan relatif aplikasi anda. Untuk hasil yang optimum, pastikan rangkaian anda stabil dan penghantaran data FX4 diutamakan jika perlu.
Versi: v3
FX4 Python Exampkurang: 21
Dokumen / Sumber
 |
Pengaturcara PYRAMID FX4 [pdf] Manual Arahan Pengaturcara FX4, FX4, Pengaturcara |