Контроллер виртуальных устройств — это настольное приложение, которое предоставляет графический пользовательский интерфейс для управления и отображения состояний ваших виртуальных Matter devices. The app provides a visual representation of your virtual device, as well as the controls for the Matter clusters supported by the device.
Приложение использует клиент RPC для связи с сервером RPC виртуального устройства, отправляя запросы, отражающие ваши действия (переключение питания, затемнение, повышение яркости) и опрашивая каждую секунду для получения состояния.
Поддерживаемые устройства
В настоящее время Контроллер виртуальных устройств поддерживает следующие типы устройств Matter :
Тип устройства Matter | Кластер(ы) приложений | Тип домашней экосистемы |
---|---|---|
Контактный датчик | Логическое состояние | Датчик |
Диммируемый свет | Вкл выкл Контроль уровня | Свет |
Расширенный цветной свет | Вкл выкл Контроль уровня Контроль цвета | Свет |
Датчик расхода | Измерение расхода | Датчик |
Датчик влажности | Измерение относительной влажности | Датчик |
Датчик освещенности | Измерение освещенности | Датчик |
Датчик присутствия | Датчик присутствия | Датчик |
Вкл/выкл свет | Вкл выкл | Свет |
Выход | Вкл выкл Контроль уровня | Выход |
Датчик давления | Измерение давления | Датчик |
Оратор | Вкл выкл Контроль уровня | Оратор |
Выключатель | Вкл выкл | Выключатель |
Датчик температуры | Измерение температуры | Датчик |
Настройте контроллер виртуального устройства
Контроллер виртуального устройства предоставляется как часть предварительно настроенного образа Docker, доступного в Docker Hub. Чтобы установить его, запустите:
user@host> docker pull us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
Выполнение этой операции может занять несколько минут.
Запустите контроллер виртуального устройства
Запустите контейнер 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
После запуска контейнера вы должны увидеть некоторый диагностический вывод, за которым следует сообщение, подтверждающее, что ваша конфигурация контейнера верна, и, наконец, приглашение оболочки контейнера:
Environment looks good, you are ready to go!
Создайте второй экземпляр сеанса терминала:
user@host> docker exec -it matter-container /bin/bash
Для виртуального устройства Matter после запуска устройства запустите контроллер виртуального устройства, передав ему аргумент
--s
и IP-порт, используемый устройством:$ electron main.js --s=localhost:33000
Для физического устройства запустите Virtual Device Controller, передав ему аргумент
--d
, за которым следует последовательный порт устройства:$ electron main.js --d=/dev/ttyUSB0
Если вы запустите контроллер без каких-либо аргументов, по умолчанию он будет использовать параметр сетевого сокета, используя порт localhost 33000.
Как только контроллер сможет подключиться к вашему устройству, он отобразит экран, показывающий состояние вашего устройства:
Показать QR-код устройства
Приложение Virtual Device Controller также можно использовать для извлечения QR-кода в процессе ввода устройства в эксплуатацию. Щелкните значок QR-кода рядом с изображением устройства, чтобы отобразить QR-код для этого устройства:
Вы можете использовать этот QR-код для ввода устройства в эксплуатацию.
Остановить контроллер виртуального устройства
Чтобы остановить контроллер виртуального устройства, нажмите Control-Q, когда экран контроллера находится в фокусе, или нажмите Control-C в сеансе терминала, где вы запустили приложение.
Обратная связь
Чтобы поделиться своими мыслями или отзывами о том, как мы можем улучшить ваше взаимодействие с контроллером виртуального устройства, заполните нашу форму обратной связи.