إدارة حسابات وكلاء تحديث الجهاز

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

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

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

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

التغييرات على عامل تحديث الجهاز في تحديث المعاينة العامة

لقد أضفنا العديد من الإمكانات الجديدة إلى عامل تحديث الجهاز في أحدث عامل تحديث معاينة عامة (الإصدار 0.8.0). راجع قائمة الإمكانات الجديدة للحصول على التفاصيل.

إذا كنت تستخدم إصدارات وكيل تحديث الجهاز 0.6.0 أو 0.7.0 يرجى الترحيل إلى أحدث إصدار وكيل 0.8.0. راجع عامل تحديث المعاينة العامة للاطلاع على التغييرات وكيفية الترقية

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

هوية الوحدة النمطية مقابل هوية الجهاز

في IoT Hub، تحت كل هوية جهاز، يمكنك إنشاء ما يصل إلى 50 هوية وحدة نمطية. كل هوية وحدة نمطية تولد ضمنيا توأم وحدة. من جانب الجهاز، تتيح لك أدوات تطوير البرامج (SDK) الخاصة بجهاز IoT Hub إنشاء وحدات حيث يفتح كل منها اتصالاً مستقلاً بـ IoT Hub. توفر هوية الوحدة النمطية وتوأم الوحدة إمكانات مماثلة لهوية الجهاز وتوأم الجهاز ولكن بدقة أدق. تعرف على المزيد حول هويات الوحدات النمطية في IoT Hub

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

دعم تحديث الجهاز

يتم حاليا دعم أنواع التحديث عبر الأثير التالية لأجهزة إنترنت الأشياء مع "تحديث الجهاز":

• أجهزة Linux (أجهزة IoT Edge وغير IoT Edge):

  • تحديث الصورة A/B
  • تحديث الحزمة
  • تحديث الوكيل للأجهزة النهائية

• الأجهزة المقيدة:

  • عينات وكيل تحديث جهاز AzureRTOS: تحديث الجهاز ل Azure IoT Hub البرنامج التعليمي ل Azure-Real-Time-Operating-System

• الأجهزة غير المتصلة:

  • فهم دعم تحديث الجهاز غير المتصل

المتطلبات الأساسية

إذا كنت تقوم بإعداد جهاز IoT/جهاز IoT Edge للتحديثات المستندة إلى الحزمة، فأضف packages.microsoft.com إلى مستودعات جهازك باتباع الخطوات التالية:

1. قم بتسجيل الدخول إلى الجهاز أو جهاز إنترنت الأشياء الذي تنوي تثبيت عامل تحديث الجهاز عليه.

2. افتح نافذة المحطة الطرفية.

3. قم بتثبيت تكوين المستودع الذي يطابق نظام تشغيل جهازك.

   curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
   

4. انسخ القائمة التي جرى توليدها إلى الدليل sources.list.d.

   sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
   

5. ثبِّت مفتاح عام Microsoft GPG.

   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
   

   sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
   

كيفية توفير عامل تحديث الجهاز كهوية وحدة نمطية

يوضح هذا القسم كيفية توفير عامل "تحديث الجهاز" كهوية وحدة نمطية على

• الأجهزة التي تدعم IoT Edge، أو
• أجهزة إنترنت الأشياء غير الحافة، أو
• أجهزة إنترنت الأشياء الأخرى.

للتحقق مما إذا كان لديك IoT Edge ممكنا على جهازك، يرجى الرجوع إلى إرشادات تثبيت IoT Edge.

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

على الأجهزة التي تدعم IoT Edge

اتبع هذه الإرشادات لتوفير عامل تحديث الجهاز على الأجهزة التي تدعم IoT Edge.

1. اتبع الإرشادات لتوفير جهاز Linux IoT Edge واحد يدويا.

2. قم بتثبيت عامل تحديث صورة تحديث الجهاز.

   نحن نقدم نماذج من الصور في مستودع الأصول هنا. ملف swUpdate هو الصورة الأساسية التي يمكنك وميضها على لوحة Raspberry Pi B3+ . ملف .gz هو التحديث الذي ستقوم باستيراده من خلال تحديث الجهاز لمركز إنترنت الأشياء. على سبيل المثال، راجع كيفية وميض الصورة على جهاز IoT Hub.

3. قم بتثبيت عامل تحديث حزمة تحديث الجهاز.

   • للحصول على أحدث إصدارات الوكيل من packages.miscrosoft.com: تحديث قوائم الحزم على جهازك وتثبيت حزمة وكيل تحديث الجهاز وتبعياتها باستخدام:

     sudo apt-get update
     

     sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt
     

   • بالنسبة لأي "rc" ، أي إصدار إصدارات الوكيل المرشح من القطع الأثرية : قم بتنزيل ملف .dep إلى الجهاز الذي تريد تثبيت عامل Device Update عليه ، ثم:

     sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEP FILE NAME>"
     

