Image update firmware OTA harus sesuai dengan OTA Matter Format file Software Image, yang meliputi:
- Pengenal file yang secara unik mengidentifikasi file sebagai sebuah File update firmware Matter
- Ukuran file
- Ukuran {i>header<i}
- Header berenkode Tag-length-value (TLV) yang berisi informasi tentang
pembaruan, termasuk:
- VID
- PID
- versi software
- Payload
Matter SDK menyediakan alat untuk membuat dan memeriksa
Matter image OTA
(ota_image_tool.py
).
Beberapa sistem build dapat membuat image OTA Matter
secara otomatis, jadi periksa
dokumentasi SoC Anda.
Membuat image OTA
Gunakan ota_image_tool.py
untuk membuat gambar:
$ ./ota_image_tool.py create \
-v hexVendorId \
-p hexProductId \
-vn versionNumber \
-vs "versionString" \
-da "hash-function \
path_to_binary \
path_to_ota_file
Untuk memverifikasi set metadata dan header file, jalankan skrip dengan kode
Perintah show
:
$ ./ota_image_tool.py show path_to_ota_file
Contoh output:
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
Mengupload image OTA
Untuk mengupload gambar ke Google Home Developer Console:
Buka Matter > OTA.
Klik Kelola di samping perangkat dalam daftar Perangkat.
Di halaman OTA Configuration, klik tab Images.
Klik Gambar Baru.
Beri nama pada gambar tersebut, lalu klik Lampirkan Gambar untuk memilih dan mengupload file gambar.
Setelah gambar berhasil divalidasi, klik Simpan.
Saat dialog konfirmasi muncul, klik Simpan untuk membuat gambar yang tersedia untuk perangkat, atau klik Batal untuk membatalkan pengiriman.
Image OTA tersedia untuk didistribusikan segera setelah diupload.