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 映像, Docker Hub如需安装该软件包,请运行以下命令:
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
启动容器后,您应该会看到一些诊断输出, 确认容器配置正确无误的消息 最后是容器 shell 提示符:
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,它 将默认为使用本地主机端口 33000 的网络套接字选项。
一旦“VDC”能够连接到您的设备,它将 显示设备状态的屏幕:
显示设备的二维码
VDC 也可用于检索二维码,如下所示: 。点击设备图片旁边的二维码图标,以显示此设备的二维码:
您可以使用此二维码调试设备。
停止 Matter 虚拟设备开发环境
如需停止 MVD-DE,请在 VDC 的屏幕处于焦点的情况下按 Control-Q,或在启动应用的终端会话中按 Control-C。
反馈
提交您的想法或反馈,帮助我们改进 体验 MVD-DE,请填写我们的反馈表单。