OTA ファームウェア アップデート イメージは、Matter OTA ソフトウェア イメージ ファイル形式に準拠している必要があります。これには次のものが含まれます。
- ファイルが Matter ファームウェア アップデート ファイルであることを一意に識別するファイル識別子
- ファイルのサイズ
- ヘッダーサイズ
- アップデートに関する情報を含む 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 イメージを追加**] をクリックします。
[Upload] をクリックして、イメージ ファイルを選択して アップロードします。
イメージが正常に検証されると、 [アップロード] ボタンの下にファイル名が表示されます。
OTA イメージは、アップロード後すぐに配布できます。
OTA イメージの説明を追加または変更する
Matter > OTA に移動します。
[管理] タブで、変更するイメージの横にある [開く] をクリックします。
[OTA イメージの詳細] ダイアログで、イメージの説明を変更できます。
[キャンセル] または [保存] をクリックします。
OTA イメージを削除する
リリース済みの OTA イメージは削除できません。削除できるのは準備完了状態のイメージのみです。準備完了状態の OTA イメージを削除するには:
Matter > OTA に移動します。
[管理] タブで、OTA イメージの横にある [その他] メニューをクリックし、[削除] を選択します。