OTA イメージを準備する

OTA ファームウェア アップデート イメージは、Matter OTA ソフトウェア イメージ ファイル形式に準拠している必要があります。この形式には次のものがあります。

  • Matter ファームウェア アップデート ファイルであることを一意に識別するファイル ID
  • ファイルのサイズ
  • ヘッダーのサイズ
  • 更新に関する情報(以下を含む)を含むタグ長値(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 にアップロードするには:

Developer Console に移動する

  1. プロジェクトを開き、デバイスを開きます。

  2. [Matter] > [OTA] に移動します。

  3. [Integrations] リストでデバイスの横にある [Manage OTA] をクリックします。

  4. [管理] タブで、 [OTA イメージを追加] をクリックします。

Matter OTA イメージのアップロード ダイアログ

  1. [アップロード] をクリックして、画像ファイルを選択してアップロードします。

    イメージが正常に検証されると、ファイル名が [アップロード] ボタンの下に表示されます。

OTA イメージは、アップロード後すぐに配布できます。

OTA イメージの説明を追加または変更する

  1. [Matter] > [OTA] に移動します。

  2. [管理] タブで、変更する画像の横にある [開く] をクリックします。

  3. [OTA イメージの詳細] ダイアログで、イメージの説明を変更できます。

  4. [キャンセル] または [保存] をクリックします。

OTA イメージを削除する

リリース済み状態の OTA イメージは削除できません。削除できるのは準備完了状態の OTA イメージのみです。準備完了状態の OTA イメージを削除するには:

  1. [Matter] > [OTA] に移動します。

  2. [管理] タブで、OTA イメージの横にある [その他] メニューをクリックし、[削除] を選択します。