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 o Matter Virtual Device (MVD) e usar o app para computador Virtual Device Controller (VDC) para fornecer uma interface gráfica do usuário que controla e exibe os estados dos dispositivos Matter virtuais. O app oferece uma representação visual do dispositivo virtual, bem como os controles para os clusters Matter com suporte do dispositivo.

O app usa um cliente de RPC para se comunicar com o servidor de RPC do dispositivo virtual, enviando solicitações que refletem suas ações (mudar a energia, escurecer, clarear) e pesquisando 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 aplicativo Tipo de ecossistema doméstico
Sensor de contato Estado booleano Sensor
Luz durável Ativado/Desativado
Controle de nível
Claro
Cor clara estendida Ativado/Desativado
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 presença Sensor
Luz ligada/desligada Ligado/Desligado Claro
Tomada Ativado/Desativado
Controle de nível
Saída
Sensor de pressão Medição de pressão Sensor
Palestrante Ativado/Desativado
Controle de nível
Apresentador
Trocar Ligado/Desligado Switch
Sensor de temperatura Medição de temperatura Sensor

Configurar o ambiente de desenvolvimento do dispositivo virtual Matter

MVD-DE é uma imagem do Docker pré-configurada 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 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 confirmando 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 instância da segunda sessão do terminal:

    user@host> docker exec -it matter-container /bin/bash
    
  3. Para um dispositivo Matter virtual, 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 VDC, passando o argumento --d seguido pela porta serial do dispositivo:

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

Se você iniciar o VDC sem fornecer nenhum argumento, ele vai usar a porta localhost 33000 como padrão para a opção de soquete de rede.

Assim que o VDC puder se conectar ao seu dispositivo, ele vai mostrar uma tela mostrando o estado do dispositivo:

Interface gráfica do usuário de dispositivo virtual

Mostrar o QR code do dispositivo

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

Controlador de dispositivo virtual mostrando o QR code do dispositivo

Você pode usar este QR code para comissionar seu dispositivo.

Interromper o ambiente de desenvolvimento de dispositivos virtuais do Matter

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

Feedback

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

Envie seu feedback