www.pyramid.tech
एफएक्स4
FX4 प्रोग्रामर मैनुअल
दस्तावेज़ आईडी: 2711715845
संस्करण: v3

FX4 प्रोग्रामर

दस्तावेज़ आईडी: 2711715845
FX4 – FX4 प्रोग्रामर मैनुअल

दस्तावेज़ आईडी: 2711650310

लेखक	मैथ्यू निकोल्स
मालिक	प्रोजेक्ट लीड
उद्देश्य	एपीआई का उपयोग करने और बाहरी अनुप्रयोगों के माध्यम से उत्पाद का विस्तार करने के लिए आवश्यक प्रोग्रामिंग अवधारणाओं की व्याख्या करें।
दायरा	FX4 से संबंधित प्रोग्रामिंग अवधारणाएँ।
अपेक्षित दर्शक	सॉफ्टवेयर डेवलपर्स उत्पाद का उपयोग करने में रुचि रखते हैं।
प्रक्रिया	https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=मानक%20मैनुअल%20निर्माण%20प्रक्रिया
प्रशिक्षण	लागू नहीं

संस्करण नियंत्रण

संस्करण	विवरण	द्वारा सहेजा गया	सहेजा गया	स्थिति
v3	एक साधारण ओवर जोड़ा गयाview और अधिक पूर्वampलेस.	मैथ्यू निकोल्स	6 मार्च, 2025 10:29 PM	अनुमत
v2	डिजिटल IO इंटरफेस और IGX के संदर्भ जोड़े गए।	मैथ्यू निकोल्स	3 मई, 2024 7:39 अपराह्न	अनुमत
v1	प्रारंभिक रिलीज पर अभी भी काम चल रहा है।	मैथ्यू निकोल्स	21 फ़रवरी, 2024 11:25 अपराह्न	अनुमत

दस्तावेज़ नियंत्रण रे नहींviewed
वर्तमान दस्तावेज़ संस्करण: v.1
कोई पुनः नहींviewउन्हें नियुक्त किया गया है।

1.1 हस्ताक्षर
नवीनतम दस्तावेज़ संस्करण के लिए
शुक्रवार, मार्च 7, 2025, 10:33 PM UTC
मैथ्यू निकोल्स द्वारा हस्ताक्षरित; अर्थ: पुनःview

संदर्भ

दस्तावेज़	दस्तावेज़ आईडी	लेखक	संस्करण
IGX – प्रोग्रामर मैनुअल	2439249921	मैथ्यू निकोल्स	1

FX4 प्रोग्रामिंग खत्मview

FX4 प्रोसेसर IGX नामक वातावरण पर चलता है, जो ब्लैकबेरी के QNX उच्च-विश्वसनीयता वाले रियलटाइम ऑपरेटिंग सिस्टम पर बनाया गया है (क्यूएनएक्स Webसाइट¹). IGX उन उपयोगकर्ताओं के लिए एक लचीला और व्यापक एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस (API) प्रदान करता है जो अपना स्वयं का होस्ट कंप्यूटर सॉफ्टवेयर लिखना चाहते हैं।
IGX परिवेश को अन्य पिरामिड उत्पादों के साथ साझा किया जाता है, जिससे एक उत्पाद के लिए विकसित सॉफ्टवेयर समाधान को आसानी से अन्य उत्पादों में स्थानांतरित किया जा सकता है।
प्रोग्रामर पिरामिड पर उपलब्ध IGX के लिए संपूर्ण दस्तावेज़ देख सकते हैं webसाइट पर: IGX | आधुनिक मॉड्यूलर नियंत्रण प्रणाली फ्रेमवर्क Web-सक्षम अनुप्रयोग²

यह खंड दो API विधियों के परीक्षण का परिचय प्रदान करता है: JSON प्रारूप का उपयोग करके HTTP और EPICS। सरलता के लिए, पायथन (पायथन Webसाइट³) का प्रयोग पूर्व के रूप में किया जाता हैampयह एक होस्ट कंप्यूटर भाषा है, जो गैर-पेशेवर प्रोग्रामरों के लिए सुलभ और प्रयोग में आसान है।

