www.pyramid.tech
FX4
FX4 forritara handbók
Auðkenni skjal: 2711715845
Útgáfa: v3

FX4 forritari

Auðkenni skjal: 2711715845
FX4 – FX4 forritarahandbók

Skjalkenni: 2711650310

Höfundur	Matthew Nichols
Eigandi	Verkefnastjóri
Tilgangur	Útskýrðu forritunarhugtökin sem nauðsynleg eru til að nota API og útvíkka vöruna í gegnum ytri forrit.
Gildissvið	FX4 tengd forritunarhugtök.
Ætlaðir áhorfendur	Hugbúnaðarhönnuðir hafa áhuga á að nota vöruna.
Ferli	https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Process
Þjálfun	EKKI GILDIR

Útgáfustýring

Útgáfa	Lýsing	Vistað af	Vistað á	Staða
v3	Bætti við einföldum yfirview og fleira examples.	Matthew Nichols	6. mars 2025 10:29	SAMÞYKKT
v2	Bætt við stafrænu IO tengi og tilvísanir aftur í IGX.	Matthew Nichols	3. maí 2024 7:39	SAMÞYKKT
v1	Upphafleg útgáfa, enn í vinnslu.	Matthew Nichols	21. febrúar 2024 11:25	SAMÞYKKT

Skjalastjórnun Ekki Reviewed
Núverandi skjalútgáfa: v.1
Nei afturviewers úthlutað.

1.1 Undirskriftir
fyrir nýjustu útgáfu skjala
Föstudagur 7. mars, 2025, 10:33 UTC
Matthew Nichols skrifaði undir ; merking: Review

Heimildir

Skjal	Skjalkenni	Höfundur	Útgáfa
IGX – Handbók forritara	2439249921	Matthew Nichols	1

FX4 forritun lokiðview

FX4 örgjörvinn keyrir á umhverfi sem kallast IGX, sem er byggt á QNX áreiðanlegu rauntíma stýrikerfi frá BlackBerry (QNX Websíða¹). IGX býður upp á sveigjanlegt og alhliða forritunarviðmót (API) fyrir notendur sem vilja skrifa sinn eigin hýsingartölvuhugbúnað.
IGX umhverfinu er deilt með öðrum Pyramid vörum, sem gerir kleift að flytja hugbúnaðarlausnir sem þróaðar eru fyrir eina vöru auðveldlega yfir á aðra.
Forritarar geta vísað í heildarskjölin fyrir IGX sem eru fáanleg á pýramídanum websíða á: IGX | Nútíma Modular Control System Framework fyrir Web-virkt forrit²

Þessi hluti veitir kynningu á því að prófa tvær af API aðferðunum: HTTP með JSON sniði og EPICS. Til einföldunar, Python (Python Websíða³) er notað sem tdample host tölvutungumál, sem er aðgengilegt og auðvelt í notkun fyrir forritara sem ekki eru fagmenn.

3.1 Notkun Python og HTTP
Sem fyrrverandiample, gerðu ráð fyrir að þú viljir lesa summan af mældum straumum með Python. Þú þarft á URL fyrir þá tilteknu IO. FX4 web GUI býður upp á auðvelda leið til að finna þetta: einfaldlega hægrismelltu á reitinn og veldu 'Afrita HTTP URL' til að afrita strenginn á klemmuspjaldið.

Nú geturðu notað Python til að prófa tengingu við notendahugbúnað í gegnum HTTP og JSON. Þú gætir þurft að flytja inn beiðnirnar og json bókasöfnin til að sinna HTTP beiðnum og gagnagreiningu.

1 Einfalt Python HTTP Example

3.2 Notkun EPICS
Ferlið við að tengja FX4 í gegnum EPICS (Experimental Physics and Industrial Control System) er svipað. EPICS er sett af hugbúnaðarverkfærum og forritum sem notuð eru til að þróa og innleiða dreifð eftirlitskerfi, mikið notað í vísindaaðstöðu.

1. https://blackberry.qnx.com/en
2. https://pyramid.tech/products/igx
3. https://www.python.org/

1. Fáðu EPICS ferlibreytuheitið (PV) fyrir viðkomandi IO.
2. Flyttu inn EPICS bókasafnið og lestu gildið.

2 Fáðu EPICS PV nafn3 Simple Python EPICS Example

Að auki bjó Pyramid til tól (EPICS Connect⁴) sem gerir þér kleift að fylgjast með EPICS ferlibreytum í rauntíma. Þetta tól er gagnlegt til að staðfesta hvort EPICS PV nafnið sé rétt og FX4 þjónar PV rétt á netinu þínu.

4 PTC EPICS Connect

FX4 forritunarforritaskil

Hugtökin og aðferðirnar sem lýst er í þessari handbók byggja á hugmyndunum sem settar eru fram í IGX – forritarahandbókinni. Vinsamlegast skoðaðu það skjal til skýringar og tdamples um hvernig grunn IGX forritun og viðmót virka. Þessi handbók mun aðeins fjalla um tækissértæka IO og virkni sem er einstök fyrir FX4.

