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

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

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

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

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