www.pyramid.tech
FX4
FX4 Programmer Manual
ID Dokumen: 2711715845
Versi: v3
Programmer FX4
ID Dokumen: 2711715845
FX4 - FX4 Programmer Manual
ID Dokumen: 2711650310
| Pengarang | Matthew Nichols |
| juragan | Pimpinan Proyek |
| tujuane | Nerangake konsep pemrograman sing perlu kanggo nggunakake API lan ngluwihi produk liwat aplikasi eksternal. |
| Cakupan | Konsep pemrograman sing gegandhengan karo FX4. |
| Tujuwan pamirsa | Pangembang piranti lunak sing kasengsem nggunakake produk kasebut. |
| Proses | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standar%20Manual%20Creation%20Proses |
| Latihan | ORA APLIKASI |
Kontrol versi
| Versi | Katrangan | Disimpen dening | Disimpen ing | Status |
| v3 | Added liwat prasajaview lan liyane examples. | Matthew Nichols | 6. mars 2025 10:29 | DISETUJUNI |
| v2 | Nambahake antarmuka IO digital lan referensi bali menyang IGX. | Matthew Nichols | 3 Mei 2024 7:39 | DISETUJUNI |
| v1 | Rilis awal, isih ana ing proses. | Matthew Nichols | 21 Februari 2024 11:25 | DISETUJUNI |
Kontrol Dokumen Ora Reviewed
Versi dokumen saiki: v.1
Ora reviewsing diutus.
1.1 Teken
kanggo versi dokumen paling anyar
Jumuah, 7 Mar 2025, 10:33 UTC
Matthew Nichols mlebu ; tegesipun: Review
Referensi
| Dokumen | Dokumen ID | Pengarang | Versi |
| IGX – Programmer Manual | 2439249921 | Matthew Nichols | 1 |
FX4 Programming Overview
Prosesor FX4 mlaku ing lingkungan sing diarani IGX, sing dibangun ing sistem operasi realtime QNX sing bisa dipercaya saka BlackBerry (QNX Websitus¹). IGX nyedhiyakake antarmuka program aplikasi (API) sing fleksibel lan lengkap kanggo pangguna sing pengin nulis piranti lunak komputer host dhewe.
Lingkungan IGX dienggo bareng ing produk Pyramid liyane, saéngga solusi piranti lunak sing dikembangake kanggo siji produk bisa gampang ditransfer menyang liyane.
Programer bisa ngrujuk menyang dokumentasi lengkap kanggo IGX kasedhiya ing Pyramid websitus ing: IGX | Framework Sistem Kontrol Modular Modern kanggo Web-Aplikasi sing diaktifake²
Bagean iki nyedhiyakake pambuka kanggo nguji rong cara API: HTTP nggunakake format JSON lan EPICS. Kanggo kesederhanaan, Python (Python Websitus³) digunakake minangka example host basa komputer, kang bisa diakses lan gampang kanggo nggunakake programer non-profesional.
3.1 Nggunakake Python lan HTTP
Minangka mantanample, nganggep sampeyan pengin maca jumlah arus diukur karo Python. Sampeyan mbutuhake URL kanggo IO tartamtu. FX4 web GUI nyedhiyakake cara sing gampang kanggo nemokake iki: cukup klik-tengen ing lapangan banjur pilih 'Salin HTTP URL' kanggo nyalin string menyang clipboard.
Saiki sampeyan bisa nggunakake Python kanggo nyoba konektivitas menyang piranti lunak pangguna liwat HTTP lan JSON. Sampeyan bisa uga kudu ngimpor panjalukan lan perpustakaan json kanggo nangani panjalukan HTTP lan parsing data.
1 Prasaja Python HTTP Example
3.2 Nggunakake EPICS
Proses kanggo nyambungake FX4 liwat EPICS (Fisika Eksperimen lan Sistem Kontrol Industri) padha. EPICS minangka sakumpulan piranti lunak lan aplikasi sing digunakake kanggo ngembangake lan ngleksanakake sistem kontrol sing disebarake, sing akeh digunakake ing fasilitas ilmiah.
- Entuk jeneng variabel proses EPICS (PV) kanggo IO sing dikarepake.
- Impor perpustakaan EPICS lan maca nilai.
2 Njaluk Jeneng PV EPICS
3 Epik Python Prasaja Example
Kajaba iku, Pyramid nggawe utilitas (EPICS Sambungake⁴) sing ngidini sampeyan ngawasi variabel proses EPICS ing wektu nyata. Alat iki migunani kanggo konfirmasi yen jeneng PV EPICS bener lan FX4 nglayani PV kanthi bener ing jaringan sampeyan.
4 PTC EPICS Sambungake
FX4 Programming API
Konsep lan cara sing diterangake ing manual iki dibangun ing konsep sing ditetepake ing IGX - Manual Programmer. Mangga deleng dokumen kasebut kanggo panjelasan lan examples carane dhasar IGX program lan antarmuka bisa. Manual iki mung bakal nutupi IO lan fungsi khusus piranti sing unik kanggo FX4.
4.1 Input Analog IO
IO iki ana hubungane karo konfigurasi lan ngumpulake data babagan input saiki analog saka FX4. Unit input saluran adhedhasar setelan sing bisa dikonfigurasi pangguna sing diarani "Sample Unit", opsi sing bener kalebu pA, nA, uA, mA, lan A.
Kabeh 4 saluran nggunakake antarmuka IO padha lan kontrol independen. Ganti channel_x nganggo channel_1 , channel_2 , channel_3 , utawa channel_4.
| Jalur IO | Katrangan |
| /fx4/adc/channel_x | READONLY NUMBER Input saiki sing diukur. |
| /fx4/adc/channel_x/scalar | NUMBER Skalar tanpa unit prasaja ditrapake ing saluran, 1 minangka standar. |
| /fx4/adc/channel_x/zero_offset | NUMBER Offset saiki ing nA kanggo saluran. |
IO ing ngisor iki ora saluran independen lan ditrapake kanggo kabeh saluran bebarengan.
| Jalur IO | Katrangan |
| /fx4/channel_sum | READONLY NUMBER Jumlah saluran input saiki. |
| /fx4/adc_unit | STRING Nyetel unit pangguna saiki kanggo saben saluran lan jumlah. Pilihan: "pa", "na", "ua", "ma", "a" |
| /fx4/rentang | STRING Nyetel kisaran input saiki. Waca GUI carane saben kode sawetara cocog karo watesan input saiki maksimum lan BW. Pilihan: "0", "1", "2", "3", "4", "5", "6", "7" |
| /fx4/adc/sample_frekuensi | NUMBER Frekuensi ing Hz sing sample data bakal averaged kanggo. Iki ngontrol sinyal-ke-noise lan tingkat data kanggo kabeh saluran. |
| /fx4/adc/conversion_frequency | NUMBER Frekuensi ing Hz sing ADC bakal ngowahi analog menyang nilai digital ing. Kanthi gawan, iki 100kHz, lan sampeyan mung arang kudu ngganti nilai iki. |
| /fx4/adc/offset_correction | READONLY NUMBER Jumlah kabeh offset saluran saiki. |
4.2 Output Analog IO
IO iki ana hubungane karo konfigurasi output analog tujuan umum saka FX4 sing ditemokake ing ngisor input analog ing panel ngarep. Kabeh 4 saluran nggunakake antarmuka IO padha lan kontrol independen. Ganti channel_x nganggo channel_1 , channel_2 , channel_3 , utawa channel_4.
| Jalur IO | Katrangan |
| /fx4/dac /channel_x | NUMBER Command voltage output. Nilai iki mung bisa ditulis nalika mode output disetel menyang manual. |
| /fx4/dac/channel_x/readback | NOMOR BISA Diukur voltage output. Iki paling mbiyantu nalika nggunakake mode output ekspresi. |
| /fx4/dac/channel_x/output_mode | STRING Nyetel mode output kanggo saluran. Pilihan: "manual", "ekspresi", "process_control" |
| /fx4/dac/saluran _ x/slew_control_enable | BOOL Ngaktifake utawa mateni watesan tingkat mateni. |
| /fx4/dac/channel_x/slew_rate | NUMBER Slew rate ing V/s kanggo saluran. |
| /fx4/dac/channel_x/upper_limit | NUMBER Perintah maksimum sing diidini voltage kanggo saluran. Ditrapake kanggo kabeh mode operasi. |
| /fx4/dac/saluran _ x/lower_limit | NUMBER Perintah minimal sing diidini voltage kanggo saluran. Ditrapake kanggo kabeh mode operasi. |
| /fx4/dac/channel _ x/ output _ expression | STRING Nyetel string ekspresi sing digunakake dening saluran nalika ana ing mode output ekspresi. |
| /fx4/dac/saluran _ x/tombol_reset | BUTTON Ngreset printah voltage wis 0. |
4.3 Input lan Output Digital
IO iki ana hubungane karo ngontrol macem-macem input lan output digital tujuan umum sing ditemokake ing FX4.
| Jalur IO | Katrangan |
| /fx4/fr1 | READONLY BOOL Fiber receiver 1. |
| /fx4/ft1 | Pemancar Serat BOOL 1. |
| /fx4/fr2 | READONLY BOOL Fiber receiver 2. |
| /fx4/ft2 | Pemancar Serat BOOL 2. |
| /fx4/fr3 | READONLY BOOL Fiber receiver 3. |
| /fx4/ft3 | Pemancar Serat BOOL 3. |
| /fx4/digital_expansion/d1 | BOOL D1 bidirectional digital expansion IO. |
| /fx4/digital_expansion/d2 | BOOL D2 bidirectional digital expansion IO. |
| /fx4/digital_expansion/d3 | BOOL D3 bidirectional digital expansion IO. |
| /fx4/digital_expansion/d4 | BOOL D4 bidirectional digital expansion IO. |
4.3.1 Konfigurasi IO Digital
Kabeh digitals duwe anak IO kanggo configuring prilaku kalebu mode operasi kang kontrol carane digital bakal operate. Saben digital bakal duwe macem-macem pilihan sing kasedhiya. Waca GUI kanggo rincian apa opsi kasedhiya kanggo apa IO.
| Bocah IO Path | Katrangan |
| …/modus | STRING Mode operasi kanggo digital. Pilihan: "input", "output", "pwm", "timer", "enkoder", "capture", "uart_rx", "uart_tx", "can_rx", "can_tx", "pru_input", utawa "pru_output" |
| …/process_signal | STRING Jeneng sinyal kontrol proses, yen ana siji. |
| …/mode_tarik | STRING Mode tarik munggah/mudhun kanggo input digital. Pilihan: "munggah", "mudhun", utawa "mateni" |
4.4 Kontrol relay
Loro-lorone relay dikontrol kanthi mandiri lan nuduhake antarmuka sing padha. Ganti relay_x karo relay_a utawa relay_b mungguh.
| Jalur IO | Katrangan |
| /fx4/relay _ x/ijin / panganggo _ printah | BOOL mrentah relay mbukak utawa ditutup. A printah bener bakal nyoba kanggo nutup relay yen interlocks diwenehake, lan printah palsu bakal tansah mbukak relay. |
| /fx4/relay _ x/state | READONLY STRING Status relay saiki. Relay sing dikunci mbukak nanging ora bisa ditutup amarga interlock. Negara: "dibukak", "ditutup", utawa "dikunci" |
| /fx4/relay _ x/otomatis _ nutup | BOOL Yen disetel dadi bener, relay bakal ditutup kanthi otomatis nalika interlocks diwenehake. Palsu kanthi gawan. |
| /fx4/relay _ x/ cycle _ count | READONLY NUMBER Jumlah siklus relay wiwit reset pungkasan. Migunani kanggo nelusuri umur relay. |
4.5 Dhuwur Voltage Modul
Waca IGX - Programmer Manual kanggo rincian ing FX4 dhuwur voltage antarmuka. Path induk komponen yaiku /fx4/high_votlage .
4.6 Pengontrol dosis
Deleng IGX - Manual Programmer kanggo rincian babagan antarmuka pengontrol dosis FX4. Jalur induk komponen yaiku /fx4/dose_controller.
FX4 Python Examples
5.1 Logger Data nggunakake HTTP
Mantan ikiample nduduhake carane njupuk sawetara wacan lan nyimpen menyang CSV file. Kanthi milih wektu tundha dawa antarane maca, sampeyan bisa nindakake log data long-term sanajan FX4 samptingkat ling disetel luwih dhuwur. Iki ngidini sampeyan terus-terusan ngumpulake lan nyimpen pangukuran sajrone wektu sing suwe tanpa ngganggu sistem, mesthekake yen data dijupuk kanthi interval sing cocog kanggo analisis sampeyan. Wektu tundha ing antarane maca mbantu ngatur kecepatan data dicathet, ngidini panyimpenan sing efisien lan nyuda risiko ilang titik data nalika isih entuk manfaat saka s kacepetan dhuwur.ampling kanggo pangukuran wektu nyata.
5.2 GUI Python prasaja
Mantan sing nomer loroample nggunakake alat GUI Tkinter, sing dibangun kanggo Python, kanggo nggawe tampilan saka arus diukur. Antarmuka iki ngidini sampeyan nggambarake bacaan saiki ing format grafis sing ramah pangguna. Tampilan kasebut bisa diowahi ukurane supaya cukup gedhe kanggo maca saka ruangan, saengga cocog kanggo skenario ing ngendi pemantauan wektu nyata dibutuhake ing papan sing luwih gedhe. Tkinter nyedhiyakake cara sing gampang kanggo nggawe antarmuka interaktif, lan kanthi nggabungake karo FX4, sampeyan bisa kanthi cepet nggawe tampilan visual saka arus sing diukur sing bisa disesuaikan kanggo cocog karo kabutuhan tartamtu.
5.3 Prasaja WebSoket Example
Mantan ikiample nduduhake ing WebAntarmuka Sockets, yaiku cara sing disenengi kanggo maca data saka FX4 nalika bandwidth maksimal dibutuhake. WebSoket nyedhiyakake saluran komunikasi full-duplex wektu nyata, ngidini transfer data sing luwih cepet lan luwih efisien dibandhingake karo cara liyane.
mantanample maca seri samples, laporan wektu rata-rata saben sample lan latensi maksimum, lan nyimpen data menyang CSV file kanggo analisis mengko. Persiyapan iki ngidini kanggo ngawasi wektu nyata sing efisien lan panyimpenan data sing gampang kanggo proses pasca.
Kinerja tartamtu sing bisa digayuh karo WebSockets gumantung ing linuwih antarmuka Ethernet lan prioritas relatif saka aplikasi. Kanggo asil sing optimal, priksa manawa jaringan sampeyan stabil lan transmisi data FX4 diutamakake yen perlu.
Versi: v3
FX4 Python Exampiki: 21
Dokumen / Sumber Daya
 |
PYRAMID FX4 Programmer [pdf] Instruksi Manual FX4 Programmer, FX4, Programmer |