Entorno de desarrollo de dispositivos virtuales de Matter

SDK de dispositivos

Matter Virtual Device Development Environment (MVD-DE) es un contenedor de Docker en el que puedes crear tu Matter Virtual Device (MVD) y usar la app de escritorio Virtual Device Controller (VDC) para proporcionar una interfaz gráfica de usuario que controle y muestre los estados de tus dispositivos Matter virtuales. La app proporciona una representación visual de tu dispositivo virtual, así como los controles de los clústeres Matter que admite el dispositivo.

La app usa un cliente de RPC para comunicarse con el servidor de RPC del dispositivo virtual, enviar solicitudes que reflejan tus acciones (activar o desactivar la alimentación, atenuar o aumentar la intensidad) y sondear una vez por segundo para recuperar el estado.

Dispositivos compatibles

Actualmente, MVD-DE admite los siguientes tipos de dispositivos Matter:

Matter Tipo de dispositivo Clústeres de aplicaciones Tipo de ecosistema de la casa
Sensor de contacto Estado booleano Sensor
Luz regulable Control de nivel
activado/desactivado
Ligera
Luz de color extendida Activado/desactivado
Control de nivel
Control de color
Ligera
Sensor de flujo Medición de flujo Sensor
Sensor de humedad Medición de la humedad relativa Sensor
Sensor de iluminación Medición de la iluminación Sensor
Sensor de ocupación Detección de ocupación Sensor
Luz de encendido/apagado Activar/Desactivar Ligera
Enchufe Control de nivel
activado/desactivado
Outlet
Sensor de presión Medición de la presión Sensor
Bocina Control de nivel
activado/desactivado
Bocina
Cambiar Activar/Desactivar Switch
Sensor de temperatura Medición de la temperatura Sensor

Configura el entorno de desarrollo de dispositivos virtuales de Matter

MVD-DE es una imagen de Docker preconfigurada disponible en Docker Hub. Para instalarlo, ejecuta lo siguiente:

user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest

Esta operación puede tardar unos minutos en completarse.

Ejecuta el entorno de desarrollo de dispositivos virtuales de Matter

  1. Inicia el contenedor de 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
    

    Después de iniciar el contenedor, deberías ver algunos resultados de diagnóstico, seguidos de un mensaje que confirma que la configuración del contenedor es correcta y, por último, el mensaje del shell del contenedor:

    Environment looks good, you are ready to go!
    
  2. Crea una segunda instancia de sesión de terminal:

    user@host> docker exec -it matter-container /bin/bash
    
  3. En el caso de un dispositivo Matter virtual, una vez que esté en ejecución, inicia VDC y pásale el argumento --s y el puerto IP que usa el dispositivo:

    $ electron main.js --s=localhost:33000
    

    Para un dispositivo físico, inicia VDC y pásale el argumento --d seguido del puerto serie del dispositivo:

    $ electron main.js --d=/dev/ttyUSB0
    

Si inicias VDC sin proporcionar ningún argumento, se usará de forma predeterminada la opción de socket de red con el puerto localhost 33000.

Una vez que VDC pueda conectarse a tu dispositivo, mostrará una pantalla que indica el estado de tu dispositivo:

Interfaz gráfica de usuario del dispositivo virtual

Cómo mostrar el código QR del dispositivo

VDC también se puede usar para recuperar el código QR como parte del flujo de comisión del dispositivo. Haz clic en el ícono de código QR junto a la imagen del dispositivo para mostrar el código QR de este dispositivo:

Controlador de dispositivos virtuales que muestra el código QR del dispositivo

Puedes usar este código QR para comisionar tu dispositivo.

Detén el entorno de desarrollo de dispositivos virtuales de Matter

Para detener MVD-DE, presiona Control Q con la pantalla de VDC en foco o presiona Control C en la sesión de la terminal en la que iniciaste la app.

Comentarios

Para enviar tus comentarios sobre cómo podemos mejorar tu experiencia con MVD-DE, completa nuestro formulario de comentarios.

Envíanos tus comentarios