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

Здание

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

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

Настройка Android Debug Bridge

Перед устранением неполадок необходимо настроить Android Debug Bridge ( adb ). Для этого выполните следующие действия:

  1. Установите на свой компьютер программу "adb" .
  2. Включите параметры разработчика и отладку по USB на своем Android телефоне.

Проверьте модули Google Play Services (GPS) Matter.

Чтобы проверить наличие модулей 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 O (8.1) или выше.
  2. Модули Matter еще не загружены. Подождите не менее 24 часов, пока они загрузятся. Убедитесь, что ваше устройство включено и заряжается в течение этого времени, чтобы не было задержек с загрузкой. Если вы не получили модули в течение 24 часов, вы можете попробовать выполнить сброс настроек устройства до заводских, чтобы принудительно загрузить модули.

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

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

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

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

  • VID-коды 0xFFF1 — 0xFFF4 зарезервированы для тестирования. Они могут использоваться для базовых пусконаладочных и контрольных испытаний, но не могут использоваться на следующих этапах разработки:

С помощью инженерного приложения для Bluetooth, такого как nRF Connect for Mobile , вы можете увидеть VID/PID маячкового устройства в поле «Сервисные данные» .

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

Приложение BLE отображает значения в формате little endian, но значения VID/PID, которые вы вводите в свой проект Developer Console , отображаются в формате big endian.

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

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

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

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

Сочетание

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

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

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

Для получения дополнительной информации см. раздел «Сертификаты для тестирования устройств Create Matter» .

Проверьте совместимость вашего концентратора с Matter.

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

Некоторые концентраторы также являются пограничными маршрутизаторами Thread , что позволяет разрабатывать и тестировать устройства Thread . Другие концентраторы поддерживают только устройства Matter поддержкой Wi-Fi и Ethernet, если в вашей сети нет другого пограничного маршрутизатора, обеспечивающего подключение Thread.

Проверить работоспособность вашего хаба можно следующим образом: проведите пальцем вниз от верхнего края > Колесо настроек > Информация об устройстве > Техническая информация > Версия прошивки Chromecast

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

Убедитесь, что вы создали интеграцию с правильной комбинацией VID/PID в Developer Console . Дополнительную информацию см. в разделе «Создание интеграции для дела» .

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

Если при вводе устройства Thread в эксплуатацию постоянно появляется сообщение об ошибке «Не удается связаться с устройством», и вы исчерпали все доступные параметры отладки, возможно, вам следует удалить сохраненные учетные данные Thread на вашем телефоне Android для чистой настройки через Настройки > Приложения > Приложения > Сервисы Google Play > Хранилище и кэш > Управление пространством > ОЧИСТИТЬ ВСЕ ДАННЫЕ .

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

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

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

Для устранения неполадок удалите все тестовые устройства из Developer Console и повторно выполните сопряжение устройства, которое вы хотите протестировать.

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

Дополнительную информацию см. в разделе «Информация об устройстве» .

Если всё пойдёт не так,

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

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