www.pyramid.tech
FX4
Llawlyfr Rhaglennydd FX4
ID y Ddogfen: 2711715845
Fersiwn: v3
Rhaglennydd FX4
ID y Ddogfen: 2711715845
FX4 - Llawlyfr Rhaglennydd FX4
ID y ddogfen: 2711650310
| Awdur | Matthew Nichols |
| Perchennog | Arweinydd Prosiect |
| Pwrpas | Egluro'r cysyniadau rhaglennu sydd eu hangen i ddefnyddio'r API ac ymestyn y cynnyrch trwy gymwysiadau allanol. |
| Cwmpas | Cysyniadau rhaglennu cysylltiedig â FX4. |
| Cynulleidfa Fwriadol | Datblygwyr meddalwedd sydd â diddordeb mewn defnyddio'r cynnyrch. |
| Proses | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Safon%20Llawlyfr%20Creu%20Proses |
| Hyfforddiant | NID YN GYMWYS |
Rheoli Fersiwn
| Fersiwn | Disgrifiad | Arbedwyd gan | Wedi'i gadw ymlaen | Statws |
| v3 | Ychwanegwyd trosodd symlview a mwy o gynamples. | Matthew Nichols | Mawrth 6, 2025 10:29 PM | CYMERADWY |
| v2 | Ychwanegwyd rhyngwynebau IO digidol a chyfeiriadau yn ôl i IGX. | Matthew Nichols | Mai 3, 2024 7:39 PM | CYMERADWY |
| v1 | Rhyddhad cychwynnol, gwaith ar y gweill o hyd. | Matthew Nichols | Chwefror 21, 2024 11:25 PM | CYMERADWY |
Rheoli Dogfennau Nid Reviewed
Fersiwn y ddogfen gyfredol: v.1
Nac ailviewwyr neilltuo.
1.1 Llofnodion
ar gyfer fersiwn diweddaraf y ddogfen
Dydd Gwener, 7fed Mawrth, 2025, 10:33 PM UTC
Arwyddodd Matthew Nichols ; ystyr: Review
Cyfeiriadau
| Dogfen | ID y ddogfen | Awdur | Fersiwn |
| IGX - Llawlyfr Rhaglennydd | 2439249921 | Matthew Nichols | 1 |
FX4 Rhaglennu Drosview
Mae'r prosesydd FX4 yn rhedeg ar amgylchedd o'r enw IGX, sydd wedi'i adeiladu ar system weithredu amser real dibynadwyedd uchel QNX o BlackBerry (QNX Websafle¹). Mae IGX yn darparu rhyngwyneb rhaglennu cymwysiadau hyblyg a chynhwysfawr (API) i ddefnyddwyr sydd am ysgrifennu eu meddalwedd cyfrifiadurol gwesteiwr eu hunain.
Rhennir amgylchedd IGX ar draws cynhyrchion Pyramid eraill, gan ganiatáu i ddatrysiadau meddalwedd a ddatblygwyd ar gyfer un cynnyrch gael eu trosglwyddo'n hawdd i eraill.
Gall rhaglenwyr gyfeirio at y ddogfennaeth gyflawn ar gyfer IGX sydd ar gael ar y Pyramid websafle yn: IGX | Fframwaith System Rheoli Modiwlaidd Modern ar gyfer Web-Ceisiadau wedi'u galluogi²
Mae'r adran hon yn rhoi cyflwyniad i brofi dau o'r dulliau API: HTTP gan ddefnyddio fformat JSON ac EPICS. Er mwyn symlrwydd, Python (Python Websafle³) yn cael ei ddefnyddio fel exampiaith gyfrifiadurol host, sy'n hygyrch ac yn hawdd i'w defnyddio ar gyfer rhaglenwyr nad ydynt yn broffesiynol.
3.1 Defnyddio Python a HTTP
Fel cynample, cymerwch eich bod am ddarllen swm y cerrynt a fesurwyd gyda Python. Mae angen y URL ar gyfer yr IO penodol hwnnw. Mae'r FX4 web Mae GUI yn darparu ffordd hawdd o ddod o hyd i hyn: de-gliciwch yn y maes a dewis 'Copy HTTP URL' i gopïo'r llinyn i'r clipfwrdd.
Nawr gallwch chi ddefnyddio Python i brofi cysylltedd â meddalwedd defnyddwyr trwy HTTP a JSON. Efallai y bydd angen i chi fewnforio'r llyfrgelloedd ceisiadau a json i drin y ceisiadau HTTP a'r dosrannu data.
1 Python Syml HTTP Example
3.2 Defnyddio EPICS
Mae'r broses ar gyfer cysylltu'r FX4 trwy EPICS (System Ffiseg Arbrofol a Rheoli Diwydiannol) yn debyg. Set o offer meddalwedd a chymwysiadau yw EPICS a ddefnyddir i ddatblygu a gweithredu systemau rheoli gwasgaredig, a ddefnyddir yn eang mewn cyfleusterau gwyddonol.
- Sicrhewch enw newidyn proses EPICS (PV) ar gyfer yr IO a ddymunir.
- Mewnforio'r llyfrgell EPICS a darllen y gwerth.
2 Cael Enw EPICS PV
3 Python EPICS Syml Example
Yn ogystal, creodd Pyramid gyfleustodau (EPICS Cyswllt⁴) sy'n eich galluogi i fonitro newidynnau proses EPICS mewn amser real. Mae'r offeryn hwn yn ddefnyddiol i gadarnhau a yw'r enw EPICS PV yn gywir a'r FX4 yn gwasanaethu'r PV yn gywir ar eich rhwydwaith.
4 PTC EPICS Cyswllt
FX4 API Rhaglennu
Mae'r cysyniadau a'r dulliau a ddisgrifir yn y llawlyfr hwn yn adeiladu ar y cysyniadau a sefydlwyd yn Llawlyfr Rhaglennydd IGX. Gweler y ddogfen honno am eglurhad ac exampllai o sut mae rhaglennu a rhyngwynebau IGX sylfaenol yn gweithio. Bydd y llawlyfr hwn ond yn ymdrin â'r IO sy'n benodol i ddyfais ac ymarferoldeb sy'n unigryw i'r FX4.
4.1 Mewnbwn Analog IO
Mae'r IO hyn yn ymwneud â ffurfweddu a chasglu data ar fewnbynnau cerrynt analog y FX4. Mae unedau mewnbynnau'r sianel yn seiliedig ar y gosodiad defnyddiwr y gellir ei ffurfweddu o'r enw “Sample Units”, mae opsiynau dilys yn cynnwys pA, NA, uA, mA, ac A.
Mae pob un o'r 4 sianel yn defnyddio'r un rhyngwyneb IO ac yn cael eu rheoli'n annibynnol. Disodli channel_x gyda channel_1 , channel_2 , channel_3 , neu channel_4 yn y drefn honno.
| Llwybr IO | Disgrifiad |
| /fx4/adc/channel_x | RHIF DARLLEN Mewnbwn cerrynt wedi'i fesur. |
| /fx4/adc/channel_x/scalar | RHIF Scalar unedol syml wedi'i osod ar y sianel, 1 yn ddiofyn. |
| /fx4/adc/channel_x/zero_offset | NUMBER Gwrthbwyso cyfredol yn NA ar gyfer y sianel. |
Nid yw'r IO canlynol yn annibynnol ar sianeli ac fe'u cymhwysir i bob sianel ar yr un pryd.
| Llwybr IO | Disgrifiad |
| /fx4/sianel_swm | RHIF DARLLEN Swm y sianeli mewnbwn cyfredol. |
| /fx4/adc_uned | STRING Yn gosod yr unedau defnyddiwr cyfredol ar gyfer pob sianel a swm. Opsiynau: “pa”, “na”, “ua”, “ma”, “a” |
| /fx4/ystod | STRING Yn gosod yr amrediad mewnbwn cyfredol. Gweler GUI am sut mae pob cod amrediad yn cyfateb i'r terfynau mewnbwn cyfredol uchaf a Dyfrffyrdd Prydain. Opsiynau: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7” |
| /fx4/adc/sample_frequency | RHIF Yr amledd mewn Hz sy'n sampBydd y data yn cael ei gyfartaleddu i. Mae hyn yn rheoli'r gyfradd signal-i-sŵn a data ar gyfer pob sianel. |
| /fx4/adc/conversion_frequency | RHIF Yr amledd mewn Hz y bydd yr ADC yn trosi gwerthoedd analog i ddigidol arno. Yn ddiofyn, mae hyn yn 100kHz, ac anaml y bydd angen i chi newid y gwerth hwn. |
| /fx4/adc/offset_correction | RHIF DARLLEN Swm holl wrthbwyso cyfredol y sianel. |
4.2 Allbwn Analog IO
Mae'r IO hyn yn ymwneud â chyfluniad allbynnau analog pwrpas cyffredinol yr FX4 a geir o dan y mewnbynnau analog ar y panel blaen. Mae pob un o'r 4 sianel yn defnyddio'r un rhyngwyneb IO ac yn cael eu rheoli'n annibynnol. Disodli channel_x gyda channel_1 , channel_2 , channel_3 , neu channel_4 yn y drefn honno.
| Llwybr IO | Disgrifiad |
| /fx4/dac /channel_x | RHIF Gorchymyn cyftage allbwn. Dim ond pan fydd modd allbwn wedi'i osod â llaw y gellir ysgrifennu at y gwerth hwn. |
| /fx4/dac/channel_x/readback | RHIF DARLLEN Wedi'i fesur cyftage allbwn. Mae hyn yn fwyaf defnyddiol wrth ddefnyddio modd allbwn mynegiant. |
| /fx4/dac/channel_x/output_mode | STRING Yn gosod y modd allbwn ar gyfer y sianel. Opsiynau: “llawlyfr”, “mynegiant”, “process_control” |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Galluogi neu analluogi cyfyngu ar gyfraddau slew. |
| /fx4/dac/channel_ x/slew_rate | RHIF Cyfradd araf mewn V/s ar gyfer y sianel. |
| /fx4/dac/channel_x/upper_limit | NUMBER Y gorchymyn uchaf a ganiateir cyftage ar gyfer y sianel. Yn berthnasol i bob dull gweithredu. |
| /fx4/dac/sianel _ x/limit_isaf | NUMBER Y gorchymyn lleiaf a ganiateir cyftage ar gyfer y sianel. Yn berthnasol i bob dull gweithredu. |
| /fx4/dac/channel _ x/ allbwn _ mynegiant | STRING Yn gosod y llinyn mynegiant a ddefnyddir gan y sianel pan fydd yn y modd allbwn mynegiant. |
| /fx4/dac/channel _ x/reset_button | BUTTON Yn ailosod y gorchymyn cyftage i 0. |
4.3 Mewnbwn ac Allbynnau Digidol
Mae'r IO hyn yn ymwneud â rheoli'r amrywiol fewnbynnau ac allbynnau digidol pwrpas cyffredinol a geir ar yr FX4.
| Llwybr IO | Disgrifiad |
| /fx4/fr1 | Derbynnydd ffibr BOOL READONLY 1. |
| /fx4/ft1 | Trosglwyddydd ffibr BOOL 1. |
| /fx4/fr2 | Derbynnydd ffibr BOOL READONLY 2. |
| /fx4/ft2 | Trosglwyddydd ffibr BOOL 2. |
| /fx4/fr3 | Derbynnydd ffibr BOOL READONLY 3. |
| /fx4/ft3 | Trosglwyddydd ffibr BOOL 3. |
| /fx4/digital_ehangu/d1 | BOOL D1 ehangu digidol deugyfeiriadol IO. |
| /fx4/digital_ehangu/d2 | BOOL D2 ehangu digidol deugyfeiriadol IO. |
| /fx4/digital_ehangu/d3 | BOOL D3 ehangu digidol deugyfeiriadol IO. |
| /fx4/digital_ehangu/d4 | BOOL D4 ehangu digidol deugyfeiriadol IO. |
4.3.1 Ffurfweddiad IO Digidol
Mae gan bob digidol IO plentyn ar gyfer ffurfweddu eu hymddygiad gan gynnwys modd gweithredu sy'n rheoli sut bydd y digidol hwnnw'n gweithredu. Bydd gan bob digidol set wahanol o opsiynau sydd ar gael. Gweler y GUI am fanylion ar ba opsiynau sydd ar gael ar gyfer pa IO.
| Llwybr IO Plentyn | Disgrifiad |
| …/modd | STRING Modd gweithredu ar gyfer y digidol. Opsiynau: “mewnbwn”, “allbwn”, “pwm”, “amserydd”, “encoder”, “cipio”, “uart_rx”, “uart_tx”, “can_rx”, “can_tx”, “pru_input”, neu “pru_output” |
| …/signal_proses | LLINELL Enw'r signal rheoli proses, os oes un. |
| …/dull_tynnu | STRING Modd tynnu i fyny/lawr ar gyfer mewnbwn digidol. Opsiynau: “i fyny”, “i lawr”, neu “analluogi” |
4.4 Rheoli Cyfnewid
Mae'r ddwy ras gyfnewid yn cael eu rheoli'n annibynnol ac yn rhannu'r un math o ryngwyneb. Amnewid relay_x gyda relay_a neu relay_b yn y drefn honno.
| Llwybr IO | Disgrifiad |
| /fx4/relay _ x/permit / defnyddiwr _ gorchymyn | Mae BOOL yn gorchymyn y ras gyfnewid ar agor neu gau. Bydd gorchymyn cywir yn ceisio cau'r ras gyfnewid os caniateir y cyd-gloi, a bydd gorchymyn ffug bob amser yn agor y ras gyfnewid. |
| /fx4/relay _ x/cyflwr | LLINYN READONLY Cyflwr presennol y daith gyfnewid. Mae cyfnewidfeydd dan glo ar agor ond ni ellir eu cau oherwydd cyd-gloi. Gwladwriaethau: “agoredig”, “caeedig”, neu “cloi” |
| /fx4/relay _ x/yn awtomatig _ cau | BOOL Pan fydd yn wir, bydd y ras gyfnewid yn cau'n awtomatig pan ganiateir y cyd-gloi. Gau yn ddiofyn. |
| /fx4/relay _ x/ cylch _ cyfrif | RHIF DARLLEN Nifer y cylchoedd cyfnewid ers yr ailosodiad diwethaf. Yn ddefnyddiol ar gyfer olrhain oes ras gyfnewid. |
4.5 Uchel Cyfroltage Modiwl
Gweler y IGX - Llawlyfr Rhaglennydd i gael manylion am gyfrol uchel FX4tage rhyngwyneb. Y llwybr rhiant cydran yw /fx4/high_votlage .
4.6 Rheolydd Dos
Gweler y IGX - Llawlyfr Rhaglennydd am fanylion ar ryngwyneb rheolydd dos FX4. Y llwybr rhiant cydran yw /fx4/dose_controller .
FX4 Python Examples
5.1 Cofnodydd Data gan ddefnyddio HTTP
Mae'r cynampMae le yn dangos sut i ddal nifer o ddarlleniadau a'u cadw i CSV file. Drwy ddewis oedi hir rhwng darlleniadau, gallwch berfformio logio data hirdymor hyd yn oed os yw'r FX4 sampcyfradd ling yn cael ei osod yn uwch. Mae hyn yn eich galluogi i gasglu a storio mesuriadau yn barhaus dros gyfnodau estynedig heb orlethu'r system, gan sicrhau bod data'n cael ei ddal ar adegau sy'n addas ar gyfer eich dadansoddiad. Mae'r oedi rhwng darlleniadau yn helpu i reoleiddio'r cyflymder y mae data'n cael ei gofnodi, gan ganiatáu ar gyfer storio'n effeithlon a lleihau'r risg o golli pwyntiau data tra'n dal i elwa o s cyflymder uchel.ampling ar gyfer mesuriadau amser real.
5.2 GUI Python Syml
Yr ail exampMae le yn defnyddio'r offeryn Tkinter GUI, sydd wedi'i adeiladu ar gyfer Python, i greu arddangosfa o'r ceryntau mesuredig. Mae'r rhyngwyneb hwn yn caniatáu ichi ddelweddu'r darlleniadau cyfredol mewn fformat graffigol hawdd ei ddefnyddio. Gellir newid maint yr arddangosfa i'w gwneud yn ddigon mawr i'w darllen o bob rhan o ystafell, gan ei gwneud yn ddelfrydol ar gyfer senarios lle mae angen monitro amser real mewn mannau mwy. Mae Tkinter yn darparu ffordd hawdd o greu rhyngwynebau rhyngweithiol, a thrwy ei integreiddio â'r FX4, gallwch chi adeiladu arddangosfa weledol yn gyflym o'r cerrynt mesuredig y gellir ei addasu i gyd-fynd â'ch anghenion penodol.
5.3 Syml WebSocedi Cynample
Mae'r cynample yn dangos y WebRhyngwyneb socedi, sef y dull a ffefrir ar gyfer darllen data o'r FX4 pan fo angen y lled band mwyaf. WebMae socedi yn darparu sianel gyfathrebu deublyg amser real, llawn, sy'n caniatáu ar gyfer trosglwyddo data yn gyflymach ac yn fwy effeithlon o'i gymharu â dulliau eraill.
Mae'r cynampmae le yn darllen cyfres o samples, yn adrodd yr amser cyfartalog fesul sampac uchafswm hwyrni, ac yn cadw'r data i CSV file ar gyfer dadansoddiad diweddarach. Mae'r gosodiad hwn yn caniatáu monitro amser real effeithlon a storio data yn hawdd ar gyfer ôl-brosesu.
Y perfformiad penodol y gellir ei gyflawni gyda WebMae socedi yn dibynnu ar ddibynadwyedd eich rhyngwyneb Ethernet a blaenoriaeth gymharol eich cais. I gael y canlyniadau gorau posibl, sicrhewch fod eich rhwydwaith yn sefydlog a bod trosglwyddiad data FX4 yn cael ei flaenoriaethu os oes angen.
Fersiwn: v3
FX4 Python Examples: 21
Dogfennau / Adnoddau
 |
Rhaglennydd PYRAMID FX4 [pdfLlawlyfr Cyfarwyddiadau Rhaglennydd FX4, FX4, Rhaglennydd |