تعريف نوع جهاز IoT جديد في تطبيق Azure IoT Central

قالب الجهاز هو مخطط يُحدد خصائص وسلوكيات نوع الجهاز المُتصل بتطبيق Azure IoT Central.

توضح هذه المقالة كيفية إنشاء قالب جهاز في IoT Central. على سبيل المثال، يمكنك إنشاء قالب جهاز لجهاز استشعار يرسل بيانات تتبع الاستخدام، مثل درجة الحرارة والخصائص، مثل الموقع. من قالب الجهاز هذا، يمكن للمشغل إنشاء أجهزة حقيقية وتوصيمها.

تظهر لقطة الشاشة التالية مثالا على قالب الجهاز:

لقطة شاشة تعرض قالب جهاز.

يحتوي قالب الجهاز على الأقسام التالية:

  • النموذج - استخدم النموذج لتحديد كيفية تفاعل جهازك مع تطبيق IoT Central. يحتوي كل نموذج على معرف نموذج فريد ويحدد قدرات الجهاز. يتم تجميع القدرات في واجهات. تتيح لك الواجهات إعادة استخدام المكونات عبر النماذج أو استخدام التوريث لتوسيع مجموعة الإمكانات.
  • البيانات الأولية - عرض البيانات الأولية المرسلة بواسطة جهاز المعاينة المعين. تعد طريقة العرض هذه مفيدة عند تصحيح أخطاء قالب جهاز أو استكشاف الأخطاء وإصلاحها.
  • طرق العرض - استخدم طرق العرض لتصور البيانات من الجهاز والنماذج لإدارة الجهاز والتحكم فيه.

لمعرفة المزيد، راجع ⁧⁩طريقة إضافة قوالب الأجهزة.⁧

لمعرفة كيفية إدارة قوالب الأجهزة باستخدام واجهة برمجة تطبيقات REST ل IoT Central، راجع كيفية استخدام واجهة برمجة تطبيقات REST ل IoT Central لإدارة قوالب الأجهزة.

إنشاء قالب الجهاز

لديك العديد من الخيارات لإنشاء قوالب الجهاز:

  • تصميم قالب الجهاز في IoT Central GUI.
  • استيراد قالب جهاز من كتالوج أجهزة Azure Certified for IoT. اختيارياً، قم بتخصيص قالب الجهاز وفقاً لمتطلباتك في IoT Central.
  • عندما يتصل الجهاز بـ IoT Central، اجعله يرسل معرف الطراز الخاص بالنموذج الذي ينفذه. يستخدم IoT Central معرف النموذج لاسترداد النموذج من مستودع النموذج وإنشاء قالب جهاز. أضف أي خصائص سحابية وافتح تطبيق IoT Central الذي يحتاجه إلى قالب الجهاز.
  • عندما يتصل الجهاز ب IoT Central، اسمح ل IoT Central بإنشاء تعريف قالب جهاز تلقائيا من البيانات التي يرسلها الجهاز.
  • تأليف نموذج جهاز باستخدام Digital Twin Definition Language (DTDL) V2. قم باستيراد طراز الجهاز يدوياً إلى تطبيق IoT Central الخاص بك. ثم أضف خصائص السحابة وعرض احتياجات تطبيق IoT Central.
  • يمكنك أيضا إضافة قوالب الجهاز إلى تطبيق IoT Central باستخدام واجهة برمجة تطبيقات REST أو CLI.

ملاحظة

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

يوضح لك هذا القسم كيفية استيراد قالب جهاز من الكتالوج وكيفية تخصيصه باستخدام IoT Central GUI. يستخدم هذا المثال قالب جهاز ESP32-Azure IoT Kit من كتالوج الجهاز:

  1. لإضافة نموذج جهاز جديد، حدد ⁧⁩New +⁧⁩ في صفحة ⁧⁩Device templates⁧⁩.
  2. في صفحة ⁧⁩Select type⁧⁩، قم بالتمرير لأسفل حتى تعثر على جزء ⁧⁩ESP32-Azure IoT Kit⁧⁩ في ⁧⁩Use a pre-configured device template⁧⁩.
  3. حدد جزء ⁧⁩ ESP32-Azure IoT Kit⁧⁩، ثم حدد ⁧⁩Next: Review⁧⁩.
  4. في صفحة مراجعة+ إنشاء حدد إنشاء. اسم النموذج الذي قمت بإنشائه هو ⁧⁩Sensor Controller⁧⁩. يشتمل النموذج على مكونات مثل ⁧⁩Sensor Controller⁧⁩ و⁧⁩SensorTemp⁧⁩ و⁧⁩واجهة Device Information⁧⁩. تحدد المكونات قدرات جهاز ESP32. تتضمن القدرات بيانات تتبع الاستخدام والخصائص والأوامر.

