Matter 仮想デバイス

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

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

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

他のツールとの比較

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

MVD には、いくつかの異なる事前構築済みの仮想デバイスが含まれており、それらを実行して制御するための統合 UI が含まれています。

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

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

MVD を取り付ける

MVD は、Debian（13 Trixie 以降）、Ubuntu（20.04 Noble Numbat 以降）、または macOS を搭載した 64 ビット x86 プロセッサ マシンで動作します。

Linux

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

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

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

sudo dpkg -i mvd_1.7.0_amd64.deb

macOS

MVD（macOS x86）dmg ファイルをダウンロードする

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

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

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

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

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

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

sudo fuser -v 33000/tcp

lsof -i:33000

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

sudo fuser -k 33000/tcp

lsof -ti:33000 | xargs kill

MVD を実行する

mvd

cd /Applications
open mvd.app

デバイスを設定する

起動するとメイン画面が表示され、仮想デバイスを構成できます。

• Device Type: デバイスタイプ（Light、Switch、Sensor など）を選択します。
• デバイス名: デバイスにユーザー フレンドリーな名前を付けます。
• 識別子: 複数のコミッショニング可能なデバイス アドバタイズを識別するために使用される 12 ビットの数値。（デフォルト: 3840）。
• Matter ポート: IP ネットワークを介した Matter のコミッショニングと通信用のポート。Matter はデフォルトで TCP/UDP ポート 5540 を使用しますが、他のサービスで使用されていない限り、別のポートを使用するように仮想デバイスを構成できます。
• ベンダー ID: テストベンダー ID 0xFFF1 のみがサポートされています。
• 商品 ID: テスト用の商品 ID 0x8000～0x801F のみがサポートされています。

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

sudo iptables -L -n

sudo ufw disable

sudo ufw enable

デバイスを動作させる

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

• オン/オフ: ほとんどのデバイスに共通。
• レベル: たとえば、ライトには明るさを調整するレベルスライダーがあります。
• 色: たとえば、色付きのライトにこのコントロールを設定できます。
• 在室: 在室確認センサーには、在室状態または不在状態をシミュレートするこのコントロールが用意されています。

すべての仮想デバイスには、次のコントロールがあります。

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

メーカー固有のトレイト

メーカー固有（MS）のトレイトは、Android 向け Home API でサポートされており、Matter の標準トレイトを超える追加機能を提供します。MS トレイトを持つデバイスをテストするには、MVD を使用して、[Custom Clusters] セクションのトレイトを操作します（上の画像を参照）。

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

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

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

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

• Matter をサポートする Google Nest Hub が必要です。

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

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

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

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

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

デバイスを操作する

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

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

デバイスでテストする

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

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

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

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

デバイスログを表示する

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

デバイスを停止する

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

アプリを終了する

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

ヘルプ

MVD に関するサポート、バグの報告、新機能のリクエストについては、Google サポートにお問い合わせください。

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

バグを報告する

MVD に不具合があると思われる場合は、ウィンドウの右上にある [Issue sms_failed] ボタンをクリックしてバグを報告してください。

フィードバックを送信

MVD の気に入っている点や、ツールの改善点についてご意見をお寄せいただくには、フィードバック フォームにご記入ください。

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

フィードバックを送信

MVD の使用中に下部に表示されるアンケートでフィードバックを送信することもできます。