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=Standard%20Manual%20Creation%20Process
تربیت	قابل اطلاق نہیں

ورژن کنٹرول

ورژن	تفصیل	کی طرف سے محفوظ	پر محفوظ کیا گیا۔	حیثیت
v3	ایک سادہ اوور شامل کیا گیا۔view اور مزید سابقamples	میتھیو نکولس	6 مارچ 2025 10:29 PM	منظور شدہ
v2	ڈیجیٹل IO انٹرفیس اور حوالہ جات کو IGX میں واپس شامل کیا گیا۔	میتھیو نکولس	3 مئی 2024 شام 7:39 بجے	منظور شدہ
v1	ابتدائی ریلیز، ابھی بھی کام جاری ہے۔	میتھیو نکولس	21 فروری 2024 11:25 PM	منظور شدہ

دستاویز کنٹرول نہیں Reviewed
دستاویز کا موجودہ ورژن: v.1
دوبارہ نہیںviewers تفویض.

1.1 دستخط
دستاویز کے تازہ ترین ورژن کے لیے
جمعہ، 7 مارچ، 2025، 10:33 PM UTC
میتھیو نکولس نے دستخط کیے۔ معنی: دوبارہview

حوالہ جات

دستاویز	دستاویز کی شناخت	مصنف	ورژن
IGX - پروگرامر دستی	2439249921	میتھیو نکولس	1

FX4 پروگرامنگ ختمview

FX4 پروسیسر IGX نامی ماحول پر چلتا ہے، جو بلیک بیری کے QNX ہائی-ریلیبلٹی ریئل ٹائم آپریٹنگ سسٹم پر بنایا گیا ہے۔کیو این ایکس Webسائٹ¹)۔ IGX ان صارفین کے لیے ایک لچکدار اور جامع ایپلیکیشن پروگرامنگ انٹرفیس (API) فراہم کرتا ہے جو اپنا میزبان کمپیوٹر سافٹ ویئر لکھنا چاہتے ہیں۔
IGX ماحول دیگر Pyramid مصنوعات میں مشترکہ ہے، جس سے ایک پروڈکٹ کے لیے تیار کردہ سافٹ ویئر حل آسانی سے دوسروں کو منتقل کیے جا سکتے ہیں۔
پروگرامرز اہرام پر دستیاب IGX کے لیے مکمل دستاویزات کا حوالہ دے سکتے ہیں۔ webسائٹ پر: IGX | کے لیے جدید ماڈیولر کنٹرول سسٹم کا فریم ورک Web- فعال ایپلی کیشنز²

یہ سیکشن API کے دو طریقوں کی جانچ کرنے کا ایک تعارف فراہم کرتا ہے: JSON فارمیٹ اور EPICS کا استعمال کرتے ہوئے HTTP۔ سادگی کے لیے، ازگر (ازگر Webسائٹ³) بطور سابق استعمال ہوتا ہے۔ampلی ہوسٹ کمپیوٹر لینگویج، جو غیر پیشہ ور پروگرامرز کے لیے قابل رسائی اور استعمال میں آسان ہے۔

3.1 ازگر اور HTTP کا استعمال
بطور سابقample، فرض کریں کہ آپ ازگر کے ساتھ ناپے ہوئے کرنٹوں کا مجموعہ پڑھنا چاہتے ہیں۔ آپ کو ضرورت ہے URL اس مخصوص IO کے لیے۔ ایف ایکس 4 web GUI اسے تلاش کرنے کا ایک آسان طریقہ فراہم کرتا ہے: فیلڈ میں صرف دائیں کلک کریں اور 'کاپی HTTP کو منتخب کریں۔ URL' سٹرنگ کو کلپ بورڈ میں کاپی کرنے کے لیے۔

اب آپ HTTP اور JSON کے ذریعے صارف کے سافٹ ویئر سے کنیکٹیویٹی کو جانچنے کے لیے Python کا استعمال کر سکتے ہیں۔ آپ کو HTTP درخواستوں اور ڈیٹا کو پارس کرنے کے لیے درخواستیں اور json لائبریریوں کو درآمد کرنے کی ضرورت پڑ سکتی ہے۔

1 سادہ ازگر HTTP Example

