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 para controlar e exibir os estados dos dispositivos Matter virtuais. O app fornece uma representação visual do dispositivo virtual, bem como os controles dos clusters Matter compatíveis com o 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 (alternam, escurecem, iluminam) e pesquisando uma vez por segundo para recuperar o estado.
Dispositivos compatíveis
Atualmente, o MVD-DE é compatível com os seguintes tipos de dispositivo Matter:
| Tipo de dispositivo Matter | Cluster(s) de aplicativo | Tipo de ecossistema da casa |
|---|---|---|
| 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 iluminação | Medição de iluminação | Sensor |
| Sensor de ocupação | Detecção de ocupação | Sensor |
| Acender ou apagar a luz | Ligado/Desligado | Claro |
| Tomada | Controle de nível ativado/desativado |
Outlet (em inglês) |
| Sensor de pressão | Medição de pressão | Sensor |
| Alto-falante | Controle de nível ativado/desativado |
Apresentador |
| Switch | Ligado/Desligado | 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 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 de dispositivos virtuais do 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:latestDepois de iniciar o contêiner, você verá uma saída de diagnóstico seguida por uma mensagem informando 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!Crie uma segunda instância da sessão do terminal:
user@host> docker exec -it matter-container /bin/bashPara um dispositivo Matter virtual, quando o dispositivo estiver em execução, inicie o VDC, transmitindo o argumento
--se a porta IP usada pelo dispositivo:$ electron main.js --s=localhost:33000Para um dispositivo físico, inicie VDC, transmitindo o argumento
--dseguido pela porta serial do dispositivo:$ electron main.js --d=/dev/ttyUSB0
Se você iniciar VDC sem fornecer argumentos, o padrão será a opção de soquete de rede usando a porta localhost 33000.
Quando o VDC conseguir se conectar ao dispositivo, uma tela com o estado do dispositivo será exibida:
Mostrar o código QR 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 código QR ao lado da imagem do dispositivo para exibir o código:
Você pode usar esse código QR para encomendar 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 sua opinião ou seu feedback sobre como podemos melhorar sua experiência com o MVD-DE, preencha nosso formulário de feedback.