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
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!
Crie uma instância da segunda sessão do terminal:
user@host> docker exec -it matter-container /bin/bash
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:
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:
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.