لقطة شاشة تعرض قالب جهاز وحدة تحكم أداة الاستشعار.

إنشاء قالب جهاز تلقائيا

يمكنك أيضا إنشاء قالب جهاز تلقائيا من جهاز متصل لم يتم تعيينه بعد إلى قالب جهاز. يستخدم IoT Central قيم القياس عن بعد والخصائص التي يرسلها الجهاز للاستدلال على نموذج جهاز.

ملاحظة

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

توضح الخطوات التالية كيفية استخدام هذه الميزة:

  1. قم بتوصيل جهازك ب IoT Central، وابدأ في إرسال البيانات. عندما ترى البيانات في طريقة عرض البيانات الأولية ، حدد قالب إنشاء تلقائي في القائمة المنسدلة إدارة القالب :

    لقطة شاشة تعرض البيانات الأولية من جهاز غير المعين.

  2. في صفحة معاينة البيانات ، قم بإجراء أي تغييرات مطلوبة على البيانات الأولية، وحدد إنشاء قالب:

    لقطة شاشة تعرض تغيير معاينة البيانات الذي يتيح لك تحرير البيانات التي يستخدمها IoT Central لإنشاء قالب الجهاز.

  3. يقوم IoT Central بإنشاء قالب استنادا إلى تنسيق البيانات المعروض في صفحة معاينة البيانات وتعيين الجهاز إليه. يمكنك إجراء المزيد من التغييرات على قالب الجهاز، مثل إعادة تسميته أو إضافة قدرات، في صفحة قوالب الجهاز :

    لقطة شاشة توضح كيفية إعادة تسمية قالب الجهاز الذي تم إنشاؤه تلقائيا.

إدارة قالب جهاز

يمكنك إعادة تسمية قالب أو حذفه من الصفحة «محرر القالب».

بعد تحديد القالب، يمكنك نشره. حتى يتم نشر القالب، لا يمكنك توصيل جهاز به، ولا يظهر على صفحة الأجهزة .

لمعرفة المزيد حول تعديل قوالب الأجهزة وتعيين إصدارها، راجع تحرير قالب جهاز موجود.

نماذج

يحدد النموذج كيفية تفاعل جهازك مع تطبيق IoT Central. قم بتخصيص النموذج الخاص بك بمزيد من الإمكانات، أو إضافة واجهات لتوريث الإمكانات، أو إضافة مكونات جديدة تستند إلى واجهات أخرى.

لإنشاء نموذج جهاز، يمكنك:

  • استخدم IoT Central لإنشاء طراز مخصص من بداية الأمر.
  • استيراد نموذج DTDL من ملف JSON. قد يكون منشئ الجهاز قد استخدم Visual Studio Code لتأليف نموذج جهاز لتطبيقك.
  • حدد أحد الأجهزة من «كتالوج الأجهزة». يستورد هذا الخيار طراز الجهاز الذي نشرته الشركة المصنعة لهذا الجهاز. يتم نشر نموذج جهاز مستورد مثل هذا تلقائيا.
  1. لعرض معرف النموذج، حدد واجهة الجذر في النموذج وحدد تحرير الهوية:

    لقطة شاشة تعرض معرف النموذج لواجهة جذر قالب الجهاز.

  2. لعرض معرف المكون، حدد تحرير الهوية على أي من واجهات المكون في النموذج.

لمعرفة المزيد، راجع دليل نمذجة أجهزة التوصيل و التشغيل IoT.

الواجهات والمكوّنات

لعرض الواجهات وإدارتها في نموذج الجهاز:

  1. انتقل إلى صفحة قوالب الأجهزة وحدد قالب الجهاز الذي أنشأته. يتم سرد الواجهات في قسم Models في قالب الجهاز. تظهر لقطة الشاشة التالية مثالا على واجهة جذر Sensor Controller في قالب الجهاز:

    لقطة شاشة تعرض واجهة الجذر لنموذج

  2. حدد علامة القطع لإضافة واجهة متوارثة أو مكوّن إلى الواجهة الجذرية. لمعرفة المزيد حول الواجهات والمكونات، راجع مكونات متعددة في دليل النمذجة.

    لقطة شاشة توضح كيفية إضافة واجهة أو مكون.

  3. لتصدير نموذج أو واجهة، حدد تصدير.

  4. لعرض DTDL أو تحريره لواجهة أو إمكانية، حدد تحرير DTDL.

