重要な仮想デバイス

デバイス SDK

Matter 仮想デバイスは、Matter ソリューションの開発とテストに有用で、物理 Matter デバイスと同様に、Google Home app (GHA) を使用してコミッショニングし、GHAGoogle Assistant を使用して制御できます。

仮想 Matter デバイスをテストまたはエミュレートする必要があるが、独自の物理または仮想デバイスを構築するためのリソースがないアプリ デベロッパーのために、Google は Matter Virtual Device (MVD) を提供しています。MatterMVD は軽量のスタンドアロンの Linux または macOS デスクトップ ツールで、さまざまな種類の仮想 Matter デバイスをシミュレートし、仮想 Matter デバイスの状態を制御して表示するためのグラフィカル ユーザー インターフェースを提供します。

物理的な Matter デバイスとは異なり、MVDMatter ファブリックに接続するために Bluetooth® Low Energy(BLE)や Thread® に依存しません。代わりに、ホストの Linux または macOS マシンの既存の Wi-Fi ネットワーク接続を使用してコミッショニングを行います。

他のツールとの比較

MVD は、自己完結型のソリューションであるという点で Virtual Device Controller (VDC) と異なり、仮想デバイスとそれを制御する UI を組み合わせています。一方、VDC は、Matter Virtual Device Development Environment (MVD-DE) で構築したデバイスなど、個別の仮想 Matter デバイスの制御に使用されます。

MVD-DE Codelab をすでに学習しているかもしれません。この Codelab では、1 種類の仮想デバイス(スマート電球)を作成します。一方、MVD には複数のビルド済み仮想デバイスが含まれており、それらを実行して制御するための統合 UI が含まれています。

表: 仮想 Matter デバイスのツールの比較
MVD VDC MVD-DE(Codelab)
Matter デバイスをエミュレートする
エミュレートされた Matter 対応デバイスを操作する
デプロイ作業が必要
ダウンロード 100 MB 未満 9 GB 20 GB

サポートされているデバイス

MVD は、次の Matter デバイスタイプをサポートしています。

表: MVD でサポートされている Matter デバイスタイプ
Matter デバイスタイプ アプリケーション クラスタ ホーム エコシステムの種類
基本的な動画プレーヤー 0x0006
0x0506
0x0509
テレビ
色温度ライト 0x0300
0x0008
0x0006
ライト
接触センサー 0x0045
センサー
調光可能ライト 0x0008
0x0006
ライト
ドアロック 0x0101
ロック
エクステンデッドカラーライト 0x0300
0x0008
0x0006
ライト
素敵 0x0202
0x0006
ファン
フローセンサー 0x0404
センサー
汎用スイッチ 0x003b
スイッチ
湿度センサー 0x0405
センサー
照度センサー 0x0400
センサー
在宅センサー 0x0406
センサー
オン/オフライト 0x0008
0x0006
ライト
オン/オフライト スイッチ 0x0006
スイッチ
オン/オフ・プラグイン・ユニット 0x0008
0x0006
コンセント
圧力センサー 0x0403
センサー
ポンプ 0x0006
0x0200
0x0402
0x0403
0x0404
該当なし
ロボット掃除機 0x0054
0x0055
0x0061
掃除機
ルーム エアコン 0x0006
0x0201
0x0202
AC
煙一酸化炭素警報 0x005C
スモーク
温度センサー 0x0402
センサー
サーモスタット 0x0201
サーモスタット
窓カバー 0x0102
ブラインド

MVD をインストールする

MVD は、Debian(11 以降)、Ubuntu(20.04 以降)、macOS が動作する 64 ビット x86 プロセッサ マシンで動作します。

Linux

MVD Debian(.deb)パッケージをダウンロードする

armored-ASCII 署名(.asc)ファイルをダウンロードする

次に、dpkg を実行して MVD Debian(.deb)パッケージをインストールします。

sudo dpkg -i mvd_1.4.0_amd64.deb

macOS

MVD(macOS x86)の dmg ファイルをダウンロードする