4.1 Analog Input IO
Þessi IO tengjast uppsetningu og söfnun gagna um hliðrænu strauminntak FX4. Einingar rásarinntakanna eru byggðar á notandastillingu sem kallast „Sample Units“, gildar valkostir innihalda pA, nA, uA, mA og A.
Allar 4 rásirnar nota sama tengi IO og eru sjálfstýrðar. Skiptu um channel_x fyrir channel_1 , channel_2 , channel_3 eða channel_4 í sömu röð.

IO leið	Lýsing
/fx4/adc/rás_x	LEGANUMMER Mælt strauminntak.
/fx4/adc/channel_x/scalar	NUMBER Einföld einingalaus mælikvarði notaður á rásina, 1 sjálfgefið.
/fx4/adc/channel_x/zero_offset	NUMBER Núverandi frávik í nA fyrir rásina.

Eftirfarandi IO er ekki rásóháð og er beitt á allar rásir samtímis.

IO leið	Lýsing
/fx4/rás_summa	READONLY NUMBER Summa núverandi inntaksrása.
/fx4/adc_unit	STRING Stillir núverandi notendaeiningar fyrir hverja rás og summu. Valkostir: "pa", "na", "ua", "ma", "a"
/fx4/svið	STRING Stillir núverandi inntakssvið. Sjá GUI fyrir hvernig hver sviðskóði samsvarar hámarks núverandi inntaksmörkum og BW. Valkostir: "0", "1", "2", "3", "4", "5", "6", "7"
/fx4/adc/sample_tíðni	TÖLDI Tíðnin í Hz sem sampLe gögn verða meðaltal til. Þetta stjórnar merki til hávaða og gagnahraða fyrir allar rásir.
/fx4/adc/conversion_frequency	NUMBER Tíðnin í Hz sem ADC mun breyta hliðstæðum í stafræn gildi á. Sjálfgefið er þetta 100kHz og þú þarft aðeins sjaldan að breyta þessu gildi.
/fx4/adc/offset_correction	LEGANUMMER Summa allra núverandi frávika rásarinnar.

4.2 Analog Output IO
Þessar IO tengjast uppsetningu almennra hliðrænu úttakanna á FX4 sem finnast undir hliðrænu inntakinu á framhliðinni. Allar 4 rásirnar nota sama tengi IO og eru sjálfstýrðar. Skiptu um channel_x fyrir channel_1 , channel_2 , channel_3 eða channel_4 í sömu röð.

IO leið	Lýsing
/fx4/dac /rás_x	NUMBER Skipun binditage framleiðsla. Aðeins er hægt að skrifa á þetta gildi þegar úttakshamur er stilltur á handvirkt.
/fx4/dac/channel_x/readback	LESIÐ FJÖLDI Mæld binditage framleiðsla. Þetta er mjög gagnlegt þegar þú notar tjáningarúttaksham.
/fx4/dac/channel_x/output_mode	STRING Stillir úttaksham fyrir rásina. Valkostir: „handvirkt“, „tjáning“, „ferlisstýring“
/fx4/dac/channel _ x/slew_control_enable	BOOL Virkjar eða slekkur á takmörkun á slew rate.
/fx4/dac/channel_ x/slew_rate	NUMBER Drægni í V/s fyrir rásina.
/fx4/dac/channel_x/upper_limit	NUMBER Hámarks leyfileg skipun voltage fyrir rásina. Gildir fyrir allar aðgerðastillingar.
/fx4/dac/rás _ x/neðri_takmark	NUMBER Lágmarks leyfð skipun voltage fyrir rásina. Gildir fyrir allar aðgerðastillingar.
/fx4/dac/rás _ x/ úttak _ tjáning	STRING Stillir tjáningarstrenginn sem rásin notar þegar hún er í tjáningarúttaksham.
/fx4/dac/rás _ x/endurstilla_hnappur	HNAPPAR Endurstillir skipunina voltage til 0.

4.3 Stafrænt inntak og úttak
Þessar IO tengjast því að stjórna hinum ýmsu almennu stafrænu inntakum og útgangum sem finnast á FX4.

IO leið	Lýsing
/fx4/fr1	READONLY BOOL Trefjamóttakari 1.
/fx4/ft1	BOOL trefjasendir 1.
/fx4/fr2	READONLY BOOL Trefjamóttakari 2.
/fx4/ft2	BOOL trefjasendir 2.
/fx4/fr3	READONLY BOOL Trefjamóttakari 3.
/fx4/ft3	BOOL trefjasendir 3.
/fx4/digital_expansion/d1	BOOL D1 tvíátta stafræn stækkun IO.
/fx4/digital_expansion/d2	BOOL D2 tvíátta stafræn stækkun IO.
/fx4/digital_expansion/d3	BOOL D3 tvíátta stafræn stækkun IO.
/fx4/digital_expansion/d4	BOOL D4 tvíátta stafræn stækkun IO.

4.3.1 Stafræn IO stillingar
Allar stafrænar tölvur eru með barna-IO til að stilla hegðun þeirra, þar á meðal rekstrarham sem stjórnar hvernig þessi stafræni mun starfa. Hver stafrænn mun hafa mismunandi sett af tiltækum valkostum. Sjá GUI fyrir upplýsingar um hvaða valkostir eru í boði fyrir hvaða IO.

