www.pyramid.tech
FX4
FX4 Programmer Manual
I-ID yedokhumenti: 2711715845
Inguqulo: v3
FX4 Umhleli
I-ID yedokhumenti: 2711715845
FX4 – FX4 Programmer Manual
I-ID Yedokhumenti: 2711650310
| Umbhali | Matthew Nichols |
| Umnikazi | Umholi wephrojekthi |
| Inhloso | Chaza imiqondo yokuhlela edingekayo ukuze usebenzise i-API futhi wandise umkhiqizo ngokusebenzisa izinhlelo zokusebenza zangaphandle. |
| Ububanzi | Imiqondo yezinhlelo ehlobene ne-FX4. |
| Izilaleli Ezihlosiwe | Abathuthukisi besoftware abanentshisekelo yokusebenzisa umkhiqizo. |
| Inqubo | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Process |
| Ukuqeqeshwa | AKUFANELEKI |
Ukulawula Inguqulo
| Inguqulo | Incazelo | Ilondolozwe ngu | Kulondolozwe kuvuliwe | Isimo |
| v3 | Kwengezwe i-over elulaview nokunye exampLes. | Matthew Nichols | Mar 6, 2025 10:29 PM | KWAMUKELWE |
| v2 | Kwengezwe izixhumanisi zedijithali ze-IO nezithenjwa emuva ku-IGX. | Matthew Nichols | Meyi 3, 2024 7:39 PM | KWAMUKELWE |
| v1 | Ukukhishwa kokuqala, kusengumsebenzi oqhubekayo. | Matthew Nichols | Feb 21, 2024 11:25 PM | KWAMUKELWE |
Ukulawula Idokhumenti Hhayi Reviewed
Inguqulo yamanje yedokhumenti: v.1
Cha kabushaviewezabelwe.
1.1 Amasiginesha
enguqulweni yakamuva yedokhumenti
NgoLwesihlanu, Mar 7, 2025, 10:33 PM UTC
Matthew Nichols wasayina; okusho ukuthi: Review
Izithenjwa
| Idokhumenti | I-ID yedokhumenti | Umbhali | Inguqulo |
| IGX - Imanuwali Yomhleli | 2439249921 | Matthew Nichols | 1 |
I-FX4 Programming Overview
Iphrosesa ye-FX4 isebenza endaweni ebizwa nge-IGX, eyakhelwe ohlelweni lwesikhathi sangempela oluthembeke kakhulu lwe-QNX oluvela kuBlackBerry (I-QNX Webindawo¹). I-IGX inikeza isixhumi esibonakalayo sohlelo lokusebenza esiguquguqukayo nesiphelele (API) kubasebenzisi abafuna ukubhala isofthiwe yabo yekhompuyutha abasingathi.
Imvelo ye-IGX yabelwana ngayo yonke eminye imikhiqizo yePyramid, okuvumela izixazululo zesoftware ezenzelwe umkhiqizo owodwa ukuthi zidluliselwe kwabanye kalula.
Abahleli bangabhekisela emibhalweni ephelele ye-IGX etholakala kuPhiramidi webisayithi ku: IGX | I-Modular Control System Framework yesimanje Web-Vula izinhlelo zokusebenza²
Lesi sigaba sinikeza isingeniso sokuhlola izindlela ezimbili ze-API: I-HTTP isebenzisa ifomethi ye-JSON kanye nama-EPICS. Ukuze kube lula, iPython (I-Python Webindawo³) isetshenziswa njenge-exampibamba ulimi lwekhompiyutha, olufinyelelekayo futhi olusebenziseka kalula kubahleli bezinhlelo abangebona abachwepheshile.
3.1 Ukusebenzisa i-Python ne-HTTP
Njengesiboneloample, cabanga ukuthi ufuna ukufunda isamba samaza akaliwe ngePython. Udinga i- URL kuleyo IO ethile. I-FX4 web I-GUI ihlinzeka ngendlela elula yokuthola lokhu: vele uchofoze kwesokudla endaweni bese ukhetha 'Kopisha i-HTTP URL' ukukopisha iyunithi yezinhlamvu ebhodini lokunamathisela.