3.1 पायथन और HTTP का उपयोग करना
एक पूर्व के रूप मेंampले, मान लीजिए कि आप पायथन के साथ मापी गई धाराओं का योग पढ़ना चाहते हैं। आपको इसकी आवश्यकता है URL उस विशेष IO के लिए। FX4 web GUI इसे खोजने का एक आसान तरीका प्रदान करता है: बस फ़ील्ड में राइट-क्लिक करें और 'HTTP कॉपी करें' चुनें URL' स्ट्रिंग को क्लिपबोर्ड पर कॉपी करने के लिए.

अब आप HTTP और JSON के माध्यम से उपयोगकर्ता सॉफ़्टवेयर से कनेक्टिविटी का परीक्षण करने के लिए पायथन का उपयोग कर सकते हैं। HTTP अनुरोधों और डेटा पार्सिंग को संभालने के लिए आपको अनुरोध और JSON लाइब्रेरीज़ को आयात करने की आवश्यकता हो सकती है।

1 सरल पायथन HTTP एक्सample

3.2 EPICS का उपयोग
FX4 को EPICS (प्रायोगिक भौतिकी और औद्योगिक नियंत्रण प्रणाली) के माध्यम से जोड़ने की प्रक्रिया समान है। EPICS सॉफ्टवेयर उपकरणों और अनुप्रयोगों का एक सेट है जिसका उपयोग वितरित नियंत्रण प्रणालियों को विकसित करने और लागू करने के लिए किया जाता है, जिसका व्यापक रूप से वैज्ञानिक सुविधाओं में उपयोग किया जाता है।

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

1. वांछित IO के लिए EPICS प्रक्रिया चर (PV) नाम प्राप्त करें।
2. EPICS लाइब्रेरी आयात करें और मान पढ़ें.

2 EPICS PV नाम प्राप्त करें3 सरल पायथन EPICS उदाहरणample

इसके अतिरिक्त, पिरामिड ने एक उपयोगिता बनाई (EPICS कनेक्ट⁴) जो आपको वास्तविक समय में EPICS प्रक्रिया चर की निगरानी करने की अनुमति देता है। यह उपकरण यह पुष्टि करने में सहायक है कि क्या EPICS PV नाम सही है और FX4 आपके नेटवर्क पर PV को सही तरीके से सेवा दे रहा है।

4 पीटीसी एपिक्स कनेक्ट

FX4 प्रोग्रामिंग एपीआई

इस मैनुअल में वर्णित अवधारणाएँ और विधियाँ IGX – प्रोग्रामर मैनुअल में स्थापित अवधारणाओं पर आधारित हैं। कृपया स्पष्टीकरण और अनुभव के लिए उस दस्तावेज़ को देखें।ampबुनियादी IGX प्रोग्रामिंग और इंटरफ़ेस कैसे काम करते हैं, इसके बारे में जानकारी। यह मैनुअल केवल डिवाइस-विशिष्ट IO और कार्यक्षमता को कवर करेगा जो FX4 के लिए अद्वितीय है।

4.1 एनालॉग इनपुट आईओ
ये IO FX4 के एनालॉग करंट इनपुट पर डेटा को कॉन्फ़िगर करने और एकत्र करने से संबंधित हैं। चैनल इनपुट की इकाइयाँ उपयोगकर्ता कॉन्फ़िगर करने योग्य सेटिंग पर आधारित होती हैं जिन्हें "S" कहा जाता हैampले इकाइयाँ", वैध विकल्पों में पीए, एनए, यूए, एमए और ए शामिल हैं।
सभी 4 चैनल एक ही इंटरफ़ेस IO का उपयोग करते हैं और स्वतंत्र रूप से नियंत्रित होते हैं। चैनल_x को क्रमशः चैनल_1, चैनल_2, चैनल_3 या चैनल_4 से बदलें।

आईओ पथ	विवरण
/fx4/adc/चैनल_x	READONLY संख्या मापा गया वर्तमान इनपुट.
/fx4/adc/channel_x/स्केलर	NUMBER चैनल पर लागू सरल इकाई रहित स्केलर, डिफ़ॉल्ट रूप से 1.
/fx4/adc/channel_x/zero_offset	NUMBER चैनल के लिए nA में वर्तमान ऑफसेट.

निम्नलिखित IO चैनल से स्वतंत्र नहीं हैं तथा सभी चैनलों पर एक साथ लागू होते हैं।

