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

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

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

ה-SDK של Matter מספק כלי ליצירה ולבדיקה של תמונות 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:

כניסה אל Developer Console

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

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

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

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

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

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

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

תמונת ה-OTA זמינה להפצה זמן קצר לאחר ההעלאה.