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

תמונות עדכון קושחה של OTA חייבות להתאים לMatterפורמט הקובץ של תמונת התוכנה של OTA, כולל:

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

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

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

3. בדף תצורת OTA, לוחצים על הכרטיסייה תמונות.

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

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

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

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

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