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 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 Matter que têm suporte do dispositivo.

O app usa um cliente RPC para se comunicar com o servidor de RPC do dispositivo virtual, enviando solicitações que refletem suas ações (alternar energia, esmaecer, iluminar) e pesquisar uma vez por segundo para recuperar o estado.

Dispositivos com suporte

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

Matter tipo de dispositivo Clusters de aplicativo Tipo de ecossistema doméstico
Entrar em contato com o sensor Estado booleano Sensor
Luz regulável Ativar/desativar
controle do nível
Claro
Cores estendidas (claro) Ativar/desativar
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 de ativação/desativação Ligado/Desligado Claro
Tomada Ativar/desativar
controle do nível
Saída
Sensor de pressão Medição de pressão Sensor
Alto-falante Ativar/desativar
controle do nível
Apresentador
Switch Ligado/Desligado Switch
Sensor de temperatura Medição de temperatura Sensor

Configurar o ambiente de desenvolvimento do dispositivo virtual do Matter

A 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 afirmando 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 VDC, passando o argumento --s e a porta IP usada pelo dispositivo:

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

    Para um dispositivo físico, inicie 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 localhost 33000.

Quando o VDC puder se conectar ao seu dispositivo, uma tela mostrando o estado do dispositivo será exibida:

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 de código QR ao lado da imagem do dispositivo para exibir o código QR:

O Virtual Device Controller mostra o código QR do dispositivo

É possível usar este código QR para comissionar seu dispositivo.

Parar o ambiente de desenvolvimento do dispositivo virtual do Matter

Para interromper o MVD-DE, pressione Control + Q com a tela de VDC em foco ou pressione Control + 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