Начать работу с Материей

Предварительная версия для разработчиков

Программа Google Home Developer позволяет производителям устройств подключать свои умные домашние устройства к экосистеме Google Home. Мы расширяем путь локального выполнения действий Smart Home, добавляя возможность добавлять Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA , or smart displays like the Google Nest Hub (2nd gen) .

В этой документации описывается, как приступить к созданию и интеграции поддерживаемой Matter платформы в экосистему Google Home.

Отказ от ответственности

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

• Учетная запись, используемая для разработки, должна иметь только один концентратор с поддержкой Matter , подключенный для тестирования. Несколько концентраторов с поддержкой Matter , подключенных одновременно или подключенных к одной и той же структуре во время тестирования, могут привести к непредсказуемому поведению.
• Все процедуры предполагают использование Linux-машины под управлением Ubuntu 20.04 для сборки и прошивки образцов Matter , которые были протестированы Google. Хотя машины MacOS поддерживаются, рекомендуется использовать Linux. Инструкции для Mac вызываются в процедурах по мере необходимости.
• Поддерживается только Android-версия GHA .

Определения

В этой документации используются следующие термины:

Пограничный маршрутизатор

Концентратор, реализующий универсальный Thread Border Router for Thread -enabled devices.

Центр

Поддерживаемое Google Nest device, such as the Google Nest Hub (2nd gen) . A hub is required to control Matter -enabled devices through other surfaces such as Assistant , the GHA , and smart displays.

Устройство с поддержкой Matter

Устройство или плата разработки, на которую была установлена ​​сборка или пример приложения с поддержкой Matter .

Мобильное устройство

Тестовый телефон использовался для помощи в сопряжении. В настоящее время это Android phone.

Предпосылки

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

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

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

По умолчанию вы можете использовать один из VID, выделенных CSA для целей тестирования. Выберите один из следующих вариантов: 0xFFF1 , 0xFFF2 , 0xFFF3 , 0xFFF4 .

Чтобы использовать производственный VID, чтобы ваша интеграция могла быть сертифицирована и запущена, вы должны сначала проверить его в Google, чтобы убедиться, что он был выдан вам CSA.

Этот VID должен быть реализован в прошивке вашего устройства.

Устройство Matter может быть сопряжено в экосистеме Google Home только в определенных сценариях с идентификатором поставщика и типом устройства.

• Тестовый VID нельзя использовать в потребительском устройстве.
• Для сопряжения производственного (бытового) устройства оно должно быть сертифицировано в CSA DCL .
• Для целей разработки и полевых испытаний устройство должно быть зарегистрировано в Google Home Developer Console .

Код товара

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

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

Некоторые кластеры Matter еще не доступны пользователям, хотя они могут использоваться системой. В большинстве случаев это означает, что атрибуты, предоставляемые через эти кластеры, не будут видны конечным пользователям: