PYRAMID logowww.pyramid.tech
FX4
FX4 Programmer Manual
I-ID yedokhumenti: 2711715845
Inguqulo: v3I-PYRAMID FX4 Programmer

FX4 Umhleli

I-ID yedokhumenti: 2711715845
FX4 – FX4 Programmer Manual

I-PYRAMID FX4 Programmer - isithonjana 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

I-PYRAMID FX4 Programmer - isithonjana 1 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.

I-PYRAMID FX4 Programmer - Isebenzisa iPython ne-HTTP

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.

I-PYRAMID FX4 Programmer - Izicelo ze-HTTP nokwahlukaniswa kwedatha1 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.

  1. https://blackberry.qnx.com/en
  2. https://pyramid.tech/products/igx
  3. https://www.python.org/
  1. Thola igama le-EPICS process variable (PV) le-IO oyifunayo.
  2. Ngenisa umtapo wezincwadi we-EPICS futhi ufunde inani.

PYRAMID FX4 Programmer - EPICS inqubo variable2 Thola igama le-EPICS PVPYRAMID FX4 Programmer - Simple Python EPICS Example3 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.

I-PYRAMID FX4 Programmer - EPICS Connect4 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.

I-PYRAMID FX4 Programmer - Isilondolozi Sedatha sisebenzisa i-HTTPI-PYRAMID FX4 Programmer - Isilondolozi Sedatha sisebenzisa i-HTTP 2I-PYRAMID FX4 Programmer - Isilondolozi Sedatha sisebenzisa i-HTTP 3I-PYRAMID FX4 Programmer - Isilondolozi Sedatha sisebenzisa i-HTTP 4

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.

PYRAMID FX4 Programmer - Simple Python GUII-PYRAMID FX4 Programmer - Simple Python GUI 2I-PYRAMID FX4 Programmer - Simple Python GUI 3I-PYRAMID FX4 Programmer - Simple Python GUI 4I-PYRAMID FX4 Programmer - Simple Python GUI 5I-PYRAMID FX4 Programmer - Simple Python GUI 6I-PYRAMID FX4 Programmer - Simple Python GUI 7

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.

I-PYRAMID FX4 Programmer - Ilula WebAmasokhethi ExampleI-PYRAMID FX4 Programmer - Ilula WebAmasokhethi Example 2I-PYRAMID FX4 Programmer - Ilula WebAmasokhethi Example 3

Inguqulo: v3
I-FX4 Python Exampngaphansi: 21

Amadokhumenti / Izinsiza

I-PYRAMID FX4 Programmer [pdf] Incwadi Yeziqondiso
FX4 Programmer, FX4, Programmer

Izithenjwa

Shiya amazwana

Ikheli lakho le-imeyili ngeke lishicilelwe. Izinkambu ezidingekayo zimakiwe *