مراقبة جهازك والتحكم فيه
تتيح لك واجهة برمجة تطبيقات REST التحكم برمجياً في الأجهزة المتصلة بتطبيق IoT Central الخاص بك.
لتبسيط مهمة مدير الأسطول، طُلب منك دمج إمكانيات التحكم في جهاز IoT Central في تطبيق إدارة الأسطول الحالي. يرغب مديرو الأسطول في استخدام تطبيق إدارة الأسطول الحالي للتحكم في الأجهزة المتصلة بتطبيق IoT Central لديك.
ستتعلم هنا كيفية استخدام واجهة برمجة تطبيقات REST لاسترداد قيم بيانات تتبع الاستخدام وقراءة خصائص الجهاز وتعيينها وإرسال الأوامر إلى الأجهزة.
بيانات تتبع الاستخدام
يتم تعريف بيانات تتبع الاستخدام التي يرسلها الجهاز في قالب الجهاز. يتضمن كل تعريف بيانات تتبع الاستخدام اسمًا ونوعًا. يمكن أن تكون أنواع بيانات تتبع الاستخدام أنواعًا بسيطة مثل الأعداد الصحيحة والسلاسل، أو أنواع معقدة مثل قوائم التعداد أو الكائنات.
تتيح لك واجهة برمجة تطبيقات IoT Central REST استرداد آخر قيمة معروفة لأي نوع من أنواع بيانات تتبع الاستخدام لجهاز متصل أو إجراء الاستعلامات لاسترداد بيانات تتبع استخدام الجهاز.
خصائص الجهاز
تُعرف الخصائص التي يدعمها الجهاز في قالب الجهاز. يستخدم IoT Central نوعين من الخصائص لتخزين المعلومات حول الأجهزة. تُخزّن خصائص الجهاز على جهاز حقيقي أو جهاز محاكاة. تُخزّن خصائص السحابة في تطبيق IoT Central وترتبط بأجهزة معينة.
على سبيل المثال، يُمكن لخاصية الجهاز تمكين جهاز من الإبلاغ عن إصدار البرنامج الثابت الحالي للجهاز. يتم إبلاغ IoT Central بقيم خاصية الجهاز فقط عند بدء تشغيل الجهاز أو عند تغيير قيمة الخاصية.
يُمكن أن تكون خاصية الجهاز قابلة للكتابة، بصورة اختيارية. يُمكن للمُشغّل استخدام تطبيق IoT Central لتعيين قيمة لخاصية قابلة للكتابة على الجهاز. على سبيل المثال، يُمكن للتطبيق استخدام خاصية قابلة للكتابة لتعيين درجة الحرارة المُستهدفة لمنظم الحرارة على الجهاز.
تاريخ آخر خدمة للجهاز هو مثال على خاصية السحابة. لا يحتاج الجهاز إلى هذه المعلومات ليعمل، لكنها بيانات من المفيد تتبعها في تطبيق إدارة الأسطول.
تتيح لك واجهة برمجة التطبيقات الخاصة بـ IoT Central ما يلي:
- تشغيل الاستعلامات لاسترداد قيم خصائص الجهاز
- الحصول على خصائص الجهاز لجهاز ما
- تحديث خصائص الجهاز القابلة للكتابة لجهاز ما
- الحصول على خصائص السحابة المرتبطة بجهاز
- تحديث خصائص السحابة المرتبطة بجهاز
أوامر الجهاز
تُعرف الأوامر التي يدعمها الجهاز في قالب الجهاز. يرسل IoT Central أوامر إلى الأجهزة للتحكم في سلوك الجهاز. يُمكن للأوامر أخذ المعلمات وإعادة القيم.
على سبيل المثال، يُمكن للجهاز أن يستجيب لأمر يطلب منه إعادة التشغيل أو يطلب منه تغيير المعدل الذي يرسل به قيم بيانات تتبع الاستخدام.
تتيح لك واجهة برمجة التطبيقات الخاصة بـ IoT Central ما يلي:
- تنفيذ أمر على الجهاز
- عرض محفوظات إرسال أمر إلى الجهاز
المكونات والوحدات النمطية
قد يتم من خلال قالب الجهاز تجميع بيانات تتبع الاستخدام والخصائص والأوامر في مكونات قابلة لإعادة الاستخدام. تتيح لك واجهة برمجة تطبيقات REST لأجهزة IoT Central ما يلي:
- استرداد آخر قيمة معروفة لأي نوع من أنواع بيانات تتبع الاستخدام من مكون على جهاز
- الحصول على خصائص الجهاز من مكون على جهاز
- تحديث خصائص الجهاز القابلة للكتابة على مكون على جهاز
- تنفيذ أمر على مكون على جهاز
- عرض محفوظات إرسال أمر إلى مكون على جهاز
يمكن لقالب الجهاز أيضًا وصف إمكانيات جهاز IoT Edge المتصل بتطبيقك. يتم تنفيذ قدرات جهاز IoT Edge في وحدات IoT Edge النمطية. يمكن أن يكون لجهاز IoT Edge وحدة نمطية واحدة أو أكثر. تتيح لك واجهة برمجة تطبيقات REST لأجهزة IoT Central ما يلي:
- استرداد آخر قيمة معروفة لأي نوع من أنواع بيانات تتبع الاستخدام من وحدة نمطية على جهاز
- الحصول على خصائص الجهاز من وحدة نمطية على جهاز IoT Edge
- تحديث خصائص الجهاز القابل للكتابة على وحدة نمطية على جهاز IoT Edge
- تنفيذ أمر على وحدة نمطية على جهاز IoT Edge
- عرض محفوظات إرسال أمر إلى وحدة نمطية على جهاز IoT Edge
يمكن لوحدة IoT Edge أيضا استخدام المكونات لتجميع قدراتها. تتيح لك واجهة برمجة تطبيقات IoT Central REST العمل مع بيانات تتبع الاستخدام والخصائص والأوامر المعرفة على مكون، في وحدة نمطية، على جهاز IoT Edge.
التحكم في الأجهزة في IoT Central
هل تحتاج إلى مساعدة؟ راجع دليل استكشاف الأخطاء وإصلاحها الذي نقدمه أو يمكنك توفير ملاحظات معينة عبر الإبلاغ عن مشكلة.