www.pyramid.tech
FX4
Manwal tal-Programmatur FX4
ID Dokument: 2711715845
Verżjoni: v3
Programmatur FX4
ID Dokument: 2711715845
FX4 – Manwal tal-Programmatur FX4
ID tad-dokument: 2711650310
| Awtur | Matthew Nichols |
| Sid | Ċomb tal-Proġett |
| Għan | Spjega l-kunċetti ta 'programmazzjoni meħtieġa biex tuża l-API u testendi l-prodott permezz ta' applikazzjonijiet esterni. |
| Ambitu | Kunċetti ta' programmazzjoni relatati mal-FX4. |
| Udjenza Intenzjonata | Żviluppaturi tas-softwer interessati fl-użu tal-prodott. |
| Proċess | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manwal%20Ħolqien%20Proċess |
| Taħriġ | MA JAPPLIKAX |
Kontroll tal-Verżjoni
| Verżjoni | Deskrizzjoni | Salvat minn | Ffrankati fuq | Status |
| v3 | Miżjud sempliċi overview u aktar examples. | Matthew Nichols | 6 ta’ Marzu 2025 10:29 | APPROVAT |
| v2 | Interfaċċji IO diġitali miżjuda u referenzi lura għal IGX. | Matthew Nichols | 3 ta’ Mejju, 2024 7:39 PM | APPROVAT |
| v1 | Rilaxx inizjali, għadu xogħol għaddej. | Matthew Nichols | 21 ta’ Frar 2024 11:25 | APPROVAT |
Kontroll tad-Dokument Mhux Reviewed
Verżjoni tad-dokument kurrenti: v.1
Le reviewers assenjati.
1.1 Firem
għall-aktar verżjoni reċenti tad-dokument
Il-Ġimgħa, 7 ta’ Marzu, 2025, 10:33 UTC
Matthew Nichols iffirma; tifsira: Riview
Referenzi
| Dokument | ID tad-dokument | Awtur | Verżjoni |
| IGX – Manwal tal-Programmatur | 2439249921 | Matthew Nichols | 1 |
FX4 Programming Overview
Il-proċessur FX4 jaħdem fuq ambjent imsejjaħ IGX, li huwa mibni fuq is-sistema operattiva QNX ta' affidabbiltà għolja f'ħin reali minn BlackBerry (QNX Websit¹). IGX jipprovdi interface ta 'programmar ta' applikazzjoni (API) flessibbli u komprensiv għal utenti li jixtiequ jiktbu s-softwer tal-kompjuter ospitanti tagħhom stess.
L-ambjent IGX huwa kondiviż bejn prodotti Pyramid oħra, li jippermetti li soluzzjonijiet ta 'softwer żviluppati għal prodott wieħed jiġu trasferiti faċilment lil oħrajn.
Il-programmaturi jistgħu jirreferu għad-dokumentazzjoni kompleta għal IGX disponibbli fuq il-Piramida websit fuq: IGX | Qafas ta 'Sistema ta' Kontroll Modulari Moderna għal Web-enabled Applikazzjonijiet²
Din it-taqsima tipprovdi introduzzjoni għall-ittestjar ta' tnejn mill-metodi API: HTTP bl-użu tal-format JSON u EPICS. Għal sempliċità, Python (Python Websit³) jintuża bħala example lingwa tal-kompjuter ospitanti, li hija aċċessibbli u faċli biex tużah għal programmaturi mhux professjonali.
3.1 L-użu ta 'Python u HTTP
Bħala example, jassumi li trid taqra s-somma tal-kurrenti mkejla b'Python. Għandek bżonn il- URL għal dak l-IO partikolari. L-FX4 web GUI tipprovdi mod faċli biex issib dan: sempliċement ikklikkja bil-lemin fil-qasam u agħżel 'Kopja HTTP URL' biex tikkopja s-sekwenza fil-clipboard.
Issa tista 'tuża Python biex tittestja l-konnettività mas-softwer tal-utent permezz ta' HTTP u JSON. Jista 'jkollok bżonn timporta t-talbiet u l-libreriji json biex timmaniġġja t-talbiet HTTP u l-parsing tad-dejta.
1 Sempliċi Python HTTP Eżample
3.2 L-użu tal-EPICS
Il-proċess għall-konnessjoni tal-FX4 permezz tal-EPICS (Fiżika Sperimentali u Sistema ta 'Kontroll Industrijali) huwa simili. EPICS huwa sett ta 'għodod ta' softwer u applikazzjonijiet użati biex jiżviluppaw u jimplimentaw sistemi ta 'kontroll distribwiti, użati ħafna f'faċilitajiet xjentifiċi.
- Ikseb l-isem tal-varjabbli tal-proċess EPICS (PV) għall-IO mixtieqa.
- Importa l-librerija EPICS u aqra l-valur.
2 Ikseb l-Isem EPICS PV
3 Sempliċi Python EPICS Eżample
Barra minn hekk, Pyramid ħolqot utilità (EPICS Qabbad⁴) li jippermettilek tissorvelja l-varjabbli tal-proċess EPICS f'ħin reali. Din l-għodda hija utli biex tikkonferma jekk l-isem EPICS PV huwiex korrett u l-FX4 huwiex qed iservi l-PV b'mod korrett fuq in-netwerk tiegħek.
4 PTC EPICS Ikkonnettja
API tal-Programmazzjoni FX4
Il-kunċetti u l-metodi deskritti f'dan il-manwal jibnu fuq il-kunċetti stabbiliti fl-IGX – Manwal tal-Programmer. Jekk jogħġbok ara dak id-dokument għal spjegazzjoni u examples ta 'kif l-ipprogrammar bażiku IGX u l-interfaces jaħdmu. Dan il-manwal se jkopri biss l-IO u l-funzjonalità speċifiċi għall-apparat li huma uniċi għall-FX4.
4.1 Input Analog IO
Dawn l-IO għandhom x'jaqsmu mal-konfigurazzjoni u l-ġbir tad-dejta fuq l-inputs tal-kurrent analogu tal-FX4. L-unitajiet tal-inputs tal-kanal huma bbażati fuq is-setting konfigurabbli mill-utent imsejjaħ “Sample Units”, għażliet validi jinkludu pA, nA, uA, mA, u A.
L-4 kanali kollha jużaw l-istess interface IO u huma kkontrollati b'mod indipendenti. Ibdel channel_x ma channel_1 , channel_2 , channel_3 , jew channel_4 rispettivament.
| IO Mogħdija | Deskrizzjoni |
| /fx4/adc/channel_x | NUMRU READONLY Input tal-kurrent imkejjel. |
| /fx4/adc/channel_x/scalar | NUMRU Skalari sempliċi mingħajr unità applikata għall-kanal, 1 awtomatikament. |
| /fx4/adc/channel_x/zero_offset | NUMRU Offset kurrenti f'nA għall-kanal. |
L-IO li ġejjin mhumiex indipendenti mill-kanali u huma applikati għall-kanali kollha simultanjament.
| IO Mogħdija | Deskrizzjoni |
| /fx4/channel_sum | NUMRU READONLY Somma tal-kanali tal-input kurrenti. |
| /fx4/adc_unit | STRING Issettja l-unitajiet tal-utent kurrenti għal kull kanal u somma. Għażliet: “pa”, “na”, “ua”, “ma”, “a” |
| /fx4/medda | STRING Issettja l-firxa tal-input kurrenti. Ara l-GUI għal kif kull kodiċi tal-firxa tikkorrispondi mal-limiti massimi tal-input kurrenti u l-BW. Għażliet: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7” |
| /fx4/adc/sample_frequency | NUMRU Il-frekwenza f'Hz li sample data se tkun medja għal. Dan jikkontrolla s-sinjal għall-istorbju u r-rata tad-dejta għall-kanali kollha. |
| /fx4/adc/conversion_frequency | NUMRU Il-frekwenza f'Hz li l-ADC se jikkonverti valuri analogi għal diġitali. B'mod awtomatiku, dan huwa 100kHz, u rari biss ikollok bżonn tibdel dan il-valur. |
| /fx4/adc/offset_correction | NUMRU READONLY Is-somma tal-offsets kurrenti kollha tal-kanal. |
4.2 Output Analog IO
Dawn l-IO jirrelataw mal-konfigurazzjoni tal-outputs analogi għal skopijiet ġenerali tal-FX4 misjuba taħt l-inputs analogi fuq il-pannell ta 'quddiem. L-4 kanali kollha jużaw l-istess interface IO u huma kkontrollati b'mod indipendenti. Ibdel channel_x ma channel_1 , channel_2 , channel_3 , jew channel_4 rispettivament.
| IO Mogħdija | Deskrizzjoni |
| /fx4/dac /channel_x | Kmand NUMRU voltage output. Dan il-valur jista' jinkiteb biss meta l-modalità tal-ħruġ tkun issettjata għal manwali. |
| /fx4/dac/channel_x/readback | NUMRU TAL-QARI VoltagĦruġ. Dan huwa l-aktar utli meta tuża l-mod ta 'output ta' espressjoni. |
| /fx4/dac/channel_x/output_mode | STRING Issettja l-mod tal-ħruġ għall-kanal. Għażliet: "manwal", "expression", "process_control" |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Jippermetti jew tiddiżattiva l-limitazzjoni tar-rata ta' slew. |
| /fx4/dac/channel_ x/slew_rate | NUMRU Rata ta' slew f'V/s għall-kanal. |
| /fx4/dac/channel_x/upper_limit | NUMRU Il-kmand massimu permess voltage għall-kanal. Japplika għall-modi kollha tat-tħaddim. |
| /fx4/dac/channel _ x/lower_limit | NUMRU Il-kmand minimu permess voltage għall-kanal. Japplika għall-modi kollha tat-tħaddim. |
| /fx4/dac/channel _ x/ output _ espressjoni | STRING Issettja s-sekwenza tal-espressjoni użata mill-kanal meta jkun fil-modalità tal-output tal-espressjoni. |
| /fx4/dac/channel _ x/reset_button | BUTTON Resets il-kmand voltage sa 0. |
4.3 Input u Outputs Diġitali
Dawn l-IO jirrelataw mal-kontroll tad-diversi inputs u outputs diġitali għal skopijiet ġenerali misjuba fuq l-FX4.
| IO Mogħdija | Deskrizzjoni |
| /fx4/fr1 | READONLY BOOL Riċevitur tal-fibra 1. |
| /fx4/ft1 | BOOL Trasmettitur tal-fibra 1. |
| /fx4/fr2 | READONLY BOOL Riċevitur tal-fibra 2. |
| /fx4/ft2 | BOOL Trasmettitur tal-fibra 2. |
| /fx4/fr3 | READONLY BOOL Riċevitur tal-fibra 3. |
| /fx4/ft3 | BOOL Trasmettitur tal-fibra 3. |
| /fx4/digital_expansion/d1 | BOOL D1 espansjoni diġitali bidirezzjonali IO. |
| /fx4/digital_expansion/d2 | BOOL D2 espansjoni diġitali bidirezzjonali IO. |
| /fx4/digital_expansion/d3 | BOOL D3 espansjoni diġitali bidirezzjonali IO. |
| /fx4/digital_expansion/d4 | BOOL D4 espansjoni diġitali bidirezzjonali IO. |
4.3.1 Konfigurazzjoni IO Diġitali
Id-diġitali kollha għandhom IO tat-tfal għall-konfigurazzjoni tal-imġieba tagħhom inkluż mod operattiv li jikkontrolla kif dak diġitali se jopera. Kull diġitali se jkollu sett differenti ta 'għażliet disponibbli. Ara l-GUI għal dettalji dwar liema għażliet huma disponibbli għal liema IO.
| It-Tfal IO Path | Deskrizzjoni |
| …/mod | STRING Mod ta' tħaddim għad-diġitali. Għażliet: “input”, “output”, “pwm”, “timer”, “encoder”, “capture”, “uart_rx”, “uart_tx”, “can_rx”, “can_tx”, “pru_input”, jew “pru_output” |
| …/sinjal_proċess | STRING L-isem tas-sinjal tal-kontroll tal-proċess, jekk hemm wieħed. |
| …/pull_mode | STRING Modalità Iġbed 'il fuq/'l isfel għal input diġitali. Għażliet: "up", "down", jew "itfi" |
4.4 Kontroll tar-Relay
Iż-żewġ relays huma kkontrollati b'mod indipendenti u jaqsmu l-istess tip ta 'interface. Ibdel relay_x b'relay_a jew relay_b rispettivament.
| IO Mogħdija | Deskrizzjoni |
| /fx4/relay _ x/permit / utent _ kmand | BOOL Jikmanda lir-relay miftuħ jew magħluq. Kmand veru jipprova jagħlaq ir-relay jekk l-interlocks jingħataw, u kmand falz dejjem jiftaħ ir-relay. |
| /fx4/relay _ x/state | READONLY STRING L-istat attwali tar-relay. Relays msakkra huma miftuħa iżda ma jistgħux jingħalqu minħabba interlock. Stati: "miftuħa", "magħluqa", jew "maqfula" |
| /fx4/relay _ x/awtomatikament _ qrib | BOOL Meta ssettjat għal veru, ir-relay jingħalaq awtomatikament meta jingħataw l-interlocks. Falz awtomatikament. |
| /fx4/relay _ x/ ċiklu _ għadd | READONLY NUMBER In-numru ta' ċikli ta' relay mill-aħħar reset. Utli għall-intraċċar tal-ħajja tar-relay. |
4.5 Vol Għolitage Modulu
Ara l-IGX – Manwal tal-Programmatur għal dettalji dwar il-volum għoli FX4tage interface. Il-mogħdija ġenitur tal-komponent hija /fx4/high_votlage .
4.6 Kontrollur tad-Doża
Ara l-IGX – Manwal tal-Programmatur għal dettalji dwar l-interface tal-kontrollur tad-doża FX4. Il-mogħdija ġenitur tal-komponent hija /fx4/dose_controller .
FX4 Python Examples
5.1 Data Logger bl-użu ta' HTTP
Dan example juri kif taqbad numru ta' qari u tissejvjahom f'CSV file. Billi tagħżel dewmien twil bejn il-qari, tista 'twettaq illoggjar tad-dejta fit-tul anke jekk l-FX4 samprata tal-ling huwa stabbilit ogħla. Dan jippermettilek tiġbor u taħżen kontinwament il-kejl fuq perjodi estiżi mingħajr ma tgħaqqad is-sistema, u tiżgura li d-dejta tinqabad f'intervalli adattati għall-analiżi tiegħek. Id-dewmien bejn il-qari jgħin biex jirregola l-pass li bih tiġi rreġistrata d-dejta, li jippermetti ħażna effiċjenti u jnaqqas ir-riskju li jintilfu punti tad-dejta filwaqt li xorta waħda tibbenefika minn veloċità għolja.ampling għal kejl f'ħin reali.
5.2 GUI sempliċi ta' Python
It-tieni example juża l-għodda Tkinter GUI, li hija mibnija għal Python, biex toħloq wirja tal-kurrenti mkejla. Dan l-interface jippermettilek li tara l-qari attwali f'format grafiku faċli għall-utent. Il-wiri jista 'jinbidel biex ikun kbir biżżejjed biex jinqara minn madwar kamra, li jagħmilha ideali għal xenarji fejn huwa meħtieġ monitoraġġ f'ħin reali fi spazji akbar. Tkinter jipprovdi mod faċli biex toħloq interfaces interattivi, u billi tintegraha mal-FX4, tista 'malajr tibni wirja viżwali tal-kurrenti mkejla li jistgħu jiġu personalizzati biex taqdi l-bżonnijiet speċifiċi tiegħek.
5.3 Sempliċi WebSokits Eżample
Dan example juri l- WebSockets interface, li huwa l-metodu preferut għall-qari tad-data mill-FX4 meta bandwidth massimu huwa meħtieġ. WebIs-sokits jipprovdu kanal ta 'komunikazzjoni full-duplex f'ħin reali, li jippermetti trasferiment ta' data aktar mgħaġġel u effiċjenti meta mqabbel ma 'metodi oħra.
L-example jaqra sensiela ta samples, tirrapporta l-ħin medju għal kull sample u latency massima, u jiffranka d-dejta f'CSV file għal analiżi aktar tard. Din is-setup tippermetti monitoraġġ effiċjenti f'ħin reali u ħażna faċli tad-dejta għall-ipproċessar ta 'wara.
Il-prestazzjoni speċifika li tista 'tinkiseb biha WebIs-sokits jiddependi fuq l-affidabbiltà tal-interface Ethernet tiegħek u l-prijorità relattiva tal-applikazzjoni tiegħek. Għal riżultati ottimali, kun żgur li n-netwerk tiegħek huwa stabbli u li t-trażmissjoni tad-dejta tal-FX4 tkun prijoritizzata jekk meħtieġ.
Verżjoni: v3
FX4 Python Examples: 21
Dokumenti / Riżorsi
 |
Programmatur PYRAMID FX4 [pdfManwal tal-Istruzzjonijiet Programmatur FX4, FX4, Programmatur |