www.pyramid.tech
FX4
FX4 programozói kézikönyv
Iratazonosító: 2711715845
Verzió: v3
FX4 programozó
Iratazonosító: 2711715845
FX4 – FX4 programozói kézikönyv
Dokumentumazonosító: 2711650310
| Szerző | Matthew Nichols |
| Tulajdonos | Projektvezető |
| Cél | Magyarázza el az API használatához szükséges programozási fogalmakat, és bővítse ki a terméket külső alkalmazásokon keresztül. |
| Hatály | FX4-hez kapcsolódó programozási koncepciók. |
| Célközönség | A termék használata iránt érdeklődő szoftverfejlesztők. |
| Folyamat | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Process |
| Edzés | NEM ALKALMAZHATÓ |
Verzióvezérlés
| Változat | Leírás | Mentette | Mentve | Állapot |
| v3 | Hozzáadott egy egyszerű overview és több plamples. | Matthew Nichols | 6. március 2025. 10:29 | JÓVÁHAGYOTT |
| v2 | Hozzáadott digitális IO interfészek és hivatkozások vissza az IGX-hez. | Matthew Nichols | 3. május 2024. 7:39 | JÓVÁHAGYOTT |
| v1 | Első kiadás, még folyamatban van. | Matthew Nichols | 21. február 2024. 11:25 | JÓVÁHAGYOTT |
Dokumentum ellenőrzés Nem Reviewed
A dokumentum jelenlegi verziója: v.1
Nincs reviewers hozzárendelt.
1.1 Aláírások
a dokumentum legújabb verziójához
7. március 2025., péntek, 10:33 UTC
Matthew Nichols aláírta ; jelentése: Review
Hivatkozások
| Dokumentum | Dokumentumazonosító | Szerző | Változat |
| IGX – Programozói kézikönyv | 2439249921 | Matthew Nichols | 1 |
FX4 programozás végeview
Az FX4 processzor az IGX nevű környezetben fut, amely a BlackBerry QNX nagy megbízhatóságú valós idejű operációs rendszerére épül (QNX Webtelek¹). Az IGX rugalmas és átfogó alkalmazásprogramozási felületet (API) biztosít azoknak a felhasználóknak, akik saját számítógépes szoftvert szeretnének írni.
Az IGX környezet megosztva van más Pyramid termékek között, így az egyik termékhez kifejlesztett szoftvermegoldások könnyen átvihetők másokra.
A programozók elolvashatják a Piramison elérhető IGX teljes dokumentációját webwebhely a következő címen: IGX | Modern moduláris vezérlőrendszer keretrendszer Web-engedélyezett alkalmazások²
Ez a szakasz bemutatja két API-módszer tesztelését: a HTTP JSON formátumot és az EPICS használatát. Az egyszerűség kedvéért Python (Piton Webtelek³) example host számítógépes nyelv, amely elérhető és könnyen használható a nem professzionális programozók számára.
3.1 Python és HTTP használata
Mint example, tegyük fel, hogy a mért áramok összegét szeretné leolvasni Python segítségével. Szükséged van a URL az adott IO számára. Az FX4 web A grafikus felhasználói felület egyszerű módot kínál ennek megtalálására: egyszerűen kattintson a jobb gombbal a mezőre, és válassza a „HTTP másolása” lehetőséget URLA karakterlánc vágólapra másolásához.
Mostantól a Python segítségével tesztelheti a felhasználói szoftverekhez való kapcsolódást HTTP-n és JSON-n keresztül. Előfordulhat, hogy importálnia kell a kéréseket és a JSON-könyvtárakat a HTTP-kérések és az adatelemzés kezeléséhez.
1 Egyszerű Python HTTP Example
3.2 Az EPICS használata
Az FX4 EPICS-en (kísérleti fizika és ipari vezérlőrendszer) keresztül történő csatlakoztatásának folyamata hasonló. Az EPICS elosztott vezérlőrendszerek fejlesztésére és megvalósítására használt szoftvereszközök és alkalmazások halmaza, amelyet széles körben használnak tudományos létesítményekben.
- Szerezze be az EPICS folyamatváltozó (PV) nevét a kívánt IO-hoz.
- Importálja az EPICS könyvtárat, és olvassa el az értéket.
2 Szerezze be az EPICS PV nevet
3 Egyszerű Python EPICS Example
Ezenkívül a Pyramid létrehozott egy segédprogramot (EPICS Connect⁴), amely lehetővé teszi az EPICS folyamatváltozók valós idejű figyelését. Ez az eszköz segít annak ellenőrzésében, hogy az EPICS PV neve helyes-e, és az FX4 megfelelően szolgálja-e ki a PV-t a hálózaton.
4 PTC EPICS Connect
FX4 programozási API
Az ebben a kézikönyvben leírt fogalmak és módszerek az IGX – Programozói Kézikönyvben meghatározott fogalmakra épülnek. Kérjük, olvassa el ezt a dokumentumot magyarázatért és plampaz alapvető IGX programozás és interfészek működését. Ez a kézikönyv csak az eszközspecifikus IO-ra és az FX4 egyedi funkcióira vonatkozik.
4.1 Analóg bemenet IO
Ezek az IO-k az FX4 analóg árambemeneteinek konfigurálására és adatgyűjtésére vonatkoznak. A csatorna bemenetek egységei a felhasználó által konfigurálható „Sample Units”, az érvényes opciók közé tartozik a pA, nA, uA, mA és A.
Mind a 4 csatorna ugyanazt az IO interfészt használja, és egymástól függetlenül vezérelhető. Cserélje le a_x csatornát a következőre: csatorna_1 , csatorna_2 , csatorna_3 vagy csatorna_4.
| IO elérési út | Leírás |
| /fx4/adc/channel_x | READONLY NUMBER Mért árambemenet. |
| /fx4/adc/channel_x/scalar | NUMBER Egyszerű mértékegység nélküli skalár alkalmazva a csatornára, alapértelmezés szerint 1. |
| /fx4/adc/channel_x/zero_offset | NUMBER Árameltolás nA-ban a csatorna számára. |
A következő IO-k nem csatornafüggetlenek, és az összes csatornára egyszerre vonatkoznak.
| IO elérési út | Leírás |
| /fx4/channel_sum | READONLY NUMBER Az aktuális bemeneti csatornák összege. |
| /fx4/adc_unit | STRING Beállítja az aktuális felhasználói egységeket minden csatornához és összeget. Opciók: „pa”, „na”, „ua”, „ma”, „a” |
| /fx4/tartomány | STRING Beállítja az aktuális beviteli tartományt. Tekintse meg a GUI-t, hogy az egyes tartománykódok hogyan felelnek meg a maximális árambemeneti határértékeknek és a BW-nek. Opciók: "0", "1", "2", "3", "4", "5", "6", "7" |
| /fx4/adc/sample_frekvencia | SZÁM Az a frekvencia Hz-ben, amely sample adatok átlagolása történik. Ez szabályozza a jel-zaj viszonyt és az adatsebességet minden csatorna esetében. |
| /fx4/adc/conversion_frequency | SZÁM Az a frekvencia Hz-ben, amelyen az ADC analógot digitálissá alakít át. Alapértelmezés szerint ez 100 kHz, és ezt az értéket csak ritkán kell módosítani. |
| /fx4/adc/offset_correction | READONLY NUMBER A csatorna összes aktuális eltolásának összege. |
4.2 Analóg kimenet IO
Ezek az IO-k az FX4 általános célú analóg kimeneteinek konfigurációjára vonatkoznak, amelyek az előlap analóg bemenetei alatt találhatók. Mind a 4 csatorna ugyanazt az IO interfészt használja, és egymástól függetlenül vezérelhető. Cserélje le a_x csatornát a következőre: csatorna_1 , csatorna_2 , csatorna_3 vagy csatorna_4 .
| IO elérési út | Leírás |
| /fx4/dac /channel_x | SZÁM Command voltage kimenet. Ez az érték csak akkor írható be, ha a kimeneti mód manuálisra van állítva. |
| /fx4/dac/channel_x/readback | CSAK OLVASÁSI SZÁM Mért voltage kimenet. Ez a kifejezéskimeneti mód használatakor a leghasznosabb. |
| /fx4/dac/channel_x/output_mode | STRING Beállítja a csatorna kimeneti módját. Opciók: „manual”, „expression”, „process_control” |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Engedélyezi vagy letiltja az elfordulási sebesség korlátozását. |
| /fx4/dac/channel_ x/slew_rate | SZÁM A csatorna elfordulási sebessége V/s-ban. |
| /fx4/dac/channel_x/upper_limit | SZÁM A maximálisan megengedett parancs voltage a csatornának. Minden üzemmódra vonatkozik. |
| /fx4/dac/channel _ x/alsó_korlát | SZÁM A minimálisan megengedett parancs voltage a csatornának. Minden üzemmódra vonatkozik. |
| /fx4/dac/channel _ x/ output _ kifejezés | STRING Beállítja a csatorna által használt kifejezési karakterláncot, amikor a kifejezés kimeneti módban van. |
| /fx4/dac/channel _ x/reset_button | GOMB Visszaállítja a parancs voltage-től 0-ig. |
4.3 Digitális bemenetek és kimenetek
Ezek az IO-k az FX4-en található különféle általános célú digitális bemenetek és kimenetek vezérlésére vonatkoznak.
| IO elérési út | Leírás |
| /fx4/fr1 | READONLY BOOL Fiber vevő 1. |
| /fx4/ft1 | BOOL Fiber jeladó 1. |
| /fx4/fr2 | READONLY BOOL Fiber vevő 2. |
| /fx4/ft2 | BOOL Fiber jeladó 2. |
| /fx4/fr3 | READONLY BOOL Fiber vevő 3. |
| /fx4/ft3 | BOOL Fiber jeladó 3. |
| /fx4/digital_expansion/d1 | BOOL D1 kétirányú digitális bővítő IO. |
| /fx4/digital_expansion/d2 | BOOL D2 kétirányú digitális bővítő IO. |
| /fx4/digital_expansion/d3 | BOOL D3 kétirányú digitális bővítő IO. |
| /fx4/digital_expansion/d4 | BOOL D4 kétirányú digitális bővítő IO. |
4.3.1 Digitális IO konfiguráció
Minden digitálisnak van gyermek IO a viselkedésének konfigurálásához, beleértve a működési módot, amely szabályozza a digitális működését. Mindegyik digitálisnak más-más elérhető opciókészlete lesz. Tekintse meg a grafikus felhasználói felületet az adott IO-hoz elérhető opciók részleteiért.
| Gyermek IO-útvonal | Leírás |
| …/mód | STRING Működési mód a digitálishoz. Opciók: „input”, „output”, „pwm”, „timer”, „encoder”, „capture”, „uart_rx”, „uart_tx”, „can_rx”, „can_tx”, „pru_input” vagy „pru_output” |
| …/process_signal | STRING A folyamatvezérlő jel neve, ha van. |
| …/pull_mode | STRING Húzás fel/le mód digitális bemenethez. Opciók: „fel”, „le” vagy „letilt” |
4.4 Relé vezérlés
Mindkét relé egymástól függetlenül vezérelhető, és ugyanazon az interfészen osztozik. Cserélje le a relay_x relay_a vagy relay_b relay-re.
| IO elérési út | Leírás |
| /fx4/relay _ x/permit / user _ parancs | BOOL Nyitást vagy zárást ad a relének. Az igaz parancs megpróbálja bezárni a relét, ha a reteszelést engedélyezik, a hamis parancs pedig mindig kinyitja a relét. |
| /fx4/relé _ x/állapot | READONLY STRING A relé aktuális állapota. A lezárt relék nyitva vannak, de reteszelés miatt nem zárhatók. Állapotok: „nyitva”, „zárva” vagy „zárva” |
| /fx4/relay _ x/automatically _ bezár | BOOL Ha igazra van állítva, a relé automatikusan zár, amikor a reteszelés engedélyezve van. Alapértelmezés szerint hamis. |
| /fx4/relé _ x/ ciklus _ száma | READONLY NUMBER Az utolsó visszaállítás óta eltelt reléciklusok száma. Hasznos a relé élettartamának követésére. |
4.5 High Voltage Modul
Az FX4 magas hangerővel kapcsolatos részletekért lásd az IGX – Programozói kézikönyvettage felület. Az összetevő szülőútvonala /fx4/high_votlage.
4.6 Dózisszabályozó
Az FX4 dózisszabályozó interfészével kapcsolatos részletekért lásd az IGX – Programozói kézikönyvet. Az összetevő szülőútvonala /fx4/dose_controller.
FX4 Python Examples
5.1 Adatnaplózó HTTP használatával
Ez az example bemutatja, hogyan rögzíthet számos mérést és menthet el CSV-fájlba file. A leolvasások közötti hosszú késleltetés kiválasztásával hosszú távú adatnaplózást végezhet akkor is, ha az FX4 sampling arány magasabbra van állítva. Ez lehetővé teszi a mérések folyamatos gyűjtését és tárolását hosszú időn keresztül anélkül, hogy túlterhelné a rendszert, biztosítva, hogy az adatok rögzítése az elemzésnek megfelelő időközönként történjen. A leolvasások közötti késleltetés segít szabályozni az adatok naplózásának ütemét, ami lehetővé teszi a hatékony tárolást és csökkenti az adatpontok hiányának kockázatát, miközben továbbra is élvezi a nagy sebességű adatátvitel előnyeit.ampling a valós idejű mérésekhez.
5.2 Egyszerű Python GUI
A második exampA le a Python számára készült Tkinter GUI eszközt használja a mért áramok megjelenítéséhez. Ez a felület lehetővé teszi, hogy felhasználóbarát grafikus formátumban jelenítse meg az aktuális értékeket. A kijelző átméretezhető, hogy elég nagy legyen ahhoz, hogy a helyiség másik részéből leolvasható legyen, így ideális olyan helyzetekben, ahol nagyobb helyeken van szükség valós idejű megfigyelésre. A Tkinter egyszerű módot kínál interaktív interfészek létrehozására, és az FX4-gyel integrálva gyorsan elkészítheti a mért áramok vizuális megjelenítését, amely testreszabható az Ön egyedi igényei szerint.
5.3 Egyszerű WebAljzatok plample
Ez az example mutatja a WebSockets interfész, amely az FX4 adatolvasásának előnyben részesített módja, amikor maximális sávszélességre van szükség. WebA socketek valós idejű, full-duplex kommunikációs csatornát biztosítanak, ami gyorsabb és hatékonyabb adatátvitelt tesz lehetővé más módszerekkel összehasonlítva.
Az example olvas egy sor samples, az átlagos másodpercenkénti időt jelentiample és a maximális késleltetést, és elmenti az adatokat CSV-fájlba file későbbi elemzéshez. Ez a beállítás hatékony valós idejű megfigyelést és egyszerű adattárolást tesz lehetővé az utófeldolgozáshoz.
A konkrét teljesítmény, amivel elérhető WebA foglalatok száma az Ethernet interfész megbízhatóságától és az alkalmazás relatív prioritásától függ. Az optimális eredmény érdekében győződjön meg arról, hogy hálózata stabil, és az FX4 adatátvitele szükség esetén prioritást élvez.
Verzió: v3
FX4 Python Exampszám: 21
Dokumentumok / Források
 |
PYRAMID FX4 programozó [pdf] Használati utasítás FX4 programozó, FX4, programozó |