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 use o app para computador Virtual Device Controller (VDC) para fornecem uma interface gráfica do usuário para controlar e exibir os estados dos dispositivos Matter virtuais. O aplicativo oferece uma interface representação do seu dispositivo virtual, bem como os controles do Matter clusters com suporte ao dispositivo.

O aplicativo usa um cliente RPC para se comunicar com o servidor RPC do dispositivo virtual, enviar solicitações que reflitam suas ações (desativar energia, escurecer, aumentar) e uma pesquisa por segundo para recuperar o estado.

Dispositivos compatíveis

Atualmente, o MVD-DE oferece suporte ao seguinte: Matter tipo de dispositivo:

Matter tipo de dispositivo Clusters de aplicativo 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 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 Ativar/Desativar Claro
Tomada Ativado/Desativado
Controle de nível
Saída
Sensor de pressão Medição de pressão Sensor
Alto-falante Ativado/Desativado
Controle de nível
Apresentador
Switch Ativar/Desativar Switch
Sensor de temperatura Medição de temperatura Sensor

Configurar o ambiente de desenvolvimento do dispositivo virtual Matter

O 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ê vai receber uma saída de diagnóstico por uma mensagem confirmando que a configuração do seu 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 o dispositivo estiver em execução, inicie a VDC, passando o argumento --s e o IP usada pelo dispositivo:

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

    Para um dispositivo físico, inicie a VDC, transmitindo a --d seguido pela porta serial do dispositivo:

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

Se você iniciar a VDC sem fornecer nenhum argumento, ela o padrão será a opção de soquete de rede usando a porta localhost 33000.

Assim que o VDC puder se conectar ao seu dispositivo, ele vai exiba 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 imagem do dispositivo para exibir o QR code:

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

Você pode usar esse código QR para comissionar seu dispositivo.

Interromper o ambiente de desenvolvimento de dispositivos virtuais do Matter

Para interromper o MVD-DE, pressione Ctrl+Q com o Tela de VDC em foco ou pressione Control+C no terminal em que você iniciou o app.

Feedback

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

Envie seu feedback.