Устранение неполадок со стандартом Matter

Сборка

Убедитесь, что ваш телефон совместим с eSIM

Все устройства с Android O (8.1, уровень API 27) и более поздними версиями совместимы с Matter. Чтобы проверить, есть ли на вашем телефоне необходимые модули, выполните следующие действия.

Как настроить Android Debug Bridge

Перед устранением неполадок необходимо настроить Android Debug Bridge (adb). Что нужно сделать:

  1. Установите на компьютер инструмент adb.
  2. Включите режим «Для разработчиков» и отладку по USB на телефоне Android.

Проверьте модули Matter в сервисах Google Play

Чтобы проверить, есть ли у вас модули Google Play services Matter, выполните следующие действия:

  1. Настройте Android Debug Bridge.
  2. Подключите телефон Android к компьютеру с помощью USB-кабеля.
  3. Чтобы проверить, установлены ли необходимые модули Matter, выполните в терминале следующую команду: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
    Если вы видите результат, похожий на приведенный ниже, значит, модули Matter установлены: 
    com.google.android.gms.home [v222110900]
     Обратите внимание, что номер версии на вашем устройстве может отличаться от указанного выше.
  4. Чтобы проверить, установлены ли необходимые модули Thread, выполните в терминале следующую команду: 
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    Если вы видите выходные данные, похожие на приведенные в следующем примере, у вас установлены модули Thread: 
    com.google.android.gms.threadnetwork [v222106301]
     Обратите внимание, что на вашем устройстве может быть установлена другая версия.

Если модули не указаны, это означает, что:

  1. У вас устаревшая версия Android. Убедитесь, что на нем установлена AndroidОС Android 8.1 или более поздней версии.
  2. Модули Matter ещё не скачаны. Подождите не менее 24 часов, пока они скачаются. Чтобы скачивание не задерживалось, убедитесь, что устройство включено и заряжается. Если вы не получили модули в течение 24 часов, попробуйте сбросить настройки устройства, чтобы принудительно скачать модули.

Проверьте VID/PID устройства

Чтобы начать разработку интеграции с Google, создайте проект и интеграцию в Google Home Console.

Устранение неполадок с Bluetooth Sniffer

Значение VID/PID, которое передает ваше устройство, должно совпадать со значением VID/PID, указанным в проекте Google Home Developer Console.

  • Идентификаторы 0xFFF1–0xFFF4 зарезервированы для тестирования. Их можно использовать для базового ввода в эксплуатацию и контрольных тестов, но не на следующих этапах разработки:

Используя приложение для работы с Bluetooth, например nRF Connect for Mobile, вы можете увидеть идентификаторы VID и PID устройства-маячка в поле Service Data (Данные сервиса).

На этом скриншоте из версии nRF Connect для Android вы видите, что VID/PID указан как 5A23FFFE, начиная с четвертого байта поля Service Data (Данные сервиса). Это указывает на VID 5A23 и PID FFFE – оба в формате с прямым порядком байтов.

Приложение BLE отображает значения в формате Little-Endian, но значения VID/PID, которые вы вводите в проект Developer Console, должны быть в формате Big-Endian.

Убедитесь, что в проект консоли Actions введены правильные значения и формат на основе данных сниффера Bluetooth.

Для значений на скриншоте выше VID и PID в Developer Console будут 235A и FEFF соответственно.

Убедитесь, что устройство создано с использованием совместимой ветви Matter SDK

Контроллеры Google Matter совместимы с Matter 1.0 и протестированы со сборками, в которых использовались коммиты из стабильной ветки v1.0-branch. Рекомендуемые коммиты для каждого нового выпуска концентратора указаны в примечаниях к общедоступному выпуску.

Подключение…

Проверьте учетные данные устройства

Если вы используете собственный VID, назначенный Alliance, убедитесь, что на устройстве указаны правильные учетные данные:

  • Декларация о сертификации (CD).
  • Сертификат подтверждения устройства (DAC) и его цепочка сертификатов.

Подробнее о том, как создать тестовые сертификаты для устройств Matter…

Как проверить совместимость контроллера с Matter

Ваш контроллер Matter должен быть одним из контроллеров, поддерживаемых Google. Кроме того, на нем должна быть установлена сборка, совместимая с Matter.

Некоторые контроллеры также являются Thread Border Router (TBR)s, что позволяет разрабатывать и тестировать устройства Thread. Другие контроллеры поддерживают только устройства Wi-Fi и Ethernet Matter, если в вашей сети нет другого устройства border router, которое обеспечивает подключение Thread.

Чтобы проверить сборку, проведите пальцем вниз от верхнего края экрана и выберите "Настройки" > "Информация об устройстве" > "Техническая информация" > "Версия встроенного ПО Chromecast".

При вводе в эксплуатацию появляется сообщение об ошибке "Не удалось связаться с Google"

Убедитесь, что вы создали интеграцию с правильной комбинацией VID/PID в Developer Console. Подробнее о том, как создать интеграцию Matter…

При вводе в эксплуатацию появляется сообщение об ошибке "Устройство не обнаружено"

Если при вводе в эксплуатацию устройства Thread вы постоянно получаете сообщение об ошибке "Не удается подключиться к устройству" и уже испробовали все доступные варианты отладки, попробуйте удалить сохраненные учетные данные Thread на телефоне Android. Для этого выберите Настройки > Приложения > Все приложения > Сервисы Google Play > Хранилище и кеш > Управление местом > Удалить все данные.

Тестирование

Введенное в эксплуатацию устройство не отображается в наборе тестов

Если вы подключили устройство с тестовыми идентификаторами поставщика (VID) и товара (PID), но оно не появляется при попытке протестировать его с помощью набора тестов в Developer Console, скорее всего, вы используете одну и ту же комбинацию тестовых VID и PID в нескольких интеграциях.

Чтобы устранить неполадки, удалите все тестовые устройства из Developer Console и снова подключите устройство, которое хотите протестировать.

Чтобы убедиться, что вы подключили нужное устройство, вы можете задать уникальные значения для производителя и модели (значения CHIP_DEVICE_CONFIG_DEVICE_*) в тестовом встроенном ПО.

Подробнее об информации об устройствах…

Если проблема не устранена

Если после выполнения всех действий по устранению неполадок, описанных здесь, проблема не решилась, ничего страшного!

В ходе устранения неполадок вы собрали важные данные об устройстве, проекте в консоли и среде. Затем перейдите на страницу поддержки и узнайте, как лучше всего поделиться проблемой с сообществом и службой поддержки Google Home.