www.pyramid.tech
FX4
FX4 Programmer Manual
Palapala ID: 2711715845
Manaʻo: v3

Mea polokalamu FX4

Palapala ID: 2711715845
FX4 - FX4 Papahana Polokalamu

Palapala ID: 2711650310

Mea kākau	Matthew Nichols
mea nona	Ke alakaʻi papahana
Ke kumu	E wehewehe i nā manaʻo hoʻolālā e pono ai e hoʻohana i ka API a hoʻonui i ka huahana ma o nā noi waho.
ʻĀpana	Nā manaʻo hoʻolālā pili FX4.
Hoʻolohe manaʻo	Makemake nā mea hoʻomohala polokalamu i ka hoʻohana ʻana i ka huahana.
Kaʻina hana	https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Maʻamau%20Manual%20Creation%20Process
Hoʻomaʻamaʻa	PILI 'OLE

Mana Mana

Manao	wehewehe	Mālama ʻia e	Mālama ʻia ma	Kūlana
v3	Hoʻohui i kahi maʻalahiview a oi aku examples.	Matthew Nichols	Mar 6, 2025 10:29 PM	Aponoia
v2	Hoʻohui ʻia nā kikowaena IO kikohoʻe a me nā kuhikuhi i ka IGX.	Matthew Nichols	Mei 3, 2024 7:39 PM	Aponoia
v1	ʻO ka hoʻokuʻu mua ʻana, ke holomua nei ka hana.	Matthew Nichols	Pepeluali 21, 2024 11:25 PM	Aponoia

Mana Palapala ʻAʻole ʻo Reviewed
Mana palapala o kēia manawa: v.1
ʻAʻohe reviewers i haawiia.

1.1 Pulima
no ka mana palapala hou loa
Pōʻalima, Malaki 7, 2025, 10:33 PM UTC
Ua kakau inoa o Matthew Nichols; ʻo ia hoʻi: Review

Nā kuhikuhi

Palapala	Palapala ID	Mea kākau	Manao
IGX – Papahana Polokalamu	2439249921	Matthew Nichols	1

Hoʻopau ka polokalamu FX4view

Holo ka kaʻina hana FX4 ma kahi kaiapuni i kapa ʻia ʻo IGX, i kūkulu ʻia ma ka QNX high-reliability realtime operating system mai BlackBerry (QNX Webpaena¹). Hāʻawi ʻo IGX i kahi maʻalahi a piha hoʻi i ka polokalamu polokalamu hoʻonohonoho polokalamu (API) no nā mea hoʻohana e makemake e kākau i kā lākou polokalamu kamepiula hoʻokipa.
Hoʻokaʻawale ʻia ke kaiapuni IGX ma nā huahana Pyramid ʻē aʻe, e ʻae ana i nā hoʻonā polokalamu i hoʻomohala ʻia no kahi huahana e maʻalahi e hoʻololi i nā mea ʻē aʻe.
Hiki i nā polokalamu polokalamu ke kuhikuhi i ka palapala piha no IGX i loaʻa ma ka Pyramid webkahua ma: IGX | Hoʻolālā ʻōnaehana modular hou no Web- nā noi i hiki²

Hāʻawi kēia ʻāpana i kahi hoʻolauna no ka hoʻāʻo ʻana i ʻelua mau ala API: HTTP me ka hoʻohana ʻana i ka JSON format a me EPICS. No ka maʻalahi, Python (Python Webpaena³) hoʻohana ʻia ma ke ʻano he example host computer 'ōlelo, i hiki a maʻalahi ke hoʻohana no nā polokalamu polokalamu ʻole.

3.1 Ke hoʻohana nei iā Python a me HTTP
Ma keʻano he exampe, manaʻo ʻoe makemake e heluhelu i ka huina o nā au i ana ʻia me Python. Pono ʻoe i ka URL no kēlā IO kūikawā. ʻO ka FX4 web Hāʻawi ʻo GUI i kahi ala maʻalahi e ʻike ai i kēia: kaomi pololei ma ke kahua a koho iā 'Kopi HTTP URL' e kope i ke kaula i ka papa ʻoki.