MVD(ARM64 M1)の dmg ファイルをダウンロードする

次に、dmg ファイルをダブルクリックしてインストール ウィンドウを開きます。

インストールを完了するには、mvd アイコンを選択して Applications フォルダにドラッグします。

macOS のインストール

ポートの使用状況を確認する

MVD のコントローラ モジュールは、TCP ポート 33000 を使用して仮想デバイスに対して RPC 呼び出しを行うため、このポートがパソコンの別のプロセスですでに使用されている場合は、必ず解放してください。

プロセスがポート 33000 を使用しているかどうかを確認するには:

Linux

sudo fuser -v 33000/tcp

macOS

lsof -i:33000

TCP ポート 33000 を使用しているプロセスを 1 つのコマンドで強制終了できます。

Linux

sudo fuser -k 33000/tcp

macOS

lsof -ti:33000 | xargs kill

MVD の実行

Linux

Linux では、アプリケーション フォルダまたはターミナルから MVD を実行します。

mvd

macOS

macOS の場合、Launchpad を使用して MVD を開くか、ターミナルから MVD を実行します。

cd /Applications
open mvd.app

デバイスの設定

メイン画面は起動時に表示され、仮想デバイスを設定できます。

  • Device Type: デバイスの種類(ライト、スイッチ、センサーなど)を選択します。
  • デバイス名: デバイスにわかりやすい名前を付けます。
  • 弁別子: 複数のコミッション可能なデバイスの広告を区別するために使用される 12 ビットの数値。(デフォルト: 3840)。
  • Matter ポート: Matter のコミッショニングと IP ネットワークを介した通信用のポート。Matter はデフォルトで TCP/UDP ポート 5540 を使用しますが、他のサービスがポートを使用していない限り、別のポートを使用するように仮想デバイスを構成できます。
  • ベンダー ID: テストベンダー ID 0xFFF1 のみがサポートされています。
  • プロダクト ID: テスト プロダクト ID 0x80000x801F のみがサポートされています。

[Virtual Device Configuration] 画面

ファイアウォールを構成する

Linux

コンピュータでファイアウォールが実行されている場合は、ファイアウォールをシャットダウンするか、Matter ポートでの受信 TCP/UDP 接続を許可します。

現在アクティブな netfilter ファイアウォール ルールを表示するには、次のコマンドを実行します。

sudo iptables -L -n

「ufw」を使用している場合は、次のコマンドで無効にできます。

sudo ufw disable

以下の方法で再度有効にできます。

sudo ufw enable

macOS

macOS でファイアウォールを設定または無効にするには:

  1. Apple メニューを開き、[システム設定] を選択します。
  2. サイドバーのリストで [ネットワーク] をクリックします。
  3. [ファイアウォール] をクリックします。
  4. [ファイアウォール] のスイッチをオフの位置に切り替えます。

デバイスを実行する

デバイスを設定したら、[デバイスを作成] をクリックします。デバイスが作成されると、[Controller] 画面が表示されます。選択したデバイスの種類に応じて、次のコントロールが 1 つ以上表示されます。

  • オン/オフ: 大部分のデバイスに共通です。
  • レベル: たとえば、ライトには明るさを調整するためのレベル スライダーなどが考えられます。
  • : たとえば、カラーライトの場合はこのコントロールを指定できます。
  • 占有率: 在室確認センサーは、在室状況をシミュレートするために、このコントロールを提供します。

すべての仮想デバイスでは、次のコントロールを利用できます。

  • QRCode: コミッショニングに使用される QR コードが表示されます。
  • 再起動: 仮想デバイスを再起動します。デバイスがネットワークから一時的に切断されます。
  • リセット: 現在のデバイスを出荷時の設定にリセットし、コミッショニング、現在の制御状態など、すべての状態を消去します。
  • 削除: デバイスを破棄して、[デバイスの作成] 画面に戻ります。

仮想デバイスのコントロール画面

デバイスをコミッショニングする

