Программа 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.
Проще всего начать с практических работ. Рекомендуем выполнить хотя бы одну из следующих практических работ:
Затем проверьте, поддерживается ли ваше устройство в экосистеме 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 and Thread Starter Kit | |||
| Telink | TLSR9528 | Руководство для разработчиков Telink Matter | |
| Texas Instruments | CC2652R7 LaunchPad development kit |
Идентификатор поставщика
По умолчанию вы можете использовать один из идентификаторов VID, выделенных альянсом для тестирования. Выберите один из следующих вариантов: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Чтобы использовать рабочий идентификатор поставщика для сертификации и запуска интеграции, сначала необходимо подтвердить его в Google. Это позволит убедиться, что идентификатор был выдан вам альянсом.
Этот идентификатор должен быть реализован во встроенном ПО устройства.
Устройство Matter можно подключить к экосистеме Google Home только при определенных идентификаторах поставщика и типах устройств.
- Тестовый идентификатор VID нельзя использовать на потребительском устройстве.
- Рабочий идентификатор VID должен быть выдан организацией "Connectivity Standards Alliance (Alliance)". Прежде чем вы сможете использовать VID в 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 |
|
¹ О том, как это влияет на выключатели, читайте в разделе Выключатели.