www.pyramid.tech
اف اكس 4
دليل مبرمج FX4
معرف المستند: 2711715845
الإصدار: v3

مبرمج FX4

معرف المستند: 2711715845
FX4 – دليل مبرمج FX4

معرف المستند: 2711650310

مؤلف	ماثيو نيكولز
مالك	قائد المشروع
غاية	شرح مفاهيم البرمجة اللازمة لاستخدام واجهة برمجة التطبيقات (API) وتوسيع المنتج من خلال التطبيقات الخارجية.
نِطَاق	مفاهيم البرمجة المتعلقة بـ FX4.
الجمهور المستهدف	مطورو البرمجيات مهتمون باستخدام المنتج.
عملية	https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=عملية الإنشاء اليدوية القياسية
تمرين	غير قابل للتطبيق

التحكم في الإصدار

إصدار	وصف	محفوظ بواسطة	تم الحفظ في	حالة
v3	تمت إضافة بسيطةview والمزيد من السابقينampليز.	ماثيو نيكولز	6 مارس 2025 10:29 مساءً	موافقة
v2	تمت إضافة واجهات الإدخال والإخراج الرقمية والمراجع إلى IGX.	ماثيو نيكولز	3 مايو 2024 7:39 مساءً	موافقة
v1	الإصدار الأولي، لا يزال قيد التطوير.	ماثيو نيكولز	21 فبراير 2024 11:25 مساءً	موافقة

مراقبة وثيقة لا إعادةviewed
إصدار المستند الحالي: الإصدار 1
لا إعادةviewتم تعيينهم.

1.1 التوقيعات
لأحدث إصدار للوثيقة
الجمعة، 7 مارس 2025، الساعة 10:33 مساءً بتوقيت UTC
توقيع ماثيو نيكولز؛ المعنى: إعادةview

مراجع

وثيقة	معرف الوثيقة	مؤلف	إصدار
IGX – دليل المبرمج	2439249921	ماثيو نيكولز	1

انتهت برمجة FX4view

يعمل معالج FX4 على بيئة تسمى IGX، والتي تم بناؤها على نظام التشغيل QNX عالي الموثوقية في الوقت الفعلي من BlackBerry (كيو إن إكس Webموقع¹). توفر IGX واجهة برمجة تطبيقات (API) مرنة وشاملة للمستخدمين الذين يرغبون في كتابة برامج الكمبيوتر المضيفة الخاصة بهم.
تتم مشاركة بيئة IGX عبر منتجات Pyramid الأخرى، مما يسمح بنقل الحلول البرمجية التي تم تطويرها لمنتج واحد بسهولة إلى المنتجات الأخرى.
يمكن للمبرمجين الرجوع إلى الوثائق الكاملة لـ IGX المتوفرة على Pyramid webالموقع في: IGX | إطار عمل نظام التحكم المعياري الحديث لـ Webالتطبيقات الممكّنة²

يقدم هذا القسم مقدمة لاختبار طريقتين من طرق واجهة برمجة التطبيقات: HTTP باستخدام صيغة JSON وEPICS. للتبسيط، استخدم Python (بايثون Webموقع³) يستخدم كمثالampلغة البرمجة المضيفة، والتي يمكن الوصول إليها وسهلة الاستخدام للمبرمجين غير المحترفين.

3.1 استخدام بايثون وHTTP
كزوج سابقampلنفترض أنك تريد قراءة مجموع التيارات المقاسة باستخدام بايثون. ستحتاج إلى URL لهذا الإدخال/الإخراج المحدد. FX4 web توفر واجهة المستخدم الرسومية طريقة سهلة للعثور على هذا: ما عليك سوى النقر بزر الماوس الأيمن في الحقل وتحديد "نسخ HTTP" URL' لنسخ السلسلة إلى الحافظة.

يمكنك الآن استخدام بايثون لاختبار الاتصال ببرامج المستخدم عبر HTTP وJSON. قد تحتاج إلى استيراد الطلبات ومكتبات json للتعامل مع طلبات HTTP وتحليل البيانات.

1 مثال بسيط على Python HTTPample

