Программа для разработчиков Google Home позволяет производителям устройств подключать свои устройства умного дома к экосистеме Google Home. Мы расширяем возможности локального выполнения действий умного дома, добавляя поддержку устройств с Matter. Теперь их можно настраивать с помощью Google Home app (GHA) и управлять ими с помощью Google Assistant, GHA и умных дисплеев, например Google Nest Hub (2nd gen).
В этой документации рассказывается, как начать создавать и интегрировать платформу с поддержкой Matter в экосистему Google Home.
Отказ от обязательств
При выполнении процедур, описанных в Matterдокументации, учитывайте следующее:
- Мы рекомендуем использовать для разработки аккаунт, к которому подключен только один хаб с поддержкой Matter. Если во время тестирования к одной структуре или одновременно к нескольким концентраторам с поддержкой Matter подключено несколько устройств, это может привести к непредсказуемым результатам.
- Во всех процедурах предполагается, что для сборки и прошивки образцов Matter используется компьютер с ОС Linux Ubuntu 20.04, протестированный 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, который будет служить border router для устройств с поддержкой Thread и локальным путем выполнения для маршрутизации действий умного дома.
- Мобильное устройство (тестовый телефон), соответствующее минимальным требованиям:
- Android O (8.1, уровень API 27 или более поздний)
- iOS (версия 16.5 или более поздняя).
- Поддержка BLE
- Идентификатор поставщика (VID) и идентификатор продукта (PID) для устройства с поддержкой Matter.
- Устройство с поддержкой Matter. Это устройство должно относиться к одному из Matter типов устройств, поддерживаемых в экосистеме Google Home, и может быть:
- Ваш собственный продукт со встроенным ПО, поддерживающим Matter.
- Одно из следующих устройств Matter для сквозной проверки:
| Поставщик | Платформа | Поддержка Thread | Руководство |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Тестирование OTA | |
| Nordic Semiconductor | nRF52840 DK | Тестирование OTA | |
| NXP | Набор для разработки IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | EFR32MG24 Dev Kit | ||
| Стартовый набор EFR32MG Zigbee и Thread | |||
| Telink | TLSR9528 | Руководство для разработчиков Telink Matter | |
| Texas Instruments | Набор для разработки CC2652R7 LaunchPad |
Идентификатор поставщика
По умолчанию для тестирования можно использовать один из идентификаторов VID, выделенных Альянсом. Выберите один из следующих вариантов: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Чтобы использовать производственный идентификатор VID для сертификации и запуска интеграции, сначала необходимо подтвердить в Google, что он был выдан вам Альянсом.
Этот VID должен быть реализован в прошивке устройства.
Устройство Matter можно подключить к экосистеме Google Home только при определенных идентификаторах поставщика и типах устройств.
- Тестовый идентификатор VID нельзя использовать на потребительском устройстве.
- Рабочий VID должен быть выдан организацией Connectivity Standards Alliance (Alliance). Google проверит, что вы являетесь владельцем этого идентификатора, прежде чем вы сможете использовать его в Google Home Developer Console. После этого вы сможете создавать интеграции для этого идентификатора.
- Для разработки и Field Trial необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID в Developer Console. Пользователь, настраивающий устройство, должен быть участником проекта или включен в список пользователей Field Trial.
- Пользователи могут использовать ваш продукт только после того, как он будет сертифицирован Alliance.
VID и PID можно использовать только один раз для одной интеграции. Если вы хотите использовать в интеграции тот же VID или PID, вам нужно:
- Измените интеграцию, используя VID или PID, на другой VID или PID.
- Удалите интеграцию, используя VID или PID.
| Какие типы пользователей могут добавить устройство в экосистему Google Home? | |||
|---|---|---|---|
| Тип VID | Статус сертификации VID и интеграции с консолью | Рабочая версия
(обычные пользователи) |
Разработка
(разработчики, пользователи Field Trial) |
| Тест | Нет интеграции с Developer Console (невозможно сертифицировать) | ||
| Тест | Интеграция существует в Developer Console (не может быть сертифицирована) | ||
| Рабочая версия | Не сертифицировано, интеграция не существует в Developer Console | ||
| Рабочая версия | Не сертифицировано, интеграция существует в Developer Console | ||
| Рабочая версия | Сертифицировано в Alliance DCL, интеграция отсутствует в Developer Console | ||
| Рабочая версия | Сертифицирован по спецификации Alliance DCL и интегрирован с Developer Console | ||
Идентификатор товара
Информация об устройстве считывается из кластера Matter Basic Information Cluster. Идентификатор продукта, закодированный в прошивке устройства, должен совпадать с идентификатором продукта Matter в консоли разработчика.
Неподдерживаемые функции
Некоторые кластеры Matter пока не показываются пользователям, хотя могут использоваться системой. В большинстве случаев это означает, что атрибуты, доступные через эти кластеры, не видны конечным пользователям:
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ Подробнее о том, как это повлияет на выключатели света…