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:

Interface gráfica do usuário do dispositivo virtual

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:

Controlador do dispositivo virtual mostrando o código QR do dispositivo

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