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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Предпосылки

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

Чтобы полностью интегрировать устройство с поддержкой 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 для сквозной проверки. Поддерживаются следующие платформы:
Таблица: Примеры Matter от поставщиков кремния
Продавец Платформа Гиды Поддержка Thread
Лаборатория Буффало BL602 Быстрый старт
BL702 Быстрый старт
Эспрессиф ESP32 Быстрый старт
ОТА-тестирование
Северный полупроводник нРФ52840 ДК Быстрый старт
ОТА-тестирование
NXP Комплект разработки IOTZTB-DK006 Быстрый старт
Реалтек Амеба серии D Быстрый старт
Силиконовые лаборатории EFR32MG Стартовый комплект Zigbee и Thread Быстрый старт
Комплект разработчика EFR32MG24 Быстрый старт
Телинк TLSR9518 Быстрый старт

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

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

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

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

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

  • Тестовый VID нельзя использовать в потребительском устройстве.
  • Для сопряжения производственного (бытового) устройства оно должно быть сертифицировано в CSA DCL .
  • Для целей разработки и полевых испытаний устройство должно быть зарегистрировано в Google Home Developer Console .
Таблица: Vendor ID (VID) и сценарии сопряжения типов устройств
Какие типы пользователей могут ввести устройство в экосистему Google Home?
Тип VID Сертификат VID и статус регистрации Производство
(Потребительские пользователи)
Разработка
(Разработчики, пользователи полевых испытаний)
Тест Не зарегистрирован (не может быть сертифицирован) Н/Д Н/Д
Тест Зарегистрирован в Developer Console (не может быть сертифицирован) Н/Д
Производство Не сертифицирован, не зарегистрирован Н/Д
Производство Не сертифицирован, зарегистрирован в Developer Console
Производство Сертифицирован в CSA DCL, не зарегистрирован Н/Д
Производство Сертифицирован в CSA DCL и зарегистрирован в Developer Console

Код товара

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

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

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

Таблица: Кластеры Matter , недоступные пользователям в экосистеме Google Home
Тип кластера Кластеры
Основной
  • Связывание
  • Этикетка
  • Фиксированная метка
  • Метка пользователя
  • Действия
  • Групповой ключ
  • Конфигурация локализации
  • Локализация формата времени
  • Локализация юнита
  • Конфигурация источника питания
  • Источник питания
  • Кластеры диагностики (Журналы диагностики, Общая диагностика, Диагностика программного обеспечения, Диагностика сети потоков, Диагностика сети Wi-Fi, Диагностика сети Ethernet)
  • Синхронизация времени
  • Выбор режима
Приложение
  • Группы и сцены напрямую не поддерживаются. Эквивалентная функциональность доступна через Routines .
  • Все медиакластеры. Аналогичные функции доступны через Google Cast .