3.2 استخدام EPICS
عملية توصيل جهاز FX4 بنظام EPICS (نظام التحكم الصناعي والفيزياء التجريبية) مشابهة. EPICS هو مجموعة من أدوات وتطبيقات البرمجيات تُستخدم لتطوير وتنفيذ أنظمة التحكم الموزعة، وتُستخدم على نطاق واسع في المنشآت العلمية.

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

1. احصل على اسم متغير عملية EPICS (PV) لـ IO المطلوب.
2. استورد مكتبة EPICS واقرأ القيمة.

2 احصل على اسم EPICS PV3 أمثلة بسيطة لـ Python EPICS Example

بالإضافة إلى ذلك، قامت شركة Pyramid بإنشاء أداة مساعدة (EPICS Connect⁴) يتيح لك مراقبة متغيرات عملية EPICS في الوقت الفعلي. تساعدك هذه الأداة على التأكد من صحة اسم EPICS PV، ومن أن جهاز FX4 يخدم PV بشكل صحيح على شبكتك.

4 PTC EPICS Connect

واجهة برمجة تطبيقات FX4

تعتمد المفاهيم والأساليب الموضحة في هذا الدليل على المفاهيم المحددة في IGX – دليل المبرمج. يرجى الاطلاع على تلك الوثيقة للحصول على شرح وعلى سبيل المثالampكيفية عمل برمجة وواجهات IGX الأساسية. سيغطي هذا الدليل فقط عملية الإدخال والإخراج الخاصة بالجهاز والوظائف الفريدة لجهاز FX4.

4.1 الإدخال التناظري IO
تتعلق عمليات الإدخال والإخراج هذه بتكوين وجمع البيانات على مدخلات التيار التناظري لجهاز FX4. تعتمد وحدات مدخلات القناة على إعداد المستخدم القابل للتكوين والذي يسمى "Sample Units"، وتشمل الخيارات الصالحة pA وnA وuA وmA وA.
تستخدم جميع القنوات الأربع نفس واجهة الإدخال والإخراج ويتم التحكم فيها بشكل مستقل. استبدلchannel_x بـchannel_4 أوchannel_1 أوchannel_2 أوchannel_3 على التوالي.

مسار الإدخال والإخراج	وصف
/fx4/adc/channel_x	رقم للقراءة فقط هو تيار الإدخال المقاس.
/fx4/adc/channel_x/scalar	رقم قياسي بسيط بدون وحدات يتم تطبيقه على القناة، 1 بشكل افتراضي.
/fx4/adc/channel_x/صفر_الإزاحة	الرقم هو الإزاحة الحالية بوحدة nA للقناة.

عمليات الإدخال/الإخراج التالية ليست قناة مستقلة ويتم تطبيقها على جميع القنوات في وقت واحد.

مسار الإدخال والإخراج	وصف
/fx4/channel_sum	رقم للقراءة فقط مجموع قنوات الإدخال الحالية.
/fx4/adc_unit	STRING يحدد وحدات المستخدم الحالية لكل قناة والمجموع. الخيارات: "pa"، "na"، "ua"، "ma"، "a"
/fx4/range	STRING يُحدد نطاق الإدخال الحالي. راجع واجهة المستخدم الرسومية لمعرفة كيفية توافق كل رمز نطاق مع حدود الإدخال الحالية القصوى وعرض النطاق الترددي. الخيارات: "0"، "1"، "2"، "3"، "4"، "5"، "6"، "7"
/fx4/adc/sample_frequency	الرقم هو التردد بالهرتز الذيampسيتم حساب متوسط ​​البيانات إلى. يتحكم هذا في معدل الإشارة إلى الضوضاء ومعدل البيانات لجميع القنوات.
/fx4/adc/تردد التحويل	الرقم هو التردد بالهرتز الذي يُحوّل عنده المُحوّل التناظري الرقمي القيم التناظرية إلى رقمية. افتراضيًا، يكون هذا التردد 100 كيلوهرتز، ونادرًا ما تحتاج إلى تغيير هذه القيمة.
/fx4/adc/offset_correction	رقم للقراءة فقط مجموع كل الإزاحات الحالية للقناة.

4.2 إخراج التناظرية IO
تتعلق عمليات الإدخال والإخراج هذه بتكوين المخرجات التناظرية للأغراض العامة لجهاز FX4 الموجودة أسفل المدخلات التناظرية على اللوحة الأمامية. تستخدم جميع القنوات الأربع نفس واجهة الإدخال والإخراج ويتم التحكم فيها بشكل مستقل. استبدلchannel_x بـchannel_4 أوchannel_1 أوchannel_2 أوchannel_3 على التوالي.