I kēia manawa hiki iā ʻoe ke hoʻohana iā Python e hoʻāʻo i ka pili ʻana i ka polokalamu hoʻohana ma o HTTP a me JSON. Pono paha ʻoe e hoʻokomo i nā noi a me nā hale waihona puke json no ka mālama ʻana i nā noi HTTP a me ka parsing data.

1 Python maʻalahi HTTP Example

3.2 Hoʻohana i ka EPICS
ʻO ke kaʻina hana no ka hoʻopili ʻana i ka FX4 ma o EPICS (Experimental Physics and Industrial Control System) ua like. ʻO EPICS kahi pūʻulu o nā lako polokalamu a me nā noi i hoʻohana ʻia no ka hoʻomohala ʻana a hoʻokō i nā ʻōnaehana mana hoʻolaha, hoʻohana nui ʻia i nā keʻena ʻepekema.

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

1. E kiʻi i ka inoa EPICS process variable (PV) no ka IO i makemake ʻia.
2. Hoʻokomo i ka waihona EPICS a heluhelu i ka waiwai.

2 E kiʻi i ka inoa EPICS PV3 EPICS Python maʻalahi Example

Eia hou, ua hana ʻo Pyramid i kahi mea pono (EPICS Hui⁴) hiki iā ʻoe ke nānā i nā loli kaʻina hana EPICS i ka manawa maoli. He mea kōkua kēia mea hana e hōʻoia inā pololei ka inoa EPICS PV a ke lawelawe pololei nei ka FX4 i ka PV ma kāu pūnaewele.

4 PTC EPICS Hoʻohui

API Papahana FX4

ʻO nā manaʻo a me nā ʻano hana i wehewehe ʻia ma kēia manual e kūkulu i nā manaʻo i hoʻokumu ʻia ma ka IGX - Programmer Manual. E ʻoluʻolu e ʻike i kēlā palapala no ka wehewehe a me ka exampe pili ana i ka hana ʻana o ka polokalamu IGX a me nā pilina. E uhi wale kēia manual i ka IO kikoʻī a me ka hana kūikawā i ka FX4.

4.1 Hoʻokomo Analog IO
Pili kēia mau IO i ka hoʻonohonoho ʻana a me ka hōʻiliʻili ʻana i ka ʻikepili ma nā mea hoʻokomo o kēia manawa o ka FX4. Hoʻokumu ʻia nā ʻāpana o ka hoʻokomo ʻana i ke kahawai ma ka hoʻonohonoho hoʻonohonoho hoʻohana i kapa ʻia ʻo "Sample Units", nā koho kūpono e pili ana i ka pA, nA, uA, mA, a me A.
Hoʻohana ʻia nā kaha 4 a pau i ka interface like IO a hoʻomalu kūʻokoʻa ʻia. E hoʻololi i ka channel_x me ke channel_1 , channel_2 , channel_3 , a i ʻole channel_4.

Alanui IO	wehewehe
/fx4/adc/channel_x	HELU READONLY i ana i ka hookomo o keia manawa.
/fx4/adc/channel_x/scalar	NUMBER scalar unitless maʻalahi i hoʻohana ʻia i ke kahawai, 1 ma ka paʻamau.
/fx4/adc/channel_x/zero_offset	NUMBER Hoʻopau i kēia manawa ma nA no ke kahawai.

ʻAʻole kūʻokoʻa ka IO ma lalo nei a hoʻohana ʻia i nā kaha āpau i ka manawa like.

