إضافة قوالب الجهاز والأجهزة إلى تطبيقك برمجياً
تمكّنك واجهة برمجة تطبيقات REST من إدارة الأجهزة في تطبيق IoT Central الخاص بك برمجياً.
لتبسيط مهمة مدير الأسطول، طُلب منك دمج إمكانيات إدارة جهاز IoT Central في تطبيق إدارة الأسطول الحالي. يرغب مديرو الأسطول في استخدام تطبيق إدارة الأسطول الحالي لإدارة الأجهزة المتصلة بتطبيق IoT Central لديك.
هنا، ستراجع أنواع الأجهزة والمصادقة عليها في تطبيق IoT Central. ثم ستتعلم كيفية استخدام واجهة برمجة تطبيقات REST لإدارة الأجهزة الفردية. في وحدة لاحقة، ستتعرف على كيفية استخدام الوظائف لإدارة الأجهزة بشكل مجمع.
الأجهزة وقوالب الجهاز
يرتبط أيّ جهاز يتصل بتطبيق IoT Central ويُدار عن طريقه بقالب جهاز في التطبيق. يعمل نموذج الجهاز في القالب كعنصر تحكم بين تطبيق IoT Central والأجهزة المتصلة به. يحتوي قالب الجهاز أيضاً على معلومات حول كيفية عرض IoT Central لمعلومات الجهاز في واجهة مستخدم الويب. على سبيل المثال، يُمكن أن يشتمل قالب الجهاز على تعريفات للوحات المعلومات لإظهار بيانات تتبع استخدام الجهاز أو لإرسال أوامر إلى جهاز.
ما قالب الجهاز؟
يحدد القسم «نموذج الجهاز» في قالب الجهاز إمكانيات الجهاز الذي تريد توصيله بتطبيقك. على سبيل المثال، يُمكن أن يحدد قالب الجهاز ما يلي:
- أنواع بيانات تتبع الاستخدام عن بُعد، مثل درجة الحرارة، التي سيرسلها جهازك إلى IoT Central.
- الخصائص، مثل إصدار البرنامج الثابت، التي سيبلغها جهازك إلى IoT Central.
- الخصائص، مثل درجة الحرارة المُستهدفة، التي سيُعينها IoT Central على جهازك.
- الأوامر، مثل إعادة التشغيل، التي سيرسلها IoT Central إلى جهازك.
تُجمع الإمكانيات الموجودة في نموذج الجهاز في الواجهات. تمكّنك الواجهات من مشاركة مجموعات من الإمكانيات ذات الصلة عبر القوالب. على سبيل المثال، تحدد واجهة معلومات الجهاز العامة خصائص الجهاز مثل الشركة المصنعة والطراز وإصدار البرنامج.
يُمكنك إنشاء قوالب الجهاز وإدارتها باستخدام واجهة مستخدم ويب IoT Central أو واجهة برمجة تطبيقات REST. في واجهة مستخدم IoT Central، يُمكنك:
- بناء قالب جهاز من البداية.
- تصفح كتالوج جهاز Azure IoT، واستيراد قوالب الأجهزة للأجهزة المعتمدة.
- استيراد ملف JSON الذي يحتوي على نموذج قدرة الجهاز وتعريفات الواجهة.
لكتابة ملف نموذج قدرة جهاز JSON، استخدم محرر لغة Digital Twins Definition Language لتعليمة Visual Studio البرمجية.
إذا كان نموذج الجهاز موجودًا بالفعل في مستودع نموذج الجهاز، يستطيع IoT Central تنزيل النموذج وإنشاء قالب جهاز في المرة الأولى التي يتصل فيها الجهاز. في هذا السيناريو، ستظل بحاجة إلى إنشاء أي خصائص سحابة ولوحات معلومات الجهاز المخصص والنماذج التي يحتاجها التطبيق.
لا تستخدم واجهة برمجة تطبيقات REST نموذج جهاز قياسي عند إنشاء قالب جهاز. تستخدم واجهة برمجة تطبيقات REST إصدارًا موسعًا يتيح لك تضمين تعريفات IoT Central محددة مثل خصائص السحابة. لمعرفة المزيد حول تنسيق ملف JSON الذي تستخدمه واجهة برمجة تطبيقات REST، راجع وثائق قوالب الأجهزة - إنشاء.
نشر قالب الجهاز
قبل أن يتمكن جهاز حقيقي من الاتصال بتطبيق IoT Central الخاص بك، يجب عليك نشر قالب الجهاز داخل تطبيق IoT Central. بعد نشر قالب الجهاز، يُمكنك أيضاً إنشاء أجهزة محاكاة من القالب.
بمجرد نشر قالب الجهاز، تتطلب التغييرات المهمة في طراز قدرة الجهاز أو تعريفات الواجهة أن تُنشئ إصداراً جديداً من قالب الجهاز وتنشره.
عند استخدام واجهة برمجة تطبيقات REST لإضافة قالب جهاز إلى تطبيقك، يتم نشره تلقائيًا.
إدارة قوالب الجهاز باستخدام واجهة برمجة تطبيقات REST
تتيح لك واجهة برمجة التطبيقات الخاصة بـ IoT Central ما يلي:
- الحصول على قائمة بقوالب الجهاز في التطبيق
- الحصول على قالب الجهاز عن طريق المُعرِّف
- إضافة قالب الجهاز إلى تطبيقك
- تحديث قالب الجهاز في تطبيقك
- حذف قالب الجهاز في تطبيقك
حظر الأجهزة وإلغاء حظرها
إذا كنت تشك في أن أحد الأجهزة يرسل بيانات غير صحيحة أو يتصرف بطريقة غير متوقعة، فيمكنك حظره. يؤدي حظر جهاز إلى منعه من الاتصال بتطبيقك - لا يمكن لجهاز محظور إرسال بيانات تتبع الاستخدام أو عدم إرسال تحديثات الخصائص أو الاستجابة للأوامر المتزامنة. لا يزال بإمكانك إدارة خصائص السحابة لجهاز محظور، لأنه يتم تخزين خصائص السحابة في تطبيق IoT Central لديك. يمكنك أيضًا تعيين خصائص قابلة للكتابة، على الرغم من أن الجهاز المحظور لن يتلقى هذه التحديثات حتى يتم إلغاء حظره.
الأجهزة الحقيقية
قبل توصيل جهاز في العالم الحقيقي بتطبيق IoT Central، يجب عليك إضافته إلى التطبيق. عندما تضيف جهازاً إلى تطبيق IoT Central، فإنك تمنح الجهاز:
- مُعرِّفًا فريدًا داخل التطبيق
- اسمًا مألوفًا
كما يمتلك كل جهاز حقيقي بيانات اعتماد الأمان الخاصة به التي يستخدمها الجهاز للمصادقة مع تطبيق IoT Central.
ويمتلك IoT Central أيضاً خيارات لإضافة أجهزة بشكل مُجمع أو السماح للأجهزة بالتسجيل الذاتي مع التطبيق. ولكن، تتجاوز مناقشة هذه الخيارات وما قد تعنيه لتطبيقاتك نطاق هذه الوحدة النمطية.
بيانات اعتماد الجهاز الحقيقي
يدعم IoT Central نوعين من المصادقة لتوصيل الأجهزة الحقيقية:
- توقيعات الوصول المشترك (SAS): يُنشئ IoT Central مفاتيح SAS لكل جهاز حقيقي تلقائياً. يُمكن للجهاز استخدام مفتاح SAS للمصادقة مع تطبيق IoT Central الخاص بك.
- شهادات X.509: يُمكنك تحميل شهادة جذر أو شهادة وسيط إلى تطبيق IoT Central واستخدامها لإنشاء شهادات الجهاز.
يوصى باستخدام شهادات X.509 في بيئة الإنتاج، ولكن مفاتيح SAS ملائمة للاستخدام في بيئة اختبار أو إثبات صحة الفكرة.
أجهزة المحاكاة
يُمكن لـ IoT Central إنشاء أجهزة محاكاة من قالب الجهاز. أجهزة المحاكاة هذه مفيدة لاختبار سلوك تطبيق IoT Central الخاص بك. يرسل جهاز المحاكاة بيانات تتبع الاستخدام، ويقوم بالإبلاغ عن قيم الخصائص، ويسمح للتطبيق بتعيين قيم الخصائص، ويستجيب للأوامر. في هذه الوحدة النمطية، ستنشئ بعض أجهزة المحاكاة لإعداد بيانات تتبع الاستخدام لتصديرها.
استخدام واجهة برمجة تطبيقات REST لإدارة أجهزتك
تتيح لك واجهة برمجة تطبيقات REST الخاصة بـ IoT Central للأجهزة:
- الحصول على قائمة بالأجهزة الموجودة في التطبيق
- الحصول على جهاز عن طريق المُعرِّف
- إنشاء جهاز
- تحديث جهاز
- حذف جهاز
- حظر جهاز وإلغاء حظره
إدارة الأجهزة في IoT Central
هل تحتاج إلى مساعدة؟ راجع دليل استكشاف الأخطاء وإصلاحها الذي نقدمه أو يمكنك توفير ملاحظات معينة عبر الإبلاغ عن مشكلة.