מכינים תמונת 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. פותחים את הפרויקט ואז פותחים את המכשיר.

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

3. לוחצים על Manage OTA (ניהול OTA) לצד המכשיר ברשימת Integrations (שילובים).

4. בכרטיסייה ניהול, לוחצים על addהוספת קובץ אימג' של OTA.

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

   אחרי שהאימות של התמונה יושלם, שם הקובץ שלה יופיע מתחת ללחצן attach_fileUpload.

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

הוספה או שינוי של תיאור של תמונה ב-OTA

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

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

3. בתיבת הדו-שיח פרטי קובץ האימג' לעדכון אופליין, אפשר לשנות את תיאור התמונה.

4. לוחצים על ביטול או על שמירה.

מחיקת קובץ אימג' לעדכון OTA

אי אפשר למחוק קובץ אימג' לעדכון OTA במצב 'פורסם', אפשר למחוק רק קובצי אימג' במצב 'מוכן'. כדי למחוק קובץ אימג' לעדכון OTA במצב 'מוכן':

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

2. בכרטיסייה Manage, לוחצים על תפריט האפשרויות הנוספות more_vert לצד קובץ האימג' של ה-OTA ובוחרים באפשרות Delete.