تصاویر به‌روزرسانی سفت‌افزار OTA باید با قالب فایل تصویر نرم‌افزار Matter OTA مطابقت داشته باشد که شامل موارد زیر است:
- شناسه فایلی که فایل را به‌طور منحصربه‌فرد به‌عنوان فایل به‌روزرسانی سفت‌افزار Matter شناسایی می‌کند
- اندازه فایل
- اندازه سرصفحه
- سرصفحه کدگذاری‌شده Tag-length-value (TLV) حاوی اطلاعاتی درباره
به‌روزرسانی، ازجمله:
- VID
- PID
- نسخه نرم‌افزار
- پایه‌بار
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:
پروژه‌تان را باز کنید، سپس دستگاهتان را باز کنید.
به Matter > OTA بروید.
روی مدیریت OTA در کنار دستگاه در فهرست ادغام‌ها کلیک کنید.
در برگه مدیریت، روی افزودن تصویر OTA کلیک کنید.
روی بارگذاری کلیک کنید تا فایل تصویری را انتخاب و بارگذاری کنید.
وقتی تصویر با موفقیت اعتبارسنجی شد، نام فایل آن زیر دکمه بارگذاری ظاهر می‌شود.
تصویر OTA کمی پس‌از بارگذاری برای توزیع دردسترس است.
افزودن یا اصلاح شرح تصویر OTA
به Matter > OTA بروید.
در برگه مدیریت، روی باز کردن در کنار تصویری که می‌خواهید اصلاح کنید کلیک کنید.
در کادر گفتگوی جزئیات تصویر OTA، می‌توانید شرح تصویر را تغییر دهید.
روی لغو یا ذخیره کلیک کنید.
حذف کردن تصویر OTA
نمی‌توانید تصویر OTA را که در وضعیت «منتشرشده» است حذف کنید، فقط می‌توانید تصاویری را که در وضعیت «آماده» هستند حذف کنید. برای حذف کردن تصویر OTA در وضعیت «آماده»:
به Matter > OTA بروید.
در برگه مدیریت، روی منو «بیشتر» در کنار تصویر OTA کلیک کنید و حذف را انتخاب کنید.