Prueba una integración de Matter

Google Home Developer Console proporciona una página de pruebas en la que puedes configurar y ejecutar pruebas en tu integración con Matter mediante el Google Home Test Suite. Test Suite es una aplicación independiente integrada en Developer Console que controla todas las pruebas de integración.

Los dispositivos para el ID del proveedor y el ID del producto de la integración se deben realizar y estar disponibles en Google Home app (GHA) para la cuenta que se usa con Developer Console a fin de que se los pruebe. Consulta Cómo vincular un dispositivo Matter para obtener más información.

Test Suite se puede ejecutar en un conjunto de dispositivos que pertenecen a una configuración específica del proyecto Matter. Es muy importante ejecutar la Test Suite en tus integraciones para asegurarte de que todo funcione correctamente.

En la página Prueba, se enumeran las integraciones de Matter que están completas y listas para probar en Listo para probar.

Las integraciones Matter probadas se enumeran en la sección Probadas.

Tipo de planes de prueba

Existen dos tipos de planes de prueba:

  • Los planes de prueba de desarrollo se usan para probar dispositivos con Matter. Se pueden editar, pero no se pueden enviar para la certificación de Matter.

  • Los planes de prueba de certificación son específicos para la certificación de Matter y no se pueden editar. Si seleccionas esta opción, se creará una versión nueva de la integración de Matter.

Versiones de integraciones

Cuando creas un plan de prueba para la certificación, se crea una versión nueva de la integración. Esta versión numerada aparece en todas las listas de integración de Developer Console a partir de la pestaña Prueba.

Las versiones nuevas nunca se crean a partir de otras versiones numeradas. Por ejemplo, el primer plan de prueba que crees para una integración creará la versión v.1 para esa integración. Si creas otro plan de prueba, se creará la versión v.2 para esa integración, pero esta no se basará en la v.1. En cambio, esta versión se basa en la instancia sin versión de la integración, al igual que la v.1.

La versión N/A de una integración representa la instancia sin versiones de la integración, que se administra en la pestaña Desarrollar.

En otras palabras, en Matter > Test en el Developer Console:

  • Si haces clic en Probar para la versión N/A de la integración, se creará una versión nueva. El número de versión será uno mayor que el de cualquier versión numerada existente.
    • Si no existen versiones numeradas, se crea la versión v.1.
    • Si existe la versión v.1, se crea la v.2. Si existe la versión v.2, se crea la versión v.3 y así sucesivamente.
  • Si haces clic en Probar para una versión numerada de la integración (por ejemplo, v.1), v.1 se creará una versión nueva. En su lugar, se vuelve a probar la versión v.1.

Para obtener más información, consulta Control de versiones de la integración.

Crea un plan de prueba

Las versiones de integración son un resumen de una integración sin control de versiones. Esto significa que, cuando creas un plan de prueba para la certificación y, por lo tanto, una versión de integración, todos los metadatos relacionados con esa integración deben ser la información que deseas usar para la integración que se lanzó.

Antes de crear un plan de prueba para la certificación, asegúrate de haber hecho lo siguiente:

  1. Crear un perfil de la empresa
  2. Ingresa el ID del proveedor (VID) de producción para la integración.
  3. Configuración y desarrollo de la marca configurados

Si no completaste todos estos pasos para tu integración, no se puede certificar una versión de integración creada para las pruebas de certificación. Deberás crear una versión nueva, lo que significa volver a realizar los pasos de Prueba, Prueba de campo y Certificación.

También deberás crear una versión nueva y volver a empezar si quieres actualizar tu marca antes de que se certifique una versión de integración.

Para crear un plan de prueba, haz lo siguiente:

Ir a Play Console

  1. En la lista de proyectos, haz clic en Open junto al proyecto con el que deseas trabajar.

  2. En el menú de navegación del lado izquierdo de la página, ve a Matter > Probar.

  3. Haz clic en Probar para la versión N/A de la integración que quieras probar. Esta acción crea una nueva versión de integración.

  4. Selecciona un tipo de prueba, como Prueba de desarrollo o Prueba de certificación. Cómo crear un plan de prueba nuevo

    • Selecciona Prueba de certificación si te estás preparando para la certificación en el ecosistema de Google.
    • No se puede usar una prueba de desarrollo para la certificación.
  5. Haga clic en Probar. Si aparece la pantalla de error No se encontraron dispositivos, significa que aún no se encargó un dispositivo para esta integración al ecosistema. Consulta Solución de problemas de vinculación para obtener más información.

  6. En la pantalla Configure your test, proporciona un nombre para la prueba y selecciona los dispositivos que quieras probar de la lista de dispositivos.

  7. Haz clic en el botón Next: Test plan.

  8. En la página Crear un plan de prueba, en la sección Conjuntos de pruebas, selecciona los conjuntos de pruebas que deseas ejecutar.

