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

La aplicación usa un cliente de RPC para comunicarse con el servidor de RPC del dispositivo virtual, envía solicitudes que reflejan tus acciones (activar o desactivar, atenuar, aclarar) 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 para la casa
Sensor de contacto Estado booleano Sensor
Luz regulable Control de nivel
de encendido/apagado
Ligera
Color extendido: claro Activar/desactivar
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 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
de encendido/apagado
Punto de salida
Sensor de presión Medición de presión Sensor
Bocina Control de nivel
de encendido/apagado
Bocina
Cambiar 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 preconfigurada de Docker que está disponible en Docker Hub. Para instalarla, 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 en el que se confirma que la configuración del contenedor es correcta y, por último, el mensaje de la 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 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
    

    En 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 de socket de red mediante el puerto localhost 33000.

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

Interfaz gráfica de usuario del dispositivo virtual

Muestra el código QR del dispositivo

El VDC también se puede usar para recuperar el código QR como parte del flujo de comisión de dispositivos. 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 del dispositivo virtual que muestra el código QR del dispositivo

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

Comentarios

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

Envíanos tus comentarios