www.pyramid.tech
FX4
Buka ea FX4 Programmer
Lethathamo la lintlha: 2711715845
Phetolelo: v3

Moqapi oa FX4

Lethathamo la lintlha: 2711715845
FX4 - Buka ea FX4 Programmer

Tokomane ID: 2711650310

Mongoli	Matthew Nichols
Mong'a	Moetapele oa Morero
Morero	Hlalosa mehopolo ea lenaneo e hlokahalang ho sebelisa API le ho holisa sehlahisoa ka lits'ebetso tsa kantle.
Sebaka	Likhopolo tse amanang le mananeo a FX4.
Bamameli ba Reriloeng	Baetsi ba lisebelisoa ba nang le thahasello ea ho sebelisa sehlahisoa.
Tshebetso	https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Process
Koetliso	HA E SEBETSE

Taolo ea Phetolelo

Phetolelo	Tlhaloso	E bolokiloe ke	E boloketsoe	Boemo
v3	E ekelitsoe ka mokhoa o bonoloview le tse ling tse examples.	Matthew Nichols	Mar 6, 2025 10:29 PM	KAMOHELO
v2	E kenyellelitse li-interface tsa IO tsa dijithale le litšupiso tse khutlelang ho IGX.	Matthew Nichols	La 3 Motšeanong 2024 7:39 PM	KAMOHELO
v1	Tokollo ea pele, mosebetsi o ntse o tsoela pele.	Matthew Nichols	Hlakola 21, 2024 11:25 PM	KAMOHELO

Taolo ea Litokomane Eseng Reviewed
Tokomane ea hajoale: v.1
Ha ho reviewba abetsoeng.

1.1 Mesaeno
bakeng sa mofuta oa morao-rao oa litokomane
Labohlano, Mar 7, 2025, 10:33 PM UTC
Matthew Nichols o saenetse; moelelo: Review

Litšupiso

Tokomane	Tokomane ID	Mongoli	Phetolelo
IGX - Buka ea Moqapi	2439249921	Matthew Nichols	1

FX4 Programming Overview

FX4 processor e sebetsa tikolohong e bitsoang IGX, e hahiloeng holim'a sistimi ea ts'ebetso ea nako ea nnete ea QNX e tšepahalang haholo ho tsoa ho BlackBerry (QNX Websebaka¹). IGX e fana ka sebopeho se feto-fetohang le se felletseng sa software (API) bakeng sa basebelisi ba batlang ho ngola software ea bona ea khomphutha e ba amohelang.
Tikoloho ea IGX e arolelanoa lihlahisoa tse ling tsa Pyramid, ho lumella litharollo tsa software tse ntlafalitsoeng bakeng sa sehlahisoa se le seng hore se fetisetsoe ho tse ling habonolo.
Baetsi ba mananeo ba ka bua ka litokomane tse felletseng tsa IGX tse fumanehang ho Pyramid websebaka ho: IGX | Moralo oa Sejoale-joale oa Tsamaiso ea Tsamaiso ea Modular bakeng sa Web-enabled Applications²

Karolo ena e fana ka kenyelletso ea ho leka mekhoa e 'meli ea API: HTTP e sebelisa sebopeho sa JSON le EPICS. Bakeng sa ho nolofatsa, Python (Python Websebaka³) e sebelisoa joalo ka mohlalaample ho amohela puo ea komporo, e fumanehang habonolo le e bonolo ho e sebelisa bakeng sa baetsi ba mananeo bao e seng litsebi.

3.1 Ho sebelisa Python le HTTP
Joalo ka mohlalaampLe, nka hore u batla ho bala kakaretso ea maqhubu a lekantsoeng le Python. U hloka URL bakeng sa IO eo e khethehileng. FX4 web GUI e fana ka mokhoa o bonolo oa ho fumana sena: tobetsa ka ho le letona tšimong ebe u khetha 'Kopitsa HTTP URL' ho kopitsa khoele ho clipboard.

Joale o ka sebelisa Python ho leka khokahanyo ho software ea mosebelisi ka HTTP le JSON. U kanna ua hloka ho kenya likopo le lilaebrari tsa json ho sebetsana le likopo tsa HTTP le ho arola data.

1 Python HTTP Example

3.2 Ho sebelisa EPICS
Mokhoa oa ho hokahanya FX4 ka EPICS (Experimental Physics and Industrial Control System) oa tšoana. EPICS ke sehlopha sa lisebelisoa tsa software le lits'ebetso tse sebelisoang ho nts'etsapele le ho kenya tšebetsong litsamaiso tsa taolo tse ajoang, tse sebelisoang haholo litsing tsa mahlale.

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