Alanui IO	wehewehe
/fx4/channel_sum	HELU READONLY Huina o na ala hookomo o keia manawa.
/fx4/adc_unit	Hoʻonohonoho ʻo STRING i nā ʻāpana mea hoʻohana i kēia manawa no kēlā me kēia kahawai a me ka huina. Nā koho: “pa”, “na”, “ua”, “ma”, “a”
/fx4/nui	Hoʻonohonoho ʻo STRING i ka laulā hoʻokomo i kēia manawa. E ʻike iā GUI no ke ʻano o ka pili ʻana o kēlā me kēia pāʻālua me nā palena hoʻokomo o kēia manawa a me BW. Nā koho: "0", "1", "2", "3", "4", "5", "6", "7"
/fx4/adc/sample_frequency	HELU Ka alapine (frequency) ma Hz i sample data e awelika i. Mālama kēia i ka hōʻailona-a-noise a me ka helu ʻikepili no nā ala āpau.
/fx4/adc/conversion_frequency	HELU Ka alapine (frequency) ma Hz a ka ADC e hoʻololi ai i ka analog i nā waiwai kikohoʻe ma. Ma ka maʻamau, ʻo 100kHz kēia, a ʻaʻole pono ʻoe e hoʻololi i kēia waiwai.
/fx4/adc/offset_correction	HELU HELU READONLY Huina o na hookui o keia wa.

4.2 Analog Output IO
Hoʻopili kēia mau IO i ka hoʻonohonoho ʻana o nā mea hoʻopuka analog kumu nui o ka FX4 i loaʻa ma lalo o nā hoʻokomo analog ma ka ʻaoʻao mua. Hoʻohana ʻia nā kaha 4 a pau i ka interface like IO a hoʻomalu kūʻokoʻa ʻia. E hoʻololi i ke kahawai_x me ke kaila_1 , kanal_2 , channel_3 , a i ʻole channel_4.

Alanui IO	wehewehe
/fx4/dac /channel_x	HELU Kauoha voltage puka ana. Hiki ke kākau ʻia kēia waiwai i ka wā i hoʻonohonoho ʻia ai ke ʻano hoʻopuka i ka manual.
/fx4/dac/channel_x/readback	HELU HELUhelu Ana voltage hoʻopuka. He mea kōkua nui kēia i ka hoʻohana ʻana i ke ʻano hoʻopuka huaʻōlelo.
/fx4/dac/channel_x/output_mode	Hoʻonohonoho ʻo STRING i ke ʻano hoʻopuka no ke kahawai. Nā koho: "manual", "expression", "process_control"
/fx4/dac/channel _ x/slew_control_enable	BOOL Ho'ā a hoʻopau paha i ka hoʻopaʻa ʻana i ka helu pepehi.
/fx4/dac/channel_ x/slew_rate	NUMBER Ka nui o ka make ma V/s no ke kahawai.
/fx4/dac/channel_x/upper_limit	HELU ʻO ke kauoha i ʻae ʻia voltage no ke kahawai. Pili i nā ʻano hana a pau.
/fx4/dac/channel _ x/lower_limit	HELU Ka palena iki i ʻae ʻia voltage no ke kahawai. Pili i nā ʻano hana a pau.
/fx4/dac/channel _ x/ hoʻopuka _ hōʻike	Hoʻonohonoho ʻo STRING i ke kaula hōʻike i hoʻohana ʻia e ke kahawai i ke ʻano o ka hoʻopuka ʻana.
/fx4/dac/channel _ x/reset_button	BUTTON Hoʻihoʻi i ke kauoha voltage i ka 0.

4.3 Kikohoʻe hoʻokomo a me nā mea hoʻopuka
Pili kēia mau IO i ka hoʻomalu ʻana i nā mea hoʻokomo kikohoʻe kumu nui a me nā huahana i loaʻa ma ka FX4.