आईओ पथ	विवरण
/fx4/चैनल_सम	READONLY NUMBER वर्तमान इनपुट चैनलों का योग.
/fx4/adc_unit	STRING प्रत्येक चैनल और योग के लिए वर्तमान उपयोगकर्ता इकाइयाँ सेट करता है। विकल्प: "पा", "ना", "उआ", "मा", "ए"
/fx4/रेंज	STRING वर्तमान इनपुट रेंज सेट करता है। प्रत्येक रेंज कोड अधिकतम वर्तमान इनपुट सीमाओं और BW से कैसे मेल खाता है, इसके लिए GUI देखें। विकल्प: “0”, “1”, “2”, “3”, “4”, “5”, “6”, “7”
/fx4/adc/एसampले_फ्रीक्वेंसी	संख्या हर्ट्ज़ में आवृत्ति जोampडेटा का औसत निकाला जाएगा। यह सभी चैनलों के लिए सिग्नल-टू-शोर और डेटा दर को नियंत्रित करता है।
/fx4/adc/रूपांतरण_आवृत्ति	संख्या Hz में वह आवृत्ति जिस पर ADC एनालॉग को डिजिटल मानों में बदलेगा। डिफ़ॉल्ट रूप से, यह 100kHz है, और आपको इस मान को बदलने की ज़रूरत बहुत कम ही पड़ेगी।
/fx4/adc/ऑफ़सेट_सुधार	READONLY संख्या सभी चैनलों के वर्तमान ऑफसेट का योग.

4.2 एनालॉग आउटपुट आईओ
ये IO फ्रंट पैनल पर एनालॉग इनपुट के अंतर्गत पाए जाने वाले FX4 के सामान्य-उद्देश्य वाले एनालॉग आउटपुट के कॉन्फ़िगरेशन से संबंधित हैं। सभी 4 चैनल एक ही इंटरफ़ेस IO का उपयोग करते हैं और स्वतंत्र रूप से नियंत्रित होते हैं। चैनल_x को क्रमशः चैनल_1, चैनल_2, चैनल_3 या चैनल_4 से बदलें।

आईओ पथ	विवरण
/fx4/dac /चैनल_x	संख्या कमांड वॉल्यूमtagआउटपुट। यह मान केवल तभी लिखा जा सकता है जब आउटपुट मोड को मैन्युअल पर सेट किया गया हो।
/fx4/dac/channel_x/रीडबैक	READONLY संख्या मापी गई मात्राtagई आउटपुट। अभिव्यक्ति आउटपुट मोड का उपयोग करते समय यह सबसे अधिक उपयोगी होता है।
/fx4/dac/channel_x/output_mode	STRING चैनल के लिए आउटपुट मोड सेट करता है। विकल्प: “मैनुअल”, “एक्सप्रेशन”, “प्रोसेस_कंट्रोल”
/fx4/dac/चैनल _ x/slew_control_enable	BOOL स्लू दर सीमित करने को सक्षम या अक्षम करता है।
/fx4/dac/चैनल_ x/slew_rate	संख्या चैनल के लिए V/s में स्लीव दर।
/fx4/dac/channel_x/upper_limit	संख्या अधिकतम स्वीकृत कमांड वॉल्यूमtagचैनल के लिए e. सभी ऑपरेशन मोड पर लागू होता है।
/fx4/dac/चैनल _ x/लोअर_लिमिट	संख्या न्यूनतम स्वीकृत कमांड वॉल्यूमtagचैनल के लिए e. सभी ऑपरेशन मोड पर लागू होता है।
/fx4/dac/चैनल _ x/ आउटपुट _ अभिव्यक्ति	STRING चैनल द्वारा प्रयुक्त अभिव्यक्ति स्ट्रिंग को सेट करता है जब वह अभिव्यक्ति आउटपुट मोड में होता है।
/fx4/dac/चैनल _ x/रीसेट_बटन	बटन कमांड वॉल्यूम को रीसेट करता हैtagई से 0.

4.3 डिजिटल इनपुट और आउटपुट
ये IO FX4 पर पाए जाने वाले विभिन्न सामान्य प्रयोजन डिजिटल इनपुट और आउटपुट को नियंत्रित करने से संबंधित हैं।