القدرات

حدد + Add capability لإضافة إمكانية إلى واجهة أو مكون. على سبيل المثال، يمكنك إضافة إمكانية درجة الحرارة المستهدفة إلى مكون SensorTemp .

لقطة شاشة توضح كيفية إضافة القدرة.

بيانات تتبع الاستخدام

بيانات تتبع الاستخدام هي تيار من القيم المرسلة من الجهاز وعادة من أداة استشعار. على سبيل المثال، قد يبلغ المستشعر عن درجة الحرارة المحيطة كما هو موضح في لقطة الشاشة التالية:

لقطة شاشة توضح كيفية إضافة نوع بيانات تتبع الاستخدام.

يوضّح الجدول التالي إعدادات التكوين لإمكانية بيانات تتبع الاستخدام:

الحقل الوصف
اسم العرض اسم العرض لقيمة بيانات تتبع الاستخدام المستخدمة في طرق العرض والنماذج.
الاسم اسم الحقل في رسالة بيانات تتبع الاستخدام. ينشئ IoT Central قيمة لهذا الحقل من اسم العرض، لكن يمكنك اختيار القيمة الخاصة بك إذا لزم الأمر. يجب أن يكون هذا الحقل أبجديا رقميا.
نوع الإمكانية بيانات تتبع الاستخدام.
النوع الدلالي النوع الدلالي لبيانات تتبع الاستخدام، مثل درجة الحرارة أو الحالة أو الحدث. يحدد اختيار النوع الدلالي أي من الحقول التالية تكون متوفرة.
المخطط نوع بيانات تتبع الاستخدام، مثل أن تكون مزدوجة أو سلسلة أو خط متجه. تُحدد الخيارات المتوفرة حسب النوع الدلالي. المخطط غير متوفر للأنواع الدلالية للحدث والحالة.
الخطورة متوفر لنوع الحدث الدلالي فقط. الخطورة هي خطأ أو معلومات أو تحذير.
قيم الحالة متوفر لنوع دلالة الحالة فقط. حدد قيم الحالة المحتملة، لكل منها اسم العرض والاسم ونوع التعداد والقيمة.
الوحدة وحدة لقيمة بيانات تتبع الاستخدام، مثل mph أو %أو °C.
وحدة العرض وحدة عرض للاستخدام في طرق العرض والنماذج.
تعليق أي تعليقات حول إمكانية بيانات تتبع الاستخدام.
الوصف وصف إمكانية بيانات تتبع الاستخدام.

الخصائص

تمثل الخصائص قيم النقطة في الوقت. يمكنك تعيين خصائص قابلة للصياغة من IoT Central. على سبيل المثال، يمكن للجهاز استخدام خاصية قابلة للكتابة للسماح للمشغل بتعيين درجة الحرارة الهدف كما هو موضح في لقطة الشاشة التالية:

لقطة شاشة توضح كيفية إضافة خاصية.

يوضّح الجدول التالي إعدادات التكوين لإمكانية خاصية:

الحقل الوصف
اسم العرض اسم العرض لقيمة الخاصية المستخدمة في طرق العرض والنماذج.
الاسم اسم الخاصية. ينشئ IoT Central قيمة لهذا الحقل من اسم العرض، لكن يمكنك اختيار القيمة الخاصة بك إذا لزم الأمر. يجب أن يكون هذا الحقل أبجديا رقميا.
نوع الإمكانية الخاصية.
النوع الدلالي النوع الدلالي للخاصيّة، مثل درجة الحرارة أو الحالة أو الحدث. يحدد اختيار النوع الدلالي أي من الحقول التالية تكون متوفرة.
المخطط نوع بيانات الخاصية، مثل أن تكون مزدوجة أو سلسلة أو خط متجه. تُحدد الخيارات المتوفرة حسب النوع الدلالي. المخطط غير متوفر للأنواع الدلالية للحدث والحالة.
قابل للكتابة إذا لم تكن الخاصية قابلة للكتابة، يمكن للجهاز الإبلاغ عن قيم الخصائص إلى IoT Central. إذا كانت الخاصية قابلة للكتابة، يمكن للجهاز الإبلاغ عن قيم الخصائص إلى IoT Central ويمكن ل IoT Central إرسال تحديثات الخصائص إلى الجهاز.
الخطورة متوفر لنوع الحدث الدلالي فقط. الخطورة هي خطأ أو معلومات أو تحذير.
قيم الحالة متوفر لنوع دلالة الحالة فقط. حدد قيم الحالة المحتملة، لكل منها اسم العرض والاسم ونوع التعداد والقيمة.
الوحدة وحدة لقيمة الخاصية، مثل mph أو %أو °C.
وحدة العرض وحدة عرض للاستخدام في طرق العرض والنماذج.
تعليق أية تعليقات حول إمكانية الخاصية.
الوصف وصف لإمكانية الخاصية.
اللون هذا ملحق IoT Central إلى DTDL.
أدنى قيمة تعيين الحد الأدنى للقيمة - هذا ملحق IoT Central إلى DTDL.
أقصى قيمة تعيين الحد الأقصى للقيمة - هذا ملحق IoT Central إلى DTDL.
المنازل العشرية هذا ملحق IoT Central إلى DTDL.

