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

يجب أن تتوافق صور تحديث البرامج الثابتة عبر الاتصال بشبكة لاسلكية مع تنسيق ملف صورة برنامج "Matter" عبر الاتصال بشبكة لاسلكية، والذي يتضمّن ما يلي:

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

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

إنشاء نسخة شبكة غير سلكية (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:

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

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

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

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

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

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

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

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

إضافة وصف صورة OTA أو تعديله

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

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

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

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

حذف نسخة شبكة غير سلكية (OTA)

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

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

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