Alanui IO	wehewehe
/fx4/fr1	READONLY BOOL Fiber loaʻa 1.
/fx4/ft1	ʻO BOOL Fiber transmitter 1.
/fx4/fr2	READONLY BOOL Fiber loaʻa 2.
/fx4/ft2	ʻO BOOL Fiber transmitter 2.
/fx4/fr3	READONLY BOOL Fiber loaʻa 3.
/fx4/ft3	ʻO BOOL Fiber transmitter 3.
/fx4/digital_expansion/d1	BOOL D1 hoʻonui kikohoʻe bidirectional IO.
/fx4/digital_expansion/d2	BOOL D2 hoʻonui kikohoʻe bidirectional IO.
/fx4/digital_expansion/d3	BOOL D3 hoʻonui kikohoʻe bidirectional IO.
/fx4/digital_expansion/d4	BOOL D4 hoʻonui kikohoʻe bidirectional IO.

4.3.1 Kikohoʻe IO hoʻonohonoho
Loaʻa i nā digitals a pau ke keiki IO no ka hoʻonohonoho ʻana i kā lākou ʻano me ke ʻano hana e hoʻomalu ai i ka hana ʻana o ia kikohoʻe. Loaʻa i kēlā me kēia kikohoʻe kahi ʻokoʻa o nā koho i loaʻa. E ʻike i ka GUI no nā kikoʻī e pili ana i nā koho i loaʻa no ka mea IO.

Alanui keiki IO	wehewehe
…/ʻano	STRING Ke ʻano hana no ke kikohoʻe. Nā koho: "hookomo", "puka", "pwm", "ka manawa", "encoder", "hopu", "uart_rx", "uart_tx", "can_rx", "can_tx", "pru_input", a i ʻole "pru_output"
…/process_signal	STRING Ka inoa hōʻailona hoʻomalu kaʻina hana, inā loaʻa kekahi.
…/pull_mode	STRING Huki i luna/lalo no kahi hoʻokomo kikohoʻe. Nā koho: "up", "down", a "disable"

4.4 Mana Relay
Hoʻomalu kūʻokoʻa ʻia nā relay ʻelua a kaʻana like i ke ʻano o ka interface. E hoʻololi i ka relay_x me ka relay_a a i ʻole relay_b.

Alanui IO	wehewehe
/fx4/relay _ x/ʻae / mea hoʻohana _ kauoha	Kauoha ʻo BOOL i ka relay e wehe a pani ʻia. E ho'āʻo ke kauoha ʻoiaʻiʻo e pani i ka relay inā hāʻawi ʻia nā mea pili, a e wehe mau ke kauoha wahaheʻe i ka relay.
/fx4/relay _ x/ mokuʻāina	READONLY STRING Ke kūlana o kēia manawa o ka relay. Hāmama nā relay i paʻa akā ʻaʻole hiki ke pani ʻia ma muli o kahi paʻa. Mokuʻāina: “wehe”, “pani”, a “paʻa”
/fx4/relay _ x/akomi _ pani	BOOL Ke hoʻonoho ʻia i ka ʻoiaʻiʻo, e pani koke ka relay ke hāʻawi ʻia nā paʻa. Hoʻopunipuni ma ka paʻamau.
/fx4/relay _ x/ cycle _ helu	HELU READONLY ʻO ka helu o nā pōʻaiapili relay mai ka hoʻoponopono hope. Maikaʻi no ka nānā ʻana i ke ola relay.

4.5 Vol Voltage Module
E ʻike i ka IGX – Programmer Manual no nā kikoʻī e pili ana i ka vol kiʻekiʻe FX4tage pāʻani. ʻO ke ala makua ʻāpana ʻo /fx4/high_votlage .

4.6 Mea Hoʻoponopono Dose
E ʻike i ka IGX - Programmer Manual no nā kikoʻī e pili ana i ka FX4 dose controller interface. ʻO ke ala makua ʻāpana ʻo /fx4/dose_controller.

FX4 Python Examples

