تحديد نوع جديد من أجهزة إنترنت الأشياء في تطبيق Azure IoT Central

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

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

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

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

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

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

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

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

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

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

ملاحظة

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

يوضح لك هذا القسم كيفية استيراد قالب جهاز من الكتالوج وكيفية تخصيصه باستخدام واجهة المستخدم الرسومية المركزية لإنترنت الأشياء. يستخدم هذا المثال قالب جهاز 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، وابدأ في إرسال البيانات. عندما ترى البيانات في طريقة عرض بيانات Raw ، حدد إنشاء قالب تلقائي في القائمة المنسدلة إدارة القالب :

   

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

   

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

   

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

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

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

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

نماذج

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

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

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

1. لعرض معرف النموذج، حدد واجهة الجذر في النموذج وحدد تحرير الهوية:

   

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

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

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

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

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

   

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

   

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

4. لعرض DTDL أو تحريره لواجهة أو قدرة، حدد تحرير DTDL.

القدرات

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

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

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

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

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

الخصائص

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

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

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

الأوامر

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

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

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

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

الأوامر غير المتصلة بالإنترنت

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

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

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

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

ملاحظة

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

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

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

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

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

التخصيصات

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

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

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

طرق العرض

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

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

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

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

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

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

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

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

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

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

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

نماذج

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

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

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

3. حدد خصائص السحابة الإلكترونية ⁧⁩Customer Name⁧⁩ و⁧⁩Last Service Date⁧⁩ وخاصية ⁧⁩Target Temperature⁧⁩. ثم حدد إضافة مقطع.

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

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

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

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

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

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

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