Controlador de dispositivo virtual

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

SDK de Device

El controlador de dispositivo virtual es una app de escritorio que proporciona una interfaz gráfica de usuario para controlar y mostrar los estados de tu entorno virtual. Matter devices. The app provides a visual representation of your virtual device, as well as the controls for the Matter clusters supported by the device.

La app usa un cliente RPC para comunicarse con el servidor RPC del dispositivo virtual, envía solicitudes que reflejan tus acciones (activar o desactivar, atenuar o aclarar) y sondear una vez por segundo a fin de recuperar el estado.

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 la casa
Sensor de contacto Estado booleano Sensor
Luz atenuable Activado/Desactivado
Control de nivel
Ligera
Luz de color extendida Activado/Desactivado
Control de nivel
Control de color
Ligera
Sensor de flujo Medición del 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 Sensor de ocupación Sensor
Encender/apagar luz Activar/Desactivar Ligera
Enchufe Activado/Desactivado
Control de nivel
Toma de corriente
Sensor de presión Medición de la presión Sensor
Bocina Activado/Desactivado
Control de nivel
Bocina
Cambiar 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 preconfigurada de Docker 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 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 de diagnóstico seguido de un mensaje que afirme que tu 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. Para un dispositivo Matter virtual, una vez que el dispositivo esté en ejecución, inicia el controlador del 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 del 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 controlador pueda conectarse a tu dispositivo, mostrará una pantalla en la que se mostrará el estado del dispositivo:

Interfaz de usuario gráfica de dispositivo virtual

Mostrar el código QR del dispositivo

La app de Virtual Device Controller también se puede usar para recuperar el código QR como parte de tu flujo de puesta en marcha del dispositivo. Haz clic en el ícono de código QR junto a la imagen del dispositivo para mostrar el código QR.

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

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

Detener el controlador de dispositivo virtual

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

Comentarios

Para enviar tus opiniones o comentarios sobre cómo podemos mejorar la experiencia con el controlador de dispositivo virtual, completa el formulario de comentarios.

Envíanos tus comentarios