1. Fumana lebitso la EPICS process variable (PV) bakeng sa IO eo u e batlang.
2. Kenya laeborari ea EPICS 'me u bale boleng.

2 Fumana EPICS PV Lebitso3 Python E Bonolo EPICS Example

Ho feta moo, Pyramid e entse sesebelisoa (EPICS Connect⁴) e u lumellang hore u shebelle mefuta e fapaneng ea ts'ebetso ea EPICS ka nako ea nnete. Sesebelisoa sena se thusa ho netefatsa hore na lebitso la EPICS PV le nepahetse le hore FX4 e sebeletsa PV ka nepo marang-rang a hau.

4 PTC EPICS Connect

FX4 Programming API

Maikutlo le mekhoa e hlalositsoeng bukeng ena e haha ​​​​holim'a likhopolo tse thehiloeng ho IGX - Programmer Manual. Ka kopo, sheba tokomane eo bakeng sa tlhaloso le mohlalaamplintlha tsa hore na mananeo a IGX le li-interfaces li sebetsa joang. Bukana ena e tla akaretsa feela IO e ikhethileng ea sesebelisoa le ts'ebetso e ikhethileng ho FX4.

4.1 Kenyelletso ea Analog IO
Li-IO tsena li amana le ho hlophisa le ho bokella lintlha tsa lisebelisoa tsa hona joale tsa analog tsa FX4. Diyuniti tsa dikeno tsa dikanale di theilwe hodima tlhophiso ya mosebedisi e bitswang “Sample Units”, likhetho tse nepahetseng li kenyelletsa pA, nA, uA, mA, le A.
Likanale tse 4 kaofela li sebelisa sebopeho se tšoanang sa IO mme li laoloa ka boikemelo. Fetolela channel_x ka channel_1 , channel_2 , channel_3 , kapa channel_4 ka ho latellana.

Mokhoa oa IO	Tlhaloso
/fx4/adc/channel_x	BALA NUMBER E lekantsoeng ha joale.
/fx4/adc/channel_x/scalar	NUMBER Sekala se bonolo se se nang bonngoe se sebelisoa seteisheneng, 1 ka linako tsohle.
/fx4/adc/channel_x/zero_offset	NUMBER E fokotsehile ho naA bakeng sa kanale.

Litsela tse latelang ha li ikemele ka likanale 'me li sebelisoa likanaleng tsohle ka nako e le 'ngoe.

Mokhoa oa IO	Tlhaloso
/fx4/channel_sum	BALA NUMBER FEELA Kakaretso ea likanale tse kentsoeng hajoale.
/fx4/adc_unit	STRING E beha liyuniti tsa basebelisi ba hajoale bakeng sa kanale ka 'ngoe le kakaretso. Likhetho: "pa", "na", "ua", "ma", "a"
/fx4/range	STRING E beha mofuta oa hona joale oa ho kenya. Sheba GUI bakeng sa hore na khoutu e 'ngoe le e' ngoe ea mefuta e lumellana joang le meeli ea hona joale ea ho kenya le BW. Likhetho: "0", "1", "2", "3", "4", "5", "6", "7"
/fx4/adc/sample_frequency	NUMBER Maqhubu a ho Hz a sampdata le tla ba ka karolelano ho. Sena se laola lebelo la mats'oao ho ea ho lerata le sekhahla sa data bakeng sa likanale tsohle.
/fx4/adc/conversion_frequency	NUMBER Maqhubu a ho Hz ao ADC e tla fetolela analoge ho boleng ba dijithale ho ona. Ka ho sa feleng, sena ke 100kHz, 'me ke ka seoelo u tla hloka ho fetola boleng bona.
/fx4/adc/offset_correction	BALA NUMBER Kakaretso ea litefiso tsohle tsa hajoale.

4.2 Analog Output IO
Li-IO tsena li amana le tlhophiso ea liphetho tsa analoge tsa sepheo se akaretsang sa FX4 tse fumanehang tlasa likenyelletso tsa analog phanele e ka pele. Likanale tse 4 kaofela li sebelisa sebopeho se tšoanang sa IO mme li laoloa ka boikemelo. Fetolela channel_x ka channel_1 , channel_2 , channel_3 , kapa channel_4 ka ho latellana.

