Matter を使ってみる

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

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

免責条項

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 ボーダー ルーターを実装するハブ。
Hub
サポートされている Google Nest デバイス(Google Nest Hub (2nd gen) など)。AssistantGHA、スマートディスプレイなどの他のサーフェスから Matter 対応デバイスを操作するには、ハブが必要です。
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 のサポート ガイド
ブーファロー研究所 BL602
BL702
エスプレッシフ ESP32 OTA テスト
Nordic Semiconductor(ノルディック セミコンダクター) nRF52840 DK OTA テスト
NXP IOTZTB-DK006 開発キット
Realtek Ameba D シリーズ
Silicon Labs EFR32MG24 開発キット
EFR32MG Zigbee および Thread スターター キット
テリンク TLSR9518
Texas Instruments CC2652R7 LaunchPad 開発キット

ベンダー ID

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

本番環境 VID を使用して統合の認定とリリースを行うには、まず Google による検証を受け、CSA によって発行されたものであることを確認する必要があります。

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

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

  • テスト用 VID は一般ユーザー向けデバイスで使用できません。
  • 本番環境 VID は Connectivity Standards Alliance (Alliance) によって発行されたものである必要があります。Google Home Developer Console で使用する VID の所有者であることを Google が検証します。その後、その VID の統合を作成できるようになります。
  • 開発とフィールド トライアルの目的で、対応する VID と PID の組み合わせを持つプロジェクトと統合を Developer Console に作成する必要があります。デバイスをコミッショニングするユーザーは、プロジェクトのメンバーであるか、フィールド トライアルのユーザーのリストに含まれている必要があります。
  • 一般ユーザーは、Alliance によって認定されたプロダクトのみを使用できます。
表: ベンダー 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 が、Play 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.

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