Se usó la API de Cloud Translation para traducir esta página.

Importa el dispositivo virtual

Los dispositivos virtuales Matter son útiles para desarrollar y probar Matter, y se pueden encargar con el Google Home app (GHA) y se controla con GHA y Google Assistant, al igual que el Matter físico dispositivos.

Para desarrolladores de apps y otras personas que necesiten probar o emular una experiencia Matter dispositivo, pero no tiene los recursos para crear el suyo física o dispositivo Matter virtual, Google ofrece la Matter Virtual Device (MVD). MVD es un herramienta de escritorio independiente y ligera de Linux o macOS que simula diferentes tipos de dispositivos Matter virtuales y proporciona una de usuario para controlar y mostrar los estados de la interfaz Matter dispositivo.

A diferencia de un dispositivo Matter físico, MVD no se basa en Bluetooth® de bajo consumo (BLE) ni en Thread® para unirse a un tejido Matter. En cambio, usa el host Conexión de red Wi-Fi existente de la máquina Linux o macOS para la puesta en servicio.

Comparación con otras herramientas

El MVD difiere de la Virtual Device Controller (VDC) en ese sentido es una solución independiente que combina un dispositivo virtual con una IU para para controlarla. En cambio, 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 , compilarás un solo tipo de dispositivo virtual: una bombilla inteligente. En Por el contrario, el objeto MVD contiene varias compilaciones virtuales e incluye una IU integrada para ejecutarlos y controlarlos.

*Tabla: Comparación de herramientas de dispositivos Matter virtuales*
	MVD	VDC	MVD-DE (codelab)
Emula un dispositivo 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 lo siguiente: Matter. tipos de dispositivos:

*Tabla: Dispositivo Matter tipos admitidos para MVD*
Matter Tipo de dispositivo	Clústeres de aplicaciones	Tipo de ecosistema de la casa
Reproductor de video básico	0 × 0006 0 × 0506 0 × 0509	TV
Temperatura de color: Luz	0 × 0300 0x0008 0 × 0006	Ligera
Sensor de contacto	0x0045	Sensor
Luz regulable	0x0008 0 × 0006	Ligera
Cerradura	0x0101	Bloquear
Color extendido: claro	0 × 0300 0x0008 0 × 0006	Ligera
Ventilador	0 × 0202 0 × 0006	Ventilador
Sensor de flujo	0 × 0404	Sensor
Interruptor genérico	0x003b	Switch
Sensor de humedad	0 × 0405	Sensor
Sensor de luz	0x0400	Sensor
Sensor de ocupación	0 × 0406	Sensor
Luz de encendido/apagado	0x0008 0 × 0006	Ligera
Interruptor de luz de encendido/apagado	0 × 0006	Switch
Unidad de complemento de encendido/apagado	0x0008 0 × 0006	Punto de salida
Sensor de presión	0 × 0403	Sensor
Surtidor	0 × 0006 0 × 0200 0 × 0402 0 × 0403 0 × 0404	Bomba de agua
Aspiradora robot	0x0054 0x0055 0x0061	Aspiradora
Aire acondicionado de la habitación	0x0006 0x0201 0x0202	Ac
Alarma de humo y monóxido de carbono	0x005C	Humo
Sensor de temperatura	0 × 0402	Sensor
Termostato	0x0201	Termostato
Cubierta de ventanas	0x0102	Persianas

Instala MVD

MVD se ejecuta en máquinas con procesadores x86 de 64 bits que ejecutan Debian (11 o versiones posteriores), Ubuntu (20.04 o versiones posteriores) o macOS.

Linux

Descarga el paquete MVD Debian (.deb)

Descarga el archivo de firma Armored-ASCII (.asc)

Luego, ejecuta dpkg para instalar MVD. Paquete Debian (.deb):

sudo dpkg -i mvd_1.4.0_amd64.deb

macOS

Descarga 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 instalación. en la ventana modal.

Para completar la instalación, selecciona y arrastra el ícono mvd a la carpeta Applications:

Verifica el uso de los puertos

El módulo del controlador en MVD usa el puerto TCP 33000 para hacer RPC llamadas al dispositivo virtual. Por lo tanto, si otro puerto ya está usando en tu computadora, 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 que use el puerto TCP 33000 con un solo 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 tu dispositivo

La pantalla principal aparece al iniciar la app, que 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.
Discriminador: Es un número de 12 bits que se usa para distinguir entre múltiples de dispositivos con comisión. (Valor predeterminado: 3840).
Puerto Matter: un puerto para Matter la puesta en servicio y la comunicación a través de redes de IP internas. Matter utiliza el puerto TCP/UDP 5540 de forma predeterminada, pero puedes configurar el dispositivo virtual para usar una distinta siempre que no lo use otro servicio.
ID de proveedor: Solo se admite el ID de proveedor de prueba 0xFFF1.
ID de producto: Solo se admiten los IDs de productos de prueba del 0x8000 al 0x801F.

