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 生态系统类型 |
---|---|---|
空气净化器 |
0x0202 0x0006 0x0071 |
空气净化器 |
空气质量传感器 |
0x005b 0x0402 0x0405 0x040c 0x040d 0x042a 0x042d 0x042e |
传感器 |
基本视频播放器 |
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 |
Ac |
烟雾/一氧化碳警报器 |
0x005C |
烟雾 |
温度传感器 |
0x0402 |
传感器 |
温控器 |
0x0201 |
温控器 |
窗帘 |
0x0102 |
百叶窗 |
安装 MVD
MVD 可在搭载 Debian(11 或更高版本)、Ubuntu(20.04 或更高版本)或 macOS 的 64 位 x86 处理器计算机上运行。
Linux
然后运行 dpkg
以安装 MVD Debian (.deb) 软件包:
sudo dpkg -i mvd_1.5.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
配置设备
启动后,系统会显示主屏幕,您可以在其中配置虚拟设备:
- 设备类型:选择设备类型(例如 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 菜单,然后选择系统设置。
- 点击边栏列表中的网络。
- 点击防火墙。
- 将防火墙开关切换到关闭位置。
运行设备
配置设备后,点击创建设备。创建设备后,系统会显示控制器界面。根据您选择的设备类型,您可能会看到以下一个或多个控件:
- 开启/关闭:大多数设备通用。
- 级别:例如,灯具可以有一个用于调节亮度的级别滑块。
- 颜色:例如,彩色灯具可以具有此控件。
- 占用情况:占用情况传感器提供此控件,用于模拟占用或空闲状态。
所有虚拟设备都具有以下控件:
- 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 配置流程的运作方式。
控制设备
配置虚拟设备后,您可以使用 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 码。
- 配置文件夹:虚拟设备存储配置的文件夹。
- 调试信息:显示设备加入的 fabric 以及设备在 fabric 中的节点 ID。
查看设备日志
如果您从终端启动 MVD,日志输出会显示在 stdout
上。您还可以在设备日志标签页上查看设备日志。
停止设备
如需停止并销毁设备,请点击删除。
终止应用
关闭控制窗口会销毁设备并终止 MVD 应用。如果您是从终端启动的,也可以在终端中输入 Ctrl-C 来终止应用。
获取帮助
如需有关 MVD 的帮助、报告 bug 或请求新功能,请与您的 Google 支持联系人联系。
点击窗口右上角的帮助
按钮即可前往此页面。提交 bug
如果您认为自己在 MVD 中发现了缺陷,可以点击窗口右上角的“问题” 按钮来提交 bug。
发送反馈
如需提交您对 MVD 的喜好之处或我们如何改进该工具的使用体验的想法,请填写我们的反馈表单。
您可以通过窗口右上角的反馈
按钮或点击下方的按钮启动该表单。