デバイスは、作成後すぐにコミッショニング可能になります。

デバイスのコミッショニングには、いくつかの前提条件があります。

  • Google Home Developer Console にプロジェクトが必要です。このプロジェクトには、仮想デバイスの設定に使用したものと同じ VID/PID の組み合わせを持つ Matter 統合が含まれている必要があります。詳しくは、プロジェクト作成ガイドをご覧ください。

  • Matter 対応の Google Nest Hub が必要です。

  • Android 8.1 以降を搭載し、GHA がインストールされている Android スマートフォンが必要です。

  • Android スマートフォンがハブと同じ Wi-Fi ネットワークに接続されている必要があります。

  • ホストマシンが Wi-Fi ネットワークに接続されている必要があります。

GHA を使用してデバイスをコミッショニングするには、[QRCode] をクリックしてデバイスの QR コードを表示し、GHA を使用して Matter デバイスをオンボーディングする方法を説明している Matter デバイスをペア設定するの手順を行います。Google Home Sample App for Matter を使用してデバイスをコミッショニングすることもできます。

Matter のコミッショニングの仕組みについては、Matter 入門をご覧ください。

デバイスを操作する

仮想デバイスをコミッショニングすると、Google Home アプリまたは Google アシスタントを音声で使用してデバイスを制御できます。次のいずれかの方法でご対応ください。

  • 仮想デバイスの状態変化をモニタリングしながら、GHA または Assistant でデバイスを制御します。
  • 仮想デバイスの状態変化をモニタリングしながら、Sample App for Matter を使用してデバイスを制御する。
  • GHA または Assistant で状態の変化をモニタリングしながら、MVD 自体を使用してデバイスの状態を制御します。

デバイスでテストする

Assistant でテストするには、VS Code 用 Google Home 拡張機能Android Studio 用 Google Home Plugin などの発話シミュレータを使用することをおすすめします。

デバイスの詳細を表示する

[デバイスの詳細] 画面には、詳細なデバイス情報が表示されます。

  • 名前: デバイスに付けられたわかりやすい名前。
  • Device Type: 選択したデバイスの種類。
  • 弁別子: 現在のデバイスの弁別子。
  • ベンダー ID: 現在のデバイス ベンダー ID。
  • プロダクト ID: 現在のデバイスのプロダクト ID。
  • RPC ポート: デバイスがコントローラ(GUI)と通信する RPC ポート。
  • Matter Port: 現在のデバイスが IP ネットワークを介して通信するために使用するポート。
  • Pass Code(パスコード): ネットワーク経由でデバイスをコミッショニングする際に使用する PIN。
  • 構成フォルダ: 仮想デバイスが構成を保存するフォルダ。
  • コミッション情報: デバイスが参加したファブリックと、ファブリック内のデバイスのノード ID が表示されます。

デバイスのログを表示する

ターミナルから MVD を起動した場合、ログ出力は stdout に表示されます。[デバイスのログ] タブでも、デバイスのログを確認できます。

デバイスを停止する

デバイスを停止して破棄するには、[削除] をクリックします。

アプリを終了する

コントロール ウィンドウを閉じると、デバイスは破棄され、MVD アプリは終了します。ターミナルから起動した場合は、ターミナルで Ctrl-C キーを押してアプリケーションを終了することもできます。

ヘルプを参照する

MVD に関するサポートが必要な場合、バグを報告する場合、または新機能をリクエストする場合は、Google サポート担当者にご連絡ください。

ウィンドウの右上にあるヘルプ ボタンをクリックすると、このページに移動します。

バグを報告

MVD に欠陥を見つけたと思われる場合は、ウィンドウの右上にある問題 ボタンをクリックしてバグを報告できます。

フィードバックの送信

MVD の気に入った点や、ツールの使い勝手についてご意見をお聞かせください。フィードバック フォームにご記入ください。

フォームは、ウィンドウの右上にあるフィードバック ボタン から、または下のボタンをクリックして起動できます。

フィードバックを送信