Configuración del dispositivo virtual
pantalla

Configura tu firewall

Linux

Si tienes un firewall ejecutándose en tu computadora, ciérralo o permite Conexiones TCP/UDP entrantes en el puerto Matter

Para ver el filtro activo netfilter actual reglas de firewall, ejecuta lo siguiente:

sudo iptables -L -n

Si usas `ufw`, se puede inhabilitar con:

sudo ufw disable

Y se puede volver a habilitar con las siguientes opciones:

sudo ufw enable

macOS

Para configurar o inhabilitar el firewall en macOS, sigue estos pasos:

Ve al menú de Apple y elige 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.

Ejecuta tu dispositivo

Una vez que el dispositivo esté configurado, haz clic en Crear dispositivo. Cuando el dispositivo está creado, aparecerá la pantalla Controller. Según el tipo de dispositivo que seleccionado, es posible que veas uno o más de los siguientes controles:

Activado/Desactivado: Es común en la mayoría de los dispositivos.
Nivel: Por ejemplo, una luz puede tener un control deslizante de nivel para ajustar brillo.
Color: Por ejemplo, la luz de color podría tener este control.
Ocupación: El sensor de ocupación ofrece este control para simular la 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 está desconectado de la red brevemente.
Restablecer: Restablece la configuración de fábrica del dispositivo actual y borra todo el estado, incluidos los siguientes: comisión, estado de controles actuales, etc.
Borrar: Destruye el dispositivo y regresa a la pantalla Crear dispositivo.

Pantalla de control del dispositivo virtual

Cómo acondicionar tu dispositivo

El dispositivo se puede comisionar en cuanto se crea.

Estos son algunos requisitos previos para la puesta en marcha del dispositivo:

Debes tener un proyecto en Google Home Developer Console. Este proyecto debe contener una integración Matter que tenga el mismo VID/PID como la que usaste para configurar tu dispositivo virtual. Consulta la guía de creación de proyectos para obtener más detalles.
Debes tener un Google Nest Hub compatible Asunto
Debes tener un teléfono Android con Android 8.1 o una versión posterior, y Se instaló GHA.
El teléfono Android debe estar conectado a la misma red Wi-Fi que el concentrador.
La máquina host debe estar conectada a la red Wi-Fi.

Para encargar el dispositivo con GHA, haz clic en QRCode para mostrar el código QR del dispositivo y, luego, sigue las instrucciones Vincula un Matter dispositivo, que explicar cómo incorporar un dispositivo Matter con el GHA También puedes asignar el dispositivo a través de la Google Home Sample App for Matter

Consulta nuestro Matter Imprimador para Descubre cómo funciona la comisión de Matter.

Cómo controlar el dispositivo

Después de encargar un dispositivo virtual, puedes controlarlo con la app de Google Home o Asistente de Google Voice. Tienes varias opciones:

Controla el dispositivo mediante GHA o Assistant mientras se supervisan los cambios de estado en el dispositivo virtual
Controla el dispositivo con el Sample App for Matter mientras se supervisa el estado cambios en el dispositivo virtual
Controla el estado del dispositivo a través del mismo MVD mientras supervisar cambios de estado en GHA o Assistant

Cómo realizar pruebas con el dispositivo

Para hacer la prueba con Assistant, te recomendamos que uses una declaración. simulador, como Extensión de Google Home para VS Code o el complemento de Google Home para Android Studio.

Cómo ver los detalles del dispositivo

La pantalla Device details muestra información detallada del dispositivo:

Nombre: Es el nombre descriptivo asignado al dispositivo.
Device Type: Es el tipo de dispositivo seleccionado.
Discriminador: Es el discriminador de dispositivo actual.
Vendor ID: Es el ID del proveedor del dispositivo actual.
ID del producto: Es el ID del producto del dispositivo actual.
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 se comunican a través de una red IP.
Código de contraseña: Es el PIN que se usa para realizar la puesta en marcha del dispositivo a través de la red.
Configuration Folder: la carpeta que almacena el dispositivo virtual. configuración.
Información de la comisión: Muestra los tejidos a los que se unió el dispositivo y el ID del nodo del dispositivo en el tejido.

Ver registros del dispositivo

Si iniciaste MVD desde la terminal, aparecerá el resultado del registro. 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.

Cómo cerrar la app

Si cierras la ventana de control, se destruirá el dispositivo y se finalizará la aplicación MVD. Si iniciaste desde la terminal, puedes También puedes finalizar la aplicación escribiendo Ctrl-C en la terminal.

Obtener ayuda

Para 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.

Si haces clic en el botón de ayuda en en la esquina superior derecha de la ventana, se te dirigirá a esta página.

Informa un error

Si cree que encontró un defecto en el MVD, es posible Para informar un error, haz clic en el error en la esquina superior derecha de la ventana.

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 a partir de los comentarios. en el en la esquina superior derecha de la ventana, o bien haz clic en el botón que aparece a continuación.

Envíanos tus comentarios