Entorno de desarrollo de dispositivos virtuales de Matter

SDK del dispositivo

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 a fin de controlar y mostrar los estados de tus dispositivos Matter virtuales. La app proporciona una representación visual del dispositivo virtual, así como los controles de los clústeres Matter compatibles con el dispositivo.

La app usa un cliente de RPC para comunicarse con el servidor RPC del dispositivo virtual, envía solicitudes que reflejan tus acciones (activar o desactivar, atenuar, iluminar) y sondea 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 ampliada Encendido/apagado
Control de nivel
Control de color
Ligera
Sensor de flujo Medición de flujo Sensor
Sensor de humedad Medición de humedad relativa Sensor
Sensor de iluminancia Medición de iluminancia Sensor
Sensor de ocupación Detección de ocupación Sensor
Luz de encendido y apagado Activar/Desactivar Ligera
Enchufe Control de nivel
activado/desactivado
Salida
Sensor de presión Medición de presión Sensor
Bocina Control de nivel
activado/desactivado
Bocina
Switch Activar/Desactivar Switch
Sensor de temperatura Medición de 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 el siguiente comando:

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 afirma que la configuración del contenedor es correcta y, finalmente, el mensaje de shell del contenedor:

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

    user@host> docker exec -it matter-container /bin/bash
    
  3. En el caso de un dispositivo virtual Matter, una vez que el dispositivo 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
    

    En el caso de un dispositivo físico, inicia el VDC y pásale el argumento --d seguido del puerto en 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 del socket de red con el puerto localhost 33000.

Una vez que VDC pueda conectarse a tu dispositivo, mostrará una pantalla en la que se mostrará el estado del dispositivo:

Interfaz gráfica de usuario de dispositivo virtual

Muestra el código QR del dispositivo

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

Controlador de dispositivo virtual que muestra el código QR del dispositivo

Puedes usar este código QR para realizar la asignación de 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 enfocada o Control + C en la sesión de terminal en la que iniciaste la app.

Comentarios

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

Envíanos tus comentarios