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 және тағы басқаларamples. | Мэтью Николс | 6 жылғы 2025 наурыз 10:29 | БЕКІТІЛДІ |
| v2 | Сандық IO интерфейстері және IGX-ке сілтемелер қосылды. | Мэтью Николс | 3 жылғы 2024 мамыр 7:39 | БЕКІТІЛДІ |
| v1 | Бастапқы шығарылым, әлі де жұмыс жүріп жатыр. | Мэтью Николс | 21 ақпан 2024 жыл 11:25 | БЕКІТІЛДІ |
Құжатты бақылау Ре емесviewed
Ағымдағы құжат нұсқасы: v.1
Қайта жоқviewтағайындалды.
1.1 Қолдар
құжаттың ең соңғы нұсқасы үшін
Жұма, 7 наурыз, 2025 жыл, 10:33 UTC
Мэтью Николс қол қойды; мағынасы: Реview
Анықтамалар
| Құжат | Құжат идентификаторы | Автор | Нұсқа |
| IGX – Бағдарламалаушы нұсқаулығы | 2439249921 | Мэтью Николс | 1 |
FX4 бағдарламалау аяқталдыview
FX4 процессоры BlackBerry компаниясының QNX жоғары сенімді нақты уақыттағы операциялық жүйесінде жасалған IGX деп аталатын ортада жұмыс істейді (QNX Webсайт¹). IGX жеке басты компьютер бағдарламалық құралын жазғысы келетін пайдаланушылар үшін икемді және жан-жақты қолданбалы бағдарламалау интерфейсін (API) қамтамасыз етеді.
IGX ортасы бір өнім үшін әзірленген бағдарламалық шешімдерді басқаларға оңай тасымалдауға мүмкіндік беретін басқа Пирамида өнімдерімен ортақ пайдаланылады.
Бағдарламашылар Пирамидада бар IGX толық құжаттамасына жүгіне алады webсайтында: IGX | үшін заманауи модульдік басқару жүйесінің негізі Web-қосылған қолданбалар²
Бұл бөлім екі API әдісін сынауға кіріспе береді: JSON пішімін және EPICS пайдаланатын HTTP. Қарапайымдылық үшін Python (Python Webсайт³) бұрынғы ретінде пайдаланыладыample хост компьютер тілі, ол кәсіби емес бағдарламашылар үшін қол жетімді және пайдалану оңай.
3.1 Python және HTTP қолдану
Бұрынғы ретіндеample, Python көмегімен өлшенген токтардың қосындысын оқығыңыз келеді делік. Сізге керек URL нақты IO үшін. FX4 web GUI мұны табудың оңай жолын ұсынады: өрісті тінтуірдің оң жақ түймешігімен басып, «HTTP көшірмелерін» таңдаңыз URL' жолды алмасу буферіне көшіру үшін.
Енді сіз HTTP және JSON арқылы пайдаланушы бағдарламалық құралына қосылу мүмкіндігін тексеру үшін Python пайдалана аласыз. HTTP сұраулары мен деректерді талдауды өңдеу үшін сұраулар мен json кітапханаларын импорттау қажет болуы мүмкін.
1 Қарапайым Python HTTP мысалыample
3.2 EPICS қолдану
FX4 құрылғысын EPICS (эксперименттік физика және өнеркәсіптік басқару жүйесі) арқылы қосу процесі ұқсас. EPICS – ғылыми нысандарда кеңінен қолданылатын, таратылған басқару жүйелерін әзірлеу және енгізу үшін қолданылатын бағдарламалық құралдар мен қолданбалы бағдарламалар жиынтығы.
- Қажетті IO үшін EPICS процесс айнымалысының (PV) атын алыңыз.
- EPICS кітапханасын импорттаңыз және мәнді оқыңыз.
2 EPICS PV атауын алыңыз
3 Қарапайым Python EPICS Мысалыample
Сонымен қатар, Pyramid утилитасын жасады (EPICS Connect⁴) бұл EPICS процесінің айнымалы мәндерін нақты уақытта бақылауға мүмкіндік береді. Бұл құрал EPICS PV атауының дұрыс екенін және FX4 желіде PV-ға дұрыс қызмет көрсететінін растауға көмектеседі.
4 PTC EPICS қосылу
FX4 бағдарламалау API
Осы нұсқаулықта сипатталған ұғымдар мен әдістер IGX – Бағдарламалаушы нұсқаулығында орнатылған тұжырымдамаларға негізделген. Түсіндіру үшін осы құжатты қараңыз және мысалыampНегізгі IGX бағдарламалау және интерфейстері қалай жұмыс істейтіні туралы мәліметтер. Бұл нұсқаулық тек құрылғыға тән IO және FX4 үшін бірегей функцияларды қамтиды.
4.1 Аналогтық кіріс IO
Бұл IO FX4 аналогтық ток кірістеріндегі деректерді конфигурациялауға және жинауға қатысты. Арна кірістерінің бірліктері пайдаланушы конфигурациялайтын «Sample Units», жарамды опцияларға pA, nA, uA, mA және A кіреді.
Барлық 4 арна бірдей IO интерфейсін пайдаланады және тәуелсіз басқарылады. арна_x орнына тиісінше арна_1 , арна_2 , арна_3 немесе арна_4.
| IO жолы | Сипаттама |
| /fx4/adc/channel_x | ТЕК ОҚУ САН Өлшенетін ток кірісі. |
| /fx4/adc/channel_x/scalar | NUMBER Арнаға қолданылатын қарапайым бірліксіз скаляр, әдепкі бойынша 1. |
| /fx4/adc/channel_x/zero_offset | NUMBER Арна үшін nA бойынша ағымдағы ығысу. |
Келесі IO арнадан тәуелсіз емес және барлық арналарға бір уақытта қолданылады.
| IO жолы | Сипаттама |
| /fx4/channel_sum | READONLY NUMBER Ағымдағы кіріс арналарының қосындысы. |
| /fx4/adc_unit | STRING Әрбір арна мен сома үшін ағымдағы пайдаланушы бірліктерін орнатады. Параметрлер: “pa”, “na”, “ua”, “ma”, “a” |
| /fx4/аралығы | STRING Ағымдағы енгізу ауқымын орнатады. Әрбір диапазон кодының максималды ағымдағы кіріс шектеулеріне және BW мәніне қалай сәйкес келетінін GUI қараңыз. Параметрлер: "0", "1", "2", "3", "4", "5", "6", "7" |
| /fx4/adc/sampжиілік | NUMBER Гц-дегі жиілік, бұл sampдеректер орташа алынады. Бұл барлық арналар үшін сигнал-шу және деректер жылдамдығын басқарады. |
| /fx4/adc/conversion_frequency | NUMBER ADC аналогты сандық мәндерге түрлендіретін Гц жиілігі. Әдепкі бойынша, бұл 100 кГц және бұл мәнді сирек өзгерту қажет болады. |
| /fx4/adc/offset_correction | ТЕК ОҚУЛЫ САН Барлық арнаның ағымдағы ығысуларының қосындысы. |
4.2 Аналогтық шығыс IO
Бұл IO алдыңғы панельдегі аналогтық кірістердің астында табылған FX4 жалпы мақсаттағы аналогтық шығыстарының конфигурациясына қатысты. Барлық 4 арна бірдей IO интерфейсін пайдаланады және тәуелсіз басқарылады. арна_x орнына тиісінше арна_1 , арна_2 , арна_3 немесе арна_4.
| IO жолы | Сипаттама |
| /fx4/dac /channel_x | NUMBER пәрмен томtage шығыс. Бұл мән шығыс режимі қолмен орнатылғанда ғана жазылуы мүмкін. |
| /fx4/dac/channel_x/readback | ТЕК ОҚЫНУ САН Өлшенген томtage шығару. Бұл өрнек шығыс режимін пайдаланған кезде өте пайдалы. |
| /fx4/dac/channel_x/output_mode | STRING Арна үшін шығыс режимін орнатады. Параметрлер: «қолмен», «өрнек», «процесс_басқару» |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Айналу жылдамдығын шектеуді қосады немесе өшіреді. |
| /fx4/dac/channel_ x/slew_rate | NUMBER Арна үшін В/с бұрылу жылдамдығы. |
| /fx4/dac/channel_x/upper_limit | NUMBER Рұқсат етілген ең көп пәрмен көлеміtage арна үшін. Барлық жұмыс режимдеріне қолданылады. |
| /fx4/dac/channel _ x/төменгі_шек | NUMBER Рұқсат етілген ең аз пәрмен көлеміtage арна үшін. Барлық жұмыс режимдеріне қолданылады. |
| /fx4/dac/channel _ x/ шығыс _ өрнегі | STRING Өрнек шығыс режимінде болған кезде арна пайдаланатын өрнек жолын орнатады. |
| /fx4/dac/channel _ x/reset_button | ТҮЙМЕ Пәрменді қалпына келтіредіtage-ден 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 Сандық IO конфигурациясы
Барлық сандық құрылғыларда олардың мінез-құлқын конфигурациялау үшін еншілес IO бар, оның ішінде сол сандық қалай жұмыс істейтінін басқаратын жұмыс режимі бар. Әрбір цифрлық қол жетімді опциялардың әртүрлі жиынтығы болады. Қандай IO үшін қол жетімді опциялар туралы мәліметтерді GUI қараңыз.
| Бала IO жолы | Сипаттама |
| …/режим | STRING Сандық үшін жұмыс режимі. Параметрлер: "input", "output", "pwm", "таймер", "кодер", "capture", "uart_rx", "uart_tx", "can_rx", "can_tx", "pru_input" немесе "pru_output" |
| …/процесс_сигнал | STRING Егер бар болса, процесті басқару сигналының атауы. |
| …/тарту_режимі | STRING Сандық кіріс үшін жоғары/төмен тарту режимі. Параметрлер: «жоғары», «төмен» немесе «өшіру» |
4.4 Релелік басқару
Екі реле де тәуелсіз басқарылады және интерфейстің бір түрін бөліседі. relay_x орнына тиісінше relay_a немесе relay_b.
| IO жолы | Сипаттама |
| /fx4/relay _ x/permit / user _ командасы | BOOL Реле ашық немесе жабық пәрмен береді. Егер құлыптар берілген болса, шын пәрмен релені жабуға тырысады, ал жалған команда әрқашан релені ашады. |
| /fx4/rele _ x/state | READONLY STRING Реленің ағымдағы күйі. Құлыпталған релелер ашық, бірақ блоктауға байланысты жабылмайды. Күйлер: «ашылған», «жабық» немесе «құлыпталған» |
| /fx4/rele _ x/автоматты түрде _ жабу | BOOL «true» мәніне орнатылғанда, блоктаулар берілгенде реле автоматты түрде жабылады. Әдепкі бойынша жалған. |
| /fx4/реле _ x/ цикл _ санау | READONLY NUMBER Соңғы қалпына келтіруден бергі релелік циклдер саны. Реленің қызмет ету мерзімін бақылау үшін пайдалы. |
4.5 Жоғары дыбысtage модулі
FX4 жоғары көлемі туралы мәліметтерді IGX – Бағдарламалаушы нұсқаулығын қараңызtage интерфейсі. Құрамдас негізгі жолы - /fx4/high_votlage .
4.6 Доза контроллері
FX4 доза реттегішінің интерфейсі туралы мәліметтерді IGX – Бағдарламалаушы нұсқаулығынан қараңыз. Құрамдастың негізгі жолы - /fx4/dose_controller .
FX4 Python Examples
5.1 HTTP көмегімен деректерді тіркеуші
Бұл бұрынғыample бірнеше оқылымдарды қалай түсіру және оларды CSV файлына сақтау жолын көрсетеді file. Көрсеткіштер арасындағы ұзақ кідірісті таңдау арқылы сіз FX4 sampлинг жылдамдығы жоғарырақ орнатылған. Бұл жүйені шамадан тыс ұзақ уақыт бойы өлшеулерді үздіксіз жинауға және сақтауға мүмкіндік береді, бұл деректердің талдауыңызға қолайлы аралықтарда түсірілуін қамтамасыз етеді. Көрсеткіштер арасындағы кідіріс деректерді тіркеу қарқынын реттеуге көмектеседі, бұл тиімді сақтауға және деректер нүктелерінің жоғалу қаупін азайтуға мүмкіндік береді, сонымен бірге жоғары жылдамдықты пайдалану мүмкіндігін пайдаланады.ampнақты уақыттағы өлшеулер үшін ling.
5.2 Қарапайым Python графикалық интерфейсі
Екінші эксample өлшенген токтардың дисплейін жасау үшін Python үшін құрастырылған Tkinter GUI құралын пайдаланады. Бұл интерфейс пайдаланушыға ыңғайлы графикалық форматта ағымдағы оқуларды визуализациялауға мүмкіндік береді. Дисплейдің өлшемін бөлмеден оқуға жеткілікті етіп өзгертуге болады, бұл үлкен кеңістіктерде нақты уақыттағы бақылау қажет сценарийлер үшін өте қолайлы етеді. Tkinter интерактивті интерфейстерді жасаудың оңай жолын ұсынады және оны FX4-пен біріктіру арқылы нақты қажеттіліктеріңізге сай теңшеуге болатын өлшенген токтардың көрнекі дисплейін жылдам құруға болады.
5.3 Қарапайым WebРозеткалар Example
Бұл бұрынғыampле көрсетеді WebМаксималды өткізу қабілеттілігі қажет болғанда FX4 деректерін оқудың қолайлы әдісі болып табылатын розетка интерфейсі. WebРозеткалар нақты уақыттағы толық дуплексті байланыс арнасын қамтамасыз етеді, бұл басқа әдістермен салыстырғанда деректерді жылдамырақ және тиімдірек тасымалдауға мүмкіндік береді.
бұрынғыample сериясын оқидыamples, секундына орташа уақытты хабарлайдыample және максималды кідіріс және деректерді CSV файлына сақтайды file кейінірек талдау үшін. Бұл орнату тиімді нақты уақытта бақылауға және кейінгі өңдеу үшін деректерді оңай сақтауға мүмкіндік береді.
көмегімен қол жеткізуге болатын нақты өнімділік WebРозеткалар Ethernet интерфейсінің сенімділігіне және қолданбаның салыстырмалы басымдығына байланысты. Оңтайлы нәтижелерге қол жеткізу үшін желіңіздің тұрақты екеніне және қажет болса, FX4 деректерін жіберуге басымдық берілгеніне көз жеткізіңіз.
Нұсқа: v3
FX4 Python Examples: 21
Құжаттар / Ресурстар
 |
PYRAMID FX4 бағдарламалаушысы [pdf] Instruction Manual FX4 бағдарламашы, FX4, бағдарламашы |