Mokhoa oa IO	Tlhaloso
/fx4/dac /channel_x	NUMBER Taelo voltage tlhahiso. Boleng bona bo ka ngolloa feela ha mokhoa oa tlhahiso o behiloe ho manual.
/fx4/dac/channel_x/readback	READONLY NUMBER Measured voltagtlhahiso. Sena se thusa haholo ha o sebelisa mokhoa oa ho hlahisa maikutlo.
/fx4/dac/channel_x/output_mode	STRING E beha mokhoa oa ho hlahisa mocha. Likhetho: "manual", "polelo", "process_control"
/fx4/dac/channel _ x/slew_control_enable	BOOL E nolofaletsa kapa e thibela ho fokotsa sekhahla sa batho ba bolailoeng.
/fx4/dac/channel_ x/slew_rate	NUMBER Sekhahla sa V/s bakeng sa kanale.
/fx4/dac/channel_x/upper_limit	NUMBER Taelo e phahameng e lumelletsoeng ka voltage bakeng sa kanale. E sebetsa ho mefuta eohle ea ts'ebetso.
/fx4/dac/channel _ x/low_limit	NUMBER Bonyane Taelo e lumelletsoeng voltage bakeng sa kanale. E sebetsa ho mefuta eohle ea ts'ebetso.
/fx4/dac/channel _ x/ tlhahiso _ polelo	STRING E beha thapo ea polelo e sebelisoang ke kanale ha e le ka mokhoa oa tlhahiso ea polelo.
/fx4/dac/channel _ x/reset_button	BUTTON E seta hape taelo voltage ho 0.

4.3 Kenyelletso le Liphetho tsa Dijithale
Li-IO tsena li amana le ho laola merero le liphetho tse fapaneng tsa dijithale tse fumanehang ho FX4.

Mokhoa oa IO	Tlhaloso
/fx4/fr1	READONLY BOOL Fiber receiver 1.
/fx4/ft1	BOOL Fiber transmitter 1.
/fx4/fr2	READONLY BOOL Fiber receiver 2.
/fx4/ft2	BOOL Fiber transmitter 2.
/fx4/fr3	READONLY BOOL Fiber receiver 3.
/fx4/ft3	BOOL Fiber transmitter 3.
/fx4/digital_expansion/d1	BOOL D1 katoloso ea dijithale habeli IO.
/fx4/digital_expansion/d2	BOOL D2 katoloso ea dijithale habeli IO.
/fx4/digital_expansion/d3	BOOL D3 katoloso ea dijithale habeli IO.
/fx4/digital_expansion/d4	BOOL D4 katoloso ea dijithale habeli IO.

4.3.1 Digital IO Configuration
Li-digital kaofela li na le IO ea bana bakeng sa ho hlophisa boitšoaro ba bona ho kenyelletsa le mokhoa oa ho sebetsa o laolang hore na digital e tla sebetsa joang. Dijithale ka 'ngoe e tla ba le likhetho tse fapaneng tse fumanehang. Sheba GUI bakeng sa lintlha tse mabapi le hore na ke likhetho life tse fumanehang bakeng sa seo IO.

Ngoana IO Tsela	Tlhaloso
…/mokhoa	STRING Mokhoa oa ts'ebetso bakeng sa dijithale. Dikgetho: “input“, “output”, “pwm”, “timer”, “encoder”, “capture”, “uart_rx”, “uart_tx”, “can_rx”, “can_tx”, “pru_input”, kapa “pru_output”
…/process_signal	STRING Lebitso la lets'oao la taolo ea tšebetso, haeba le le teng.
…/pull_mode	STRING E hulela holimo/tlase bakeng sa ho kenya letsoho ka dijithale. Likhetho: "holimo", "fatše", kapa "thibela"

4.4 Relay Taolo
Li-relay ka bobeli li laoloa ka boikemelo 'me li arolelana mofuta o tšoanang oa sebopeho. Tlosa relay_x ka relay_a kapa relay_b ka ho latellana.

Mokhoa oa IO	Tlhaloso
/fx4/relay _ x/permit/taelo ya mosebedisi	BOOL E laela hore relay e buloe kapa e koetsoe. Taelo ea 'nete e tla leka ho koala relay haeba li-interlock li fanoa,' me taelo ea bohata e tla lula e bula relay.
/fx4/relay _ x/state	READONLY STRING Boemo ba hajoale ba relay. Li-relay tse notletsoeng li butsoe empa li ke ke tsa koaloa ka lebaka la ho hokahanngoa. States: "e butsoe", "e koetsoe", kapa "e notletsoe"
/fx4/relay _ x/automatically _ koala	BOOL Ha e setiloe ho 'nete, relay e tla koala ka bo eona ha li-interlock li fanoe. Bohata ka ho sa feleng.
/fx4/relay _ x/ potoloho _ palo	READONLY NUMBER Palo ea lipokoloho tsa ho fetisetsoa ho tloha nakong ea ho seta bocha. E thusa ho latedisa bophelo bohle ba relay.