आईओ पथ	विवरण
/fx4/fr1	READONLY BOOL फाइबर रिसीवर 1.
/एफएक्स4/एफटी1	BOOL फाइबर ट्रांसमीटर 1.
/fx4/fr2	READONLY BOOL फाइबर रिसीवर 2.
/एफएक्स4/एफटी2	BOOL फाइबर ट्रांसमीटर 2.
/fx4/fr3	READONLY BOOL फाइबर रिसीवर 3.
/एफएक्स4/एफटी3	BOOL फाइबर ट्रांसमीटर 3.
/fx4/डिजिटल_विस्तार/d1	BOOL D1 द्विदिश डिजिटल विस्तार IO.
/fx4/डिजिटल_विस्तार/d2	BOOL D2 द्विदिश डिजिटल विस्तार IO.
/fx4/डिजिटल_विस्तार/d3	BOOL D3 द्विदिश डिजिटल विस्तार IO.
/fx4/डिजिटल_विस्तार/d4	BOOL D4 द्विदिश डिजिटल विस्तार IO.

4.3.1 डिजिटल आईओ कॉन्फ़िगरेशन
सभी डिजिटल में उनके व्यवहार को कॉन्फ़िगर करने के लिए चाइल्ड IO होता है जिसमें एक ऑपरेटिंग मोड शामिल होता है जो नियंत्रित करता है कि वह डिजिटल कैसे काम करेगा। प्रत्येक डिजिटल में उपलब्ध विकल्पों का एक अलग सेट होगा। किस IO के लिए कौन से विकल्प उपलब्ध हैं, इस बारे में विवरण के लिए GUI देखें।

चाइल्ड IO पथ	विवरण
…/तरीका	डिजिटल के लिए STRING ऑपरेशन मोड. विकल्प: “इनपुट”, “आउटपुट”, “pwm”, “टाइमर”, “एनकोडर”, “कैप्चर”, “uart_rx”, “uart_tx”, “can_rx”, “can_tx”, “pru_input”, या “pru_output”
…/प्रक्रिया_संकेत	STRING प्रक्रिया नियंत्रण सिग्नल का नाम, यदि कोई हो।
…/पुल_मोड	STRING डिजिटल इनपुट के लिए ऊपर/नीचे मोड खींचें। विकल्प: “ऊपर”, “नीचे”, या “अक्षम करें”

4.4 रिले नियंत्रण
दोनों रिले स्वतंत्र रूप से नियंत्रित होते हैं और एक ही प्रकार का इंटरफ़ेस साझा करते हैं। Relay_x को क्रमशः Relay_a या Relay_b से बदलें।

आईओ पथ	विवरण
/fx4/relay _ x/permit / उपयोगकर्ता _ आदेश	BOOL रिले को खोलने या बंद करने का आदेश देता है। यदि इंटरलॉक दिए गए हैं तो एक सही कमांड रिले को बंद करने का प्रयास करेगा, और गलत कमांड हमेशा रिले को खोलेगा।
/fx4/रिले _ x/स्थिति	READONLY STRING रिले की वर्तमान स्थिति. लॉक रिले खुले होते हैं लेकिन इंटरलॉक के कारण बंद नहीं हो सकते। स्थितियाँ: “खुला”, “बंद”, या “लॉक किया गया”
/fx4/रिले _ x/स्वतः _ बंद	BOOL जब सत्य पर सेट किया जाता है, तो इंटरलॉक दिए जाने पर रिले स्वचालित रूप से बंद हो जाएगा। डिफ़ॉल्ट रूप से असत्य।
/fx4/रिले _ x/ चक्र _ गिनती	READONLY NUMBER अंतिम रीसेट के बाद से रिले चक्रों की संख्या। रिले जीवनकाल को ट्रैक करने के लिए उपयोगी।

4.5 हाई वॉल्यूमtagई मॉड्यूल
FX4 हाई वॉल्यूम पर विवरण के लिए IGX – प्रोग्रामर मैनुअल देखेंtagई इंटरफ़ेस. घटक मूल पथ /fx4/high_votlage है.

4.6 खुराक नियंत्रक
FX4 डोज़ कंट्रोलर इंटरफ़ेस के विवरण के लिए IGX – प्रोग्रामर मैनुअल देखें। घटक पैरेंट पथ /fx4/dose_controller है।