3.2 EPICS استعمال کرنا
EPICS (تجرباتی طبیعیات اور صنعتی کنٹرول سسٹم) کے ذریعے FX4 کو جوڑنے کا عمل یکساں ہے۔ 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 سادہ Python EPICS Example

مزید برآں، اہرام نے ایک افادیت بنائی (EPICS کنیکٹ⁴) جو آپ کو ریئل ٹائم میں EPICS پروسیس متغیرات کی نگرانی کرنے کی اجازت دیتا ہے۔ یہ ٹول اس بات کی تصدیق کرنے میں مددگار ہے کہ آیا EPICS PV کا نام درست ہے اور FX4 آپ کے نیٹ ورک پر PV کو صحیح طریقے سے پیش کر رہا ہے۔

4 PTC EPICS کنیکٹ

FX4 پروگرامنگ API

اس دستی میں بیان کردہ تصورات اور طریقے IGX – پروگرامر مینول میں قائم کردہ تصورات پر استوار ہیں۔ براہ کرم وضاحت اور سابق کے لیے وہ دستاویز دیکھیںampبنیادی IGX پروگرامنگ اور انٹرفیس کیسے کام کرتے ہیں۔ یہ ہدایت نامہ صرف ڈیوائس کے مخصوص IO اور فعالیت کا احاطہ کرے گا جو FX4 کے لیے منفرد ہے۔

4.1 اینالاگ ان پٹ IO
یہ IO FX4 کے اینالاگ موجودہ ان پٹ پر ڈیٹا کو ترتیب دینے اور جمع کرنے سے متعلق ہیں۔ چینل کے ان پٹس کی اکائیاں صارف کی قابل ترتیب ترتیب پر مبنی ہیں جسے "Sample یونٹس"، درست اختیارات میں پی اے، این اے، یو اے، ایم اے، اور اے شامل ہیں۔
تمام 4 چینلز ایک ہی انٹرفیس IO استعمال کرتے ہیں اور آزادانہ طور پر کنٹرول کیے جاتے ہیں۔ channel_x کو بالترتیب channel_1، channel_2، channel_3، یا channel_4 سے بدل دیں۔

IO پاتھ	تفصیل
/fx4/adc/channel_x	READONLY NUMBER ماپا کرنٹ ان پٹ۔
/fx4/adc/channel_x/scalar	NUMBER سادہ یونٹ لیس اسکیلر چینل پر لاگو کیا گیا، 1 بذریعہ ڈیفالٹ۔
/fx4/adc/channel_x/zero_offset	چینل کے لیے nA میں NUMBER کرنٹ آفسیٹ۔

مندرجہ ذیل IO چینل آزاد نہیں ہیں اور بیک وقت تمام چینلز پر لاگو ہوتے ہیں۔

IO پاتھ	تفصیل
/fx4/channel_sum	READONLY NUMBER موجودہ ان پٹ چینلز کا مجموعہ۔
/fx4/adc_unit	STRING ہر چینل اور رقم کے لیے موجودہ صارف یونٹس کو سیٹ کرتا ہے۔ اختیارات: "pa"، "na"، "ua"، "ma"، "a"
/fx4/range	STRING موجودہ ان پٹ رینج سیٹ کرتا ہے۔ GUI دیکھیں کہ کس طرح ہر رینج کوڈ زیادہ سے زیادہ موجودہ ان پٹ کی حدوں اور BW سے مطابقت رکھتا ہے۔ اختیارات: "0"، "1"، "2"، "3"، "4"، "5"، "6"، "7"
/fx4/adc/sample_frequency	NUMBER ہرٹز میں فریکوئنسی جو sampلی ڈیٹا کا اوسط لیا جائے گا۔ یہ تمام چینلز کے لیے سگنل ٹو شور اور ڈیٹا کی شرح کو کنٹرول کرتا ہے۔
/fx4/adc/conversion_frequency	NUMBER ہرٹز میں وہ فریکوئنسی جس پر ADC اینالاگ کو ڈیجیٹل اقدار میں تبدیل کرے گا۔ پہلے سے طے شدہ طور پر، یہ 100kHz ہے، اور آپ کو شاذ و نادر ہی اس قدر کو تبدیل کرنے کی ضرورت ہوگی۔
/fx4/adc/offset_correction	تمام چینل کے موجودہ آفسیٹس کا READONLY NUMBER مجموعہ۔

