نود.جي اس
دليل المستخدم
تطبيق جهاز التوجيه Node.js
تطبيق جهاز التوجيه Node.js
© 2023 Advantech Czech sro لا يجوز إعادة إنتاج أي جزء من هذا المنشور أو نقله بأي شكل أو بأي وسيلة، إلكترونية أو ميكانيكية، بما في ذلك التصوير الفوتوغرافي أو التسجيل أو أي نظام لتخزين المعلومات واسترجاعها دون موافقة كتابية.
المعلومات الواردة في هذا الدليل عرضة للتغيير دون إشعار مسبق، ولا تمثل التزامًا من جانب شركة Advantech.
لا تتحمل شركة Advantech Czech sro مسؤولية الأضرار العرضية أو التبعية الناتجة عن تقديم أو أداء أو استخدام هذا الدليل.
جميع أسماء العلامات التجارية المستخدمة في هذا الدليل هي علامات تجارية مسجلة لأصحابها. إن استخدام العلامات التجارية أو التسميات الأخرى في هذا المنشور هو لأغراض مرجعية فقط ولا يشكل موافقة من صاحب العلامة التجارية.
الرموز المستعملة
 |
خطر - معلومات تتعلق بسلامة المستخدم أو الضرر المحتمل لجهاز التوجيه. |
 |
الاهتمام - المشاكل التي يمكن أن تنشأ في مواقف محددة. |
 |
معلومات - نصائح مفيدة أو معلومات ذات أهمية خاصة. |
 |
