ご案内: 新しいデベロッパー プレビュー プログラムがまもなくリリースされます。こちらからお申し込みのうえ、新しいツールを試してフィードバックをいち早くご利用ください。

Matter 仮想デバイス開発環境

デバイス SDK

Matter Virtual Device Development Environment (MVD-DE) は、Matter Virtual Device (MVD) を作成し、Virtual Device Controller (VDC) デスクトップ アプリを使用して仮想 Matter デバイスの状態をコントロールして表示するグラフィカル ユーザー インターフェースを提供する Docker コンテナです。アプリは、仮想デバイスを視覚的に表現し、デバイスでサポートされている Matter クラスタのコントロールを提供します。

アプリは RPC クライアントを使用して仮想デバイスの RPC サーバーと通信し、アクション(電源の切り替え、消灯、明るさ調整)を反映したリクエストを送信し、1 秒に 1 回ポーリングして状態を取得します。

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

現在、MVD-DE は以下の Matter デバイスタイプをサポートしています。

Matter デバイスタイプ アプリケーション クラスタ ホーム エコシステムの種類
接触センサー ブール状態 Sensor
調光 オン/オフ
レベル管理
浅い睡眠
エクステンデッド カラー ライト オン/オフ
レベル コントロール
色の管理
浅い睡眠
フローセンサー フロー測定 Sensor
湿度センサー 相対湿度測定 Sensor
照度センサー 照度測定 Sensor
在室確認センサー 在宅確認 Sensor
オン/オフライト オン / オフ 浅い睡眠
コンセント オン/オフ
レベル管理
コンセント
圧力センサー 圧力測定 Sensor
スピーカー オン/オフ
レベル管理
スピーカー
Switch オン / オフ Switch
温度センサー 温度測定 Sensor

Matter 仮想デバイス開発環境をセットアップする

MVD-DE は、Docker Hub で利用可能な事前構成済みの Docker イメージです。インストールするには、次のコマンドを実行します。

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

このオペレーションが完了するまでに数分かかることがあります。

Matter 仮想デバイス開発環境を実行する

  1. Docker コンテナを起動します。

    user@host> xhost local:1000
    user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
    

    コンテナを起動すると、診断出力が表示され、コンテナ構成が正しいことを確認するメッセージが表示されます。最後に、コンテナシェル プロンプトが表示されます。

    Environment looks good, you are ready to go!
    
  2. 2 つ目のターミナル セッション インスタンスを作成します。

    user@host> docker exec -it matter-container /bin/bash
    
  3. 仮想 Matter デバイスの場合は、デバイスが実行中になったら VDC を起動し、--s 引数とデバイスで使用する IP ポートを渡します。

    $ electron main.js --s=localhost:33000
    

    実機の場合は、VDC を起動し、--d 引数の後にデバイスのシリアルポートを渡します。

    $ electron main.js --d=/dev/ttyUSB0
    

引数を指定せずに VDC を起動した場合、デフォルトは localhost のポート 33000 を使用するネットワーク ソケット オプションになります。

VDC がデバイスに接続できるようになると、デバイスの状態を示す画面が表示されます。

仮想デバイスのグラフィック ユーザー インターフェース

デバイスの QR コードを表示する

VDC を使用して、デバイスのコミッショニング フローで QR コードを取得することもできます。デバイス画像の横にある QR コードアイコンをクリックして、このデバイスの QR コードを表示します。

デバイスの QR コードが表示されている仮想デバイス コントローラ

この QR コードを使用して、デバイスをコミッショニングできます。

Matter 仮想デバイス開発環境を停止する

MVD-DE を停止するには、VDC の画面をフォーカスした状態で Ctrl+Q キーを押すか、アプリを起動したターミナル セッションで Ctrl+C キーを押します。

フィードバック

MVD-DE の操作性を改善するためのご意見やフィードバックがございましたら、フィードバック フォームにご記入ください。

フィードバックをお寄せください