الأوامر

يمكنك طلب أوامر الجهاز من IoT Central. تُصدر الأوامر بشكل اختياري المعلمات إلى الجهاز وتتلقى استجابة من الجهاز. على سبيل المثال، يمكنك استدعاء أمر لإعادة تشغيل جهاز في 10 ثوان كما هو موضح في لقطة الشاشة التالية:

لقطة شاشة توضح كيفية إضافة الأوامر.

يوضّح الجدول التالي إعدادات التكوين لإمكانية أمر:

الحقل الوصف
اسم العرض اسم العرض للأمر المستخدم في طرق العرض والنماذج.
الاسم الاسم الخاص بالأمر. ينشئ IoT Central قيمة لهذا الحقل من اسم العرض، لكن يمكنك اختيار القيمة الخاصة بك إذا لزم الأمر. يجب أن يكون هذا الحقل أبجديا رقميا.
نوع الإمكانية الأمر.
قائمة الانتظار في حال كانت غير متصلة إذا تم تمكينه، يمكنك طلب الأمر حتى إذا كان الجهاز غير متصل. إذا لم يتم تمكينه، يمكنك طلب الأمر فقط عندما يكون الجهاز متصلا بالإنترنت.
تعليق أية تعليقات حول إمكانية الأمر.
الوصف وصف لإمكانية الأمر.
طلب إذا تم تمكين تعريف معلمة الطلب بما في ذلك: الاسم واسم العرض والمخطط والوحدة ووحدة العرض.
الاستجابة إذا تم التمكين، يمكن تحديد استجابة الأمر، بما في ذلك الاسم واسم العرض والمخطط والوحدة ووحدة العرض.
القيمة المبدئية قيمة المعلمة الافتراضية. هذا ملحق IoT Central إلى DTDL.

لمعرفة المزيد حول كيفية تنفيذ الأجهزة للأوامر، راجع بيانات تتبع الاستخدام والخصائص ولأوامر حمولات > الأوامر والأوامر طويلة الأمد.

أوامر غير متصلة

يمكنك اختيار أوامر قائمة الانتظار إذا كان الجهاز غير متصل حاليا عن طريق تمكين خيار قائمة الانتظار إذا كان غير متصل لأمر في قالب الجهاز.

يستخدم هذا الخيار رسائل IoT Hub من السحابة إلى الجهاز لإرسال إعلامات إلى الأجهزة. لمعرفة المزيد، راجع مقالة IoT Hub إرسال رسائل من السحابة إلى الجهاز.

الرسائل من السحابة إلى الجهاز:

  • هي إعلامات أحادية الاتجاه للجهاز من الحل الخاص بك.
  • ضمان تسليم الرسائل مرة واحدة على الأقل. يستمر IoT Hub في الرسائل من السحابة إلى الجهاز في قوائم الانتظار لكل جهاز، ما يضمن المرونة ضد الاتصال وفشل الجهاز.
  • اطلب من الجهاز تنفيذ معالج رسائل لمعالجة الرسالة من السحابة إلى الجهاز.

ملاحظة

يتم وضع علامة على الأوامر دون اتصال كما durable لو قمت بتصدير النموذج ك DTDL.

خصائص السحابة