مسار الإدخال والإخراج	وصف
/fx4/dac /channel_x	رقم أمر مستوى الصوتtagه الإخراج. لا يمكن الكتابة إلى هذه القيمة إلا عند ضبط وضع الإخراج على الوضع اليدوي.
/fx4/dac/channel_x/readback	رقم للقراءة فقط الحجم المقاسtagالإخراج الإلكتروني. يُعد هذا مفيدًا للغاية عند استخدام وضع إخراج التعبير.
/fx4/dac/channel_x/output_mode	STRING يحدد وضع الإخراج للقناة. الخيارات: "يدوي"، "تعبير"، "التحكم في العملية"
/fx4/dac/channel _ x/slew_control_enable	BOOL تمكين أو تعطيل الحد من معدل الانحدار.
/fx4/dac/channel_x/slew_rate	الرقم معدل الانحراف بوحدة V/s للقناة.
/fx4/dac/channel_x/upper_limit	الرقم هو الحد الأقصى المسموح به لحجم الأوامرtagه للقناة. ينطبق على جميع أوضاع التشغيل.
/fx4/dac/channel _ x/lower_limit	الرقم هو الحد الأدنى المسموح به لحجم الأوامرtagه للقناة. ينطبق على جميع أوضاع التشغيل.
/fx4/dac/channel _ x/ output _ expression	STRING يحدد سلسلة التعبير التي تستخدمها القناة عندما تكون في وضع إخراج التعبير.
/fx4/dac/channel _ x/reset_button	زر إعادة تعيين مستوى صوت الأمرtagه إلى 0.

4.3 المدخلات والمخرجات الرقمية
ترتبط هذه المدخلات والمخرجات الرقمية العامة المختلفة الموجودة في FX4.

مسار الإدخال والإخراج	وصف
/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/التوسع الرقمي/d1	BOOL D1 التوسع الرقمي ثنائي الاتجاه IO.
/fx4/التوسع الرقمي/d2	BOOL D2 التوسع الرقمي ثنائي الاتجاه IO.
/fx4/التوسع الرقمي/d3	BOOL D3 التوسع الرقمي ثنائي الاتجاه IO.
/fx4/التوسع الرقمي/d4	BOOL D4 التوسع الرقمي ثنائي الاتجاه IO.

4.3.1 تكوين الإدخال/الإخراج الرقمي
جميع الوحدات الرقمية لديها مدخلات/مدخلات فرعية لضبط سلوكها، بما في ذلك وضع التشغيل الذي يتحكم في كيفية عمل الوحدة الرقمية. لكل وحدة رقمية مجموعة مختلفة من الخيارات المتاحة. راجع واجهة المستخدم الرسومية لمزيد من التفاصيل حول الخيارات المتاحة لكل مدخل/مدخل.

مسار الإدخال/الإخراج الفرعي	وصف
…/وضع	وضع التشغيل STRING للوسائط الرقمية. الخيارات: "إدخال"، "إخراج"، "PWM"، "مؤقت"، "مشفر"، "التقاط"، "UART_RX"، "UART_TX"، "CAN_RX"، "CAN_TX"، "PRU_INPORT"، أو "PRU_OUTPUT"
…/إشارة_العملية	سلسلة اسم إشارة التحكم في العملية، إذا كان هناك واحد.
…/وضع السحب	وضع السحب لأعلى/لأسفل لإدخال رقمي. الخيارات: "أعلى"، "أسفل"، أو "تعطيل"

4.4 التحكم في التتابع
يتم التحكم في كلا المرحلين بشكل مستقل ويتشاركان نفس نوع الواجهة. استبدل relay_x بـ relay_a أو relay_b على التوالي.