4.2 اینالاگ آؤٹ پٹ IO
یہ IO سامنے والے پینل پر ینالاگ ان پٹ کے نیچے پائے جانے والے FX4 کے عمومی مقصد کے اینالاگ آؤٹ پٹس کی ترتیب سے متعلق ہیں۔ تمام 4 چینلز ایک ہی انٹرفیس IO استعمال کرتے ہیں اور آزادانہ طور پر کنٹرول کیے جاتے ہیں۔ channel_x کو بالترتیب channel_1، channel_2، channel_3، یا channel_4 سے بدل دیں۔

IO پاتھ	تفصیل
/fx4/dac /channel_x	NUMBER کمانڈ والیومtagای آؤٹ پٹ. یہ قدر صرف اس وقت لکھی جا سکتی ہے جب آؤٹ پٹ موڈ مینوئل پر سیٹ ہو۔
/fx4/dac/channel_x/readback	READONLY NUMBER ماپی ہوئی جلدtagای آؤٹ پٹ ایکسپریشن آؤٹ پٹ موڈ کا استعمال کرتے وقت یہ سب سے زیادہ مددگار ہے۔
/fx4/dac/channel_x/output_mode	STRING چینل کے لیے آؤٹ پٹ موڈ سیٹ کرتا ہے۔ اختیارات: "دستی"، "اظہار"، "process_control"
/fx4/dac/channel _ x/slew_control_enable	BOOL متعدد شرح کو محدود کرنے کو فعال یا غیر فعال کرتا ہے۔
/fx4/dac/channel_ x/slew_rate	چینل کے لیے V/s میں NUMBER سلیو ریٹ۔
/fx4/dac/channel_x/upper_limit	NUMBER زیادہ سے زیادہ اجازت شدہ کمانڈ والیومtage چینل کے لیے۔ آپریشن کے تمام طریقوں پر لاگو ہوتا ہے۔
/fx4/dac/channel _ x/lower_limit	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 آپریشن موڈ۔ اختیارات: "ان پٹ"، "آؤٹ پٹ"، "پی ڈبلیو ایم"، "ٹائمر"، "انکوڈر"، "کیپچر"، "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/relay _ x/state	READONLY STRING ریلے کی موجودہ حالت۔ مقفل ریلے کھلے ہیں لیکن انٹر لاک کی وجہ سے بند نہیں ہوسکتے۔ ریاستیں: "کھلی"، "بند"، یا "مقفل"
/fx4/relay _ x/خودکار طور پر _ بند	BOOL درست پر سیٹ ہونے پر، جب انٹرلاکس دیے جائیں گے تو ریلے خود بخود بند ہو جائے گا۔ ڈیفالٹ کے لحاظ سے غلط۔
/fx4/relay _ x/ سائیکل _ شمار	READONLY NUMBER آخری ری سیٹ کے بعد سے ریلے سائیکلوں کی تعداد۔ ریلے کی زندگی بھر سے باخبر رہنے کے لیے مفید ہے۔

4.5 ہائی والیمtagای ماڈیول
FX4 ہائی والیم پر تفصیلات کے لیے IGX – پروگرامر دستی دیکھیںtagای انٹرفیس. جزو کا بنیادی راستہ ہے /fx4/high_votlage ۔

4.6 خوراک کنٹرولر
FX4 خوراک کنٹرولر انٹرفیس پر تفصیلات کے لیے IGX – پروگرامر دستی دیکھیں۔ جزو کا بنیادی راستہ ہے /fx4/dose_controller ۔

FX4 Python Examples

