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设备类型 应用集群 Home 生态系统类型
接触传感器 布尔值状态 传感器
可调光灯 开启/关闭
音量控制
浅色
扩展色光 开启/关闭
亮度控制
颜色控制
浅色
流量传感器 流量测量 传感器
湿度传感器 相对湿度测量 传感器
照度传感器 照度测量 传感器
在家/外出传感器 在家/外出感知 传感器
开/关灯 开启/关闭 浅色
插座 开启/关闭
音量控制
插座
压力传感器 压力测量 传感器
扬声器 开启/关闭
音量控制
扬声器
切换 开启/关闭 开关
温度传感器 温度测量 传感器

设置 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
    

    启动容器后,您应该会看到一些诊断输出, 确认容器配置正确无误的消息 最后是容器 shell 提示符:

    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,它 将默认为使用本地主机端口 33000 的网络套接字选项。

一旦“VDC”能够连接到您的设备,它将 显示设备状态的屏幕:

虚拟设备图形界面

显示设备的二维码

VDC 还可用于在设备配置流程中检索二维码。点击 设备图片,用于显示此设备的二维码:

显示设备二维码的虚拟设备控制器

您可以使用此二维码调试设备。

停止 Matter 虚拟设备开发环境

要停止 MVD-DE,请按 Ctrl-Q 和 VDC的屏幕已获得焦点,或在终端中按 Ctrl+C 您启动应用的会话

反馈

提交您的想法或反馈,帮助我们改进 体验 MVD-DE,请填写我们的反馈表单。

向我们发送反馈