Протестируйте интеграцию Matter

Google Home Developer Console предоставляет тестовую страницу, на которой вы можете настроить и запустить тесты для интеграции с Matter с помощью Google Home Test Suite . Test Suite — это отдельное приложение, встроенное в Developer Console , которое выполняет все интеграционное тестирование.

Для тестирования устройства с идентификатором поставщика и идентификатором продукта интеграции должны быть введены в эксплуатацию и доступны в Google Home app (GHA) для учетной записи, используемой с Developer Console . Дополнительную информацию см. в разделе «Сопряжение устройства Matter» .

Test Suite можно запускать на наборе устройств, принадлежащих к определенной конфигурации проекта Matter . Очень важно запустить Test Suite для вашей интеграции, чтобы убедиться, что все работает правильно.

На странице «Тестирование» интеграции Matter , которые завершены и готовы к тестированию, перечислены в разделе «Готово к тестированию» .

Протестированные интеграции Matter перечислены в разделе «Протестировано» .

Тип планов тестирования

Существует два типа планов тестирования:

  • Планы тестирования разработки используются для тестирования управляющих устройств с помощью Matter . Их можно редактировать, но нельзя отправить на сертификацию Matter .

  • Планы сертификационных испытаний предназначены специально для сертификации Matter и не подлежат редактированию. Выбор этой опции создаст новую версию вашей интеграции Matter .

Версии интеграции

При создании плана тестирования для сертификации создается новая версия интеграции. Эта пронумерованная версия указана во всех списках интеграции в Developer Console , начиная с вкладки «Тест».

Новые версии никогда не создаются из других пронумерованных версий. Например, первый план тестирования, который вы создадите для интеграции, создаст версию v.1 для этой интеграции. Создание другого плана тестирования приведет к созданию версии v.2 для этой интеграции, но эта версия не будет основана на версии v.1 . Вместо этого эта версия основана на неверсированном экземпляре интеграции, как и версия 1 .

Версия интеграции «Н/Д» представляет собой неверсированный экземпляр интеграции, управление которым осуществляется на вкладке «Разработка» .

Другими словами, в разделе Matter > «Тест» в Developer Console :

  • Если вы нажмете «Проверить версию N/A интеграции», будет создана новая версия. Номер версии будет на единицу выше, чем у всех существующих пронумерованных версий.
    • Если пронумерованных версий не существует, создается версия v.1 .
    • Если версия v.1 существует, создается версия v.2 . Если существует версия v.2 , создается версия v.3 и т. д.
  • Если вы нажмете Проверить для пронумерованной версии интеграции (например, v.1 ), новая версия не будет создана. Вместо этого снова тестируется версия v.1 .

Дополнительные сведения см. в разделе Управление версиями интеграции .

Создайте план тестирования

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

Прежде чем создавать план тестирования для сертификации, убедитесь, что вы выполнили следующее:

  1. Создал профиль компании .
  2. Введен производственный идентификатор поставщика (VID) для интеграции .
  3. Настроенная настройка и брендинг .

Если вы не выполнили все эти действия для интеграции, версия интеграции, созданная для сертификационного тестирования , не может быть сертифицирована . Вам придется создать новую версию, что означает повторение этапов тестирования, полевых испытаний и сертификации.

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

Чтобы создать план тестирования:

Зайдите в консоль разработчика

  1. В списке проектов нажмите «Открыть» рядом с проектом, с которым вы хотите работать.

  2. В меню навигации в левой части страницы выберите Matter > «Тест» .

  3. Нажмите «Протестировать» для версии N/A интеграции, которую вы хотите протестировать. Это действие создает новую версию интеграции .

  4. Выберите тип теста: тест разработки или сертификационный тест . Создание нового плана тестирования

    • Выберите Сертификационный тест , если вы готовитесь к сертификации в экосистеме Google.
    • Тест развития не может использоваться для сертификации.
  5. Нажмите «Тест» . Если вы увидите экран с ошибкой «Устройство не найдено» , это означает, что устройство для этой интеграции еще не введено в эксплуатацию в экосистему. Дополнительную информацию см. в разделе «Устранение неполадок при сопряжении» .

  6. На экране «Настройка теста» укажите имя теста и выберите устройства, которые вы хотите протестировать, из списка устройств.

  7. Нажмите кнопку «Далее: план тестирования» .

  8. На странице Создание плана тестирования в разделе Наборы тестов выберите наборы тестов, которые вы хотите запустить.

Создайте план тестирования

Если вы хотите выйти из Test Suite , нажмите Вернуться в центр разработчиков .

Запустите план тестирования

В Test Suite на странице «Создание плана тестирования» нажмите «Выполнить тест» . Появится страница «Тестовая среда» со статусом и журналами всех тестов.

Результаты теста появятся после завершения тестов. Рядом с ним отображается статус выполнения каждого набора тестов (пройдено, не пройдено).

На панели «Журналы» отображается состояние выполнения каждого отдельного теста.

Результаты теста

Чтобы повторно протестировать план тестирования на странице «Среда тестирования» , нажмите «Повторное тестирование» вверху после завершения выполнения теста.

После завершения:

Просмотр и интерпретация результатов теста

На странице «История тестов» в Test Suite вы можете просмотреть результаты предыдущих тестов для плана разработки или неотправленного плана сертификационного тестирования, нажав «Повторно протестировать» для нужного плана тестирования в разделе «Планы тестирования» . Вы перейдете на страницу «Тестовая среда» , на которой отображаются результаты этого теста.

История испытаний

Для отправленного плана сертификации нажмите «Результаты» в разделе «Сохранено для сертификации» , чтобы просмотреть отчет о результатах тестирования.

Результаты тестирования также можно получить для версии интеграции на вкладке «Тест» в Developer Console . Нажмите «Просмотреть» , чтобы просмотреть историю тестов любой версии интеграции, указанной на этой странице, чтобы перейти на страницу «История тестов» в Test Suite .

Статусы консоли

На этапе тестирования встречаются следующие состояния консоли:

Раздел Положение дел Описание Требование Что делать дальше
Готов к тестированию Готовый Эта версия integration готова к тестированию. Н/Д Протестируйте эту версию integration.
Протестировано Готовый Эта версия integration была протестирована и может быть отправлена ​​на полевые испытания или сертификацию.

Версия была протестирована и сохранена.

Все неудачные тестовые случаи включают обоснования для проверки Google.

При желании повторите тест .

Поиск неисправностей

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

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

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

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

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

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

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

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

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

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

Используя инженерное приложение 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 соответственно.