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

Здание

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

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

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

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

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

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

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

  1. Настройте Android Debug Bridge .
  2. Используйте USB-кабель для подключения телефона Android к компьютеру.
  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.

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

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

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

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

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

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

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

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

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

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

Сопряжение

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

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

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

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

Проверьте свой концентратор, совместимый с Matter

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

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