Vol. 4.5 e Phahamengtage Mojule
Sheba Buka ea IGX - Programmer bakeng sa lintlha tse mabapi le FX4 high voltage interface. Karolo ea tsela ea motsoali ke /fx4/high_votlage.

4.6 Taolo ea Lethal dose
Sheba buka ea IGX - Programmer Manual bakeng sa lintlha tse mabapi le sebopeho sa taolo ea litekanyetso tsa FX4. Karolo ea tsela ea motsoali ke /fx4/dose_controller.

FX4 Python Examples

5.1 Data Logger e sebelisa HTTP
Exampe bonts'a mokhoa oa ho hapa lipalo tse 'maloa le ho li boloka ho CSV file. Ka ho khetha tieho e telele lipakeng tsa ho bala, o ka etsa ho rengoa ha data nako e telele le haeba FX4 sampling rate e behiloe holimo. Sena se o lumella ho lula o bokella le ho boloka litekanyo ka nako e telele ntle le ho hatella sistimi, ho netefatsa hore data e nkuoa ka linako tse loketseng tlhahlobo ea hau. Ho lieha pakeng tsa ho bala ho thusa ho laola lebelo leo data e kenngoa ka lona, ​​​​ho lumella ho boloka hantle le ho fokotsa kotsi ea ho lahleheloa ke lintlha tsa data ha u ntse u rua molemo ho tloha ka lebelo le phahameng.ampling bakeng sa litekanyo tsa nako ea sebele.

5.2 Python GUI e bonolo
Example sebelisa sesebelisoa sa Tkinter GUI, se hahiloeng bakeng sa Python, ho etsa pontšo ea maqhubu a lekantsoeng. Khokahano ena e u lumella ho bona ka mahlo a kelello lipalo tsa hajoale ka sebopeho sa graphical se bonolo sa basebelisi. Pontšo e ka fetoloa boholo ba eona ho etsa hore e be kholo e lekaneng hore e ka baloa ho tsoa ka phapusing, ho etsa hore e be e loketseng maemo ao ho hlokahalang hore ho shejoe nako ea 'nete libakeng tse kholoanyane. Tkinter e fana ka mokhoa o bonolo oa ho etsa li-interfaces tse kopanetsoeng, 'me ka ho li kopanya le FX4, u ka potlakela ho haha ​​​​ponts'o ea pono ea maqhubu a lekantsoeng a ka etsoang ho lumellana le litlhoko tsa hau tse khethehileng.

5.3 E bonolo WebSockets Example
Example bontša ea WebSockets interface, e leng mokhoa o ratoang oa ho bala data ho tsoa ho FX4 ha ho hlokahala bandwidth e phahameng. WebLi-sockets li fana ka mocha oa puisano oa nako ea sebele, o tletseng duplex, o lumellang phetisetso ea data e potlakileng le e sebetsang haholoanyane ha e bapisoa le mekhoa e meng.
Example bala letoto la samples, e tlaleha ka karolelano nako ka sample le latency e phahameng, 'me e boloka data ho CSV file bakeng sa tlhahlobo ea morao-rao. Setupo sena se u fa monyetla oa ho beha leihlo ka nako ea nnete le ho boloka data habonolo bakeng sa ts'ebetso ea morao-rao.
Tshebetso e itseng e ka finyelloang ka WebLi-sockets li ipapisitse le ts'epahalo ea sehokelo sa hau sa Ethernet le taba ea mantlha ea kopo ea hau. Bakeng sa liphetho tse nepahetseng, etsa bonnete ba hore marang-rang a hau a tsitsitse le hore phetiso ea data ea FX4 e beoa pele ha ho hlokahala.

Phetolelo: v3
FX4 Python Exampka tlase ho 21

Litokomane / Lisebelisoa

Moqapi oa PYRAMID FX4 [pdf] Buka ea Taelo Lenaneo la FX4, FX4, Moetsi oa Lenaneo

Litšupiso

• Bukana ea Mosebelisi