HTTP کا استعمال کرتے ہوئے 5.1 ڈیٹا لاگر
یہ سابقample یہ ظاہر کرتا ہے کہ متعدد ریڈنگز کو کیسے حاصل کیا جائے اور انہیں CSV میں محفوظ کیا جائے۔ file. پڑھنے کے درمیان طویل تاخیر کا انتخاب کرکے، آپ طویل مدتی ڈیٹا لاگنگ انجام دے سکتے ہیں چاہے FX4 sampلنگ کی شرح زیادہ مقرر کی گئی ہے۔ یہ آپ کو نظام کو مغلوب کیے بغیر طویل مدت تک پیمائش کو مسلسل جمع اور ذخیرہ کرنے کی اجازت دیتا ہے، اس بات کو یقینی بناتے ہوئے کہ آپ کے تجزیہ کے لیے موزوں وقفوں پر ڈیٹا کیپچر کیا جائے۔ پڑھنے کے درمیان تاخیر اس رفتار کو منظم کرنے میں مدد کرتی ہے جس پر ڈیٹا لاگ کیا جاتا ہے، موثر اسٹوریج کی اجازت دیتا ہے اور ڈیٹا پوائنٹس کے غائب ہونے کے خطرے کو کم کرنے کے ساتھ ساتھ تیز رفتار s سے فائدہ اٹھاتا ہے۔ampحقیقی وقت کی پیمائش کے لیے ling.

5.2 سادہ ازگر GUI
دوسرا سابق۔ampلی ٹیکنٹر جی یو آئی ٹول کا استعمال کرتا ہے، جو ازگر کے لیے بنایا گیا ہے، تاکہ ماپا کرنٹ کا ڈسپلے بنایا جا سکے۔ یہ انٹرفیس آپ کو موجودہ ریڈنگز کو صارف دوست گرافیکل فارمیٹ میں دیکھنے کی اجازت دیتا ہے۔ ڈسپلے کا سائز تبدیل کیا جا سکتا ہے تاکہ اسے پورے کمرے سے پڑھنے کے لیے کافی بڑا بنایا جا سکے، یہ ان منظرناموں کے لیے مثالی ہے جہاں بڑی جگہوں پر حقیقی وقت کی نگرانی کی ضرورت ہوتی ہے۔ Tkinter انٹرایکٹو انٹرفیس بنانے کا ایک آسان طریقہ فراہم کرتا ہے، اور اسے FX4 کے ساتھ ضم کر کے، آپ تیزی سے ناپے ہوئے کرنٹ کا ایک بصری ڈسپلے بنا سکتے ہیں جسے آپ کی مخصوص ضروریات کے مطابق بنایا جا سکتا ہے۔

5.3 سادہ Webساکٹ سابقample
یہ سابقampلی کا مظاہرہ کرتا ہے۔ Webساکٹ انٹرفیس، جو کہ FX4 سے ڈیٹا پڑھنے کا ترجیحی طریقہ ہے جب زیادہ سے زیادہ بینڈوتھ کی ضرورت ہو۔ Webساکٹ ایک حقیقی وقت، مکمل ڈوپلیکس مواصلاتی چینل فراہم کرتے ہیں، جو دوسرے طریقوں کے مقابلے میں تیز اور زیادہ موثر ڈیٹا کی منتقلی کی اجازت دیتا ہے۔
سابقample s کی ایک سیریز پڑھتا ہے۔amples، فی سیکنڈ اوسط وقت کی اطلاع دیتا ہے۔ample اور زیادہ سے زیادہ تاخیر، اور ڈیٹا کو CSV میں محفوظ کرتا ہے۔ file بعد میں تجزیہ کے لیے یہ سیٹ اپ موثر ریئل ٹائم مانیٹرنگ اور پوسٹ پروسیسنگ کے لیے آسان ڈیٹا اسٹوریج کی اجازت دیتا ہے۔
مخصوص کارکردگی جس کے ساتھ حاصل کیا جا سکتا ہے۔ Webساکٹ آپ کے ایتھرنیٹ انٹرفیس کی وشوسنییتا اور آپ کی درخواست کی نسبتہ ترجیح پر منحصر ہے۔ بہترین نتائج کے لیے، یقینی بنائیں کہ آپ کا نیٹ ورک مستحکم ہے اور اگر ضروری ہو تو FX4 کی ڈیٹا ٹرانسمیشن کو ترجیح دی جاتی ہے۔

ورژن: v3
FX4 Python Examples: 21

دستاویزات / وسائل

PYRAMID FX4 پروگرامر [پی ڈی ایف] ہدایات دستی FX4 پروگرامر، FX4، پروگرامر

حوالہ جات

• صارف دستی