Matter 虚拟设备对于开发和测试 Matter 解决方案非常有用,可以使用 Google Home app (GHA) 进行调试,并使用 GHA 和 Google Assistant 进行控制,就像实体 Matter 设备一样。
对于需要测试或模拟虚拟 Matter 设备但缺乏资源来构建自己的实体或虚拟 Matter 设备的应用开发者和其他人员,Google 提供了 Matter Virtual Device (MVD)。MVD 是一款轻量级独立 Linux 或 macOS 桌面工具,可模拟不同类型的虚拟 Matter 设备,并提供图形界面来控制和显示虚拟 Matter 设备的状态。
与实体 Matter 设备不同,MVD 不依赖蓝牙®低功耗 (BLE) 或 Thread® 来加入 Matter 结构。而是使用主机 Linux 或 macOS 机器的现有 Wi-Fi 网络连接进行调试。
与其他工具相比
MVD 与 Virtual Device Controller (VDC) 的不同之处在于,它是一个独立的解决方案,将虚拟设备与用于控制它的界面相结合。相比之下,VDC 用于控制单独的虚拟 Matter 设备,例如我们在 Matter Virtual Device Development Environment (MVD-DE) 中构建的设备。
您可能已经学过 MVD-DE Codelab。在此 Codelab 中,您将构建一种虚拟设备,即智能灯泡。相比之下,MVD 包含多种不同的预构建虚拟设备,并包含用于运行和控制这些设备的集成界面。
MVD | VDC | MVD-DE (Codelab) | |
---|---|---|---|
模拟 Matter 设备 | |||
控制模拟的 Matter 设备 | |||
需要的开发工作 | |||
下载 | 小于 100 MB | 9 GB | 20 GB |
支持的设备
MVD 支持以下 Matter 设备类型:
Matter设备类型 | 应用集群 | Home 生态系统类型 |
---|---|---|
基本视频播放器 |
0x0006 0x0506 0x0509 |
电视 |
色温灯 |
0x0300 0x0008 0x0006 |
灯 |
接触传感器 |
0x0045 |
传感器 |
可调光灯 |
0x0008 0x0006 |
灯 |
门锁 |
0x0101 |
锁定 |
扩展色灯 |
0x0300 0x0008 0x0006 |
灯 |
风扇 |
0x0202 0x0006 |
风扇 |
流量传感器 |
0x0404 |
传感器 |
通用开关 |
0x003b |
开关 |
湿度传感器 |
0x0405 |
传感器 |
照度传感器 |
0x0400 |
传感器 |
在家/外出传感器 |
0x0406 |
传感器 |
开/关指示灯 |
0x0008 0x0006 |
灯 |
开/关灯开关 |
0x0006 |
开关 |
开启/关闭插电装置 |
0x0008 0x0006 |
插座 |
压力传感器 |
0x0403 |
传感器 |
泵 |
0x0006 0x0200 0x0402 0x0403 0x0404 |
不适用 |
机器人吸尘器 |
0x0054 0x0055 0x0061 |
吸尘器 |
室内空调 |
0x0006 0x0201 0x0202 |
帐号 |
烟雾一氧化碳警报器 |
0x005C |
烟雾 |
温度传感器 |
0x0402 |
传感器 |
恒温器 |
0x0201 |
温控器 |
窗帘 |
0x0102 |
卷帘 |
安装 MVD
MVD 可在运行 Debian(11 或更高版本)、Ubuntu(20.04 或更高版本)或 macOS 的 64 位 x86 处理器计算机上运行。
Linux
然后运行 dpkg
以安装 MVD Debian (.deb) 软件包:
sudo dpkg -i mvd_1.4.0_amd64.deb
macOS
然后,双击 dmg
文件以打开安装窗口。
如需完成安装,请选择 mvd
图标并将其拖动到 Applications
文件夹中:
检查端口使用情况
MVD 中的控制器模块使用 TCP 端口 33000 对虚拟设备进行 RPC 调用,因此,如果此端口已被计算机上的其他进程使用,请务必将其释放。
如需查看是否有任何进程正在使用端口 33000,请执行以下操作:
Linux
sudo fuser -v 33000/tcp
macOS
lsof -i:33000
您可以通过一条命令终止使用 TCP 端口 33000 的任何进程:
Linux
sudo fuser -k 33000/tcp
macOS
lsof -ti:33000 | xargs kill
运行 MVD
Linux
在 Linux 上,从应用文件夹或从终端运行 MVD:
mvd
macOS
在 macOS 上,使用 Launchpad 打开 MVD 或从终端运行 MVD:
cd /Applications
open mvd.app
配置您的设备
系统会在启动时显示主屏幕,供您配置虚拟设备:
- Device Type:选择设备类型(例如 Light、Switch、Sensor 等)。
- 设备名称:为设备指定一个易于理解的名称。
- 判别器:一个 12 位数字,用于区分多个含佣金设备广告。(默认值:
3840
)。 - Matter 端口:用于通过 IP 网络进行 Matter 调试和通信的端口。Matter 默认使用 TCP/UDP 端口 5540,但您可以将虚拟设备配置为使用其他端口,只要没有其他服务在使用此端口。
- 供应商 ID:仅支持测试供应商 ID
0xFFF1
。 - 产品 ID:仅支持测试产品 ID
0x8000
到0x801F
。
配置防火墙
Linux
如果您的计算机正在运行防火墙,请将其关闭或允许 Matter 端口上的传入 TCP/UDP 连接。
如需查看当前活跃的 netfilter 防火墙规则,请运行以下命令:
sudo iptables -L -n
如果您使用的是 `ufw`,可使用以下命令将其停用:
sudo ufw disable
您还可以通过以下方式重新启用:
sudo ufw enable
macOS
如需在 macOS 上配置或停用防火墙,请执行以下操作:
- 转到 Apple 菜单,然后选择系统设置。
- 点击边栏列表中的网络。
- 点击防火墙。
- 将防火墙的开关切换到关闭位置。
运行您的设备
配置设备后,点击创建设备。创建设备后,系统会显示控制器屏幕。根据您选择的设备类型,您可能会看到以下一个或多个控件:
- 开启/关闭:适用于大多数设备。
- Level:例如,灯可以具有用于调整亮度的级别滑块。
- 颜色:例如,彩灯可以设置此控件。
- 在家/外出传感器:在家/外出传感器提供此控件,用于模拟有人在家或外出状态。
所有虚拟设备都具有以下控件:
- QRCode:显示用于调试的二维码。
- 重新启动:重启虚拟设备。设备暂时断开与网络的连接。
- 重置:将当前设备恢复出厂设置并清除所有状态,包括调试、当前控件状态等
- 删除:销毁设备并返回创建设备屏幕。
调试设备
设备一经制造便可供使用。
调试设备需要满足一些前提条件:
您必须在 Google Home Developer Console 中拥有一个项目。此项目必须包含一个 Matter 集成,该集成的 VID/PID 组合与您在设置虚拟设备时使用的 VID/PID 组合相同。如需了解详情,请参阅项目创建指南。
您必须拥有搭载 Android 8.1 或更高版本且安装了 GHA 的 Android 手机。
Android 手机必须与 hub 连接到同一个 Wi-Fi 网络。
主机必须连接到 Wi-Fi 网络。
如需使用 GHA 调试设备,请点击QRCode以显示设备的二维码,然后按照配对 Matter 设备中的说明操作,其中介绍了如何使用 GHA 对 Matter 设备进行初始配置。您还可以使用 Google Home Sample App for Matter 调试设备。
如需了解 Matter 调试的工作原理,请参阅我们的 Matter Primer。
控制设备
调试虚拟设备后,您可以使用 Google Home 应用或 Google 助理通过语音控制该设备。您可以选择以下任一解决办法:
- 通过 GHA 或 Assistant 控制设备,同时监控虚拟设备上的状态变化,或者
- 使用 Sample App for Matter 控制设备,同时监控虚拟设备上的状态变化,或者
- 通过 MVD 本身控制设备状态,同时监控 GHA 或 Assistant 中的状态变化。
使用设备进行测试
如需使用 Assistant 进行测试,我们建议您使用语音模拟器,例如 Google Home Extension for VS Code 或 Google Home Plugin for Android Studio。
查看设备详细信息
设备详情屏幕会显示详细的设备信息:
- 名称:为设备指定的易记名称。
- 设备类型:所选设备类型。
- 判别器:当前的设备判别器。
- 供应商 ID:当前的设备供应商 ID。
- 产品 ID:当前的设备产品 ID。
- RPC 端口:设备与控制器 (GUI) 通信的 RPC 端口。
- Matter 端口:当前设备用于通过 IP 网络进行通信的端口。
- 密码:用于通过网络调试设备的 PIN 码。
- 配置文件夹:虚拟设备存储配置的文件夹。
- 佣金信息:显示设备所联接的架构以及该架构中的设备的节点 ID。
查看设备日志
如果您从终端启动了 MVD,日志输出会显示在 stdout
上。您还可以在设备日志标签页中查看设备日志。
停止设备
如需停止并销毁设备,请点击删除。
终止应用
关闭控制窗口会销毁设备并终止 MVD 应用。如果您是从终端启动的,也可以在终端中输入 Ctrl-C 来终止应用。
获取帮助
如需有关 MVD 的帮助、报告 bug 或请求新功能,请与您的 Google 支持联系人联系。
点击窗口右上角的帮助
按钮可转到此页面。提交错误报告
如果您认为自己在 MVD 中发现缺陷,可以点击窗口右上角的“问题” 按钮提交 bug。
发送反馈
如果您想告诉我们您喜欢 MVD 的哪些方面,或我们如何能够改善您使用该工具的体验,请填写我们的反馈表单。
您可以通过窗口右上角的反馈
按钮来启动表单,也可以通过点击下面的按钮来启动此表单。