OTA ファームウェア アップデート イメージは、Matter OTA ソフトウェア イメージ ファイル形式に準拠している必要があります。ファイル形式には以下が含まれます。
- ファイルが Matter ファームウェア アップデート ファイルであることを一意に識別するファイル識別子
- ファイルのサイズ
- ヘッダーサイズ
- タグの長さの値(TLV)でエンコードされたヘッダー。次の情報が含まれます。
- 車両識別番号
- 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 イメージは、アップロード後すぐに配布できるようになります。