FX4 पायथन एक्सampलेस

5.1 HTTP का उपयोग करके डेटा लॉगर
यह भूतपूर्वampयह दर्शाता है कि अनेक रीडिंग को कैसे कैप्चर किया जाए और उन्हें CSV में कैसे सेव किया जाए fileरीडिंग के बीच एक लंबी देरी का चयन करके, आप लंबी अवधि के डेटा लॉगिंग कर सकते हैं भले ही FX4ampलिंग दर अधिक निर्धारित की जाती है। यह आपको सिस्टम को अधिक बोझिल किए बिना लंबे समय तक मापों को लगातार एकत्रित और संग्रहीत करने की अनुमति देता है, यह सुनिश्चित करता है कि डेटा आपके विश्लेषण के लिए उपयुक्त अंतराल पर कैप्चर किया जाता है। रीडिंग के बीच की देरी डेटा लॉग करने की गति को विनियमित करने में मदद करती है, जिससे कुशल भंडारण की अनुमति मिलती है और डेटा बिंदुओं के गुम होने के जोखिम को कम किया जाता है जबकि अभी भी उच्च गति से लाभ मिलता हैampवास्तविक समय माप के लिए ling.

5.2 सरल पायथन GUI
दूसरा पूर्वampमापी गई धाराओं का प्रदर्शन बनाने के लिए, ले Tkinter GUI टूल का उपयोग करता है, जो पायथन के लिए बनाया गया है। यह इंटरफ़ेस आपको उपयोगकर्ता के अनुकूल ग्राफ़िकल प्रारूप में वर्तमान रीडिंग को देखने की अनुमति देता है। डिस्प्ले को कमरे के पार से पढ़ने के लिए पर्याप्त बड़ा बनाने के लिए आकार बदला जा सकता है, जिससे यह उन परिदृश्यों के लिए आदर्श बन जाता है जहाँ बड़े स्थानों में वास्तविक समय की निगरानी की आवश्यकता होती है। Tkinter इंटरैक्टिव इंटरफ़ेस बनाने का एक आसान तरीका प्रदान करता है, और इसे FX4 के साथ एकीकृत करके, आप मापी गई धाराओं का एक दृश्य प्रदर्शन जल्दी से बना सकते हैं जिसे आपकी विशिष्ट आवश्यकताओं के अनुरूप अनुकूलित किया जा सकता है।

5.3 सरल Webसॉकेट्स एक्सample
यह भूतपूर्वample दर्शाता है Webसॉकेट्स इंटरफ़ेस, जो अधिकतम बैंडविड्थ की आवश्यकता होने पर FX4 से डेटा पढ़ने के लिए पसंदीदा विधि है। Webसॉकेट्स वास्तविक समय, पूर्ण-द्वैध संचार चैनल प्रदान करते हैं, जिससे अन्य विधियों की तुलना में अधिक तीव्र और कुशल डेटा स्थानांतरण संभव होता है।
भूतपूर्वampवह एक श्रृंखला पढ़ता हैampलेस, प्रति सेकंड औसत समय की रिपोर्ट करता हैampले और अधिकतम विलंबता, और डेटा को CSV में सहेजता है file बाद में विश्लेषण के लिए। यह सेटअप कुशल वास्तविक समय की निगरानी और पोस्ट-प्रोसेसिंग के लिए आसान डेटा भंडारण की अनुमति देता है।
विशिष्ट प्रदर्शन जो प्राप्त किया जा सकता है Webसॉकेट आपके ईथरनेट इंटरफ़ेस की विश्वसनीयता और आपके एप्लिकेशन की सापेक्ष प्राथमिकता पर निर्भर करता है। इष्टतम परिणामों के लिए, सुनिश्चित करें कि आपका नेटवर्क स्थिर है और यदि आवश्यक हो तो FX4 के डेटा ट्रांसमिशन को प्राथमिकता दी जाती है।

संस्करण: v3
FX4 पायथन एक्सampलेस: 21

दस्तावेज़ / संसाधन

पिरामिड FX4 प्रोग्रामर [पीडीएफ] निर्देश पुस्तिका एफएक्स4 प्रोग्रामर, एफएक्स4, प्रोग्रामर

संदर्भ

• उपयोगकर्ता पुस्तिका