إعداد صورة عبر OTA

يجب أن تتوافق صور تحديث البرامج الثابتة عبر الهواء (OTA) مع Matter تنسيق ملف صورة برنامج OTA ، والذي يتضمّن ما يلي:

  • معرّف ملف يحدّد الملف بشكل فريد على أنّه ملف تحديث للبرامج الثابتة Matter
  • حجم الملف
  • حجم العنوان
  • رأس بترميز "العلامة والطول والقيمة" (TLV) يحتوي على معلومات حول التحديث، بما في ذلك:
    • VID
    • PID
    • إصدار البرنامج
  • الحمولة

توفّر حزمة تطوير البرامج (SDK) Matter أداة لإنشاء صور Matter عبر الأثير (OTA) وفحصها (ota_image_tool.py). ويمكن لبعض أنظمة الإصدار إنشاء صور Matter عبر الأثير (OTA) تلقائيًا، لذا يُرجى الرجوع إلى مستندات نظام التشغيل على الشريحة.

إنشاء صورة OTA

استخدِم ota_image_tool.py لإنشاء الصورة:

$ ./ota_image_tool.py create \
  -v hexVendorId \
  -p hexProductId \
  -vn versionNumber \
  -vs "versionString" \
  -da "hash-function \
  path_to_binary \
  path_to_ota_file

للتحقّق من مجموعة البيانات الوصفية وعنوان الملف، شغِّل النص البرمجي باستخدام الأمر show:

$ ./ota_image_tool.py show path_to_ota_file

مثال على الإخراج:

Magic: 1beef11e
Total Size: 90
Header Size: 62
Header TLV:
  [0] Vendor Id: XXXX (0xXX)
  [1] Product Id: XXX (0xXX)
  [2] Version: 101 (0x65)
  [3] Version String: 1.0.1
  [4] Payload Size: 12 (0xc)
  [8] Digest Type: 1 (0x1)
  [9] Digest: a948904f2f0f429b8f8197694b30184b0d2ed1c3cd2a1ec0fb85d299a193a447

تحميل نسخة شبكة غير سلكية (OTA)

لتحميل الصورة إلى Google Home Developer Console، اتّبِع الخطوات التالية:

الانتقال إلى Play Console

  1. افتح مشروعك، ثم افتح جهازك.

  2. انتقِل إلى Matter > OTA.

  3. انقر على إدارة التحديث عبر الأثير (OTA) بجانب الجهاز في قائمة عمليات الدمج.

  4. في علامة التبويب إدارة، انقر على إضافة صورة OTA.

مربّع الحوار الخاص بتحميل صورة تحديث Matter عبر اتصال لاسلكي

  1. انقر على تحميل لاختيار ملف الصورة وتحميله.

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

تتوفّر صورة OTA للتوزيع بعد وقت قصير من تحميلها.

إضافة وصف لصورة وكالة سفر على الإنترنت أو تعديله

  1. انتقِل إلى Matter > OTA.

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

  3. في مربّع الحوار تفاصيل صورة OTA، يمكنك تغيير وصف الصورة.

  4. انقر على إلغاء أو حفظ.

حذف صورة OTA

لا يمكنك حذف صورة OTA في حالة "تم الإصدار"، ولكن يمكنك حذف الصور في حالة "جاهزة" فقط. لحذف صورة OTA في حالة "جاهزة"، اتّبِع الخطوات التالية:

  1. انتقِل إلى Matter > OTA.

  2. في علامة التبويب إدارة، انقر على قائمة "المزيد" بجانب صورة OTA واختَر حذف.