Matter 虛擬裝置開發環境

裝置 SDK

Matter Virtual Device Development Environment (MVD-DE) 是一個 Docker 容器,可讓您建立 Matter Virtual Device (MVD),並使用 Virtual Device Controller (VDC) 電腦版應用程式提供圖形使用者介面,以控制及顯示虛擬 Matter 裝置的狀態。應用程式提供虛擬裝置的視覺化呈現方式,以及裝置支援的 Matter 叢集控制選項。

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

支援的裝置

目前,MVD-DE 支援下列 Matter 裝置類型:

Matter 種裝置類型 應用程式叢集 居家生態系統類型
聯絡感應器 布林值 感應器
可調光 開啟/關閉
等級控制
輕度
延伸彩光 開啟/關閉
關卡控制
色彩控制
輕度
流程感應器 流程評估 感應器
濕度感應器 相對濕度測量 感應器
照明感測器 照度測量 感應器
活動情形感應器 活動情形感應功能 感應器
開/關燈 開啟/關閉 輕度
插座 開啟/關閉
等級控制
插座
壓力感測器 壓力測量 感應器
擴音 開啟/關閉
等級控制
喇叭
切換按鈕 開啟/關閉 Switch
溫度感應器 溫度測量 感應器

設定 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. 建立第二個終端機工作階段執行個體:

    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 code

VDC 也可用來擷取 QR code,做為裝置調解流程的一部分。按一下裝置圖片旁邊的 QR code 圖示,即可顯示這部裝置的 QR code:

顯示裝置的 QR code 的虛擬裝置控制器

你可以使用這個 QR code 指導裝置。

停止 Matter 虛擬裝置開發環境

如要停止 MVD-DE,請在焦點位於 VDC 的螢幕上按下 Control-Q,或在啟動應用程式的終端機工作階段中按下 Control-C 鍵。

意見回饋

如要提供想法或意見回饋,協助我們改善「MVD-DE」的使用體驗,請填寫意見回饋表單。

提供意見回饋