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

Здание

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

Все устройства 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 часов, вы можете попробовать выполнить сброс настроек устройства до заводских, чтобы принудительно загрузить модули.

Журналы устройств концентратора Fuchsia

Чтобы включить концентратор для получения локальных журналов:

  1. Отправьте электронное письмо с серийным номером и моделью вашего устройства своему Technical Account Manager (TAM) . Их можно найти мелкими буквами под устройством.
  2. После внесения в белый список необходимо включить эту функцию, выполнив следующие действия:
    • Из хаба:
      1. Проведите вниз от верхнего края экрана
      2. Коснитесь значка «Настройки .
      3. Найдите версию Fuchsia. В Google Nest Hub (2nd gen) выберите «Информация об устройстве» > «Техническая информация» > «Версия Fuchsia».
      4. Нажмите «Версия Фуксия» 7 раз. Это активирует возможности разработчика
      5. Вернитесь в меню верхнего уровня
      6. Нажмите «Параметры разработчика».
      7. Нажмите «Журнал партнеров».
    • Функция будет включена в течение 24 часов. После этого снова включите функцию ведения журнала, начиная с шага 5.
  3. Получите IP-адрес вашего хаба:
    • Из хаба, если у него есть экран:
      1. Проведите вниз от верхнего края экрана
      2. Коснитесь значка «Настройки .
      3. Найдите IP-адрес устройства. На Nest Hub (2nd gen) выберите «Информация об устройстве» > «Техническая информация» > «IP-адрес».
    • Из Google Home app (GHA) на вашем телефоне:
      1. Коснитесь устройства, чтобы открыть страницу сведений об устройстве.
      2. Коснитесь значка , чтобы открыть страницу настроек.
      3. Найдите IP-адрес устройства: перейдите в раздел «Информация об устройстве» > «Техническая информация» > «IP-адрес».
  4. Чтобы получить журналы из концентратора, вы отправите HTTP-запрос GET к концентратору с компьютера в той же сети Wi-Fi.
    • Обратите внимание на порт и путь конечной точки:
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • Соединение может оставаться открытым только одну минуту, но данные, полученные из буфера, обычно содержат 20-30 минут прошлых событий.
      • В идеале журналы извлекаются с помощью этого метода сразу после завершения процедуры тестирования, чтобы гарантировать, что буфер содержит контент, относящийся к тесту (аналогично отчетам об ошибках Android).

Отключить редактирование журналов Android

  • В целях конфиденциальности и безопасности эту функцию следует использовать только в целях инженерных испытаний.
  • Не используйте эту опцию с производственными устройствами или пользователями.
  • Шаги:
    1. Отправьте учетные записи Google пользователей, у которых будут неотредактированные журналы, в свой TAM Google.
    2. После подтверждения того, что ваша учетная запись добавлена ​​в белый список, перезагрузите телефон.

Проверьте 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.