استخدم خصائص شبكة النظير لتخزين معلومات حول الأجهزة في IoT Central. لا تُرسل خصائص شبكة النظير إلى الجهاز إطلاقا. على سبيل المثال، يمكنك استخدام خصائص شبكة النظير لتخزين اسم العميل الذي ثبّت الجهاز أو تاريخ الخدمة الأخير للجهاز.

لقطة شاشة توضح كيفية إضافة خصائص السحابة.

تلميح

يمكنك فقط إضافة خصائص السحابة إلى المكون الجذر في النموذج.

يوضّح الجدول التالي إعدادات التكوين لخاصية شبكة النظير:

الحقل الوصف
اسم العرض اسم العرض لقيمة خاصية السحابة المستخدمة في طرق العرض والنماذج.
الاسم اسم خاصية شبكة النظير. ينشئ IoT Central قيمة لهذا الحقل من اسم العرض، لكن يمكنك اختيار القيمة الخاصة بك إذا لزم الأمر.
النوع الدلالي النوع الدلالي للخاصيّة، مثل درجة الحرارة أو الحالة أو الحدث. يحدد اختيار النوع الدلالي أي من الحقول التالية تكون متوفرة.
المخطط نوع بيانات خاصية شبكة النظير، مثل أن تكون مزدوجة أو سلسلة أو خط متجه. تُحدد الخيارات المتوفرة حسب النوع الدلالي.

طرق العرض

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

يعد إنشاء العروض الافتراضية طريقة سريعة لتصور معلومات الجهاز الهامة. تنقسم العروض الافتراضية لثلاثة أنواع هي:

العروض الافتراضية

  • الأوامر: طريقة عرض مع أوامر الجهاز، وتسمح للمشغل بإرسالها إلى جهازك.
  • نظرة عامة: طريقة عرض مع بيانات تتبع الاستخدام للجهاز، وعرض المخططات والمقاييس.
  • حول: طريقة عرض تحتوي على معلومات الجهاز، وتعرض خصائص الجهاز.

بعد تحديد إنشاء طرق عرض افتراضية، تتم إضافتها تلقائيا ضمن قسم طرق العرض في قالب جهازك.

العروض المخصصة

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

لإضافة عرض إلى قالب الجهاز:

  1. انتقل إلى قالب جهازك، وحدد طرق العرض.
  2. حدد تصور الجهاز.
  3. أدخل اسما لعرضك في View name.
  4. حدد البدء بمرئية ضمن إضافة مربعات واختر نوع المرئيات للتجانب الخاص بك. ثم حدد إضافة لوحة أو اسحب المرئية وأفلتها على اللوحة. لتكوين التجانب، حدد الأيقونة الموجودة على شكل ترس.

لقطة شاشة توضح كيفية البدء بمرئية.

لقطة شاشة توضح كيفية تكوين لوحة.

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

  • لا يوجد جهاز إصدار أولي.
  • جهاز الاختبار الحقيقي الذي كوّنته لقالب جهازك.
  • الجهاز الموجود في التطبيق الخاص بك، باستخدام معرف الجهاز.

نماذج

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

  1. حدد العقدة ⁧⁩Views⁧⁩، ثم حدد مربع ⁧⁩Editing device and cloud data⁧⁩ لإضافة طريقة عرض جديدة.

  2. قم بتغيير اسم النموذج إلى ⁧⁩ إدارة الجهاز⁧⁩.

  3. حدد الخصائص وخصائص السحابة لإضافتها إلى النموذج. ثم حدد إضافة مقطع.

  4. حدد ⁧⁩Save⁧⁩ لحفظ النموذج الجديد الخاص بك.

لقطة شاشة توضح كيفية تكوين نموذج.

نشر قالب الجهاز

قبل أن تتمكن من توصيل جهاز يطبّق نموذج الجهاز، يتوجب عليك نشر قالب الجهاز.

لنشر قالب جهاز، انتقل إلى قالب جهازك، وحدد نشر.

بعد نشر قالب جهاز، يمكن للمشغل الانتقال إلى صفحة الأجهزة ، وإضافة أجهزة حقيقية أو محاكاة تستخدم قالب جهازك. يمكنك الاستمرار في تعديل قالب جهازك ومن حفظه أثناء إجراء التغييرات. عندما تريد دفع هذه التغييرات إلى عامل التشغيل لعرضها ضمن صفحة الأجهزة ، يجب تحديد نشر في كل مرة.

الخطوات التالية

الخطوة التالية المقترحة هي القراءة حول كيفية إجراء تغييرات على قالب جهاز موجود.