5.1 Logger Data me ka hoʻohana ʻana iā HTTP
ʻO kēia exampHōʻike ʻo ia i ka hopu ʻana i kekahi mau heluhelu a mālama iā lākou i kahi CSV file. Ma ke koho ʻana i kahi lohi lōʻihi ma waena o nā heluhelu, hiki iā ʻoe ke hana i ka hoʻopaʻa inoa ʻikepili lōʻihi inā ʻo ka FX4 sampua hoʻonohonoho ʻia ka ling rate kiʻekiʻe. Hāʻawi kēia iā ʻoe e hōʻiliʻili mau a mālama i nā ana no nā manawa lōʻihi me ka ʻole o ka hoʻoluhi ʻana i ka ʻōnaehana, e hōʻoia i ka hopu ʻia ʻana o ka ʻikepili i nā manawa kūpono no kāu loiloi. ʻO ka lohi ma waena o nā heluhelu e kōkua i ka hoʻoponopono ʻana i ka wikiwiki o ka hoʻopaʻa ʻana i ka ʻikepili, e ʻae ana i ka mālama pono ʻana a me ka hōʻemi ʻana i ka pilikia o ka nalo ʻana o nā helu ʻikepili ʻoiai e pōmaikaʻi ana i nā s wikiwiki.ampling no nā ana manawa maoli.

5.2 GUI Python maʻalahi
ʻO ka ex luaampHoʻohana ʻo ia i ka hāmeʻa Tkinter GUI, i kūkulu ʻia no Python, e hana i kahi hōʻike o nā au i ana ʻia. Hāʻawi kēia interface iā ʻoe e nānā i nā heluhelu o kēia manawa ma kahi ʻano kiʻi hoʻohana. Hiki ke hoʻololi hou ʻia ka hōʻike i mea e nui ai ka heluhelu ʻana mai kēlā ʻaoʻao o kahi lumi, e kūpono ia no nā hiʻohiʻona kahi e pono ai ka nānā ʻana i ka manawa maoli ma nā wahi nui. Hāʻawi ʻo Tkinter i kahi ala maʻalahi e hana i nā pilina pili, a ma ka hoʻohui ʻana iā ia me ka FX4, hiki iā ʻoe ke kūkulu wikiwiki i kahi hōʻike ʻike o nā au i ana ʻia i hiki ke hoʻopili ʻia e kūpono i kāu mau pono kikoʻī.

5.3 Maʻalahi WebNā Sockets Example
ʻO kēia example hoike ana i ka WebSockets interface, ʻo ia ke ala i makemake ʻia no ka heluhelu ʻana i ka ʻikepili mai ka FX4 ke koi ʻia ka bandwidth kiʻekiʻe. WebHāʻawi nā Sockets i kahi kaila kamaʻilio piha-duplex manawa maoli, e ʻae ana i ka hoʻoili ʻikepili wikiwiki a ʻoi aku ka maikaʻi ma mua o nā ʻano hana ʻē aʻe.
ʻO ka example heluhelu i ka moʻo o samples, hōʻike i ka manawa maʻamau i kēlā me kēia sample a me ka lōʻihi loa, a mālama i ka ʻikepili i kahi CSV file no ka nānā ʻana ma hope. Hiki i kēia hoʻonohonoho ke nānā pono i ka manawa maoli a me ka maʻalahi o ka mālama ʻana i ka ʻikepili no ka hana hope.
ʻO ka hana kūikawā i hiki ke hoʻokō me WebAia nā kumu i ka hilinaʻi o kāu interface Ethernet a me ka mea nui o kāu noi. No nā hualoaʻa maikaʻi loa, e hōʻoia i ka paʻa o kāu pūnaewele a ʻo ka hoʻouna ʻana i ka ʻikepili o FX4 ka mea nui inā pono.

Manaʻo: v3
FX4 Python Examples: 21

Palapala / Punawai

PYRAMID FX4 Programmer [pdf] Palapala Aʻo FX4 Programmer, FX4, Programmer

Nā kuhikuhi

• Palapala Hoʻohana