Barn IO Path	Lýsing
…/hamur	STRING Notkunarhamur fyrir stafræna. Valkostir: „inntak“, „úttak“, „pwm“, „tímamælir“, „kóðari“, „fanga“, „uart_rx“, „uart_tx“, „can_rx“, „can_tx“, „pru_inntak“ eða „pru_útgangur“
…/ferli_merki	STRING Heiti ferlistýringarmerkis, ef það er eitt.
…/pull_mode	STRING Dragðu upp/niður stillingu fyrir stafrænt inntak. Valkostir: „upp“, „niður“ eða „slökkva“

4.4 Relay Control
Bæði liðin eru sjálfstýrð og deila sömu tegund viðmóts. Skiptu um relay_x fyrir relay_a eða relay_b í sömu röð.

IO leið	Lýsing
/fx4/relay _ x/permit / user _ skipun	BOOL Skipar um opið eða lokað gengi. Sönn skipun mun reyna að loka genginu ef læsingarnar eru veittar og röng skipun mun alltaf opna gengið.
/fx4/gengi _ x/ástand	READONLY STRING Núverandi staða gengisins. Læst lið eru opin en ekki hægt að loka þeim vegna samlæsingar. Ríki: „opnað“, „lokað“ eða „læst“
/fx4/relay _ x/sjálfkrafa _ loka	BOOL Þegar stillt er á satt, mun gengið lokast sjálfkrafa þegar læsingar eru veittar. False sjálfgefið.
/fx4/gengi _ x/ hringrás _ telja	READONLY NUMBER Fjöldi gengislota frá síðustu endurstillingu. Gagnlegt til að fylgjast með líftíma gengis.

4.5 Hár binditage Eining
Sjá IGX – forritarahandbók fyrir upplýsingar um FX4 hávoltage tengi. Foreldraslóð íhluta er /fx4/high_votlage .

4.6 Skammtastýring
Sjá IGX – forritarahandbók fyrir upplýsingar um viðmót FX4 skammtastýringar. Foreldraslóð íhluta er /fx4/dose_controller .

FX4 Python Examples

5.1 Gagnaskrármaður með HTTP
Þetta frvampLe sýnir hvernig á að fanga fjölda lestra og vista þær í CSV file. Með því að velja langan tíma á milli lestra geturðu framkvæmt langtíma gagnaskráningu jafnvel þótt FX4 sampling hlutfall er stillt hærra. Þetta gerir þér kleift að safna og geyma mælingar stöðugt yfir langan tíma án þess að yfirgnæfa kerfið og tryggja að gögn séu tekin með millibili sem hentar greiningu þinni. Töfin á milli lestra hjálpar til við að stjórna hraðanum sem gögn eru skráð á, sem gerir kleift að geyma skilvirka og dregur úr hættu á að gagnapunkta vanti á meðan þú nýtur enn góðs af háhraða sampling fyrir rauntímamælingar.

5.2 Einfalt Python GUI
Seinni fyrrverandiample notar Tkinter GUI tólið, sem er smíðað fyrir Python, til að búa til skjá á mældum straumum. Þetta viðmót gerir þér kleift að sjá núverandi lestur á notendavænu myndrænu formi. Hægt er að breyta stærð skjásins til að gera hann nógu stór til að lesa úr herberginu, sem gerir hann tilvalinn fyrir aðstæður þar sem rauntímavöktunar er þörf í stærri rýmum. Tkinter býður upp á auðvelda leið til að búa til gagnvirkt viðmót og með því að samþætta það við FX4 geturðu á fljótlegan hátt byggt upp sjónræna sýningu á mældum straumum sem hægt er að aðlaga að þínum þörfum.

5.3 Einfalt WebInnstungur Example
Þetta frvample sýnir fram á WebSockets tengi, sem er ákjósanleg aðferð til að lesa gögn úr FX4 þegar hámarks bandbreidd er krafist. WebInnstungur veita rauntíma, fullri tvíhliða samskiptarás, sem gerir kleift að flytja hraðari og skilvirkari gagnaflutning samanborið við aðrar aðferðir.
Fyrrverandiample les röð af samples, segir meðaltíma á sample og hámarks leynd, og vistar gögnin í CSV file til síðari greiningar. Þessi uppsetning gerir ráð fyrir skilvirku rauntíma eftirliti og auðveldri gagnageymslu fyrir eftirvinnslu.
Sérstakur árangur sem hægt er að ná með WebInnstungur fer eftir áreiðanleika Ethernet viðmótsins og hlutfallslegum forgangi forritsins. Til að ná sem bestum árangri skaltu ganga úr skugga um að netið þitt sé stöðugt og að gagnasendingum FX4 sé forgangsraðað ef þörf krefur.

Útgáfa: v3
FX4 Python Examples: 21

Skjöl / auðlindir

PYRAMID FX4 forritari [pdfLeiðbeiningarhandbók FX4 forritari, FX4, forritari

Heimildir

• Notendahandbók