Начало работы с Matter

Программа 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.

Требования

Рекомендуемые расширения IDE для разработки Matter

Чтобы полностью интегрировать устройство с поддержкой Matter в экосистему Google Home, разработчику необходимо:

  1. Контроллер Google с поддержкой Thread, который будет служить border router для устройств с поддержкой Thread и локальным путем выполнения для маршрутизации действий умного дома.
  2. Мобильное устройство (тестовый телефон), соответствующее минимальным требованиям:
    • Android O (8.1, уровень API 27 или выше)
    • iOS 16.5 или более поздней версии;
    • Поддержка BLE
  3. Идентификатор поставщика (VID) и идентификатор продукта (PID) для устройства с поддержкой Matter.
  4. Устройство с поддержкой Matter. Это устройство должно быть одним из Matter типов устройств, поддерживаемых в экосистеме Google Home, например:

Идентификатор поставщика

По умолчанию вы можете использовать один из идентификаторов, выделенных альянсом для тестирования. Выберите один из следующих вариантов: 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.
Таблица. Сценарии сопоставления идентификатора поставщика (VID) и типа устройства
Какие типы пользователей могут вводить устройство в эксплуатацию в экосистеме 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 пока не видны пользователям, но могут использоваться системой. В большинстве случаев это означает, что атрибуты, представленные в этих кластерах, не видны конечным пользователям.

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

¹ О том, как это влияет на выключатели, читайте в разделе Выключатели.