www.pyramid.tech
FX4
FX4 programatzailearen eskuliburua
Dokumentua ID: 2711715845
Bertsioa: v3
FX4 programatzailea
Dokumentua ID: 2711715845
FX4 - FX4 Programatzailearen eskuliburua
Dokumentuaren IDa: 2711650310
| Egilea | Matthew Nichols |
| Jabea | Proiektuaren arduraduna |
| Helburua | APIa erabiltzeko eta produktua kanpoko aplikazioen bidez hedatzeko beharrezkoak diren programazio-kontzeptuak azaltzea. |
| Eremua | FX4rekin lotutako programazio kontzeptuak. |
| Aurreikusitako publikoa | Produktua erabiltzeko interesa duten software garatzaileak. |
| Prozesua | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=%20Manual%20Sorkuntza%20Prozesu estandarra |
| Prestakuntza | EZ DA APLIKAGARRIA |
Bertsio Kontrola
| Bertsioa | Deskribapena | Honek gordeta | On gordeta | Egoera |
| v3 | Gain sinple bat gehitu daview eta gehiago examples. | Matthew Nichols | 6/2025/10 29:XNUMX | ONARTUA |
| v2 | IO interfaze digitalak eta erreferentziak IGX-ra itzuli dira. | Matthew Nichols | 3ko maiatzaren 2024a 7:39 | ONARTUA |
| v1 | Hasierako kaleratzea, oraindik lan bat. | Matthew Nichols | 21ko otsailaren 2024a 11:25 | ONARTUA |
Dokumentuen Kontrola Ez Reviewed
Uneko dokumentuaren bertsioa: v.1
Berririk ezviewesleitutakoak.
1.1 Sinadurak
dokumentuaren azken bertsiorako
7eko martxoaren 2025a, ostirala, 10:33 UTC
Matthew Nichols sinatu zuen; esanahia: Erreview
Erreferentziak
| Dokumentua | Dokumentuaren IDa | Egilea | Bertsioa |
| IGX – Programatzailearen eskuliburua | 2439249921 | Matthew Nichols | 1 |
FX4 programazioa amaituview
FX4 prozesadorea IGX izeneko ingurune batean exekutatzen da, zeina BlackBerry-ren fidagarritasun handiko QNX denbora errealeko sistema eragilean eraikia (QNX Webgunea¹). IGX-k aplikazioen programazio interfaze (API) malgu eta integrala eskaintzen du bere ordenagailu ostalariaren softwarea idatzi nahi duten erabiltzaileentzat.
IGX ingurunea beste Pyramid produktuetan partekatzen da, produktu baterako garatutako software-soluzioak beste batzuetara erraz transferitzeko aukera emanez.
Programatzaileek Pyramid-en eskuragarri dagoen IGX-rako dokumentazio osoa ikus dezakete webgunea: IGX | Kontrol-sistema modular modernoaren esparrua Web-gaitutako aplikazioak²
Atal honek API metodoetako bi probatzeko sarrera eskaintzen du: HTTP JSON formatua erabiliz eta EPICS. Sinpletasunerako, Python (Python Webgunea³) adibide gisa erabiltzen daampprogramatzaile ez-profesionalentzat erabilerraza eta erabilerraza den lengoaia ostalari informatikoa.
3.1 Python eta HTTP erabiltzea
Example, demagun Python-ekin neurtutako korronteen batura irakurri nahi duzula. Behar duzu URL IO zehatz horretarako. FX4 web GUI-k hau aurkitzeko modu erraz bat eskaintzen du: egin klik eskuineko botoiarekin eremuan eta hautatu 'Kopiatu HTTP URL' katea arbelean kopiatzeko.
Orain Python erabil dezakezu erabiltzailearen softwarearekiko konexioa probatzeko HTTP eta JSON bidez. Baliteke eskaerak eta json liburutegiak inportatu behar izatea HTTP eskaerak eta datu-analisia kudeatzeko.
1 Python HTTP Simple Adibample
3.2 EPICS erabiltzea
FX4 EPICS (Experimental Physics and Industrial Control System) bidez konektatzeko prozesua antzekoa da. EPICS kontrol banatutako sistemak garatzeko eta ezartzeko erabiltzen diren software-tresna eta aplikazio multzoa da, instalazio zientifikoetan oso erabilia.
- Lortu EPICS prozesu-aldagaiaren izena (PV) nahi duzun IOrako.
- Inportatu EPICS liburutegia eta irakurri balioa.
2 Lortu EPICS PV izena
3 Simple Python EPICS Adibample
Gainera, Pyramid-ek utilitate bat sortu zuen (EPICS Konektatu⁴) EPICS prozesuko aldagaiak denbora errealean kontrolatzeko aukera ematen duena. Tresna hau lagungarria da EPICS PV izena zuzena den eta FX4 PV-a zure sarean behar bezala zerbitzatzen ari den baieztatzeko.
4 PTC EPICS Konektatu
FX4 Programazio APIa
Eskuliburu honetan deskribatutako kontzeptuak eta metodoak IGX – Programatzaileen Eskuliburuan ezarritako kontzeptuetan oinarritzen dira. Mesedez, ikusi dokumentu hori azalpenetarako eta adibidezampOinarrizko IGX programazioa eta interfazeak nola funtzionatzen duten jakiteko. Eskuliburu honek FX4-rako berezia den gailuaren IO eta funtzionaltasun espezifikoak bakarrik landuko ditu.
4.1 Sarrera analogikoa IO
IO hauek FX4-ren korronte analogikoko sarreretan datuak konfiguratzeari eta biltzeari dagozkio. Kanalaren sarreren unitateak erabiltzaileak "Sample Units”, baliozko aukeren artean pA, nA, uA, mA eta A daude.
4 kanal guztiek interfaze IO bera erabiltzen dute eta modu independentean kontrolatzen dira. Ordeztu channel_x channel_1 , channel_2 , channel_3 edo channel_4-rekin hurrenez hurren.
| IO Bidea | Deskribapena |
| /fx4/adc/channel_x | IRAKURTZEKO ZENBAKIA Korronte-sarrera neurtua. |
| /fx4/adc/channel_x/scalar | ZENBAKIA Unitaterik gabeko eskalar sinplea kanalari aplikatuta, 1 lehenespenez. |
| /fx4/adc/channel_x/zero_offset | ZENBAKIA Kanalaren uneko desplazamendua nAtan. |
Ondorengo IOak ez dira kanal independenteak eta kanal guztietan aplikatzen dira aldi berean.
| IO Bidea | Deskribapena |
| /fx4/channel_sum | IRAKURTZEKO ZENBAKIA Uneko sarrerako kanalen batura. |
| /fx4/adc_unit | STRING Uneko erabiltzaile-unitateak ezartzen ditu kanal eta batura bakoitzeko. Aukerak: “pa”, “na”, “ua”, “ma”, “a” |
| /fx4/barrutia | STRING Uneko sarrera-barrutia ezartzen du. Ikusi GUI-a barruti-kode bakoitza uneko gehienezko sarrera-mugekin eta BW-rekin bat datorren jakiteko. Aukerak: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7” |
| /fx4/adc/sample_frequency | ZENBAKIA s duten Hz-ko maiztasunaample datuak batez bestekoa izango da. Honek kanal guztien seinale-zarata eta datu-tasa kontrolatzen ditu. |
| /fx4/adc/conversion_frequency | ZENBAKIA ADCak balio analogikoak digital bihurtzeko Hz-ko maiztasuna. Lehenespenez, 100 kHz-koa da, eta oso gutxitan aldatu beharko duzu balio hori. |
| /fx4/adc/offset_correction | IRAKURTZEKO ZENBAKIA Kanalaren uneko desplazamendu guztien batura. |
4.2 Irteera analogikoa IO
IO hauek aurrealdeko paneleko sarrera analogikoen azpian aurkitzen diren FX4-ren erabilera orokorreko irteera analogikoen konfigurazioari dagozkio. 4 kanal guztiek interfaze IO bera erabiltzen dute eta modu independentean kontrolatzen dira. Ordeztu channel_x channel_1 , channel_2 , channel_3 edo channel_4-rekin hurrenez hurren.
| IO Bidea | Deskribapena |
| /fx4/dac /channel_x | ZENBAKIA Agindua voltage irteera. Balio hau soilik idatz daiteke irteera modua eskuzko moduan ezartzen denean. |
| /fx4/dac/channel_x/readback | IRAKURTZEKO ZENBAKIA Bolumen neurtuatagirteera. Hau lagungarriena da adierazpenen irteera modua erabiltzean. |
| /fx4/dac/channel_x/output_mode | STRING Kanalaren irteera modua ezartzen du. Aukerak: "eskuzko", "espresioa", "prozesu_kontrola" |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Slew-tasa mugatzea gaitu edo desgaitzen du. |
| /fx4/dac/channel_ x/slew_rate | ZENBAKIA Kanalaren igoera-tasa V/s-tan. |
| /fx4/dac/channel_x/upper_limit | ZENBAKIA Onartutako gehienezko komandoa voltage kanalerako. Eragiketa modu guztietan aplikatzen da. |
| /fx4/dac/channel _ x/lower_limit | ZENBAKIA Onartutako gutxieneko komandoa voltage kanalerako. Eragiketa modu guztietan aplikatzen da. |
| /fx4/dac/channel _ x/ irteera _ adierazpena | STRING Kanalak espresio irteera moduan dagoenean erabiltzen duen adierazpen-katea ezartzen du. |
| /fx4/dac/channel _ x/reset_button | BOTOIA Komandoa berrezartzen dutage 0tik. |
4.3 Sarrera eta irteera digitalak
IO hauek FX4-n aurkitzen diren helburu orokorreko sarrera eta irteera digital desberdinak kontrolatzearekin lotuta daude.
| IO Bidea | Deskribapena |
| /fx4/fr1 | READONLY BOOL Zuntz-hargailua 1. |
| /fx4/ft1 | BOOL Zuntz igorlea 1. |
| /fx4/fr2 | READONLY BOOL Zuntz-hargailua 2. |
| /fx4/ft2 | BOOL Zuntz igorlea 2. |
| /fx4/fr3 | READONLY BOOL Zuntz-hargailua 3. |
| /fx4/ft3 | BOOL Zuntz igorlea 3. |
| /fx4/digital_expansion/d1 | BOOL D1 bi norabideko hedapen digitala IO. |
| /fx4/digital_expansion/d2 | BOOL D2 bi norabideko hedapen digitala IO. |
| /fx4/digital_expansion/d3 | BOOL D3 bi norabideko hedapen digitala IO. |
| /fx4/digital_expansion/d4 | BOOL D4 bi norabideko hedapen digitala IO. |
4.3.1 IO digitalaren konfigurazioa
Digital guztiek IO seme-alaba dute beren portaera konfiguratzeko, digital horrek nola funtzionatuko duen kontrolatzen duen funtzionamendu modua barne. Digital bakoitzak aukera sorta ezberdin bat izango du eskuragarri. Ikusi GUIa zer IOrako erabilgarri dauden aukeren inguruko xehetasunetarako.
| Haurren IO Bidea | Deskribapena |
| …/modua | STRING Digitalaren funtzionamendu modua. Aukerak: "sarrera", "irteera", "pwm", "tenporizadorea", "kodetzailea", "kaptura", "uart_rx", "uart_tx", "can_rx", "can_tx", "pru_input" edo "pru_output" |
| …/prozesu_seinalea | STRING Prozesuaren kontrol-seinalearen izena, baldin badago. |
| …/tira_modua | STRING Sarrera digital baterako tira gora/behera modua. Aukerak: "gora", "behera" edo "desgaitu" |
4.4 Erreleen Kontrola
Bi erreleek modu independentean kontrolatzen dituzte eta interfaze mota bera partekatzen dute. Ordeztu relay_x relay_a edo relay_b-rekin, hurrenez hurren.
| IO Bidea | Deskribapena |
| /fx4/relay _ x/permit / user _ command | BOOL Errelea ireki edo itxi agintzen du. Egiazko komando bat errelea ixten saiatuko da interblokeoak ematen badira, eta agindu faltsuak beti irekiko du errelea. |
| /fx4/errele _ x/egoera | READONLY STRING Errelearen uneko egoera. Blokeatutako erreleak irekita daude baina ezin dira itxi interblokeo baten ondorioz. Estatuak: "ireki", "itxita" edo "blokeatuta" |
| /fx4/errele _ x/automatikoki _ itxi | BOOL True gisa ezartzen denean, errelea automatikoki itxiko da interblokeoak ematen direnean. Lehenespenez faltsua. |
| /fx4/errele _ x/ ziklo _ zenbaketa | IRAKURTZEKO ZENBAKIA Azken berrezarri zenetik erreleen ziklo kopurua. Baliagarria errelearen bizitzaren jarraipena egiteko. |
4.5 Goi Boltage Modulua
Ikus IGX - Programatzailearen eskuliburua FX4 bolumen handikoari buruzko xehetasunak lortzekotage interfazea. Osagaiaren bide nagusia /fx4/high_votlage da.
4.6 Dosi-kontrolatzailea
Ikusi IGX - Programatzaileen eskuliburua FX4 dosi kontrolatzailearen interfazeari buruzko xehetasunak lortzeko. Osagaiaren bide nagusia /fx4/dose_controller da.
FX4 Python Adibamples
5.1 Datuen erregistratzailea HTTP erabiliz
Adibample-k irakurketa batzuk nola atera eta CSV batean nola gorde erakusten du file. Irakurketen arteko atzerapen luzea aukeratuz gero, epe luzerako datuen erregistroa egin dezakezu FX4 s bada ere.ampling tasa handiagoa ezartzen da. Horri esker, neurketak etengabe bildu eta gorde ditzakezu epe luzeetan, sistema larritu gabe, datuak zure analisirako egokiak diren tarteetan jasotzen direla ziurtatuz. Irakurketen arteko atzerapenak datuak erregistratzen diren erritmoa erregulatzen laguntzen du, biltegiratze eraginkorra ahalbidetzen du eta datu-puntuak galtzeko arriskua murrizten du, abiadura handiko s-ak onuratuz.ampling denbora errealeko neurketak egiteko.
5.2 Python GUI sinplea
Bigarren example-ek Tkinter GUI tresna erabiltzen du, Pythonentzat eraikia, neurtutako korronteen bistaratzea sortzeko. Interfaze honek egungo irakurketak formatu grafiko egokian ikusteko aukera ematen du. Pantaila tamaina alda daiteke gela batetik bestera irakurtzeko nahikoa izan dadin, eta espazio handiagoetan denbora errealeko monitorizazioa behar den eszenatokietarako aproposa da. Tkinter-ek interfaze interaktiboak sortzeko modu erraz bat eskaintzen du, eta FX4-rekin integratuz, neurtutako korronteen bisuala azkar eraiki dezakezu, zure beharretara egokitzeko pertsonalizatu daitekeen.
5.3 Sinplea WebEntxufeak Adibample
Adibample erakusten du WebSocketen interfazea, hau da, FX4-ko datuak irakurtzeko metodo hobetsia banda zabalera maximoa behar denean. WebSocket-ek denbora errealeko eta full-duplex komunikazio kanala eskaintzen dute, beste metodo batzuekin alderatuta datu-transferentzia azkarrago eta eraginkorragoa ahalbidetuz.
Adibample s serie bat irakurtzen duamples, sko batez besteko denboraren berri ematen duample eta gehienezko latentzia, eta datuak CSV batean gordetzen ditu file geroago aztertzeko. Konfigurazio honek denbora errealeko jarraipen eraginkorra eta datuen biltegiratze erraza ahalbidetzen du postprozesatzeko.
Lortu daitekeen errendimendu zehatza WebSocketak zure Ethernet interfazearen fidagarritasunaren eta zure aplikazioaren lehentasun erlatiboaren araberakoak dira. Emaitza optimoak lortzeko, ziurtatu zure sarea egonkorra dela eta behar izanez gero FX4-ren datu-transmisioari lehentasuna ematen zaiola.
Bertsioa: v3
FX4 Python Adibampzenbakia: 21
Dokumentuak / Baliabideak
 |
PYRAMID FX4 Programatzailea [pdf] Argibideen eskuliburua FX4 Programatzailea, FX4, Programatzailea |