Ambiente di sviluppo Matter Virtual Device Development

SDK del dispositivo

Matter Virtual Device Development Environment (MVD-DE) è un container Docker in cui puoi creare Matter Virtual Device (MVD) e usa l'app desktop Virtual Device Controller (VDC) per una Graphic User Interface per controllare e visualizzare gli stati dispositivi Matter virtuali. L'app offre un'interfaccia rappresentazione del dispositivo virtuale, oltre ai controlli per Matter cluster supportati dal dispositivo.

L'app utilizza un client RPC per comunicare con il server RPC del dispositivo virtuale, di richieste che riflettono le azioni (attiva/disattiva, attenua, aumenta l'intensità) eseguire il polling una volta al secondo per recuperare lo stato.

Dispositivi supportati

Attualmente, il MVD-DE supporta le seguenti funzionalità Matter tipi di dispositivi:

Matter tipo di dispositivo Cluster di applicazioni Tipo di ecosistema domestico
Sensore di contatto Stato booleano Sensore
Luce regolabile On/Off
Controllo livello
Chiaro
Luce colore estesa On/Off
Controllo livello
Controllo colore
Chiaro
Sensore di flusso Misurazione del flusso Sensore
Sensore di umidità Misurazione dell'umidità relativa Sensore
Sensore di illuminamento Misurazione dell'illuminazione Sensore
Sensore di presenza Rilevamento della presenza Sensore
Luce on/off ON/OFF Chiaro
Presa elettrica On/Off
Controllo livello
Presa
Sensore di pressione Misurazione della pressione Sensore
Altoparlante On/Off
Controllo livello
Altoparlante
Cambia ON/OFF Cambia
Sensore di temperatura Misurazione della temperatura Sensore

Configura l'ambiente di sviluppo di dispositivi virtuali Matter

MVD-DE è un'immagine Docker preconfigurata disponibile nella Docker Hub. Per installarlo, esegui:

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

Il completamento dell'operazione potrebbe richiedere alcuni minuti.

Gestisci l'ambiente di sviluppo di dispositivi virtuali Matter

  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 vedere un output diagnostico seguito da un messaggio che afferma che la configurazione del container è corretta e Infine, il 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 VDC, passando l'argomento --s e l'IP porta usata dal dispositivo:

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

    Per un dispositivo fisico, avvia VDC, passando il --d seguito dalla porta seriale del dispositivo:

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

Se avvii VDC senza fornire argomenti, utilizzerà per impostazione predefinita l'opzione del socket di rete utilizzando la porta localhost 33000.

Quando VDC riesce a connettersi al tuo dispositivo, mostra una schermata che mostra lo stato del dispositivo:

Interfaccia utente grafica del dispositivo virtuale

Mostrare il codice QR del dispositivo

VDC può essere utilizzato anche per recuperare il codice QR come parte del flusso di messa in servizio del dispositivo. Fai clic sull'icona del codice QR accanto all'immagine del dispositivo per visualizzare il codice QR del dispositivo:

Virtual Device Controller che mostra il codice QR del dispositivo

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

Interrompi l'ambiente di sviluppo di dispositivi virtuali Matter

Per arrestare MVD-DE, premi Ctrl+Q con il lo schermo di VDC a fuoco oppure premi Ctrl-C nel terminale sessione in cui hai avviato l'app.

Feedback

Per inviare la tua opinione o feedback su come possiamo migliorare la tua esperienza con MVD-DE, compila il nostro Modulo di feedback.

Inviaci il tuo feedback