توفير وكيل تحديث الجهاز

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

التغييرات التي تم إجراؤها على عامل تحديث الجهاز في إصدار GA

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

يمكنك التحقق من الإصدار المثبت من وكيل Device Update ووكيل Delivery Optimization في قسم Device Properties (خصائص الجهاز) في جهاز IoT المزدوج. تعرف على المزيد حول خصائص الجهاز من خلال واجهة ADU الأساسية .

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

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

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

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

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

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

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

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

  • نماذج عامل Eclipse ThreadX Device Update: البرنامج التعليمي لتحديث الجهاز ل Azure IoT Hub لنظام التشغيل Azure-Real-Time

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

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

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

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

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

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 الأخرى.

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

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

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

اتبع هذه التعليمات لتزويد وكيل Device Update على الأجهزة التي تدعم IoT Edge .

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

2. قم بتثبيت وكيل تحديث صورة Device Update (تحديث الجهاز).

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

3. قم بتثبيت وكيل تحديث حزمة Device Update (تحديث الجهاز).

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

     sudo apt-get update
     

     sudo apt-get install deviceupdate-agent
     

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

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

   • إذا كنت تقوم بإعداد MCC لسيناريو جهاز غير متصل، فقم بتثبيت المكون الإضافي ل Delivery Optimization APT:

     sudo apt-get install deliveryoptimization-plugin-apt
     

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

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

   قم بتغيير نوع الاتصال إلى "AIS" للوكلاء الذين سيستخدمون خدمة هوية IoT للتزويد. يجب أن يكون حقل الاتصال ionData سلسلة فارغة. يرجى ملاحظة أنه يجب تعيين كافة القيم التي تحتوي على علامة "Place value here". راجع تكوين عامل DU.

5. أنت الآن جاهز لبدء تشغيل وكيل Device Update على جهاز IoT الخاص بك.

على أجهزة Iot Linux بدون تثبيت IoT Edge

اتبع هذه الإرشادات لتزويد وكيل Device Update (تحديث الجهاز) على أجهزة IoT Linux.

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

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

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

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

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

   قم بتغيير نوع الاتصال إلى "AIS" للوكلاء الذين سيستخدمون خدمة هوية IoT للتزويد. يجب أن يكون حقل الاتصال ionData سلسلة فارغة. يرجى ملاحظة أنه يجب تعيين كافة القيم التي تحتوي على علامة "Place value here". راجع تكوين عامل DU.

5. أنت الآن جاهز لبدء تشغيل وكيل Device Update على جهاز IoT الخاص بك.

أجهزة IoT الأخرى

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

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

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

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

4. أضف سلسلة الاتصال إلى ملف تكوين Device Update :

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

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

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

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

   3. أدخل سلسلة الاتصال الأساسية المنسوخة إلى قيمة حقل 'connectionData' في ملف du-config.json. يرجى ملاحظة أنه يجب تعيين كافة القيم التي تحتوي على علامة "Place value here". راجع تكوين عامل DU

5. الآن أنت جاهز لبدء تشغيل وكيل Device Update على جهاز IoT الخاص بك.

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

يصف هذا القسم كيفية بدء وكيل Device Update والتحقق منه كهوية وحدة تعمل بنجاح على جهاز IoT الخاص بك.

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

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

   sudo systemctl restart deviceupdate-agent
   

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

   sudo systemctl status deviceupdate-agent
   

   يجب أن ترى الحالة بشكل جيد.

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

   

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

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

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

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

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

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

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

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

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

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

• البدء في استخدام Ubuntu (18.04 × 64) الوكيل المرجعي للمحاكاة

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