Los dispositivos virtuales Matter son útiles para desarrollar y probar soluciones de Matter, y se pueden pedir con Google Home app (GHA) y controlarse con GHA y Google Assistant, al igual que los dispositivos Matter físicos.
Para los desarrolladores de apps y otras personas que necesitan probar o emular un dispositivo Matter virtual, pero no tienen los recursos para compilar su propio dispositivo Matter físico o virtual, Google ofrece Matter Virtual Device (MVD). MVD es una herramienta independiente y liviana para computadoras de escritorio en Linux o macOS que simula diferentes tipos de dispositivos Matter virtuales y proporciona una interfaz gráfica de usuario para controlar y mostrar los estados del dispositivo Matter virtual.
A diferencia de un dispositivo físico Matter, MVD no depende de Bluetooth® de bajo consumo (BLE) ni de Thread® para unirse a una estructura Matter. En su lugar, usa la conexión de red Wi-Fi existente de la máquina anfitrión con Linux o macOS para realizar la comisión.
En comparación con otras herramientas
MVD se diferencia de Virtual Device Controller (VDC) en que es una solución independiente que combina un dispositivo virtual con una IU para controlarlo. Por el contrario, VDC se usa para controlar un dispositivo Matter virtual independiente, como el que compilamos en Matter Virtual Device Development Environment (MVD-DE).
Es posible que ya hayas trabajado con el codelab MVD-DE. En este codelab, compilarás un solo tipo de dispositivo virtual: una bombilla inteligente. Por el contrario, MVD contiene varios dispositivos virtuales previamente compilados y, además, incluye una IU integrada para ejecutarlos y controlarlos.
MVD | VDC | MVD-DE (Codelab) | |
---|---|---|---|
Emula un dispositivo de Matter | |||
Cómo controlar un dispositivo Matter emulado | |||
Esfuerzo de desarrollo requerido | |||
Descargar | Menos de 100 MB | 9 GB | 20 GB |
Dispositivos compatibles
MVD admite los siguientes tipos de dispositivos Matter:
Matter tipo de dispositivo | Clústeres de aplicaciones | Tipo de ecosistema de la casa |
---|---|---|
Reproductor de video básico |
0x0006 0x0506 0x0509 |
TV |
Luz de temperatura de color |
0x0300 0x0008 0x0006 |
Ligera |
Sensor de contacto |
0x0045 |
Sensor |
Luz regulable |
0x0008 0x0006 |
Ligera |
Cerraduras |
0x0101 |
Bloquear |
Luz de color extendido |
0x0300 0x0008 0x0006 |
Ligera |
Ventilador |
0x0202 0x0006 |
Con ventilador |
Sensor de flujo |
0x0404 |
Sensor |
Interruptor genérico |
0x003b |
Switch |
Sensor de humedad |
0x0405 |
Sensor |
Sensor de iluminación |
0 × 0400 |
Sensor |
Sensor de ocupación |
0x0406 |
Sensor |
Luz de encendido/apagado |
0x0008 0x0006 |
Ligera |
Interruptor de luz de encendido/apagado |
0x0006 |
Switch |
Unidad de complemento activada/desactivada |
0x0008 0x0006 |
Salida |
Sensor de presión |
0x0403 |
Sensor |
Surtidor |
0x0006 0x0200 0x0402 0x0403 0x0404 |
N/A |
Aspiradora robot |
0x0054 0x0055 0x0061 |
Aspiradora |
Aire acondicionado para habitaciones |
0x0006 0x0201 0x0202 |
A.C. |
Alarma de humo y monóxido de carbono |
0x005C |
Humo |
Sensor de temperatura |
0x0402 |
Sensor |
Termostato |
0x0201 |
Termostato |
Cubiertas de ventanas |
0x0102 |
Persianas |
Instalar MVD
MVD se ejecuta en máquinas con procesadores x86 de 64 bits que ejecutan Debian (11 o una versión posterior), Ubuntu (20.04 o posterior) o macOS.
Linux
Descarga el paquete de MVD Debian (.deb)
Descarga el archivo de firma ASCII protegida (.asc)
Luego, ejecuta dpkg
para instalar el paquete MVD de Debian (.deb):
sudo dpkg -i mvd_1.4.0_amd64.deb
macOS
Descargar el archivo dmg de MVD (macOS x86)
Descargar el archivo dmg de MVD (ARM64 M1)
Luego, haz doble clic en el archivo dmg
para abrir la ventana de instalación.
Para completar la instalación, selecciona y arrastra el ícono mvd
a la carpeta Applications
:
Cómo verificar el uso de puertos
El módulo de controlador en MVD usa el puerto TCP 33000 para realizar llamadas RPC al dispositivo virtual, por lo que, si otro proceso de tu computadora ya usa ese puerto, asegúrate de liberarlo.
Para ver si algún proceso usa el puerto 33000, haz lo siguiente:
Linux
sudo fuser -v 33000/tcp
macOS
lsof -i:33000
Puedes finalizar cualquier proceso usando el puerto TCP 33000 con un único comando:
Linux
sudo fuser -k 33000/tcp
macOS
lsof -ti:33000 | xargs kill
Ejecutar MVD
Linux
En Linux, ejecuta MVD desde la carpeta de aplicaciones o desde la terminal:
mvd
macOS
En macOS, usa Launchpad para abrir MVD o ejecutar MVD desde la terminal:
cd /Applications
open mvd.app
Configura el dispositivo
La pantalla principal aparece después del inicio y te permite configurar un dispositivo virtual:
- Device Type: Selecciona el tipo de dispositivo (por ejemplo, Luz, Interruptor, Sensor, etcétera).
- Nombre del dispositivo: Asigna un nombre fácil de usar al dispositivo.
- Discriminante: Es un número de 12 bits que se usa para discernir entre varios anuncios de dispositivos encargados. (Valor predeterminado:
3840
). - Puerto Matter: Es un puerto para la puesta en marcha y la comunicación de Matter a través de redes IP. Matter usa el puerto TCP/UDP 5540 de forma predeterminada, pero puedes configurar el dispositivo virtual para que use un puerto diferente, siempre que ningún otro servicio lo esté usando.
- ID del proveedor: Solo se admite el ID del proveedor de prueba
0xFFF1
. - ID del producto: Solo se admiten los IDs de productos de prueba
0x8000
a0x801F
.
Configura tu firewall
Linux
Si tienes un firewall en ejecución en tu computadora, apágalo o permite las conexiones TCP/UDP entrantes en el puerto Matter.
Ejecuta el siguiente comando para ver las reglas de firewall activas actuales de netfilter:
sudo iptables -L -n
Si usas `ufw`, se puede inhabilitar con lo siguiente:
sudo ufw disable
Puedes volver a habilitarla con los siguientes recursos:
sudo ufw enable
macOS
Para configurar o inhabilitar el firewall en macOS, haz lo siguiente:
- Ve al menú de de Apple y selecciona Configuración del sistema.
- Haz clic en Red en la lista de la barra lateral.
- Haz clic en Firewall.
- Cambia el interruptor de Firewall a la posición Desactivado.
Cómo ejecutar tu dispositivo
Una vez que el dispositivo esté configurado, haz clic en Crear dispositivo. Cuando se crea el dispositivo, aparece la pantalla Controller. Según el tipo de dispositivo que hayas seleccionado, es posible que veas uno o más de los siguientes controles:
- Activado/Desactivado: común en la mayoría de los dispositivos
- Nivel: Por ejemplo, una luz podría tener un control deslizante de nivel para ajustar el brillo.
- Color: Por ejemplo, una luz de color podría tener este control.
- Ocupación: El Sensor de ocupación ofrece este control para simular el estado ocupado o desocupado.
Todos los dispositivos virtuales tienen los siguientes controles:
- QRCode: Muestra el código QR que se usó para la comisión.
- Restart: Reinicia el dispositivo virtual. El dispositivo se desconecta de la red brevemente.
- Reset: Restablece la configuración de fábrica del dispositivo actual y borra todo el estado, incluida la puesta en marcha y el estado de los controles actuales, entre otros.
- Borrar: Destruye el dispositivo y regresa a la pantalla Crear dispositivo.
Encarga tu dispositivo
El dispositivo se puede comisionar en cuanto se crea.
Para poner en marcha el dispositivo, existen algunos requisitos previos:
Debes tener un proyecto en Google Home Developer Console. Este proyecto debe contener una integración Matter con la misma combinación de VID/PID que usaste para configurar el dispositivo virtual. Consulta la guía de creación de proyectos para obtener más detalles.
Debes tener un Google Nest Hub compatible con Matter.
Debes tener un teléfono Android que ejecute Android 8.1 o una versión posterior y tenga instalado GHA.
El teléfono Android debe estar conectado a la misma red Wi-Fi que la unidad central.
La máquina anfitrión debe estar conectada a la red Wi-Fi.
Para asignar el dispositivo con GHA, haz clic en QRCode para mostrar el código QR del dispositivo y, luego, sigue las instrucciones que se indican en Cómo vincular un dispositivo Matter, en las que se explica cómo integrar un dispositivo Matter con GHA. También puedes encargar el dispositivo con Google Home Sample App for Matter.
Consulta nuestro Primer Matter para aprender cómo funciona la comisión de Matter.
Cómo controlar el dispositivo
Después de asignar un dispositivo virtual, puedes controlarlo con la app de Google Home o Asistente de Google con la voz. Tienes varias opciones:
- Controlar el dispositivo con GHA o Assistant mientras supervisas los cambios de estado en el dispositivo virtual
- Controlar el dispositivo con Sample App for Matter mientras supervisas los cambios de estado en el dispositivo virtual
- Controla el estado del dispositivo a través de MVD mientras supervisas los cambios de estado en GHA o Assistant.
Realiza pruebas con el dispositivo
Para probar con Assistant, te recomendamos que uses un simulador de expresiones, como la extensión de Google Home para VS Code o el complemento de Google Home para Android Studio.
Ver detalles del dispositivo
En la pantalla Device details, se muestra información detallada del dispositivo:
- Nombre: Es el nombre descriptivo asignado al dispositivo.
- Device Type: Es el tipo de dispositivo seleccionado.
- Discriminante: Es el discriminador de dispositivos actual.
- Vendor ID: Es el ID del proveedor del dispositivo actual.
- ID del producto: El ID del producto actual del dispositivo.
- Puerto RPC: Es el puerto RPC que el dispositivo se comunica con los controladores (GUI).
- Puerto Matter: Es el puerto que usa el dispositivo actual para comunicarse a través de la red IP.
- Código de acceso: Es el PIN que se usa para poner el dispositivo en servicio a través de la red.
- Configuration Folder: Es la carpeta en la que se almacena la configuración en el dispositivo virtual.
- Información de la comisión: Muestra las telas que unió el dispositivo y el ID de nodo del dispositivo.
Consulta los registros del dispositivo
Si iniciaste MVD desde la terminal, el resultado del registro aparecerá en stdout
.
También puedes ver los registros del dispositivo en la pestaña Registros del dispositivo.
Detén el dispositivo
Para detener y destruir el dispositivo, haz clic en Borrar.
Cerrar la app
Si cierras la ventana de control, se destruye el dispositivo y se finaliza la aplicación de MVD. Si iniciaste desde la terminal, también puedes finalizar la aplicación escribiendo Ctrl-C en la terminal.
Obtén ayuda
Si quieres obtener ayuda con MVD, informar un error o solicitar una función nueva, comunícate con tu contacto de Atención al cliente de Google.
Haz clic en el botón de ayuda
en la esquina superior derecha de la ventana para acceder a esta página.Informar un error
Si crees que encontraste un defecto en el archivo MVD, puedes hacer clic en el botón Issue que se encuentra en la esquina superior derecha de la ventana para informarlo.
Enviar comentarios
Para enviarnos tus comentarios sobre lo que te gusta de MVD o cómo podemos mejorar tu experiencia con la herramienta, completa nuestro formulario de comentarios.
El formulario se puede iniciar desde el botón de comentarios
en la esquina superior derecha de la ventana o con un clic en el siguiente botón.