مسار الإدخال والإخراج	وصف
/fx4/relay _ x/permit / user _ command	أمر BOOL يُطلِق أو يُغلِق المُرحِّل. سيُحاول الأمر true إغلاق المُرحِّل إذا تمّت الموافقة على التداخلات، وسيُفتَح المُرحِّل دائمًا.
/fx4/relay _ x/state	READONLY STRING الحالة الحالية للمرحل. تكون المرحلات المقفلة مفتوحة ولكن لا يمكن إغلاقها بسبب وجود قفل. الدول: "مفتوحة" أو "مغلقة" أو "مقفلة"
/fx4/relay _ x/يغلق تلقائيًا	BOOL عند ضبطه على "صحيح"، سيُغلق المُرحِّل تلقائيًا عند منح التداخلات. افتراضيًا، يكون "خطأ".
/fx4/relay _ x/ عدد الدورات	رقم للقراءة فقط: عدد دورات التتابع منذ آخر إعادة ضبط. مفيد لتتبع عمر التتابع.

4.5 حجم كبيرtagالوحدة الإلكترونية
راجع دليل مبرمج IGX للحصول على تفاصيل حول مستوى الصوت العالي FX4tagواجهة ه. المسار الأصلي للمكون هو /fx4/high_votlage .

4.6 وحدة التحكم بالجرعة
راجع دليل مبرمج IGX لمزيد من التفاصيل حول واجهة وحدة تحكم الجرعة FX4. مسار المكون الرئيسي هو /fx4/dose_controller.

FX4 Python Exampليه

5.1 مسجل البيانات باستخدام HTTP
هذا السابقampيوضح كيفية التقاط عدد من القراءات وحفظها في ملف CSV fileمن خلال اختيار تأخير طويل بين القراءات، يمكنك إجراء تسجيل بيانات طويل الأمد حتى إذا كان جهاز FX4ampتم ضبط معدل التسجيل على مستوى أعلى. يتيح لك هذا جمع القياسات وتخزينها باستمرار لفترات طويلة دون إرهاق النظام، مما يضمن التقاط البيانات على فترات مناسبة لتحليلك. يساعد التأخير بين القراءات على تنظيم سرعة تسجيل البيانات، مما يسمح بتخزين فعال ويقلل من خطر فقدان نقاط البيانات مع الاستفادة من سرعة المعالجة العالية.ampling للقياسات في الوقت الحقيقي.

5.2 واجهة المستخدم الرسومية البسيطة لبايثون
الثاني السابقampيستخدم le أداة Tkinter GUI، المصممة للغة بايثون، لعرض التيارات المقاسة. تتيح لك هذه الواجهة عرض قراءات التيارات بصيغة رسومية سهلة الاستخدام. يمكن تغيير حجم الشاشة لتصبح كبيرة بما يكفي للقراءة من جميع أنحاء الغرفة، مما يجعلها مثالية للحالات التي تتطلب مراقبة آنية في المساحات الكبيرة. يوفر Tkinter طريقة سهلة لإنشاء واجهات تفاعلية، وبدمجه مع FX4، يمكنك إنشاء عرض مرئي سريع للتيارات المقاسة، والذي يمكن تخصيصه ليناسب احتياجاتك الخاصة.

5.3 بسيط Webمقابس Example
هذا السابقampيوضح ذلك Webواجهة المقابس، وهي الطريقة المفضلة لقراءة البيانات من FX4 عندما تكون هناك حاجة إلى الحد الأقصى للنطاق الترددي. Webتوفر المقابس قناة اتصال ثنائية الاتجاه في الوقت الفعلي، مما يسمح بنقل البيانات بشكل أسرع وأكثر كفاءة مقارنة بالطرق الأخرى.
السابقampيقرأ سلسلة منamples، يقدم متوسط ​​الوقت لكل ثانيةampالحد الأقصى والحد الأقصى للزمن، ويحفظ البيانات في ملف CSV file لتحليلها لاحقًا. يتيح هذا الإعداد مراقبة فعّالة في الوقت الفعلي وتخزينًا سهلًا للبيانات لمرحلة ما بعد المعالجة.
الأداء المحدد الذي يمكن تحقيقه باستخدام Webتعتمد جودة المنافذ على موثوقية واجهة إيثرنت لديك والأولوية النسبية لتطبيقك. للحصول على أفضل النتائج، تأكد من استقرار شبكتك وإعطاء الأولوية لنقل بيانات جهاز FX4 عند الحاجة.

الإصدار: v3
FX4 Python Exampليه: 21

المستندات / الموارد

مبرمج PYRAMID FX4 [بي دي اف] دليل التعليمات مبرمج FX4، مبرمج FX4

مراجع

• دليل المستخدم