www.pyramid.tech
FX4
Падручнік праграміста FX4
Ідэнтыфікатар дакумента: 2711715845
Версія: v3
Праграміст FX4
Ідэнтыфікатар дакумента: 2711715845
FX4 – Кіраўніцтва праграміста FX4
Ідэнтыфікатар дакумента: 2711650310
| Аўтар | Мэцью Нікалс |
| Уладальнік | Кіраўнік праекта |
| Прызначэнне | Растлумачце канцэпцыі праграмавання, неабходныя для выкарыстання API і пашырэння прадукту з дапамогай знешніх прыкладанняў. |
| Вобласць прымянення | Канцэпцыі праграмавання, звязаныя з FX4. |
| Мэтавая аўдыторыя | Распрацоўшчыкі праграмнага забеспячэння зацікаўлены ў выкарыстанні прадукту. |
| Працэс | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Стандартны%20Інструкцыя%20Стварэнне%20Працэс |
| Навучанне | Не ўжываецца |
Кантроль версій
| Версія | Апісанне | Захавана | Захавана на | Статус |
| v3 | Дададзены просты надview і больш эксampлес. | Мэцью Нікалс | 6 сакавіка 2025 г. 10:29 | ЗАЦВЕРДЖАНА |
| v2 | Дададзены лічбавыя інтэрфейсы ўводу-выводу і спасылкі на IGX. | Мэцью Нікалс | 3 мая 2024 г. 7:39 | ЗАЦВЕРДЖАНА |
| v1 | Першапачатковы выпуск, праца яшчэ працягваецца. | Мэцью Нікалс | 21 лютага 2024 г. 11:25 | ЗАЦВЕРДЖАНА |
Дакумент кантрольны Не Reviewed
Актуальная версія дакумента: т.1
Няма паўторнагаviewers прызначаныя.
1.1 Подпісы
для апошняй версіі дакумента
Пятніца, 7 сакавіка 2025 г., 10:33 UTC
Мэцью Нікалс падпісаў ; значэнне: Review
Спасылкі
| Дакумент | Ідэнтыфікатар дакумента | Аўтар | Версія |
| IGX - Кіраўніцтва праграміста | 2439249921 | Мэцью Нікалс | 1 |
Скончана праграмаванне FX4view
Працэсар FX4 працуе ў асяроддзі пад назвай IGX, якое пабудавана на аснове высоканадзейнай аперацыйнай сістэмы рэальнага часу QNX ад BlackBerry (QNX Webсайт¹). IGX забяспечвае гнуткі і ўсёабдымны інтэрфейс прыкладнога праграмавання (API) для карыстальнікаў, якія жадаюць напісаць уласнае праграмнае забеспячэнне для хост-кампутара.
Асяроддзе IGX сумесна з іншымі прадуктамі Pyramid, што дазваляе праграмным рашэнням, распрацаваным для аднаго прадукту, лёгка пераносіцца на іншыя.
Праграмісты могуць звярнуцца да поўнай дакументацыі для IGX, даступнай на Pyramid webсайт па адрасе: IGX | Сучасная модульная сістэма кіравання WebПрыкладанні з падтрымкай²
У гэтым раздзеле прадстаўлены ўводзіны ў тэставанне двух метадаў API: HTTP з выкарыстаннем фармату JSON і EPICS. Для прастаты, Python (Python Webсайт³) выкарыстоўваецца як прыкладample мова хост кампутара, які даступны і просты ў выкарыстанні для непрафесійных праграмістаў.
3.1 Выкарыстанне Python і HTTP
Як былыample, выкажам здагадку, што вы хочаце прачытаць суму вымераных токаў з дапамогай Python. Вам трэба URL для гэтага канкрэтнага IO. FX4 web GUI забяспечвае просты спосаб знайсці гэта: проста пстрыкніце правай кнопкай мышы ў полі і выберыце «Капіяваць HTTP». URL', каб скапіяваць радок у буфер абмену.
Цяпер вы можаце выкарыстоўваць Python для праверкі падключэння да праграмнага забеспячэння карыстальніка праз HTTP і JSON. Вам можа спатрэбіцца імпартаваць запыты і бібліятэкі json для апрацоўкі HTTP-запытаў і аналізу даных.
1 Просты Python HTTP Example
3.2 Выкарыстанне EPICS
Працэс падключэння FX4 праз EPICS (Experimental Physics and Industrial Control System) аналагічны. EPICS - гэта набор праграмных сродкаў і прыкладанняў, якія выкарыстоўваюцца для распрацоўкі і ўкаранення размеркаваных сістэм кіравання, якія шырока выкарыстоўваюцца ў навуковых установах.
- Атрымайце назву зменнай працэсу EPICS (PV) для жаданага ўводу-вываду.
- Імпартуйце бібліятэку EPICS і прачытайце значэнне.
2 Атрымайце імя EPICS PV
3 Simple Python EPICS Example
Акрамя таго, Pyramid стварыла ўтыліту (EPICS Connect⁴), што дазваляе кантраляваць зменныя працэсу EPICS у рэжыме рэальнага часу. Гэты інструмент дапамагае пацвердзіць, што назва EPICS PV правільная і ці правільна FX4 абслугоўвае PV у вашай сетцы.
4 PTC EPICS Connect
API праграмавання FX4
Канцэпцыі і метады, апісаныя ў гэтым кіраўніцтве, абапіраюцца на канцэпцыі, замацаваныя ў IGX – Кіраўніцтве праграміста. Калі ласка, глядзіце гэты дакумент для тлумачэнняў і прыкладampпадрабязнасці аб тым, як працуюць асноўныя праграмы і інтэрфейсы IGX. У гэтым кіраўніцтве будуць разгледжаны толькі ўвод-вывод і функцыянальнасць, характэрныя толькі для FX4.
4.1 Аналагавы ўваход IO
Гэтыя IO датычацца канфігурацыі і збору даных на аналагавых токавых уваходах FX4. Адзінкі ўводу каналаў заснаваны на канфігураванай карыстальнікам наладзе пад назвай «Sample Units”, дапушчальныя варыянты ўключаюць pA, nA, uA, mA і A.
Усе 4 каналы выкарыстоўваюць адзін і той жа інтэрфейс уводу-выводу і кіруюцца незалежна. Заменіце канал_x на канал_1, канал_2, канал_3 ці канал_4 адпаведна.
| Шлях IO | Апісанне |
| /fx4/adc/канал_x | READONLY NUMBER Вымераны ўваходны ток. |
| /fx4/adc/канал_x/скаляр | NUMBER Просты бязразмерны скаляр, прыменены да канала, 1 па змаўчанні. |
| /fx4/adc/channel_x/zero_offset | NUMBER Бягучае зрушэнне ў нА для канала. |
Наступныя IO не залежаць ад канала і прымяняюцца да ўсіх каналаў адначасова.
| Шлях IO | Апісанне |
| /fx4/сума_канала | READONLY NUMBER Сума бягучых уваходных каналаў. |
| /fx4/adc_unit | STRING Усталёўвае бягучыя карыстальніцкія адзінкі для кожнага канала і суму. Варыянты: «па», «на», «уа», «ма», «а» |
| /fx4/дыяпазон | STRING Усталёўвае бягучы дыяпазон уводу. Глядзіце GUI, каб даведацца, як кожны код дыяпазону адпавядае максімальным лімітам уводу току і BW. Параметры: «0», «1», «2», «3», «4», «5», «6», «7» |
| /fx4/adc/sampле_частата | ЛІК Частата ў Гц, што sample даныя будуць асераднёныя да. Гэта кантралюе суадносіны сігнал/шум і хуткасць перадачы дадзеных для ўсіх каналаў. |
| /fx4/adc/частата_пераўтварэння | ЛІК Частата ў Гц, на якой АЦП будзе пераўтвараць аналагавыя значэнні ў лічбавыя. Па змаўчанні гэта 100 кГц, і вам трэба будзе змяняць гэта значэнне вельмі рэдка. |
| /fx4/adc/offset_correction | READONLY NUMBER Сума ўсіх бягучых зрушэнняў канала. |
4.2 Аналагавы выхад IO
Гэтыя IO датычацца канфігурацыі аналагавых выхадаў агульнага прызначэння FX4, размешчаных пад аналагавымі ўваходамі на пярэдняй панэлі. Усе 4 каналы выкарыстоўваюць адзін і той жа інтэрфейс уводу-выводу і кіруюцца незалежна. Заменіце канал_x на канал_1, канал_2, канал_3 ці канал_4 адпаведна.
| Шлях IO | Апісанне |
| /fx4/dac /канал_x | NUMBER Command voltagе выхад. Гэта значэнне можна запісаць, толькі калі рэжым вываду ўсталяваны ўручную. |
| /fx4/dac/channel_x/readback | ЛІК ТОЛЬКІ ДЛЯ ЧЫТАННЯ Вымераны аб'ёмtagэлектронны выхад. Гэта найбольш карысна пры выкарыстанні рэжыму вываду выразаў. |
| /fx4/dac/channel_x/output_mode | STRING Усталёўвае рэжым вываду для канала. Параметры: «ручной», «выраз», «кантроль_працэсу» |
| /fx4/dac/канал _ x/slew_control_enable | BOOL Уключае або выключае абмежаванне хуткасці нарастання. |
| /fx4/dac/channel_ x/slew_rate | NUMBER Хуткасць нарастання ў В/с для канала. |
| /fx4/dac/channel_x/upper_limit | NUMBER Максімальна дазволеная каманда voltage для канала. Ужываецца для ўсіх рэжымаў працы. |
| /fx4/dac/канал _ x/ніжняя мяжа | NUMBER Мінімальна дазволеная каманда voltage для канала. Ужываецца для ўсіх рэжымаў працы. |
| /fx4/dac/channel _ x/ выхадны _ выраз | STRING Задае радок выразу, які выкарыстоўваецца каналам, калі ён знаходзіцца ў рэжыме вываду выразу. |
| /fx4/dac/канал _ x/кнопка_скіду | КНОПКА Скідае каманду voltage да 0. |
4.3 Лічбавыя ўваходы і выхады
Гэтыя IO датычацца кіравання рознымі лічбавымі ўваходамі і выхадамі агульнага прызначэння, якія знаходзяцца на FX4.
| Шлях IO | Апісанне |
| /fx4/fr1 | READONLY BOOL Прыёмнік оптавалакна 1. |
| /fx4/ft1 | Валаконны перадатчык BOOL 1. |
| /fx4/fr2 | READONLY BOOL Прыёмнік оптавалакна 2. |
| /fx4/ft2 | Валаконны перадатчык BOOL 2. |
| /fx4/fr3 | READONLY BOOL Прыёмнік оптавалакна 3. |
| /fx4/ft3 | Валаконны перадатчык BOOL 3. |
| /fx4/digital_expansion/d1 | BOOL D1 двунакіраванага лічбавага пашырэння IO. |
| /fx4/digital_expansion/d2 | BOOL D2 двунакіраванага лічбавага пашырэння IO. |
| /fx4/digital_expansion/d3 | BOOL D3 двунакіраванага лічбавага пашырэння IO. |
| /fx4/digital_expansion/d4 | BOOL D4 двунакіраванага лічбавага пашырэння IO. |
4.3.1 Канфігурацыя лічбавага ўводу-вываду
Усе лічбавыя прылады маюць даччыны ўвод-вывод для канфігурацыі іх паводзін, уключаючы рэжым працы, які кантралюе, як будзе працаваць гэты лічбавы. Кожны лічбавы будзе мець розны набор даступных опцый. Глядзіце графічны інтэрфейс, каб даведацца, якія параметры даступныя для таго ці іншага ўводу-выводу.
| Дзіцячы шлях уводу-выводу | Апісанне |
| …/рэжым | STRING Рэжым працы для лічбавага. Параметры: «уваход», «выхад», «шырока-імп.», «таймер», «кадавальнік», «захоп», «uart_rx», «uart_tx», «can_rx», «can_tx», «pru_input» або «pru_output» |
| …/process_signal | STRING Імя сігналу кіравання працэсам, калі яно ёсць. |
| …/pull_mode | STRING Рэжым пацягвання ўверх/уніз для лічбавага ўваходу. Варыянты: «уверх», «уніз» або «адключыць» |
4.4 Рэлейнае кіраванне
Абодва рэле кіруюцца незалежна і маюць аднолькавы тып інтэрфейсу. Заменіце relay_x на relay_a або relay_b адпаведна.
| Шлях IO | Апісанне |
| /fx4/relay _ x/permit / user _ каманда | BOOL Дае каманду на адкрыццё або замыканне рэле. Сапраўдная каманда будзе спрабаваць замкнуць рэле, калі зададзены блакіроўкі, а ілжывая каманда заўсёды адкрывае рэле. |
| /fx4/рэле _ x/стан | READONLY STRING Бягучы стан рэле. Заблакіраваныя рэле адкрыты, але не могуць быць замкнёныя з-за блакіроўкі. Станы: «адкрыта», «закрыта» або «заблакіравана» |
| /fx4/relay _ x/аўтаматычна _ закрыць | BOOL Калі ўсталявана значэнне true, рэле будзе аўтаматычна замыкацца, калі будуць прадастаўлены блакіроўкі. Па змаўчанні false. |
| /fx4/рэле _ x/ колькасць цыклаў _ | READONLY NUMBER Колькасць цыклаў рэле з моманту апошняга скіду. Карысна для адсочвання тэрміну службы рэле. |
4.5 Вышtagэлектронны модуль
Глядзіце IGX - Кіраўніцтва праграміста для атрымання падрабязнай інфармацыі аб FX4 high voltagэлектронны інтэрфейс. Бацькоўскі шлях кампанента /fx4/high_votlage.
4.6 Кантролер дозы
Падрабязную інфармацыю аб інтэрфейсе кантролера дозы FX4 глядзіце ў Кіраўніцтве праграміста IGX. Бацькоўскі шлях кампанента /fx4/dose_controller.
FX4 Python Exampлес
5.1 Рэгістратар даных з выкарыстаннем HTTP
Гэты былыample дэманструе, як захапіць шэраг паказанняў і захаваць іх у CSV file. Выбіраючы вялікую затрымку паміж паказаннямі, вы можаце выконваць доўгатэрміновую рэгістрацыю даных, нават калі FX4 sampстаўка лінга ўсталёўваецца вышэй. Гэта дазваляе вам бесперапынна збіраць і захоўваць вымярэнні на працягу працяглых перыядаў часу, не перагружаючы сістэму, гарантуючы, што даныя збіраюцца з інтэрваламі, прыдатнымі для вашага аналізу. Затрымка паміж паказаннямі дапамагае рэгуляваць хуткасць запісу даных, забяспечваючы эфектыўнае захоўванне і зніжаючы рызыку пропуску кропак даных, пры гэтым карыстаючыся перавагамі высакахуткасных сampling для вымярэнняў у рэальным часе.
5.2 Просты графічны інтэрфейс Python
Другі эксample выкарыстоўвае інструмент GUI Tkinter, створаны для Python, для стварэння адлюстравання вымераных токаў. Гэты інтэрфейс дазваляе візуалізаваць бягучыя паказанні ў зручным графічным фармаце. Памер дысплея можна змяніць, каб зрабіць яго дастаткова вялікім, каб можна было чытаць з іншага боку пакоя, што робіць яго ідэальным для сцэнарыяў, калі неабходны маніторынг у рэжыме рэальнага часу ў вялікіх прасторах. Tkinter забяспечвае просты спосаб стварэння інтэрактыўных інтэрфейсаў, і, інтэгруючы яго з FX4, вы можаце хутка стварыць візуальнае адлюстраванне вымераных токаў, якое можна наладзіць у адпаведнасці з вашымі канкрэтнымі патрэбамі.
5.3 Просты WebРазеткі Example
Гэты былыample дэманструе WebІнтэрфейс Sockets, які з'яўляецца пераважным метадам для чытання дадзеных з FX4, калі патрабуецца максімальная прапускная здольнасць. WebСокеты забяспечваюць поўнадуплексны канал сувязі ў рэжыме рэальнага часу, дазваляючы больш хуткую і эфектыўную перадачу даных у параўнанні з іншымі метадамі.
Былыample чытае шэраг samples, паведамляе сярэдні час за сample і максімальную затрымку, а таксама захоўвае даныя ў CSV file для наступнага аналізу. Гэтая ўстаноўка дазваляе ажыццяўляць эфектыўны маніторынг у рэжыме рэальнага часу і лёгка захоўваць даныя для наступнай апрацоўкі.
Канкрэтная прадукцыйнасць, якой можна дасягнуць WebРазеткі залежаць ад надзейнасці вашага інтэрфейсу Ethernet і адноснага прыярытэту вашага прыкладання. Для дасягнення аптымальных вынікаў пераканайцеся, што ваша сетка стабільная і што перадача дадзеных FX4 мае прыярытэт, калі гэта неабходна.
Версія: v3
FX4 Python Exampлес: 21
Дакументы / Рэсурсы
 |
Праграміст PYRAMID FX4 [pdfІнструкцыя па эксплуатацыі Праграміст FX4, FX4, праграміст |