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

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

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

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

כניסה ל-Developer Console

1. פותחים את הפרויקט ואז פותחים את המכשיר.

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

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

4. בכרטיסייה ניהול, לוחצים על addהוספת תמונה של סוכנות נסיעות אונליין.

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

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

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

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

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

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

3. בתיבת הדו-שיח פרטי תמונה ב-OTA, אפשר לשנות את תיאור התמונה.

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

מחיקה של תמונת OTA

אי אפשר למחוק תמונת OTA שנמצאת במצב Released (הופצה), אפשר למחוק רק תמונות שנמצאות במצב Ready (מוכנה). כדי למחוק תמונת OTA במצב Ready:

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

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