Manje ungasebenzisa i-Python ukuhlola ukuxhumeka kusofthiwe yomsebenzisi nge-HTTP ne-JSON. Ungase udinge ukungenisa izicelo namalabhulali e-json ukuze uphathe izicelo ze-HTTP nokwahlukaniswa kwedatha.
1 I-Python HTTP Elula Example
3.2 Ukusebenzisa i-EPICS
Inqubo yokuxhuma i-FX4 nge-EPICS (I-Experimental Physics and Industrial Control System) iyafana. I-EPICS iqoqo lamathuluzi esofthiwe nezinhlelo zokusebenza ezisetshenziselwa ukuthuthukisa nokusebenzisa izinhlelo zokulawula ezisabalalisiwe, ezisetshenziswa kabanzi ezikhungweni zesayensi.
- Thola igama le-EPICS process variable (PV) le-IO oyifunayo.
- Ngenisa umtapo wezincwadi we-EPICS futhi ufunde inani.
2 Thola igama le-EPICS PV
3 I-Python Elula EPICS Example
Ukwengeza, Iphiramidi idale insiza (EPICS Xhuma⁴) okukuvumela ukuthi ugade okuguquguqukayo kwenqubo ye-EPICS ngesikhathi sangempela. Leli thuluzi liwusizo ukuqinisekisa ukuthi igama le-EPICS PV lilungile futhi i-FX4 inikezela nge-PV ngendlela efanele kunethiwekhi yakho.
4 PTC EPICS Xhuma
I-FX4 Programming API
Imiqondo nezindlela ezichazwe kuleli bhukwana zakhela phezu kwemiqondo esungulwe ku-IGX - Imanuwali Yohlelo. Sicela ubheke lowo mbhalo ukuze uthole incazelo kanye nesibampokuncane kokuthi izinhlelo eziyisisekelo ze-IGX nezixhumi ezibonakalayo zisebenza kanjani. Le manuwali izofaka kuphela i-IO eqondene nedivayisi kanye nokusebenza okuhlukile kwe-FX4.
4.1 Okokufaka kwe-Analog IO
Le IO ihlobene nokumisa nokuqoqa idatha kokokufaka kwamanje kwe-analog ye-FX4. Amayunithi okokufaka kwesiteshi asekelwe esimisweni esilungisekayo somsebenzisi esibizwa ngokuthi “Sample Units”, izinketho ezivumelekile zifaka i-pA, nA, uA, mA, kanye no-A.
Zonke iziteshi ezi-4 zisebenzisa i-interface efanayo ye-IO futhi zilawulwa ngokuzimela. Esikhundleni se-channel_x ufake isiteshi_1 , channel_2 , channel_3 , noma channel_4 ngokulandelanayo.
| Indlela ye-IO | Incazelo |
| /fx4/adc/channel_x | FUNDA KUPHELA NUMBER Okokufaka kwamanje okukaliwe. |
| /fx4/adc/channel_x/scalar | NUMBER Isikala esingenayunithi esilula sisetshenziswe esiteshini, singu-1 ngokuzenzakalelayo. |
| /fx4/adc/channel_x/zero_offset | NUMBER Ukulinganisa kwamanje ku-nA esiteshini. |
I-IO elandelayo ayizimele futhi isetshenziswa kuwo wonke amashaneli kanye kanye.
| Indlela ye-IO | Incazelo |
| /fx4/channel_sum | FUNDA KUPHELA NUMBER Isamba seziteshi zamanje zokufakwayo. |
| /fx4/adc_unit | STRING Imisa amayunithi abasebenzisi bamanje esiteshini ngasinye nesamba. Izinketho: “pa”, “na”, “ua”, “ma”, “a” |
| /fx4/range | STRING Imisa ububanzi bamanje bokufaka. Bona i-GUI ukuthi ikhodi ngayinye yobubanzi ihambisana kanjani nemikhawulo ephezulu yamanje yokufaka kanye ne-BW. Izinketho: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7” |
| /fx4/adc/sample_frequency | NUMBER Imvamisa ku-Hz ethi sampidatha izolinganiselwa kokuthi. Lokhu kulawula izinga lesignali kuya kumsindo kanye nedatha yazo zonke iziteshi. |
| /fx4/adc/conversion_frequency | NUMBER Imvamisa ku-Hz i-ADC ezoguqulela amanani e-analog kuya edijithali kuwo. Ngokuzenzakalelayo, lokhu kungu-100kHz, futhi ngeke udinge ukushintsha leli nani. |
| /fx4/adc/offset_correction | FUNDA KUPHELA NUMBER Isamba sakho konke ukulungisa kwamanje kwesiteshi. |
4.2 I-Analog Output IO
Lezi IO zihlobene nokucushwa kokuphumayo kwe-analog yenhloso evamile ye-FX4 etholakala ngaphansi kokokufaka kwe-analog kuphaneli yangaphambili. Zonke iziteshi ezi-4 zisebenzisa i-interface efanayo ye-IO futhi zilawulwa ngokuzimela. Esikhundleni se-channel_x ufake isiteshi_1 , channel_2 , channel_3 , noma channel_4 ngokulandelanayo.
| Indlela ye-IO | Incazelo |
| /fx4/dac /channel_x | NUMBER Umyalo voltage okukhiphayo. Leli nani lingabhalelwa kuphela uma imodi yokukhipha isethelwe kumanuwali. |
| /fx4/dac/channel_x/readback | READONLY NUMBER Measured voltagokukhiphayo. Lokhu kusiza kakhulu uma usebenzisa imodi yokukhipha inkulumo. |
| /fx4/dac/channel_x/output_mode | STRING Isetha imodi yokukhiphayo yesiteshi. Izinketho: “manual”, “expression”, “process_control” |
| /fx4/dac/channel _ x/slew_control_enable | I-BOOL Inika amandla noma ikhubaza ukukhawulelwa kwesilinganiso sokubulala. |
| /fx4/dac/channel_ x/slew_rate | NUMBER Izinga lokusheshisa ngama-V/s esiteshini. |
| /fx4/dac/channel_x/upper_limit | NUMBER Umkhawulo womyalo ovunyelwe voltage yesiteshi. Isebenza kuwo wonke amamodi okusebenza. |
| /fx4/dac/channel _ x/low_limit | NUMBER Ubuncane bomyalo obuvunyelwe voltage yesiteshi. Isebenza kuwo wonke amamodi okusebenza. |
| /fx4/dac/channel _ x/ okukhiphayo _ isisho | STRING Imisa iyunithi yezinhlamvu zenkulumo esetshenziswa isiteshi uma ikwimodi yokukhipha inkulumo. |
| /fx4/dac/channel _ x/reset_button | BUTTON Isetha kabusha umyalo voltage kwe0. |
4.3 Okokufaka Kwedijithali kanye Nemiphumela
Lawa ma-IO ahlobene nokulawula okokufaka kwedijithali okuyinjongo evamile kanye nemiphumela etholakala ku-FX4.
| Indlela ye-IO | Incazelo |
| /fx4/fr1 | READONLY BOOL Fiber receiver 1. |
| /fx4/ft1 | I-BOOL Fiber Transmitter 1. |
| /fx4/fr2 | READONLY BOOL Fiber receiver 2. |
| /fx4/ft2 | I-BOOL Fiber Transmitter 2. |
| /fx4/fr3 | READONLY BOOL Fiber receiver 3. |
| /fx4/ft3 | I-BOOL Fiber Transmitter 3. |
| /fx4/digital_expansion/d1 | I-BOOL D1 yokunwetshwa kwedijithali okuphindwe kabili kwe-IO. |
| /fx4/digital_expansion/d2 | I-BOOL D2 yokunwetshwa kwedijithali okuphindwe kabili kwe-IO. |
| /fx4/digital_expansion/d3 | I-BOOL D3 yokunwetshwa kwedijithali okuphindwe kabili kwe-IO. |
| /fx4/digital_expansion/d4 | I-BOOL D4 yokunwetshwa kwedijithali okuphindwe kabili kwe-IO. |
4.3.1 Ukucushwa Kwedijithali ye-IO
Wonke amadijithali ane-IO yengane yokulungisa ukuziphatha kwawo okuhlanganisa nemodi yokusebenza elawula ukuthi leyo dijithali izosebenza kanjani. Idijithali ngayinye izoba nesethi ehlukile yezinketho ezitholakalayo. Bona i-GUI ngemininingwane yokuthi iziphi izinketho ezitholakalayo zalokho i-IO.
| Ingane IO Path | Incazelo |
| …/imodi | STRING Imodi yokusebenza yedijithali. Izinketho: “okokufaka“, “output”, “pwm”, “timer”, “encoder”, “capture”, “uart_rx”, “uart_tx”, “can_rx”, “can_tx”, “pru_input”, noma “pru_output” |
| …/process_signal | STRING Igama lesignali yokulawula inqubo, uma likhona. |
| …/donsa_imodi | STRING Imodi yokudonsela phezulu/phansi ukuze uthole okokufaka kwedijithali. Izinketho: "phezulu", "phansi", noma "khubaza" |
4.4 Ukulawulwa kwe-Relay
Kokubili ukudluliselwa kulawulwa ngokuzimela futhi kwabelana ngohlobo olufanayo lwesixhumi esibonakalayo. Faka esikhundleni i-relay_x nge-relay_a noma i-relay_b ngokulandelanayo.
| Indlela ye-IO | Incazelo |
| /fx4/relay _ x/imvume / umsebenzisi _ umyalo | I-BOOL Iyala ukuthi ukudluliselwa kuvuliwe noma kuvaliwe. Umyalo weqiniso uzozama ukuvala i-relay uma izingidi zinikezwa, futhi umyalo wamanga uzohlala uvule i-relay. |
| /fx4/relay _ x/state | READONLY STRING Isimo samanje se-relay. Ukudluliselwa okukhiyiwe kuvuliwe kodwa akukwazi ukuvalwa ngenxa yokukhiya. Amazwe: "kuvuliwe", "kuvaliwe", noma "kukhiyiwe" |
| /fx4/relay _ x/ngokuzenzakalelayo _ vala | BOOL Uma kusethelwe kuqiniso, i-relay izovala ngokuzenzakalelayo lapho izixhumo zinikezwa. Amanga ngokuzenzakalelayo. |
| /fx4/relay _ x/ umjikelezo _ ukubala | FUNDA KUPHELA INOMBOLO Inani lemijikelezo yokudlulisa kusukela ekusethwe kabusha kokugcina. Iwusizo ekulandeleleni impilo yokudlulisela phambili. |
4.5 Ivolumu ephezulutage Imojuli
Bheka I-IGX – Programmer Manual ukuze uthole imininingwane nge-FX4 high voltage interface. Indlela yomzali yengxenye ithi /fx4/high_votlage .
4.6 Isilawuli somthamo
Bheka I-IGX - Imanuwali Yomhleli ukuze uthole imininingwane ngesixhumi esibonakalayo sokulawula umthamo we-FX4. Indlela yomzali yengxenye ithi /fx4/dose_controller .
I-FX4 Python ExampLes
5.1 Isigcini Sedatha sisebenzisa i-HTTP
Lesi exampi-le ibonisa ukuthi ithwebula kanjani inani lokufundwayo futhi ikulondoloze ku-CSV file. Ngokukhetha ukubambezeleka okude phakathi kokufundwayo, ungenza ukuloga kwedatha yesikhathi eside noma ngabe ama-FX4 sampizinga le-ling libekwe phezulu. Lokhu kukuvumela ukuthi uqoqe futhi ugcine izilinganiso ngokuqhubekayo ezikhathini ezinwetshiwe ngaphandle kokugaxa isistimu, uqinisekise ukuthi idatha ithathwa ngezikhathi ezifanele ukuhlaziya kwakho. Ukubambezeleka phakathi kokufundwa kusiza ukulawula ijubane idatha efakwe ngalo, okuvumela ukugcinwa okuphumelelayo kanye nokunciphisa ingcuphe yokushoda kwamaphoyinti edatha kuyilapho usazuza kusivinini esikhulu.ampling ukuze uthole izilinganiso zesikhathi sangempela.