Crea un plan de prueba

Si quieres salir de Test Suite, haz clic en Volver a Developer Center.

Ejecuta el plan de prueba

En Test Suite, en la página Crear un plan de prueba, haz clic en Ejecutar prueba. Aparecerá la página Entorno de pruebas, con el estado y los registros de todas las pruebas.

Los resultados de la prueba aparecerán una vez que se completen. Junto a ella, aparecerá el estado de la ejecución de cada paquete de pruebas (Aprobado, Con errores).

En el panel Registros, se muestra el estado de cada ejecución de prueba individual.

Resultados de la prueba

Para volver a probar un plan de prueba desde la página Entorno de pruebas, haz clic en Volver a probar en la parte superior después de que se complete la ejecución de prueba.

Cuando termines, haz lo siguiente:

Visualiza e interpreta los resultados de las pruebas

En la página Test history en Test Suite, puedes ver los resultados de las pruebas anteriores de un plan de desarrollo o de un plan de prueba de certificación no enviado. Para ello, haz clic en Retest (Volver a probar) para el plan de prueba deseado en la sección Planes de prueba (Planes de prueba). Esta acción te llevará a la página Entorno de pruebas, que muestra los resultados de esa prueba.

Historial de pruebas

En el caso de un plan de certificación enviado, haz clic en Resultados en la sección Guardados para la certificación a fin de ver el informe de resultados de la prueba.

También se puede acceder a los resultados de las pruebas de una versión de integración en la pestaña Prueba de Developer Console. Haz clic en Ver para ir al Historial de pruebas de cualquier versión de integración que aparezca en esa página a fin de ir a la página Historial de pruebas en la Test Suite.

Estados de la consola

En la fase de prueba, se encuentran los siguientes estados de la consola:

Sección Estado Descripción Requisito Qué hacer después
Listo para la prueba Listo Esta versión de integration está lista para probarse. No disponible Prueba esta versión del integration.
Probado Listo Esta versión de integration se probó y se puede enviar para la prueba de campo o la certificación.

Se probó y guardó la versión.

Todos los casos de prueba fallidos incluyen justificaciones para que Google las revise.

Si lo deseas, vuelve a probar.

Solución de problemas

El dispositivo comisionado no aparece en el paquete de pruebas

Si vinculaste un dispositivo con un ID de proveedor (VID) y un ID de producto (PID) de prueba, pero no aparece cuando intentas probar el dispositivo con el paquete de pruebas en Developer Console, es probable que esto se deba al uso de la misma combinación de VID y PID de prueba en varias integraciones.

Para solucionar el problema, quita todos los dispositivos de prueba de Developer Console y vuelve a vincular el dispositivo que deseas probar.

Para validar que vinculaste el correcto, puedes configurar la información del fabricante y del modelo (valores de CHIP_DEVICE_CONFIG_DEVICE_*) del dispositivo para valores únicos en tu firmware de prueba.

Consulta Información del dispositivo para obtener más detalles.

Verifica el VID/PID de tu dispositivo

Si quieres comenzar a desarrollar tu integración con Google, debes crear un proyecto y una integración en la consola de Google Home.

Solución de problemas del Sniffer Bluetooth

El valor de VID/PID que envía tu dispositivo debe coincidir con el VID/PID que ingresaste en tu proyecto Developer Console.

  • VID 0xFFF1: 0xFFF4 están reservados para pruebas. Se pueden usar para pruebas básicas de puesta en servicio y control, pero no durante las siguientes fases del desarrollo:

Cuando usas una app de ingeniería de Bluetooth, como nRF Connect for Mobile, puedes ver el VID/PID del dispositivo de baliza en el campo Service Data.

En esta captura de pantalla de la versión Android de nRF Connect, verás que el VID/PID aparece como 5A23FFFE a partir del cuarto byte del campo Service Data. Esto indica un VID de 5A23 y un PID de FFFE, ambos en formato endian pequeño.

La app de BLE muestra los valores en Little Endian, pero los valores VID/PID que ingresas en el proyecto Developer Console están en big endian.

Verifica que se hayan ingresado los valores y el formato correctos en tu proyecto de Actions Console en función de lo que muestra el detector de Bluetooth.

Para los valores de la captura de pantalla de ejemplo, el VID y el PID de Developer Console serían 235A y FEFF, respectivamente.