Matter を使ってみる

Google の Home Developer プログラムでは、デバイス メーカーがスマートホーム デバイスを Google Home エコシステムに接続できます。Google は、スマートホーム アクションのローカル フルフィルメント パスを拡張し、Google Home app (GHA) を使用して Matter 対応デバイスを追加してセットアップし、Google AssistantGHAGoogle Nest Hub (2nd gen) などのスマートディスプレイを使用してデバイスを操作できるようになりました。

このドキュメントでは、Matter 対応プラットフォームを構築して Google Home エコシステムに統合する方法について説明します。

免責条項

Matter のドキュメントに記載されている手順については、次の点に注意してください。

  • 開発に使用するアカウントには、テスト用に Matter 対応のハブを 1 つだけ接続することをおすすめします。テスト中に複数の Matter 対応ハブを同時に接続したり、同じ構造に接続したりすると、予期しない動作が発生する可能性があります。
  • すべての手順では、Ubuntu 20.04 を実行している Linux マシンを使用して Matter サンプルをビルドしてフラッシュすることを前提としています。この手順は Google によってテストされています。macOS マシンはサポートされていますが、Linux をおすすめします。Mac 固有の手順は、必要に応じて手順で説明します。

作成方法

Google Home エコシステムと統合する Matter 対応デバイスを構築するには、Matter 互換のデベロッパー ボードと Matter SDK を使用します。

Codelab を使用するのが最も簡単な方法です。次のいずれかの Codelab を 1 つ以上実施することをおすすめします。

次に、サポートされているデバイスのリストで、統合するデバイスが Google Home エコシステムでサポートされていることを確認します。次に、デベロッパー チェックリストを読み、プロジェクトの作成からリリースまでの開発フローを把握します。

サポートされているデバイス デベロッパー チェックリスト

定義

このドキュメントでは、次の用語を使用します。

ボーダー ルーター
Thread 対応デバイス用の汎用 Thread ボーダー ルーターを実装するハブ。
ハブ
サポートされている Google Nest デバイス(Google Nest Hub (2nd gen) など)。Matter 対応デバイスを AssistantGHA、スマートディスプレイなどの他のサーフェスから操作するには、ハブが必要です。
Matter 対応デバイス
Matter 対応のビルドまたはサンプルアプリが書き込まれたデバイスまたは開発ボード。
モバイル デバイス
ペア設定に使用したテスト用スマートフォン。現在、これは Android スマートフォンです。

前提条件

Matter 開発に推奨される IDE 拡張機能

Matter 対応デバイスを Google Home エコシステムと完全に統合するには、デベロッパーは次の要件を満たしている必要があります。

  1. Thread 対応の Google ハブ: Thread 対応デバイスのボーダー ルーターと、スマートホーム インテントのルーティング用のローカル フルフィルメント パスの両方として機能します。
  2. 以下の最小要件を満たすモバイル デバイス(テスト用スマートフォン):
    • Android O(8.1、API レベル 27 以降)
    • iOS(v16.5 以降)
    • BLE の機能
  3. Matter 対応デバイスのベンダー ID(VID)プロダクト ID(PID)
  4. Matter 対応デバイス。このデバイスは、Google Home エコシステムでサポートされている Matter デバイスタイプのいずれかである必要があります。たとえば、次のデバイスが該当します。
    • Matter 対応のファームウェアを搭載した独自のプロダクト。
    • エンドツーエンドの検証に使用する次のいずれかの Matter デバイス:
表: シリコン ベンダーの Matter の例
ベンダー プラットフォーム Thread のサポート ガイド
Bouffalo Lab BL602
BL702
Espressif ESP32 OTA テスト
Nordic Semiconductor nRF52840 DK OTA テスト
NXP IOTZTB-DK006 開発キット
Realtek Ameba D シリーズ
Silicon Labs EFR32MG24 開発キット
EFR32MG Zigbee と Thread のスターターキット
Telink TLSR9518
Texas Instruments CC2652R7 LaunchPad 開発キット

ベンダー ID

デフォルトでは、CSA によって割り振られた VID のいずれかをテスト目的で使用できます。0xFFF10xFFF20xFFF30xFFF4 のいずれかを選択します。

本番環境の VID を使用して統合を認定およびリリースするには、まず Google で VID が CSA から発行されていることを確認する必要があります。

この VID はデバイスのファームウェアに実装する必要があります。

Matter デバイスは、特定のベンダー ID とデバイスタイプのシナリオでのみ、Google Home エコシステムでペア設定できます。

  • テスト用の VID は一般ユーザー向けデバイスでは使用できません。
  • 製品版 VID は Connectivity Standards Alliance (Alliance) によって発行されている必要があります。Google Home Developer Console で VID を使用できるようになる前に、その VID の所有者であることを Google が確認します。その後、その VID の統合を作成できるようになります。
  • 開発とフィールド トライアルの目的で、対応する VID と PID の組み合わせを持つプロジェクトと統合を Developer Console に作成する必要があります。デバイスを構成するユーザーは、プロジェクトのメンバーであるか、フィールド トライアル ユーザーのリストに登録されている必要があります。
  • 一般ユーザーは、Alliance によって認定された製品のみを使用できます。

VID と PID は、1 回の統合につき 1 回しか使用できません。統合で同じ VID または PID を使用する場合は、次のいずれかを行う必要があります。

  • VID または PID を使用して統合を編集し、別の VID または PID に変更します。
  • VID または PID を使用して統合を削除します。
表: ベンダー ID(VID)とデバイスタイプのペア設定シナリオ
Google Home エコシステムにデバイスを組み込むことができるユーザーはどのようなタイプですか?
VID の種類 VID 認定とコンソール統合のステータス 本番環境
(一般ユーザー)
開発
(デベロッパー、フィールド トライアル ユーザー)
テスト Developer Console に統合なし(認定不可)
テスト Developer Console に統合が存在する(認定不可)
本番環境 認定されていません。Developer Console に統合が存在しません。
本番環境 認定なし。Developer Console に統合が存在します。
本番環境 Alliance DCL で認定されていますが、Developer Console に統合はありません。
本番環境 Alliance DCL で認定されており、Developer Console に統合が存在する

商品 ID

デバイスに関する情報は、Matter 基本情報クラスタから読み取られます。デバイスのファームウェアにエンコードされた商品 ID は、Developer Console の Matter 統合の商品 ID と一致している必要があります。

サポートされていない機能

一部の Matter クラスタは、システムで使用される可能性がありますが、まだユーザーに公開されていません。ほとんどの場合、これらのクラスタを通じて公開される属性はエンドユーザーには表示されません。

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ オン/オフの照明スイッチへの影響については、オン/オフの照明スイッチをご覧ください。