1. Введение
Matter — это протокол подключения, который открывает потрясающие возможности для разработки интеллектуальных устройств. В этой лаборатории вы создадите свое первое устройство Matter, используя ресурсы Matter SDK.
Чтобы узнать о Matter, посетите Центр разработчиков Google Home или веб-сайт Connectivity Standards Alliance .
Что вы узнаете
- Как настроить среду сборки Matter
- Как создать виртуальное устройство Matter, работающее на вашем компьютере
- Как настроить и управлять виртуальным устройством Matter с помощью Google Home
Что вам понадобится
- Хаб — это любое устройство Google Nest, поддерживающее Matter , например Nest Hub (2-го поколения).
- Машина Linux с оконной системой X11.
- Докер.
- Гит.
- Базовые знания Linux.
- Обратите внимание, что предполагаемая оболочка для всех команд в этой лаборатории — BASH.
2. Настройте свою среду
Проверьте свое оборудование
Компьютеры Windows и macOS не поддерживаются этой установкой Docker. Вы можете вручную установить и собрать Matter на macOS.
Кроме того, в этих инструкциях предполагается, что на вашем компьютере с Linux установлена оконная система X11. Если на вашем компьютере с Linux работает Wayland, убедитесь, что X.Org также установлен.
Настройка среды разработки
- Установите Docker Engine (не используйте Docker Desktop).
- Клонируйте Matter SDK. Обратите внимание на коммит, который мы используем ниже.
git clone https://github.com/project-chip/connectedhomeip.git cd connectedhomeip git show commit f2f3d0eb03ba5bea32b22f19982c402a8c1c9063
- Запустите контейнер сборки, используя общедоступные образы CI SDK, и запустите вновь созданное виртуальное устройство из этого контейнера. Найдите изображение, которое будет соответствовать нашей версии SDK, следующим образом:
buildimage=$(grep chip-build .github/workflows/chef.yaml | head -n 1 | awk '{print $2}') echo $buildimage
Если вы используете тот же коммит, вы должны увидетьghcr.io/project-chip/chip-build:66
Сначала перенаправьте порты xhost, чтобы мы могли позже использовать приложения пользовательского интерфейса:xhost local:1000
Затем запустите контейнер с соответствующими ресурсами, перенаправленными с хоста (наш SDK для проверки, сети и ресурсов отображения/связи).docker run -it --ipc=host --net=host -e DISPLAY --name matter-container --mount source=$(pwd),target=/workspace,type=bind --workdir="/workspace" $buildimage /bin/bash
Давайте разберемся с командой docker и параметрами, которые мы ей передали:
-
xhost local:1000
позволяет системе X Window получать соединения от локального хоста через порт 1000, что позволяет использовать графический интерфейс пользователя. -
docker run … image
запускает заданный образ, при необходимости извлекая его из реестра Docker. -
--ipc=host
позволяет Docker использовать пространство имен межпроцессного взаимодействия с вашим хост-компьютером. -
--net=host
позволяет Docker использовать сетевой стек хоста внутри контейнера, что необходимо для передачи трафика mDNS от хоста к контейнеру, а также для совместного использования дисплея X11 хоста. -
-e DISPLAY
экспортирует$DISPLAY
на хост, обеспечивая доступ к графическому интерфейсу вашей системы. Это необходимо для запуска инструмента ZAP при редактировании кластеров Материи. -
-it
запускает Docker с интерактивным терминалом (tty), а не в фоновом режиме. -
--mount
монтирует ранее извлеченный нами SDK в контейнер. -
--workdir
устанавливает рабочий каталог при запуске в наш смонтированный каталог SDK.
При желании вы можете запустить второй экземпляр сеанса терминала:
user@host> docker exec -it matter-container /bin/bash $
Остановите и запустите контейнер Matter Docker.
Всякий раз, когда вы запускаете команду docker run
, вы создаете новый контейнер с указанным образом. Когда вы это сделаете, ваши старые данные, сохраненные в предыдущем экземпляре контейнера, будут потеряны. Иногда это именно то, что вам нужно, потому что это позволяет вам начать новую установку. Но бывают случаи, когда вы предпочитаете сохранять конфигурацию своей работы и среды между сеансами.
По этой причине после создания контейнера вы можете остановить его, чтобы не потерять свою работу.
user@host> docker stop matter-container
Когда вы будете готовы к повторному запуску, запустите контейнер и откройте окно терминала:
user@host> docker start matter-container user@host> docker exec -it matter-container /bin/bash
Вы можете открыть дополнительные сеансы терминала для вашего контейнера с помощью:
user@host> docker exec -it matter-container /bin/bash
Или запустите корневой сеанс, используя:
user@host> docker exec -u 0 -it matter-container /bin/bash
Начальная настройка Материи
Инициализируйте SDK
Инициализируйте Matter SDK. Выполнение этой операции займет несколько минут.
source scripts/bootstrap.sh python3 scripts/checkout_submodules.py --shallow --platform linux
Ваш Matter SDK теперь инициализирован. Чтобы быстро повторно инициализировать среду в будущем, запустите:
sudo docker exec -it matter-container /bin/bash source ./scripts/activate.sh
Обмен файлами между хостом и контейнером
Ранее мы получили доступ к файлам на вашем хост-компьютере изнутри контейнера с помощью привязки. Вы также можете записывать файлы в смонтированный каталог изнутри контейнера для доступа к ним с хоста.
В общем, используйте привязку, запустив контейнер с дополнительным аргументом --mount source=$(pwd),target=/workspace,type=bind
чтобы смонтировать текущий рабочий каталог в контейнер /workspace
.
user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container --mount source=$(pwd),target=/workspace,type=bind us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
Разрешения пользователя контейнера для подключенного каталога должны управляться на хосте.
Получите идентификатор группы пользователей контейнера внутри контейнера.
$ id uid=1000(matter) gid=1000(matter) groups=1000(matter)
Откройте еще один сеанс терминала на узле контейнера и установите в качестве рабочего каталога каталог, смонтированный контейнером.
Рекурсивно установите группу для файлов в смонтированном каталоге в группу пользователя контейнера.
user@host> sudo chgrp -R 1000 .
Предоставьте группе нужные разрешения в каталоге. В этом примере группе пользователей контейнера предоставляются права на чтение, запись и выполнение для всех файлов в смонтированном каталоге.
user@host> sudo chmod -R g+rwx .
Обратите внимание, что эти команды не влияют на разрешения новых файлов, создаваемых пользователем хоста. Не забудьте при необходимости обновить разрешения для новых файлов, созданных на хосте.
Вы можете добавить пользователя хоста в группу пользователей контейнера, чтобы наследовать разрешения для файлов, созданных пользователем контейнера.
user@host> currentuser=$(whoami) user@host> sudo usermod -a -G 1000 $currentuser
3. Консоль разработчика Google Home
Консоль разработчика Google Home — это веб-приложение, с помощью которого вы управляете интеграцией Matter с Google Home.
Любое устройство Matter, прошедшее сертификацию Connectivity Standards Alliance (Alliance) Matter, работает в экосистеме Google Home. Несертифицированные разрабатываемые устройства могут быть введены в эксплуатацию в экосистеме Google Home при определенных условиях — дополнительную информацию см. в разделе «Ограничения на сопряжение» .
Создать проект разработчика
Начните с перехода в консоль разработчика Google Home:
- Нажмите Создать проект .
- Введите уникальное имя проекта и нажмите « Создать проект» .
- Нажмите + Добавить интеграцию , чтобы перейти на экран ресурсов Matter , где вы сможете просмотреть документацию по разработке Matter и прочитать о некоторых инструментах.
- Когда вы будете готовы продолжить, нажмите «Далее: разработка» , после чего отобразится страница контрольного списка вопросов .
- Нажмите Далее: Настройка.
- На странице настройки введите название продукта .
- Нажмите «Выбрать тип устройства» и выберите тип устройства в раскрывающемся меню (в данном случае «
Light
»). - В поле «Идентификатор поставщика (VID)» выберите «Тестовый VID» и выберите 0xFFF1 в раскрывающемся меню «Тестовый VID». В поле «Идентификатор продукта (PID)» введите 0x8000 и нажмите «Сохранить и продолжить» , а затем нажмите «Сохранить» на следующей странице. Используйте эти точные значения VID/PID, от них зависят последующие шаги кодовой лаборатории.
- Теперь вы увидите свою интеграцию в разделе «Интеграции Материи» .
- Перезагрузите хаб, чтобы убедиться, что он получил самую последнюю конфигурацию проекта интеграции Matter. Если позже вам придется изменить VID или PID, вам также потребуется перезагрузить компьютер после сохранения проекта, чтобы изменения вступили в силу. Пошаговые инструкции по перезагрузке см. в разделе Перезапуск устройств Google Nest или Google Wifi .
4. Создайте устройство
Все примеры в Matter находятся в папке examples
в репозитории Github . Доступно несколько примеров, но в этой лаборатории мы сосредоточимся на Chef .
Шеф -повар одновременно:
- Пример приложения, предоставляющего интерфейс терминала, функции оболочки также можно найти в приложении
examples/shell
. - Сценарий, который использует принцип соглашения над конфигурацией для инкапсуляции нескольких общих задач, необходимых для разработки устройства с поддержкой Matter.
Перейдите в папку с примерами Chef и создайте свою первую сборку Matter:
$ cd examples/chef $ ./chef.py -zbr -d rootnode_dimmablelight_bCwGYSDpoe -t linux
У Chef есть несколько опций, которые можно просмотреть, запустив chef.py -h
. Здесь мы используем следующие варианты:
-
-d
: определяет тип используемого устройства. В данном случае мы создаем приложение освещения с элементами управления включением/выключением и уровнем. -
-z
: вызывает инструмент ZAP для создания исходных файлов, реализующих тип устройства. То есть на основе выбранного вами освещения ZAP автоматически создаст код для включения в сборку, который определяет источник света (модель данных) и то, как он взаимодействует с другими устройствами (модель взаимодействия). -
-b
: строит. -
-r
: [необязательно] включает сервер RPC на виртуальном устройстве Matter, чтобы другие компоненты (например, графический интерфейс) могли взаимодействовать с устройством для установки и получения атрибутов модели данных. -
-t linux
: целевая платформа. Платформы поддержки:linux
,nrfconnect
иesp32
. Вы можете запустить./chef.py -h
чтобы просмотреть все доступные команды и поддерживаемые целевые платформы.linux
используется для виртуальных устройств Matter.
Запустите устройство
Matter использует TCP/UDP-порт 5540 , поэтому, если на вашем компьютере работает брандмауэр, либо выключите его, либо разрешите входящие TCP/UDP-соединения на порту 5540.
Запустите виртуальное устройство в контейнере с помощью:
$ ./linux/out/rootnode_dimmablelight_bCwGYSDpoe [1648589956496] [14264:16538181] CHIP: [DL] _Init] ... [1648562026.946882][433632:433632] CHIP:SVR: SetupQRCode: [MT:Y3.13Y2N00KA0648G00] [1648562026.946893][433632:433632] CHIP:SVR: Copy/paste the below URL in a browser to see the QR Code: [1648562026.946901][433632:433632] CHIP:SVR: https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AY3.13Y2N00KA0648G00 [1648562026.946915][433632:433632] CHIP:SVR: Manual pairing code: [34970112332]
Оставьте устройство включенным. Теперь мы обратим наше внимание на приложение Google Home, чтобы мы могли подключить ваше устройство к Google Home.
Остановите устройство
Если вам нужно остановить устройство, вы можете выйти из программы, нажав CTRL+C. Если приложение не закрывается, возможно, вам также придется использовать CTRL+\.
Учетные данные вашего виртуального устройства хранятся в каталоге /tmp/
в файлах, начинающихся с префикса chip
.
Если вы хотите повторить весь процесс ввода в эксплуатацию с самого начала, вам придется удалить эти файлы, выполнив следующую команду:
$ rm /tmp/chip*
5. Введите устройство в эксплуатацию
Примечание . Этот шаг будет успешным только в том случае, если вы уже настроили свой проект в консоли разработчика Google Home.
Гнездо Хаб
Для ввода вашего устройства в эксплуатацию на фабрике Matter требуется концентратор. Это устройство Google Nest, такое как Nest Hub (2-го поколения), которое поддерживает Matter и которое будет служить как пограничным маршрутизатором для устройств с поддержкой потоков, так и локальным путем выполнения для маршрутизации намерений умного дома.
Обратитесь к этому списку , чтобы узнать, какие концентраторы поддерживают Matter.
Перед началом процесса ввода в эксплуатацию убедитесь, что:
- Ваш хаб связан с той же учетной записью Google, которую вы использовали для входа в консоль Google Home.
- Ваш концентратор находится в той же сети Wi-Fi, что и компьютер, который вы используете для запуска устройства Virtual Matter.
- Ваш хаб имеет ту же структуру, которую вы используете в своем приложении Google Home. («Дом» в Google Home Graph представляет вашу структуру).
Получить QR-код
Для процесса ввода в эксплуатацию требуется информация о подключении Matter, предоставленная через QR-код. Изучите вывод консоли приложения Matter, который будет содержать ссылку на QR-код, соответствующий вводу в эксплуатацию.
Провести комиссионную операцию
- Откройте приложение Google Home.
- Нажмите + в левом верхнем углу.
- Нажмите «Настроить устройство» .
- Нажмите «Новое устройство» .
- Выберите свой дом и нажмите «Далее» .
- Приложение Google Home сканирует ваше устройство. При появлении сообщения «Обнаружено важное устройство...» нажмите «Да». В противном случае коснитесь « Настроить другое устройство» и выберите «Материальное устройство» из списка устройств.
- Наведите камеру на QR-код вашего устройства или QR-код, созданный на веб-сайте.
- Продолжайте процесс сопряжения, как указано в последовательности действий приложения Google Home.
После выполнения этих шагов виртуальное устройство Matter должно быть успешно введено в эксплуатацию и появиться в виде нового значка в вашем приложении Google Home.
Поиск неисправностей
При вводе в эксплуатацию возникает ошибка «Проблема с подключением» или «Не удалось связаться с Google».
- Убедитесь, что вы создали проект с правильной комбинацией VID/PID в домашней консоли Google и у вас нет других проектов, использующих ту же комбинацию VID/PID.
Не удается выполнить ввод в эксплуатацию после длительного сканирования устройства.
- Убедитесь, что брандмауэр вашего компьютера отключен и что вы используете виртуальное устройство.
- Отключите все физические сетевые интерфейсы (Ethernet), чтобы ваш компьютер использовал исключительно Wi-Fi.
6. Управление устройством
Как только ваше устройство с поддержкой Matter будет успешно введено в эксплуатацию и появится в приложении Google Home в виде лампочки, вы можете проверить управление устройством различными способами:
- Использование Google Ассистента.
- Использование приложения Google Home.
Google Ассистент
Используйте Google Assistant на своем телефоне или концентраторе, чтобы переключать состояние устройства с помощью голосовых команд, например «Окей, Google, включи мой свет».
Дополнительные примеры команд см. в разделе «Управление устройствами умного дома с помощью голосовых команд» раздела «Управление устройствами умного дома, добавленными в приложение Google Home» .
Приложение Google Home
Вы можете нажать метки «Включить» и «Выключить» рядом со значком лампочки, отображаемым в приложении Google Home.
Дополнительную информацию см. в разделе «Управление устройствами с помощью приложения Google Home» статьи «Управление устройствами умного дома, добавленными в приложение Google Home» .
7. Поздравляем!
Вы успешно создали свое первое устройство Материи. Потрясающий!
В этой лаборатории вы узнали, как:
- Установите среду разработки Matter.
- Создайте и запустите виртуальное устройство Matter.
- Вводите в эксплуатацию и управляйте своим виртуальным устройством из Google Home.
Чтобы узнать больше о Материи, изучите эти ссылки:
- Matter Primer в Центре разработчиков Google Home, где вы изучите основы концепций Matter.
- Спецификация Matter, Библиотека устройств Matter и Библиотека кластеров приложений Matter, опубликованные Альянсом стандартов связи .
- Репозиторий Matter на GitHub .
1. Введение
Matter — это протокол подключения, который открывает потрясающие возможности для разработки интеллектуальных устройств. В этой лаборатории вы создадите свое первое устройство Matter, используя ресурсы Matter SDK.
Чтобы узнать о Matter, посетите Центр разработчиков Google Home или веб-сайт Connectivity Standards Alliance .
Что вы узнаете
- Как настроить среду сборки Matter
- Как создать виртуальное устройство Matter, работающее на вашем компьютере
- Как настроить и управлять виртуальным устройством Matter с помощью Google Home
Что вам понадобится
- Хаб — это любое устройство Google Nest, поддерживающее Matter , например Nest Hub (2-го поколения).
- Машина Linux с оконной системой X11.
- Докер.
- Гит.
- Базовые знания Linux.
- Обратите внимание, что предполагаемая оболочка для всех команд в этой лаборатории — BASH.
2. Настройте свою среду
Проверьте свое оборудование
Компьютеры Windows и macOS не поддерживаются этой установкой Docker. Вы можете вручную установить и собрать Matter на macOS.
Кроме того, в этих инструкциях предполагается, что на вашем компьютере с Linux установлена оконная система X11. Если на вашем компьютере с Linux работает Wayland, убедитесь, что X.Org также установлен.
Настройка среды разработки
- Установите Docker Engine (не используйте Docker Desktop).
- Клонируйте Matter SDK. Обратите внимание на коммит, который мы используем ниже.
git clone https://github.com/project-chip/connectedhomeip.git cd connectedhomeip git show commit f2f3d0eb03ba5bea32b22f19982c402a8c1c9063
- Запустите контейнер сборки, используя общедоступные образы CI SDK, и запустите вновь созданное виртуальное устройство из этого контейнера. Найдите изображение, которое будет соответствовать нашей версии SDK, следующим образом:
buildimage=$(grep chip-build .github/workflows/chef.yaml | head -n 1 | awk '{print $2}') echo $buildimage
Если вы используете тот же коммит, вы должны увидетьghcr.io/project-chip/chip-build:66
Сначала перенаправьте порты xhost, чтобы мы могли позже использовать приложения пользовательского интерфейса:xhost local:1000
Затем запустите контейнер с соответствующими ресурсами, перенаправленными с хоста (наш SDK для проверки, сети и ресурсов дисплея/связи).docker run -it --ipc=host --net=host -e DISPLAY --name matter-container --mount source=$(pwd),target=/workspace,type=bind --workdir="/workspace" $buildimage /bin/bash
Давайте разберемся с командой docker и параметрами, которые мы ей передали:
-
xhost local:1000
позволяет системе X Window получать соединения от локального хоста через порт 1000, что позволяет использовать графический интерфейс пользователя. -
docker run … image
запускает заданный образ, при необходимости извлекая его из реестра Docker. -
--ipc=host
позволяет Docker использовать пространство имен межпроцессного взаимодействия с вашим хост-компьютером. -
--net=host
позволяет Docker использовать сетевой стек хоста внутри контейнера, что необходимо для передачи трафика mDNS от хоста к контейнеру, а также для совместного использования дисплея X11 хоста. -
-e DISPLAY
экспортирует$DISPLAY
на хост, обеспечивая доступ к графическому интерфейсу вашей системы. Это необходимо для запуска инструмента ZAP при редактировании кластеров Материи. -
-it
запускает Docker с интерактивным терминалом (tty), а не в фоновом режиме. -
--mount
монтирует ранее извлеченный нами SDK в контейнер. -
--workdir
устанавливает рабочий каталог при запуске в наш смонтированный каталог SDK.
При желании вы можете запустить второй экземпляр сеанса терминала:
user@host> docker exec -it matter-container /bin/bash $
Остановите и запустите контейнер Matter Docker.
Всякий раз, когда вы запускаете команду docker run
, вы создаете новый контейнер с указанным изображением. Когда вы это сделаете, ваши старые данные, сохраненные в предыдущем экземпляре контейнера, будут потеряны. Иногда это именно то, что вам нужно, потому что это позволяет вам начать новую установку. Но бывают случаи, когда вы предпочитаете сохранять конфигурацию своей работы и среды между сеансами.
По этой причине после создания контейнера вы можете остановить его, чтобы не потерять свою работу.
user@host> docker stop matter-container
Когда вы будете готовы к повторному запуску, запустите контейнер и откройте окно терминала:
user@host> docker start matter-container user@host> docker exec -it matter-container /bin/bash
Вы можете открыть дополнительные сеансы терминала для вашего контейнера с помощью:
user@host> docker exec -it matter-container /bin/bash
Или запустите корневой сеанс, используя:
user@host> docker exec -u 0 -it matter-container /bin/bash
Начальная настройка Материи
Инициализируйте SDK
Инициализируйте Matter SDK. Выполнение этой операции займет несколько минут.
source scripts/bootstrap.sh python3 scripts/checkout_submodules.py --shallow --platform linux
Ваш Matter SDK теперь инициализирован. Чтобы быстро повторно инициализировать среду в будущем, запустите:
sudo docker exec -it matter-container /bin/bash source ./scripts/activate.sh
Обмен файлами между хостом и контейнером
Ранее мы получали доступ к файлам на вашем хост-компьютере из контейнера с помощью привязки. Вы также можете записывать файлы в смонтированный каталог изнутри контейнера для доступа к ним с хоста.
В общем, используйте привязку, запустив контейнер с дополнительным аргументом --mount source=$(pwd),target=/workspace,type=bind
чтобы смонтировать текущий рабочий каталог в контейнер в /workspace
.
user@host> docker run -it --ipc=host --net=host -e DISPLAY --name matter-container --mount source=$(pwd),target=/workspace,type=bind us-docker.pkg.dev/nest-matter/docker-repo/virtual-device-image:latest
Разрешения пользователя контейнера для подключенного каталога должны управляться на хосте.
Получите идентификатор группы пользователей контейнера внутри контейнера.
$ id uid=1000(matter) gid=1000(matter) groups=1000(matter)
Откройте еще один сеанс терминала на узле контейнера и установите в качестве рабочего каталога каталог, смонтированный контейнером.
Рекурсивно установите группу для файлов в смонтированном каталоге в группу пользователя контейнера.
user@host> sudo chgrp -R 1000 .
Предоставьте группе нужные разрешения в каталоге. В этом примере группе пользователей контейнера предоставляются права на чтение, запись и выполнение для всех файлов в смонтированном каталоге.
user@host> sudo chmod -R g+rwx .
Обратите внимание, что эти команды не влияют на разрешения новых файлов, создаваемых пользователем хоста. Не забудьте при необходимости обновить разрешения для новых файлов, созданных на хосте.
Вы можете добавить пользователя хоста в группу пользователей контейнера, чтобы наследовать разрешения для файлов, созданных пользователем контейнера.
user@host> currentuser=$(whoami) user@host> sudo usermod -a -G 1000 $currentuser
3. Консоль разработчика Google Home
Консоль разработчика Google Home — это веб-приложение, с помощью которого вы управляете интеграцией Matter с Google Home.
Любое устройство Matter, прошедшее сертификацию Connectivity Standards Alliance (Alliance) Matter, работает в экосистеме Google Home. Несертифицированные разрабатываемые устройства могут быть введены в эксплуатацию в экосистеме Google Home при определенных условиях — дополнительную информацию см. в разделе «Ограничения на сопряжение» .
Создать проект разработчика
Начните с перехода в консоль разработчика Google Home:
- Нажмите Создать проект .
- Введите уникальное имя проекта и нажмите « Создать проект» .
- Нажмите + Добавить интеграцию , чтобы перейти на экран ресурсов Matter , где вы сможете просмотреть документацию по разработке Matter и прочитать о некоторых инструментах.
- Когда вы будете готовы продолжить, нажмите «Далее: разработка» , после чего отобразится страница контрольного списка вопросов .
- Нажмите Далее: Настройка.
- На странице настройки введите название продукта .
- Нажмите «Выбрать тип устройства» и выберите тип устройства в раскрывающемся меню (в данном случае «
Light
»). - В поле «Идентификатор поставщика (VID)» выберите «Тестовый VID» и выберите 0xFFF1 в раскрывающемся меню «Тестовый VID». В поле «Идентификатор продукта (PID)» введите 0x8000 и нажмите «Сохранить и продолжить» , а затем нажмите «Сохранить» на следующей странице. Используйте эти точные значения VID/PID, от них зависят последующие шаги кодовой лаборатории.
- Теперь вы увидите свою интеграцию в разделе «Интеграции Материи» .
- Перезагрузите хаб, чтобы убедиться, что он получил самую последнюю конфигурацию проекта интеграции Matter. Если позже вам придется изменить VID или PID, вам также потребуется перезагрузиться после сохранения проекта, чтобы изменения вступили в силу. Пошаговые инструкции по перезагрузке см. в разделе Перезапуск устройств Google Nest или Google Wifi .
4. Создайте устройство
Все примеры в Matter находятся в папке examples
в репозитории Github . Доступно несколько примеров, но в этой лаборатории мы сосредоточимся на Chef .
Шеф -повар одновременно:
- Пример приложения, предоставляющего интерфейс терминала, функции оболочки также можно найти в приложении
examples/shell
. - Сценарий, который использует принцип соглашения над конфигурацией для инкапсуляции нескольких общих задач, необходимых для разработки устройства с поддержкой Matter.
Перейдите в папку с примерами Chef и создайте свою первую сборку Matter:
$ cd examples/chef $ ./chef.py -zbr -d rootnode_dimmablelight_bCwGYSDpoe -t linux
У Chef есть несколько опций, которые можно просмотреть, запустив chef.py -h
. Здесь мы используем следующие варианты:
-
-d
: определяет тип используемого устройства. В данном случае мы создаем приложение освещения с элементами управления включением/выключением и уровнем. -
-z
: вызывает инструмент ZAP для создания исходных файлов, реализующих тип устройства. То есть на основе выбранного вами освещения ZAP автоматически создаст код для включения в сборку, который определяет источник света (модель данных) и то, как он взаимодействует с другими устройствами (модель взаимодействия). -
-b
: строит. -
-r
: [необязательно] включает сервер RPC на виртуальном устройстве Matter, чтобы другие компоненты (например, графический интерфейс) могли взаимодействовать с устройством для установки и получения атрибутов модели данных. -
-t linux
: целевая платформа. Платформы поддержки:linux
,nrfconnect
иesp32
. Вы можете запустить./chef.py -h
чтобы просмотреть все доступные команды и поддерживаемые целевые платформы.linux
используется для виртуальных устройств Matter.
Запустите устройство
Matter использует TCP/UDP-порт 5540 , поэтому, если на вашем компьютере работает брандмауэр, либо выключите его, либо разрешите входящие TCP/UDP-соединения на порту 5540.
Запустите виртуальное устройство в контейнере с помощью:
$ ./linux/out/rootnode_dimmablelight_bCwGYSDpoe [1648589956496] [14264:16538181] CHIP: [DL] _Init] ... [1648562026.946882][433632:433632] CHIP:SVR: SetupQRCode: [MT:Y3.13Y2N00KA0648G00] [1648562026.946893][433632:433632] CHIP:SVR: Copy/paste the below URL in a browser to see the QR Code: [1648562026.946901][433632:433632] CHIP:SVR: https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3AY3.13Y2N00KA0648G00 [1648562026.946915][433632:433632] CHIP:SVR: Manual pairing code: [34970112332]
Оставьте устройство включенным. Теперь мы обратим наше внимание на приложение Google Home, чтобы мы могли подключить ваше устройство к Google Home.
Остановите устройство
Если вам нужно остановить устройство, вы можете выйти из программы, нажав CTRL+C. Если приложение не закрывается, возможно, вам также придется использовать CTRL+\.
Учетные данные вашего виртуального устройства хранятся в каталоге /tmp/
в файлах, начинающихся с префикса chip
.
Если вы хотите повторить весь процесс ввода в эксплуатацию с самого начала, вам придется удалить эти файлы, выполнив следующую команду:
$ rm /tmp/chip*
5. Введите устройство в эксплуатацию
Примечание . Этот шаг будет успешным только в том случае, если вы уже настроили свой проект в консоли разработчика Google Home.
Гнездо Хаб
Для ввода вашего устройства в эксплуатацию на фабрике Matter требуется концентратор. Это устройство Google Nest, такое как Nest Hub (2-го поколения), которое поддерживает Matter и которое будет служить как пограничным маршрутизатором для устройств с поддержкой потоков, так и локальным путем выполнения для маршрутизации намерений умного дома.
Обратитесь к этому списку , чтобы узнать, какие концентраторы поддерживают Matter.
Перед началом процесса ввода в эксплуатацию убедитесь, что:
- Ваш хаб связан с той же учетной записью Google, которую вы использовали для входа в консоль Google Home.
- Ваш концентратор находится в той же сети Wi-Fi, что и компьютер, который вы используете для запуска устройства Virtual Matter.
- Ваш хаб имеет ту же структуру, которую вы используете в своем приложении Google Home. («Дом» в Google Home Graph представляет вашу структуру).
Получить QR-код
Для процесса ввода в эксплуатацию требуется вводная информация Matter, предоставляемая через QR-код. Изучите вывод консоли приложения Matter, который будет содержать ссылку на QR-код, соответствующий вводу в эксплуатацию.
Провести комиссионную операцию
- Откройте приложение Google Home.
- Нажмите + в левом верхнем углу.
- Нажмите «Настроить устройство» .
- Нажмите «Новое устройство» .
- Выберите свой дом и нажмите «Далее» .
- Приложение Google Home выполняет поиск вашего устройства. При появлении сообщения «Обнаружено важное устройство...» нажмите «Да». В противном случае коснитесь « Настроить другое устройство» и выберите «Материальное устройство» из списка устройств.
- Наведите камеру на QR-код вашего устройства или QR-код, созданный на веб-сайте.
- Продолжайте процесс сопряжения, как указано в последовательности действий приложения Google Home.
После выполнения этих шагов виртуальное устройство Matter должно быть успешно введено в эксплуатацию и появиться в виде нового значка в вашем приложении Google Home.
Поиск неисправностей
При вводе в эксплуатацию возникает ошибка «Проблема с подключением» или «Не удалось связаться с Google».
- Убедитесь, что вы создали проект с правильной комбинацией VID/PID в домашней консоли Google и у вас нет других проектов, использующих ту же комбинацию VID/PID.
Не удается выполнить ввод в эксплуатацию после длительного сканирования устройства.
- Убедитесь, что брандмауэр вашего компьютера отключен и что вы используете виртуальное устройство.
- Отключите все физические сетевые интерфейсы (Ethernet), чтобы ваш компьютер использовал исключительно Wi-Fi.
6. Управление устройством
После того как ваше устройство с поддержкой Matter будет успешно введено в эксплуатацию и появится в приложении Google Home в виде лампочки, вы можете проверить управление устройством различными способами:
- Использование Google Ассистента.
- Использование приложения Google Home.
Google Ассистент
Используйте Google Assistant на своем телефоне или концентраторе, чтобы переключать состояние устройства с помощью голосовых команд, например «Окей, Google, включи мой свет».
Дополнительные примеры команд см. в разделе «Управление устройствами умного дома с помощью голосовых команд» статьи «Управление устройствами умного дома, добавленными в приложение Google Home» .
Приложение Google Home
Вы можете нажать метки «Включить» и «Выключить» рядом со значком лампочки, отображаемым в приложении Google Home.
Дополнительную информацию см. в разделе «Управление устройствами с помощью приложения Google Home» статьи «Управление устройствами умного дома, добавленными в приложение Google Home» .
7. Поздравляем!
Вы успешно создали свое первое устройство Материи. Потрясающий!
В этой лаборатории вы узнали, как:
- Установите среду разработки Matter.
- Создайте и запустите виртуальное устройство Matter.
- Вводите в эксплуатацию и управляйте своим виртуальным устройством из Google Home.
Чтобы узнать больше о Материи, изучите эти ссылки:
- Matter Primer в Центре разработчиков Google Home, где вы изучите основы концепций Matter.
- Спецификация Matter, Библиотека устройств Matter и Библиотека кластеров приложений Matter, опубликованные Альянсом стандартов связи .
- Репозиторий Matter на GitHub .