Устранение неполадок в сборках Matter

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

Все Android O (8.1, API level 27) and later devices are compatible with Matter . Follow the steps below to check if your phone has the necessary modules.

Настройте мост отладки Android

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

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

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

Чтобы проверить, есть ли у вас Google Play services Matter modules, do the following:

  1. Настройте мост отладки Android .
  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 modules are installed:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    If you see output similar to the below, you have the Thread modules installed:
    com.google.android.gms.threadnetwork [v222106301]
    Note that the version number above may be different from your device.

Если модулей нет в списке, это означает, что либо:

  1. У вас устаревшая версия Android . Убедитесь, что это Android O (8.1) или выше.
  2. Модули Matter еще не загружены. Подождите не менее 24 часов, пока они загрузятся. Убедитесь, что ваше устройство включено и заряжается в это время, чтобы загрузка не задерживалась. Если вы не получили модули в течение 24 часов, вы можете попробовать выполнить сброс заводских данных устройства, чтобы принудительно загрузить модули.

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

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

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

Значение VID/PID, которое отправляет ваше устройство, должно совпадать с VID/PID, введенным в ваш Google Home Developer Console project. - VID 0xFFF1-0xFFF4 is reserved for testing . It may be used for basic commissioning and control tests, but they can't be used for - Test Suite. - Field Trials. - OTA.

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

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

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

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

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

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

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

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

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

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

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

Подтвердите, что ваш концентратор совместим с Matter

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

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

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

Сбой ввода в эксплуатацию с сообщением об ошибке «Не удалось связаться с Google».

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

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

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

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

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

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

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

Если что-то по-прежнему пойдет не так

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

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