Controller per dispositivi virtuali

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

SDK dispositivo

Il controller del dispositivo virtuale è un'app per desktop che offre una Graphic User Interface per controllare e visualizzare gli stati della VM. 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.

L'app utilizza un client RPC per comunicare con il server RPC del dispositivo virtuale, inviando richieste che riflettono le tue azioni (potenza di attivazione/disattivazione, attenuazione e luminosità) e sondaggi una volta al secondo per recuperare lo stato.

Dispositivi supportati

Attualmente, il controller del dispositivo virtuale supporta i seguenti tipi di dispositivi Matter:

Matter tipo di dispositivo Cluster di applicazioni Tipo di ecosistema domestico
Sensore di contatto Stato booleano Sensore
Luce dimmerabile On/Off
Controllo del livello
Luce
Luce colorata estesa On/Off
Controllo del livello
Controllo del colore
Luce
Sensore di flusso Misurazione del flusso Sensore
Sensore di umidità Misurazione dell'umidità relativa Sensore
Sensore di illuminazione Misurazione dell'illuminazione Sensore
Sensore di presenza Rilevamento del numero di partecipanti Sensore
Spia accesa/spenta ON/OFF Luce
Presa elettrica On/Off
Controllo del livello
Outlet
Sensore di pressione Misurazione della pressione Sensore
Altoparlante On/Off
Controllo del livello
Relatore
Cambia ON/OFF Cambia
Sensore di temperatura Misurazione della temperatura Sensore

Configurare il controller del dispositivo virtuale

Il controller del dispositivo virtuale viene fornito come parte di un'immagine Docker preconfigurata disponibile su Docker Hub. Per installarla, esegui questo comando:

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

L'operazione potrebbe richiedere alcuni minuti.

Esegui il controller del dispositivo virtuale

  1. Avvia il container 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
    

    Dopo aver avviato il container, dovresti visualizzare un output di diagnostica seguito da un messaggio che conferma la correttezza della configurazione del container e, infine, dal prompt della shell del container:

    Environment looks good, you are ready to go!
    
  2. Crea una seconda istanza di sessione del terminale:

    user@host> docker exec -it matter-container /bin/bash
    
  3. Per un dispositivo Matter virtuale, quando il dispositivo è in esecuzione, avvia il controller del dispositivo virtuale, trasmettendo l'argomento --s e la porta IP utilizzata dal dispositivo:

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

    Per un dispositivo fisico, avvia il controller del dispositivo virtuale, passando l'argomento --d seguito dalla porta seriale del dispositivo:

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

Se avvii il controller senza fornire argomenti, verrà utilizzata per impostazione predefinita l'opzione socket di rete utilizzando la porta localhost 33000.

Quando il controller è in grado di connettersi al dispositivo, viene visualizzata una schermata con lo stato del dispositivo:

Interfaccia utente grafica di un dispositivo virtuale

Mostra il codice QR del dispositivo

L'app Virtual Device Controller può essere utilizzata anche per recuperare il codice QR nell'ambito della procedura di messa in servizio del dispositivo. Fai clic sull'icona del codice QR accanto all'immagine del dispositivo per visualizzare il codice QR per questo dispositivo:

Controller di dispositivi virtuali che mostra il codice QR del dispositivo

Puoi utilizzare questo codice QR per mettere in servizio il dispositivo.

Arresta il controller del dispositivo virtuale

Per interrompere il controller del dispositivo virtuale, premi Ctrl+Q con lo schermo del controller attivo, oppure premi Ctrl+C nella sessione del terminale in cui hai avviato l'app.

Feedback

Per inviare la tua opinione o il tuo feedback su come possiamo migliorare la tua esperienza con il controller del dispositivo virtuale, compila il nostro modulo di feedback.

Inviare un feedback