虛擬裝置控制器

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Device SDK

虛擬裝置控制器是一款桌面應用程式,提供圖形化使用者介面,可控管及顯示虛擬 Matter devices. The app provides a visual representation of your virtual device, as well as the controls for the Matter clusters supported by the device.

應用程式使用 RPC 用戶端與虛擬裝置的 RPC 伺服器通訊,然後傳送可反映您動作 (切換電源、調暗、調亮) 的請求,並每秒輪詢一次以擷取狀態。

支援的裝置

虛擬裝置控制器目前支援下列 Matter 裝置類型:

Matter」裝置類型 應用程式叢集 住家生態系統類型
聯絡人感應器 布林州 感應器
可調暗燈光 開啟/關閉
音量控制
輕度
延伸淺色 開啟/關閉
音量控制
色彩控制
輕度
流量感測器 流量測量 感應器
濕度感應器 相對濕度測量 感應器
光度感應器 光度測量 感應器
活動情形感應器 座位佔用率偵測功能 感應器
開啟/關閉指示燈 開啟/關閉 輕度
插座 開啟/關閉
音量控制
插座
壓力感測器 壓力測量 感應器
擴音 開啟/關閉
音量控制
擴音
切換按鈕 開啟/關閉 Switch
溫度感應器 測量溫度 感應器

設定虛擬裝置控制器

虛擬裝置控制器是 Docker 中預先設定 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. 建立第二個終端機工作階段執行個體:

    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
    

如果您在沒有提供任何引數的情況下啟動控制器,系統會使用 localhost 通訊埠 33000 來將網路通訊端選項預設為網路通訊端選項。

控制器成功連線到裝置後,畫面會顯示裝置狀態:

虛擬裝置圖形使用者介面

顯示裝置的 QR 圖碼

虛擬裝置控制器應用程式也能用來擷取 QR 圖碼作為裝置佣金流程的一部分。按一下裝置映像檔旁邊的 QR 圖碼圖示,即可顯示這部裝置的 QR 圖碼:

顯示裝置 QR 圖碼的虛擬裝置控制器

你可以使用這個 QR 圖碼委任裝置。

停止虛擬裝置控制器

如要停止虛擬裝置控制器,請在控制器畫面的焦點下按下 Control-Q 鍵,或是在啟動應用程式的終端機工作階段中按下 Control-C 鍵。

意見回饋

如要提交意見或意見回饋,協助我們改善虛擬裝置控制器的使用體驗,請填寫我們的意見回饋表單。

提供意見回饋