Matter Virtual Device Development Environment (MVD-DE) 是 Docker 容器,可用於建立 Matter Virtual Device (MVD),並使用 Virtual Device Controller (VDC) 桌面應用程式提供圖形使用者介面,用於控制及顯示虛擬 Matter 裝置的狀態。這個應用程式會以視覺化方式呈現虛擬裝置,以及裝置支援的 Matter 叢集控制項。
應用程式會使用 RPC 用戶端與虛擬裝置的 RPC 伺服器通訊,傳送反映您動作的請求 (切換電源、調暗、調亮),並每秒輪詢一次以擷取狀態。
支援的裝置
MVD-DE 目前支援下列 Matter 裝置類型:
Matter 裝置類型 | 應用程式叢集 | 住家生態系統類型 |
---|---|---|
接觸式感應器 | 布林狀態 | 感應器 |
可調光燈 | 開啟/關閉 音量控制 |
輕度 |
延長型色彩燈 | 開/關 燈光控制 色彩控制 |
輕度 |
流量感應器 | 流量測量 | 感應器 |
濕度感應器 | 相對濕度測量 | 感應器 |
照度感應器 | 照度測量 | 感應器 |
活動情形感應器 | 住家活動情形偵測 | 感應器 |
開啟/關閉燈光 | 開啟/關閉 | 輕度 |
插座 | 開啟/關閉 音量控制 |
Outlet |
壓力感應器 | 壓力測量 | 感應器 |
喇叭 | 開啟/關閉 音量控制 |
喇叭 |
切換 | 開啟/關閉 | Switch |
溫度感應器 | 溫度測量 | 感應器 |
設定 Matter 虛擬裝置開發環境
MVD-DE 是 Docker Hub 上可用的預先設定 Docker 映像檔。如要安裝,請執行以下指令:
user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
這項作業可能需要幾分鐘才能完成。
執行 Matter 虛擬裝置開發環境
啟動 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!
建立第二個終端機工作階段例項:
user@host> docker exec -it matter-container /bin/bash
對於虛擬 Matter 裝置,裝置執行後,請啟動 VDC,並傳遞
--s
引數和裝置使用的 IP 連接埠:$ electron main.js --s=localhost:33000
如為實體裝置,請啟動 VDC,並傳遞
--d
引數和裝置序列埠:$ electron main.js --d=/dev/ttyUSB0
如果您在啟動 VDC 時未提供任何引數,系統會預設使用 localhost 通訊埠 33000 的網路通訊端選項。
VDC 連上裝置後,畫面上會顯示裝置狀態:
顯示裝置的 QR code
VDC 也可以用於在裝置委派流程中擷取 QR code。按一下裝置圖片旁的 QR code 圖示,即可顯示此裝置的 QR code:
你可以使用這個 QR code 啟用裝置。
停止 Matter 虛擬裝置開發環境
如要停止 MVD-DE,請在 VDC 畫面聚焦時按下 Control-Q 鍵,或是在啟動應用程式的終端機工作階段中按下 Control-C 鍵。
意見回饋
如要針對 MVD-DE 提供意見或回饋,協助我們改善使用體驗,請填寫意見回饋表單。