Программа Google Home Developer позволяет производителям устройств подключать свои устройства умного дома к экосистеме Google Home. Мы расширяем локальный путь реализации Smart Home Actions, добавив возможность добавлять устройства с поддержкой Matter для настройки с помощью Google Home app (GHA) и управлять ими с помощью Google Assistant , GHA или интеллектуальных дисплеев, таких как Google Nest Hub (2nd gen) .
В этой документации описывается, как приступить к созданию и интеграции платформы, поддерживаемой Matter в экосистему Google Home.
Отказ от ответственности
Что касается процедур, описанных в документации Matter , имейте в виду следующее:
- Мы рекомендуем, чтобы к учетной записи, используемой для разработки, был подключен только один концентратор с поддержкой Matter для тестирования. Несколько концентраторов с поддержкой Matter , подключенных одновременно или подключенных к одной и той же структуре во время тестирования, могут привести к непредсказуемому поведению.
- Все процедуры предполагают использование Linux-машины под управлением Ubuntu 20.04 для сборки и прошивки образцов Matter , протестированных Google. Хотя поддерживаются машины MacOS, рекомендуется использовать Linux. Инструкции для Mac вызываются в процедурах по мере необходимости.
Как построить
Чтобы создать устройство с поддержкой Matter , которое интегрируется с экосистемой Google Home, вам придется работать с совместимой с Matter платой разработки и Matter SDK .
Самый простой способ начать — пройти наши лаборатории по написанию кода. Мы рекомендуем выполнить хотя бы одну из следующих лабораторий кода:
После этого проверьте наш список поддерживаемых устройств , чтобы убедиться, что то, что вы планируете интегрировать, поддерживается в экосистеме Google Home. Затем прочитайте Контрольный список для разработчиков , чтобы понять весь процесс разработки: от создания проекта до запуска.
Контрольный список для разработчиков поддерживаемых устройств
Определения
В данной документации используются следующие термины:
- Пограничный маршрутизатор
- Концентратор, реализующий универсальный пограничный маршрутизатор Thread для устройств с поддержкой Thread .
- Центр
- Поддерживаемое устройство Google Nest , например Google Nest Hub (2nd gen) . Хаб необходим для управления устройствами с поддержкой Matter через другие поверхности, такие как Assistant , GHA и интеллектуальные дисплеи.
- Устройство с поддержкой Matter
- Устройство или плата разработки, на которую была прошита сборка или образец приложения с поддержкой Matter .
- Мобильное устройство
- Тестовый телефон использовался для помощи в сопряжении. На данный момент это телефон Android .
Предварительные условия
Чтобы полностью интегрировать устройство с поддержкой Matter в экосистему Google Home, разработчик должен иметь:
- Хаб Google с поддержкой Thread , который будет служить как пограничным маршрутизатором для устройств с поддержкой Thread, так и локальным путем выполнения для маршрутизации намерений умного дома.
- Мобильное устройство (тестовый телефон), соответствующее минимальным требованиям:
- Android O (8.1, уровень API 27 или новее)
- iOS (16.5 или новее)
- возможность BLE
- Идентификатор поставщика (VID) и идентификатор продукта (PID) для устройства с поддержкой Matter .
- Устройство с поддержкой Matter . Это устройство должно относиться к одному из типов устройств Matter , поддерживаемых в экосистеме Google Home , и может быть:
- Ваш собственный продукт с прошивкой, поддерживающей Matter .
- Одно из следующих устройств Matter , которое можно использовать для сквозной проверки:
Продавец | Платформа | Поддержка Thread | Гид |
---|---|---|---|
Лаборатория Буффало | БЛ602 | ||
BL702 | |||
Эспрессиф | ЭСП32 | ОТА-тестирование | |
Северные полупроводники | nRF52840 ДК | ОТА-тестирование | |
НХП | Комплект разработчика IOTZTB-DK006 | ||
Реалтек | Амеба серии D | ||
Кремниевые лаборатории | Комплект разработчика EFR32MG24 | ||
EFR32MG Стартовый комплект Zigbee и Thread | |||
Телинк | ТЛСР9518 | ||
Техасские инструменты | CC2652R7 Комплект разработчика LaunchPad |
Идентификатор поставщика
По умолчанию вы можете использовать один из VID, выделенных CSA, для целей тестирования. Выберите один из следующих вариантов: 0xFFF1
, 0xFFF2
, 0xFFF3
, 0xFFF4
.
Чтобы использовать производственный VID, чтобы ваша интеграция могла быть сертифицирована и запущена, вам необходимо сначала подтвердить его в Google, чтобы убедиться, что он был выдан вам CSA.
Этот VID должен быть реализован в прошивке вашего устройства.
Устройство Matter можно подключить к экосистеме Google Home только в определенных сценариях с идентификатором поставщика и типом устройства.
- Тестовый VID нельзя использовать на потребительском устройстве.
- Ваш производственный VID должен быть выдан Connectivity Standards Alliance (Alliance) . Google подтвердит, что вы являетесь владельцем этого VID, прежде чем вы сможете использовать его в Google Home Developer Console . Как только это произойдет, вы сможете создавать интеграции для этого VID.
- Для целей разработки и полевых испытаний в Developer Console необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID. Пользователь, выполняющий ввод устройства в эксплуатацию, должен либо быть участником проекта, либо быть включен в список пользователей, участвующих в полевых испытаниях.
- Потребители смогут использовать ваш продукт только после того, как он будет сертифицирован Alliance .
VID и PID можно использовать только один раз для одной интеграции. Если вы хотите использовать тот же VID или PID в своей интеграции, вам необходимо:
- Измените интеграцию, используя VID или PID, на другой VID или PID.
- Удалите интеграцию, используя VID или PID.
Какие типы пользователей могут подключить устройство к экосистеме Google Home? | |||
---|---|---|---|
Тип VID | Сертификация VID и статус интеграции с консолью | Производство (Пользователи-потребители) | Разработка (Разработчики, пользователи полевой пробной версии) |
Тест | Нет интеграции с Developer Console (невозможно пройти сертификацию) | ||
Тест | Интеграция существует в Developer Console (не подлежит сертификации) | ||
Производство | Не сертифицировано, интеграция не существует в Developer Console | ||
Производство | Не сертифицировано, существует интеграция в Developer Console | ||
Производство | Сертифицировано в Alliance DCL, интеграция с Developer Console невозможна. | ||
Производство | Сертифицировано в Alliance DCL, имеется интеграция с Developer Console |
Идентификатор продукта
Информация об устройстве считывается из кластера основной информации Matter . Идентификатор продукта, закодированный в прошивке вашего устройства, должен совпадать с идентификатором продукта интеграции Matter в консоли разработчика.
Неподдерживаемые функции
Некоторые кластеры Matter еще не доступны пользователям, хотя могут использоваться системой. В большинстве случаев это означает, что атрибуты, представленные через эти кластеры, не видны конечным пользователям:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
¹ См. «Выключатели включения/выключения освещения», чтобы узнать, как это влияет на выключатели освещения.