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 você pode 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 para controlar e mostrar os estados dos dispositivos Matter virtuais. O app fornece uma representação visual do dispositivo virtual, além dos controles para os clusters Matter aceitos pelo dispositivo.

O app usa um cliente RPC para se comunicar com o servidor RPC do dispositivo virtual, enviando solicitações que refletem suas ações (ligar, desligar, escurecer, iluminar) e fazendo pesquisas uma vez por segundo para recuperar o estado.

Dispositivos compatíveis

No momento, 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 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 luminosidade Medição de iluminamento Sensor
Sensor de ocupação Detecção de ocupação Sensor
Luz de ativação/desativação Ativar/Desativar Claro
Tomada Controle de nível
ativado/desativado
Tomadas
Sensor de pressão Medição de pressão Sensor
Alto-falante Controle de nível
ativado/desativado
Apresentador
Switch Ativar/Desativar Switch
Sensor de temperatura Medição de temperatura Sensor

Configurar o ambiente de desenvolvimento de dispositivos virtuais do Matter

O MVD-DE é uma imagem pré-configurada do Docker disponível no Docker Hub. Para instalar, 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 de dispositivos virtuais 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 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 segunda instância de sessão de terminal:

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

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

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

Quando o VDC conseguir se conectar ao seu dispositivo, ele vai mostrar uma tela com o estado do dispositivo:

Interface gráfica do usuário do dispositivo virtual

Mostrar o QR code do dispositivo

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

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

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

Parar o ambiente de desenvolvimento de dispositivos virtuais do Matter

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

Feedback

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

Envie seu feedback