¡Atención! Pronto se lanzarán nuevos programas de vista previa para desarrolladores. Postúlate aquí y sé una de las primeras personas en probar herramientas nuevas y enviar comentarios.

Controlador de dispositivo virtual

SDK del dispositivo

El controlador de dispositivos virtuales es una app de escritorio que proporciona una interfaz gráfica de usuario para controlar y mostrar los estados de los dispositivos Matter virtuales. La app proporciona una representación visual de tu dispositivo virtual, así como los controles para 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, envía solicitudes que reflejan tus acciones (activar o desactivar, atenuar o aumentar el brillo) y realiza un sondeo una vez por segundo para recuperar estados.

Dispositivos compatibles

Actualmente, el controlador de dispositivo virtual admite los siguientes tipos de dispositivos Matter:

Tipo de dispositivo Matter Clústeres de aplicaciones Tipo de ecosistema de Home
Sensor de contacto Estado booleano Sensor
Luz regulable Control de nivel
Activado/Desactivado
Ligera
Color extendido Activado/Desactivado
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 iluminación Sensor
Sensor de ocupación Sensor de ocupación Sensor
Luz de encendido/apagado Activar/Desactivar Ligera
Enchufe Control de nivel
Activado/Desactivado
Tomacorriente
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 controlador de dispositivo virtual

El controlador de dispositivo virtual se proporciona como parte de una imagen de Docker configurada previamente que está disponible en Docker Hub. Para instalarla, ejecute 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 controlador de dispositivo virtual

  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 un resultado del diagnóstico seguido de un mensaje que indica que la configuración del contenedor es correcta y, por último, el símbolo del sistema 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. Para un dispositivo virtual Matter, una vez que se esté ejecutando, inicia el controlador de dispositivo virtual 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 el controlador de dispositivo virtual y pásale el argumento --d seguido del puerto en serie del dispositivo:

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

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

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

Interfaz de usuario gráfica de dispositivo virtual

Muestra el código QR del dispositivo

La app de controlador de dispositivo virtual también se puede usar para recuperar el código QR como parte del flujo de asignación de dispositivos. Haz clic en el ícono de código QR junto a la imagen del dispositivo para ver su código:

El controlador de dispositivo virtual muestra el código QR del dispositivo.

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

Cómo detener el controlador de dispositivo virtual

Para detener el controlador de dispositivo virtual, presiona Control-Q con la pantalla del controlador enfocada o presiona Control-C en la sesión de la terminal en la que iniciaste la app.

Comentarios

Completa nuestro formulario de comentarios para enviar tus comentarios o sugerencias sobre cómo podemos mejorar tu experiencia con el controlador de dispositivo virtual.

Envíanos tus comentarios