Exampلو - على سبيل المثالampلو الوظيفة أو الأمر أو البرنامج النصي. |
سجل التغييرات
1.1 سجل تغييرات Node.js
الإصدار 1.0.0 (2017-10-02)
- الإصدار الأول.
الإصدار 1.1.0 (2017-11-08) - تم التحديث إلى Node.js 8.9.1.
الإصدار 1.2.0 (2018-02-18) - تمت إضافة دعم لتسجيل الدخول إلى file مع الدورية.
الإصدار 1.2.1 (2018-08-10) - تم التحديث إلى Node.js 8.11.1.
الإصدار 2.0.0 (2020-02-21) - تم التحديث إلى Node.js 10.15.3 وffi 2.3.0.
- عقد التثبيت الأمثل fileس لتقليل الحجم.
- مستعد لدول مجلس التعاون الخليجي 7.4 الجديد.
- جاهز للنواة الجديدة 4.14.
- مُجهز لمنصة V4.
- تمت إضافة العقدة المخصصة "جهاز التوجيه".
- قم بتعيين المسار الافتراضي للبحث عن العقد إلى /usr/lib/node_modules.
الإصدار 2.1.0 (2021-05-06) - تم التحديث إلى Node.js 10.23.1.
- تم نقل معلومات الترخيص من وحدة Node-RED.
الإصدار 16.14.2 (2022-03-18) - تم التحديث إلى Node.js 16.14.2 مع npm 8.5.0.
الإصدار 16.15.0 (2022-05-10) - تمت إضافة كائن للعمل مع تكوين جهاز التوجيه إلى عقدة جهاز التوجيه.
- تم التحديث إلى Node.js 16.15.0 مع npm 8.5.5.
- تسجيل الدخول الثابت على FW 6.3.5.
الإصدار 16.17.0 (2022-08-25) - تم التحديث إلى Node.js 16.17.0 مع npm 8.15.0.
- تمت إضافة خاصية ProductModel إلى عقدة جهاز التوجيه.
الإصدار 18.15.0 (2023-04-06) - تم التحديث إلى Node.js 18.15.0 مع npm 9.5.0.
- تمت إزالة العقدة القديمة عديمة الفائدة "متى".
تطبيق جهاز التوجيه Node.js
تطبيق جهاز التوجيه Node.js غير موجود في البرامج الثابتة القياسية لجهاز التوجيه. تم شرح تحميل تطبيق جهاز التوجيه هذا في دليل التكوين (راجع المستندات ذات الصلة بالفصل). تطبيق جهاز التوجيه هذا متوافق فقط مع أجهزة توجيه النظام الأساسي v3 و v4!
2.1 المقدمة
عقدة Node.js هي عقدة بيئة تشغيل JavaScript خاصة من جانب الخادم متاحة لأجهزة التوجيه الخلوية Advantech. يتم استخدام هذه العقدة بواسطة وحدات Advantech المكتوبة بلغة JavaScript، ولكن يمكن استخدامها بواسطة أي تطبيق JavaScript آخر تابع لجهة خارجية لإدارة أجهزة التوجيه وصيانتها.
تحتوي وحدة جهاز التوجيه على هذه العقد بالإضافة إلى العقد المدمجة:
- Node-authenticate-pam – مصادقة PAM غير المتزامنة لـ NodeJS،
- عقدة جهاز التوجيه – عقدة خاصة لأجهزة التوجيه الخلوية الخاصة بشركة Advantech الموضحة في هذا المستند بالتفصيل.
2.2 بناء العقد المخصصة
الطريقة الرسمية لكيفية إنشاء عقدة وتثبيتها هي استخدام الأمر nmp. ومع ذلك، هناك بعض القيود نظرًا لأن أجهزة توجيه Advantech عبارة عن أجهزة مضمنة لا تحتوي على نظام تشغيل Linux كامل ومزودة بأجهزة متخصصة. يمكنك تثبيت تطبيق nmp Router على جهاز التوجيه واستخدامه بالطريقة الشائعة، أو إعداد العقد باستخدام أداة npm على جهاز الكمبيوتر الخاص بك ثم نسخها إلى جهاز التوجيه. لكن ليس من الممكن تثبيت جميع العقد التي يمكنك العثور عليها في مستودع npm.
لمزيد من التفاصيل انظر: تطبيقات جهاز التوجيه – بوابة هندسة أجهزة التوجيه الخلوية (advantech.cz)في الفصل 4.5 من ملاحظة تطبيق Node-RED.
عقدة جهاز التوجيه
هذا الجزء من الوثيقة مخصص بشكل خاص للمبرمجين.
توفر عقدة جهاز التوجيه (المسماة "جهاز التوجيه") إمكانية الوصول إلى الوظائف والأجهزة الخاصة بجهاز التوجيه. يمكنك تحميل عقدة Node.js في التعليمات البرمجية الخاصة بك عن طريق require("جهاز التوجيه")، على سبيل المثالampعلى:
سنستخدم المتغير r من هذا المثالampجنيه للوصول إلى جميع الخصائص في السابق التاليampليه في هذه الملاحظات.
مثال بسيطampاستخدام عقدة جهاز التوجيه
في الشكل التالي هو السابقينampعملية تحميل عقدة Node.js.
3.1 خصائص العقدة
3.1.1 اسم المنتج
متغير سلسلة للقراءة فقط محمل باسم منتج جهاز التوجيه. السابقampجنيه من الاستخدام:
3.1.2 نموذج المنتج
متغير سلسلة للقراءة فقط محمل بإشارة طراز جهاز التوجيه. السابقampجنيه من الاستخدام:
3.1.3 مراجعة المنتج
متغير سلسلة للقراءة فقط محملاً برقم مراجعة منتج جهاز التوجيه. السابقampجنيه من الاستخدام:
الناتج: 1.0
3.1.4 رمز المنصة
متغير سلسلة للقراءة فقط محمّل برمز النظام الأساسي لجهاز التوجيه. وهو مدعوم من خلال أجهزة التوجيه الخاصة بنموذج الإنتاج v3 وv4. السابقampجنيه من الاستخدام:
الإخراج: V3
3.1.5 الرقم التسلسلي
متغير سلسلة للقراءة فقط محمل بالرقم التسلسلي للموجه. السابقampجنيه من الاستخدام:
الإخراج: ACZ1100000322054
3.1.6 إصدار البرامج الثابتة
متغير سلسلة للقراءة فقط تم تحميله مع إصدار البرنامج الثابت لجهاز التوجيه. السابقampجنيه من الاستخدام:
المخرجات: 6.2.1 (2019-10-16)
3.1.7 بطارية متوافقة مع RTC
متغير منطقي للقراءة فقط محمّل بحالة بطارية RTC الخاصة بجهاز التوجيه. صحيح يعني موافق، خطأ يعني سيئ.
Exampجنيه من الاستخدام:
الإخراج: صحيح
3.1.8 مصدر الطاقة
متغير رقم عشري للقراءة فقط محمل بمصدر طاقة جهاز التوجيهtagه. السابقampجنيه من الاستخدام:
المخرج: 11.701 فولت
3.1.9 درجة حرارة
متغير عدد صحيح للقراءة فقط محمّل بدرجة حرارة داخلية للموجه بالدرجات المئوية. السابقampجنيه من الاستخدام:
الإخراج: 39 درجة مئوية
3.1.1 0usrLED
متغير منطقي للكتابة فقط لمؤشر LED "USR" لجهاز التوجيه. السابقampجنيه من الاستخدام:
يضبط USR LED على ON (إضاءة).
3.1.11 ب
مصفوفة للقراءة فقط تحتوي على قيم على المدخلات الثنائية لجهاز التوجيه. يحتوي المصفوفة على العناصر المتعلقة بعدد المدخلات الثنائية. على سبيل المثال، يحتوي جهاز التوجيه على BIN0 وBIN1، لذا فإن المصفوفة تحتوي على فهارس صالحة 0 و1. يمكن أن تحتوي عناصر المصفوفة على قيم 0 أو 1. على سبيل المثالampجنيه من الاستخدام:
الإخراج: الإدخال الثنائي الثانوي: 0
3.1.12 نوبة
المصفوفة المتعلقة بالمخرجات الثنائية لجهاز التوجيه. إنه مشابه لـ B_IN ولكن يمكنك أيضًا كتابة القيم. القيمة المكتوبة تغير حالة الإخراج. السابقampجنيه من الاستخدام:
3.1.13 إكس باص
كائن للعمل مع X Bus. X Bus عبارة عن ناقل خاص للاتصال بين العمليات. على سبيل المثال
يمكنك الاشتراك في المعلومات التي ترتفع/تخفض واجهة الشبكة أو الرسائل النصية القصيرة من برنامج mwan. يمكنك أيضًا إرسال/الاشتراك في موضوعاتك الخاصة بين تطبيقاتك.
يرسل إلى نظام مراقبة الطلب لمشاهدة تطبيق "myapp" الخاص بك. يجب أن يرسل التطبيق هذه الرسالة بشكل منتظم في موعد لا يتجاوز الفترة المحددة في الرسالة السابقة (300 ثانية في هذا المثالampلو). توقف المهلة 0 عن المشاهدة.
الإخراج:
XBus.read (الموضوع)
قراءة الرسالة المخزنة من XBus. السابقampجنيه من الاستخدام:
3.1.1 4 التكوين
كائن يحتوي على تكوين جهاز التوجيه. يمكن للمستخدم قراءة عنصر التكوين عن طريق الحصول على خاصية الكائن وكتابة عنصر التكوين عن طريق تعيين خاصية الكائن. مفاتيح الكائنات هي نفس مفاتيح التكوين كما في الإعداد fileس. من الممكن البحث عن اسم المفتاح المطلوب في الإعداد ذي الصلة file. يتم وضع تكوينات البرامج الثابتة في /etc/settings.* fileس. يتم وضع تكوين تطبيق جهاز التوجيه في /opt/*/etc/settings fileس. تقرير جهاز التوجيه (Web واجهة المستخدم: الحالة / سجل النظام / تقرير الحفظ) تحتوي على قائمة كاملة بالتكوين الحالي وربما تكون هذه هي الطريقة الأسهل للعثور على مفتاح التكوين المطلوب.
في حالة عدم وجود مفتاح معين، تكون قيمة القراءة غير محددة وتسبب القيمة المكتوبة استثناءً (في الوضع الصارم). لا يمكن إضافة عنصر تكوين جديد غير موجود، فقط لتعديل عنصر موجود. يتم التعامل مع كافة قيم التكوين كسلاسل. إذا كان المستخدم بحاجة إلى العمل مع نوع مختلف، فيجب عليه تحويله بنفسه. لا تقوم العقدة بأي التحقق من صحة القيمة. المستخدم هو المسؤول عن إرسال القيم الصحيحة. السابقampليه:
بالنسبة إلى WIFI_AP_SSID=ROUTER_AP في /etc/settings.wifi_ap (أو بالأحرى في حقل SSID في نموذج WiFi • Access Point 1) سيكون الإخراج:
على سبيل المثالampكيفية تعيين قيمة التكوين:
يغير عناوين IP على واجهة eth0
ملحوظة: يتم كتابة التكوين الجديد فقط. إذا أراد المستخدم أن يتم تطبيقه على بيئة التشغيل، فمن الضروري إعادة تشغيل جهاز التوجيه أو الخدمة ذات الصلة. على سبيل المثالampأعلاه من الممكن استخدام أمر shell التالي:
- تطبيقات جهاز التوجيه: icr.infech.cz/user-modules
- مؤسسة شبيبة: https://nodered.org/
يمكنك الحصول على المستندات المتعلقة بالمنتج على البوابة الهندسية على icr.infech.cz عنوان.
للحصول على دليل البدء السريع لجهاز التوجيه الخاص بك، أو دليل المستخدم، أو دليل التكوين، أو البرامج الثابتة، انتقل إلى نماذج جهاز التوجيه الصفحة، وابحث عن الطراز المطلوب، وانتقل إلى علامة التبويب "الأدلة" أو "البرامج الثابتة"، على التوالي.
تتوفر حزم وأدلة تثبيت تطبيقات جهاز التوجيه على تطبيقات جهاز التوجيه صفحة.
للحصول على وثائق التطوير، انتقل إلى منطقة التطوير صفحة.
Advantech Czech sro ، Sokolska 71 ، 562 04 Usti nad Orlici ، جمهورية التشيك
الوثيقة رقم APP-0080-EN، المراجعة اعتبارًا من 12 أكتوبر 2023.
المستندات / الموارد
 |
تطبيق ADVANTECH Node.js لجهاز التوجيه [بي دي اف] دليل المستخدم تطبيق جهاز التوجيه Node.js، تطبيق جهاز التوجيه Node.js، التطبيق |