4. أنت الآن جاهز لبدء تشغيل عامل تحديث الجهاز على جهاز IoT Edge الخاص بك.

على أجهزة إنترنت الأشياء لينكس دون تثبيت IoT Edge

اتبع هذه الإرشادات لتوفير عامل تحديث الجهاز على أجهزة IoT Linux الخاصة بك.

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

2. قم بتكوين خدمة هوية إنترنت الأشياء باتباع الإرشادات الواردة في تكوين خدمة هوية Azure IoT.

3. أخيرا قم بتثبيت وكيل تحديث الجهاز. نحن نقدم نماذج من الصور في الأصول هنا ، وملف swUpdate هو الصورة الأساسية التي يمكنك وميضها على لوحة Raspberry Pi B3+ ، وملف .gz هو التحديث الذي ستقوم باستيراده من خلال تحديث الجهاز ل IoT Hub. اطلع على مثال حول كيفية وميض الصورة على جهاز IoT Hub.

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

    sudo nano /etc/adu/du-config.json
   

   قم بتغيير نوع الاتصال إلى "AIS" للوكلاء الذين سيستخدمون خدمة هوية إنترنت الأشياء للتوفير. يجب أن يكون الحقل ConnectionData سلسلة فارغة

5. أنت الآن جاهز لبدء تشغيل عامل تحديث الجهاز على جهاز إنترنت الأشياء الخاص بك.

أجهزة إنترنت الأشياء الأخرى

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

1. نحن نقدم نماذج من الصور في مستودع الأصول هنا. ملف swUpdate هو الصورة الأساسية التي يمكنك وميضها على لوحة Raspberry Pi B3+ . ملف .gz هو التحديث الذي ستقوم باستيراده من خلال تحديث الجهاز لمركز إنترنت الأشياء. على سبيل المثال، راجع كيفية وميض الصورة على جهاز IoT Hub.

2. قم بتسجيل الدخول إلى الجهاز أو جهاز IoT Edge / جهاز IoT.

3. افتح نافذة terminal.

4. أضف سلسلة الاتصال إلى ملف تكوين "تحديث الجهاز":

   1. أدخل ما يلي في نافذة المحطة الطرفية:

      • لاستخدام وكيل أوبونتو : سودو نانو / etc / adu / du-config.json
      • لاستخدام صورة مرجع Yocto : sudo nano /adu/du-config.json

   2. نسخ سلسلة الاتصال الأساسية

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

   3. أدخل سلسلة الاتصال الأساسية المنسوخة إلى قيمة حقل "connectionData" في ملف du-config.json. ثم احفظ الملف وأغلقه.

5. أنت الآن جاهز لبدء تشغيل عامل تحديث الجهاز على جهاز إنترنت الأشياء الخاص بك.

كيفية بدء تشغيل "عامل تحديث الجهاز"

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

1. سجل الدخول إلى الجهاز أو الجهاز الذي تم تثبيت عامل "تحديث الجهاز" عليه.

2. افتح نافذة المحطة الطرفية، وأدخل الأمر أدناه.

   sudo systemctl restart adu-agent
   

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

   sudo systemctl status adu-agent
   

   يجب أن ترى الحالة موافق.

4. على مدخل IoT Hub، انتقل إلى جهاز IoT أو أجهزة IoT Edge للعثور على الجهاز الذي قمت بتكوينه باستخدام عامل "تحديث الجهاز". هناك سترى وكيل تحديث الجهاز يعمل كوحدة نمطية. على سبيل المثال:

   

كيفية إنشاء وتشغيل عامل تحديث الجهاز

يمكنك أيضا إنشاء وكيل تحديث جهاز العميل الخاص بك وتعديله.

اتبع الإرشادات لإنشاء عامل تحديث الجهاز من المصدر.

بمجرد بناء الوكيل بنجاح ، فقد حان الوقت لتشغيل الوكيل.

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

دليل استكشاف الأخطاء وإصلاحها

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

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

يمكنك استخدام البرامج التعليمية التالية للحصول على عرض توضيحي بسيط لتحديث الجهاز ل IoT Hub:

• تحديث الصورة: البدء في استخدام Raspberry Pi 3 B + Reference Yocto Image القابل للتوسيع عبر مصدر مفتوح لإنشاء صورك الخاصة للهندسة المعمارية الأخرى حسب الحاجة.

• تحديث الحزمة: بدء استخدام وكيل حزمة Ubuntu Server 18.04 x64

• تحديث الوكيل: بدء استخدام العامل الثنائي "تحديث الجهاز" للأجهزة النهائية

• الشروع في استخدام أوبونتو (18.04 x64) وكيل مرجع محاكي

• تحديث الجهاز ل Azure IoT Hub البرنامج التعليمي ل Azure-Real-Time-Operating-System