Matter 仮想デバイス開発環境

デバイス SDK

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

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

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

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

Matter デバイスタイプ アプリケーション クラスタ 家庭用エコシステムのタイプ
接触センサー ブール値の状態 Sensor
調光可能ライト オン/オフ
レベル コントロール
浅い睡眠
拡張カラーライト オン/オフ
レベル コントロール
カラー コントロール
浅い睡眠
フローセンサー 流量測定 Sensor
湿度センサー 相対湿度測定 Sensor
照度センサー 照度測定 Sensor
在宅確認センサー 在宅確認 Sensor
ライトのオン/オフ オン / オフ 浅い睡眠
コンセント オン/オフ
レベル コントロール
コンセント
圧力センサー 圧力測定 Sensor
スピーカー オン/オフ
レベル コントロール
スピーカー
切り替える オン / オフ 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 のエクスペリエンス向上のためにご意見やフィードバックをお送りいただく場合は、フィードバック フォームをご利用ください。

フィードバックの送信