Начни с Материи

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

Предварительные условия

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

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

  1. Хаб Google с поддержкой Thread , который будет служить как пограничным маршрутизатором для устройств с поддержкой Thread, так и локальным путем выполнения для маршрутизации намерений умного дома.
  2. Мобильное устройство (тестовый телефон), соответствующее минимальным требованиям:
    • Android O (8.1, уровень API 27 или новее)
    • iOS (16.5 или новее)
    • возможность BLE
  3. Идентификатор поставщика (VID) и идентификатор продукта (PID) для устройства с поддержкой Matter .
  4. Устройство с поддержкой Matter . Это устройство должно относиться к одному из типов устройств Matter , поддерживаемых в экосистеме Google Home , и может быть:
    • Ваш собственный продукт с прошивкой, поддерживающей Matter .
    • Одно из следующих устройств 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.
Таблица: Сценарии сопряжения идентификатора поставщика (VID) и типа устройства
Какие типы пользователей могут подключить устройство к экосистеме Google Home?
Тип VID Сертификация VID и статус интеграции с консолью Производство
(Пользователи-потребители)
Разработка
(Разработчики, пользователи полевой пробной версии)
Тест Нет интеграции с Developer Console (невозможно пройти сертификацию)
Тест Интеграция существует в Developer Console (не подлежит сертификации)
Производство Не сертифицировано, интеграция не существует в Developer Console
Производство Не сертифицировано, существует интеграция в Developer Console
Производство Сертифицировано в Alliance DCL, интеграция с Developer Console невозможна.
Производство Сертифицировано в Alliance DCL, имеется интеграция с Developer Console

Идентификатор продукта

Информация об устройстве считывается из кластера основной информации Matter . Идентификатор продукта, закодированный в прошивке вашего устройства, должен совпадать с идентификатором продукта интеграции Matter в консоли разработчика.

Неподдерживаемые функции

Некоторые кластеры 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 .

¹ См. «Выключатели включения/выключения освещения», чтобы узнать, как это влияет на выключатели освещения.