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 デバイスタイプ アプリケーション クラスタ ホーム エコシステムの種類
接触センサー ブール値の State 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 の利便性向上のため、ご意見やフィードバックがございましたら、フィードバック フォームにご記入ください。

フィードバックの送信