5.2 I-Python GUI elula
Eyesibili exampI-le isebenzisa ithuluzi le-Tkinter GUI, elakhelwe iPython, ukudala isibonisi semisinga elinganisiwe. Lesi sixhumanisi sikuvumela ukuthi ubone ngeso lengqondo ukufundwa kwamanje ngefomethi yesithombe esebenziseka kalula. Isibonisi singashintshwa usayizi ukuze sisenze sibe sikhulu ngokwanele ukuthi singafundwa egumbini lonke, okusenze sifaneleke ezimweni lapho kudingeka khona ukuqapha kwesikhathi sangempela ezindaweni ezinkulu. I-Tkinter inikeza indlela elula yokudala izixhumanisi ezisebenzisanayo, futhi ngokuyihlanganisa ne-FX4, ungakwazi ukwakha ngokushesha isibonisi esibonakalayo samaza akaliwe angenziwa ngendlela oyifisayo ukuze afanele izidingo zakho ezithile.







5.3 Ilula WebAmasokhethi Example
Lesi example ibonisa WebIsixhumi esibonakalayo samasokhethi, okuyindlela ekhethwayo yokufunda idatha ku-FX4 lapho umkhawulokudonsa omkhulu udingeka. WebAmasokhethi ahlinzeka ngesikhathi sangempela, isiteshi sokuxhumana esiyiduplex egcwele, okuvumela ukudluliswa kwedatha okushesha futhi okuphumelelayo uma kuqhathaniswa nezinye izindlela.
I-example ufunda uchungechunge sampkancane, ibika isikhathi esimaphakathi ngesample kanye nokubambezeleka okukhulu, futhi ilondoloza idatha ku-CSV file ukuze kuhlaziywe kamuva. Lokhu kusetha kuvumela ukuqapha kwesikhathi sangempela okusebenzayo kanye nokugcinwa kwedatha okulula kokucubungula ngemva kokucubungula.
Ukusebenza okuqondile okungafinyelelwa ngakho WebAmasokhethi ancike ekuthembekeni kwesixhumi esibonakalayo se-Ethernet kanye nokubalulekile okuhlobene kohlelo lwakho lokusebenza. Ukuze uthole imiphumela emihle, qinisekisa ukuthi inethiwekhi yakho izinzile nokuthi ukudluliswa kwedatha ye-FX4 kubekwa phambili uma kunesidingo.



Inguqulo: v3
I-FX4 Python Exampngaphansi: 21
Amadokhumenti / Izinsiza
![]() |
I-PYRAMID FX4 Programmer [pdf] Incwadi Yeziqondiso FX4 Programmer, FX4, Programmer |
