仮想デバイス コントローラ

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

デバイス SDK

仮想デバイス コントローラは、仮想 Matter デバイスの状態を制御したり表示したりするためのグラフィカル ユーザー インターフェースを提供するデスクトップ アプリです。このアプリは、仮想デバイスを視覚的に表示し、デバイスでサポートされている Matter クラスタのコントロールを提供します。

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

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

現在、仮想デバイス コントローラは、次の Matter デバイスタイプをサポートしています。

Matter 種類のデバイス アプリケーション クラスタ ホーム エコシステムの種類
接触センサー ブール値の状態 Sensor
調光 オン/オフ
レベル調整
浅い睡眠
拡張カラーライト オン / オフ
レベル調整
色調整
浅い睡眠
フローセンサー フロー測定 Sensor
湿度センサー 相対湿度測定 Sensor
照度センサー 照度の測定 Sensor
在室確認センサー 在宅確認 Sensor
オン/オフライト オン / オフ 浅い睡眠
コンセント オン / オフ
レベル調整
コンセント
圧力センサー 圧力測定 Sensor
スピーカー オン/オフ
レベル調整
話し手
切り替える オン / オフ Switch
温度センサー 体温測定 Sensor

仮想デバイス コントローラをセットアップする

仮想デバイス コントローラは、Docker Hub で事前構成された Docker イメージの一部として提供されます。これをインストールするには、次のコマンドを実行します。

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

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

仮想デバイス コントローラを実行する

  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 デバイスの場合、デバイスが起動したら、仮想デバイス コントローラを起動して、--s 引数と、デバイスで使用する IP ポートを渡します。

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

    物理デバイスの場合は、仮想デバイス コントローラを起動し、--d 引数に続けてデバイスのシリアルポートを渡します。

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

引数を指定せずに Controller を起動すると、デフォルトで localhost ポート 33000 を使用するネットワーク ソケット オプションが使用されます。

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

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

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

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

デバイスの QR コードを表示する仮想デバイス コントローラ

この QR コードを使用してデバイスを試用できます。

仮想デバイス コントローラを停止する

仮想デバイス コントローラを停止するには、コントローラの画面をフォーカスした状態で Ctrl+Q キーを押すか、アプリを起動したターミナル セッションで Ctrl+C キーを押します。

フィードバック

仮想デバイス コントローラの操作性を向上させる方法についてご意見やフィードバックをお送りいただく場合は、フィードバック フォームにご記入ください。

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