Prueba una integración de Matter

Google Home Developer Console proporciona una página de Prueba en la que puedes configura y ejecuta pruebas en tu Matter integración con Google Home Test Suite. El Test Suite es una aplicación independiente integrada en la Developer Console, que controla todas las pruebas de integración.

Se deben poner en marcha los dispositivos para el ID del proveedor y el ID del producto de la integración y están disponibles en Google Home app (GHA) para la cuenta que se usa con el Developer Console para que se puedan probar. Consulta Cómo vincular un dispositivo Matter para obtener más información.

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

En la página Probar, Matter integraciones completas y listas para la prueba se detallan en la sección Listo para probar.

Las integraciones de Matter que se probaron se enumeran en en la sección Verificados.

Tipos de planes de prueba

Existen dos tipos de planes de prueba:

  • Los planes de prueba de desarrollo se usan para probar dispositivos de control con Matter. Pueden editarse, pero no enviarse para obtener la certificación de Matter.

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

Versiones de integraciones

Cuando creas un plan de prueba para certificación, se crea una nueva versión de la integración. Este número aparece en todas las listas de integración de la Developer Console desde la pestaña Probar en adelante.

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 y la integración de datos. Si creas otro plan de prueba, se creará la versión v.2 para eso pero esta versión no se basará en la versión v.1. En cambio, esta versión se basa en la instancia sin versiones de la integración, al igual que v.1.

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

En otras palabras, en Matter > Prueba en la Developer Console:

  • Si haces clic en Probar para la versión N/A de la integración, se mostrará una versión nueva crear. El número de versión será uno más alto que cualquier número existente versiones.
    • Si no existen versiones numeradas, se crea la versión v.1.
    • Si existe la versión v.1, se crea la versión 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 por ejemplo, v.1), no se creará una nueva. En cambio, se usa la versión v.1 se volvió a probar.

Para obtener más información, consulta Integración control de versiones.

Crea un plan de prueba

Las versiones de integración son un resumen de una integración sin 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 lanzada.

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

  1. Creaste un perfil de la empresa.
  2. Se ingresó el ID del proveedor de producción. (VID) de la integración.
  3. Configuración y desarrollo de la marca establecidos.

Si no completaste todos los pasos para la integración, La versión creada para la prueba de certificación no se puede certificar. Tendrás para crear una nueva versión, lo que significa rehacer los procesos de Prueba, Prueba de campo y Certificación pasos.

También tendrás que crear una nueva versión y empezar de nuevo si quieres actualiza tu desarrollo de la marca antes de que se certifique una versión de integración.

Para crear un plan de prueba, sigue estos pasos:

Ve a Play Console

  1. En la lista de proyectos, haz clic en Open junto al proyecto que deseas. en los datos que utilizan.

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

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

  4. Selecciona un tipo de prueba: 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 obtener 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 una pantalla de error que indica que no se encontró ningún dispositivo, significa que un dispositivo que esta integración todavía no se encargó en el ecosistema. Consulta Solución de problemas de vinculación para obtener más información.

  6. En la pantalla Configure your test, ingresa un nombre para tu prueba y selecciona los dispositivos que quieres 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 Paquetes de pruebas, selecciona los paquetes de pruebas que deseas ejecutar.

Crea un plan de prueba

Si deseas salir de Test Suite, haz clic en Volver al desarrollador Centro.

Ejecuta el plan de prueba

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

Los resultados de la prueba aparecerán una vez que se completen. El estado de cada ejecución del paquete de pruebas aparece junto a él (Aprobado, Falló).

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 prueba, haz clic en Volver a probar en la parte superior después de que se complete la ejecución de la prueba.

Cuando termines, haz lo siguiente:

Cómo ver e interpretar los resultados de las pruebas

En la página Historial de pruebas de Test Suite, puedes ver resultados de pruebas anteriores de un plan de desarrollo o una certificación no entregada plan de prueba haciendo clic en Volver a probar para el plan de prueba deseado en Planes de prueba. sección. Esta acción te llevará a la página Entorno de pruebas, que muestra la resultados de esa prueba.

Historial de pruebas

Si deseas enviar un plan de certificación, haz clic en Resultados en la sección Guardado para certificación para ver el informe de resultados de las pruebas.

También se puede acceder a los resultados de la prueba de una versión de integración en Prueba en la Developer Console. Haz clic en Ver en el Historial de pruebas de cualquier versión de integración que aparezca en esa página para ir al historial de pruebas en el 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
Lista para probar Listo Esta versión de integration está lista para probarse. N/A Prueba esta versión del integration
Probado Listo Esta versión de integration se probó y se puede enviar a la prueba de campo o a la certificación.

Se probó y guardó la versión.

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

Vuelve a probar si lo deseas.

Solución de problemas

El dispositivo encargado no aparece en el paquete de pruebas

Si vinculaste un dispositivo con un ID del proveedor (VID) y un ID del producto (PID) de prueba, pero no aparece cuando intentas probar el dispositivo con el Suite en Developer Console, es probable que esto se deba a con 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 vincúlalos el dispositivo que quieres volver a probar.

Para validar que vinculó el dispositivo correcto, puede configurar el valor de Fabricante y Información del modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) del dispositivo valores únicos en el firmware de prueba.

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

Verifica el VID/PID de tu dispositivo

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

Soluciona problemas relacionados con el sniffer de Bluetooth

El valor de VID/PID que envía el dispositivo contador debe coincidir con el valor del VID/PID se ingresó en tu proyecto de Developer Console.

  • Los VID 0xFFF1: 0xFFF4 están reservados para pruebas. Pueden usarse para pruebas básicas de puesta en servicio y control, pero no se pueden utilizar durante el las siguientes fases de desarrollo:

Usar una aplicación de ingeniería de Bluetooth, como nRF Connect para dispositivos móviles, podrás consultar el VID/PID del dispositivo de baliza en el campo Datos del servicio.

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 de el campo Datos del servicio. Esto indica un VID de 5A23 y un PID de FFFE: ambas en formato Little endian.

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

Verifica que se hayan ingresado los valores y el formato correctos en tus Acciones de consola de Cloud según lo que muestra el detector de Bluetooth.

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