Программа Google Home Developer позволяет производителям устройств подключать свои устройства умного дома к экосистеме Google Home. Мы расширяем возможности локального выполнения действий умного дома, добавляя поддержку устройств с 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.
Проще всего начать с практических работ. Рекомендуем выполнить хотя бы одну из следующих практических работ:
Затем проверьте, есть ли ваше устройство в списке поддерживаемых. Затем ознакомьтесь с контрольным списком для разработчиков, чтобы понять весь процесс разработки от создания проекта до запуска.
Поддерживаемые устройства Контрольный список для разработчиков
Определения
В этой документации используются следующие термины:
- Пограничный маршрутизатор
- Концентратор, который реализует пограничный маршрутизатор 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 для сквозной проверки:
Таблица. Примеры Matter от поставщиков чипов Поставщик Платформа Поддержка Thread Руководство Bouffalo Lab BL602 BL702 Espressif ESP32 Тестирование OTA Nordic Semiconductor nRF52840 DK Тестирование OTA NXP IOTZTB-DK006 development kit Realtek Ameba D Series Silicon Labs EFR32MG24 Dev Kit EFR32MG Zigbee and Thread Starter Kit Telink TLSR9528 Руководство для разработчиков Telink Matter Texas Instruments CC2652R7 LaunchPad development kit
Идентификатор поставщика
По умолчанию вы можете использовать один из идентификаторов, выделенных альянсом для тестирования. Выберите один из следующих вариантов: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Чтобы использовать рабочий идентификатор поставщика для сертификации и запуска интеграции, сначала необходимо подтвердить его в Google. Это позволит убедиться, что идентификатор был выдан вам альянсом.
Этот идентификатор должен быть реализован во встроенном ПО устройства.
Устройство Matter можно подключить к экосистеме Google Home только при определенных идентификаторах поставщика и типах устройств.
- Тестовый идентификатор VID нельзя использовать на потребительском устройстве.
- Рабочий идентификатор VID должен быть выдан организацией "Connectivity Standards Alliance (Alliance)". Прежде чем вы сможете использовать идентификатор в Google Home Developer Console, Google проверит, что он принадлежит вам. После этого вы сможете создавать интеграции для этого идентификатора.
- Для разработки и Field Trial необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID в Developer Console. Пользователь, который вводит устройство в эксплуатацию, должен быть участником проекта или входить в список пользователей Field Trial.
- Обычные пользователи могут использовать ваш продукт только после того, как он будет сертифицирован Alliance.
Идентификаторы 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. Идентификатор товара, закодированный во встроенном ПО устройства, должен совпадать с идентификатором товара интеграции Matter в Developer Console.
Неподдерживаемые функции
Некоторые кластеры Matter пока не видны пользователям, но могут использоваться системой. В большинстве случаев это означает, что атрибуты, представленные в этих кластерах, не видны конечным пользователям.
| Cluster Type | Clusters |
|---|---|
| Core |
|
| Application |
|
¹ О том, как это влияет на выключатели, читайте в разделе Выключатели.