Ambiente de desenvolvimento virtual do dispositivo Matter

SDK do dispositivo

O Matter Virtual Device Development Environment (MVD-DE) é um contêiner do Docker em que é possível criar seu Matter Virtual Device (MVD) e usar o app Virtual Device Controller (VDC) para computador a fim de fornecer uma interface gráfica do usuário para controlar e exibir os estados dos dispositivos virtuais Matter. O app fornece uma representação visual do seu dispositivo virtual, bem como os controles dos clusters de Matter com suporte do dispositivo.

O app usa um cliente RPC para se comunicar com o servidor RPC do dispositivo virtual, enviando solicitações refletindo suas ações (alternar energia, diminuir, aumentar brilho) e sondando uma vez por segundo para recuperar o estado.

Dispositivos compatíveis

Atualmente, o MVD-DE oferece suporte aos seguintes tipos de dispositivo Matter:

Matter tipo de dispositivo	Clusters de aplicativos	Tipo de ecossistema doméstico
Sensor de contato	Estado booleano	Sensor
Luz regulável	Controle de nível ativado/desativado	Claro
Luz de cor estendida	Ligar/desligar Controle de nível Controle de cor	Claro
Sensor de fluxo	Medição de fluxo	Sensor
Sensor de umidade	Medição de umidade relativa	Sensor
Sensor de iluminação	Medição de iluminação	Sensor
Sensor de presença	Detecção de ocupação	Sensor
Luz apagada/apagada	Ligado/Desligado	Claro
Tomada	Controle de nível ativado/desativado	Saída
Sensor de pressão	Medição de pressão	Sensor
Alto-falante	Controle de nível ativado/desativado	Apresentador
Switch	Ligado/Desligado	Switch
Sensor de temperatura	Medição de temperatura	Sensor

Configurar o ambiente de desenvolvimento do dispositivo virtual do Matter

O MVD-DE é uma imagem pré-configurada do Docker disponível no Docker Hub. Para instalá-lo, execute:

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

Essa operação pode levar alguns minutos para ser concluída.

Executar o ambiente de desenvolvimento do dispositivo virtual do Matter

1. Inicie o contêiner do 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
   

   Depois de iniciar o contêiner, você verá uma saída de diagnóstico seguida por uma mensagem que confirma que a configuração do contêiner está correta e, por fim, o prompt do shell do contêiner:

   Environment looks good, you are ready to go!
   

2. Crie uma segunda instância de sessão do terminal:

   user@host> docker exec -it matter-container /bin/bash
   

3. Para um dispositivo virtual Matter, quando ele estiver em execução, inicie o VDC, transmitindo o argumento --s e a porta IP usada pelo dispositivo:

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

   Para um dispositivo físico, inicie o VDC, passando o argumento --d seguido pela porta serial do dispositivo:

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

Se você iniciar o VDC sem fornecer argumentos, ele usará a opção de soquete de rede como padrão usando a porta 33000 do localhost.

Quando o VDC puder se conectar ao dispositivo, ele exibirá uma tela mostrando o estado do dispositivo:

Mostrar o código QR do dispositivo

O VDC também pode ser usado para extrair o código QR como parte do fluxo de comissionamento do dispositivo. Clique no ícone do código QR ao lado da imagem do dispositivo para exibir o código QR:

Use este código QR para comissionar seu dispositivo.

Interromper o ambiente de desenvolvimento do dispositivo virtual do Matter

Para interromper o MVD-DE, pressione Ctrl+Q com a tela de VDC em foco ou pressione Ctrl+C na sessão do terminal em que você iniciou o app.

Feedback

Para enviar sua opinião ou feedback sobre como podemos melhorar sua experiência com o MVD-DE, preencha nosso formulário de feedback.

Envie seu feedback