מכינים תמונת OTA

קובצי אימג' של עדכוני קושחה ב-OTA חייבים להיות תואמים לפורמט הקובץ Matter OTA Software Image, שכולל:

• מזהה קובץ שמזהה את הקובץ באופן ייחודי כקובץ עדכון קושחה של Matter
• גודל הקובץ
• גודל הכותרת
• כותרת עם קידוד Tag-length-value (TLV) שמכילה מידע על העדכון, כולל:
  • VID
  • PID
  • גרסת התוכנה
• המטען הייעודי (payload)

Matter SDK מספק כלי ליצירה ולבדיקה של קובצי אימג' OTA של Matter (ota_image_tool.py). חלק ממערכות ה-build יכולות ליצור קובצי אימג' 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:

כניסה למסוף הפיתוח

1. עוברים אל Matter > OTA.

2. לוחצים על ניהול לצד המכשיר ברשימת המכשירים.

3. בדף OTA Configuration, לוחצים על הכרטיסייה Images.

4. לוחצים על תמונה חדשה.

1. נותנים שם לתמונה ולוחצים על צירוף תמונה כדי לבחור את קובץ התמונה ולהעלות אותו.

2. אחרי שהאימות של התמונה מסתיים, לוחצים על שמירה.

3. כשתיבת הדו-שיח לאישור מופיעה, לוחצים על שמירה כדי שהתמונה תהיה זמינה במכשירים, או על ביטול כדי לבטל את השליחה.

קובץ האימג' לעדכון OTA יהיה זמין להפצה זמן קצר אחרי ההעלאה.