Cómo probar una integración de Matter

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Google Home Developer Console provides a Test page where you can configure and run tests against your Matter integration using the Google Home Test Suite . The Test Suite is a separate application built into the Developer Console that handles all integration testing.

Los dispositivos para el ID de proveedor y el ID de producto de la integración deben estar en marcha y estar disponibles en Google Home app (GHA) for the account being used with the Developer Console in order to be tested. See Pair a Matter device for more information..

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

En la página Test, se incluyen las integraciones de Matter que están completas y listas para probar en Ready to test.

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

Tipo de planes de prueba

Existen dos tipos de planes de prueba:

  • Los planes de prueba de desarrollo se usan para probar los dispositivos de control mediante Matter. Se pueden editar, pero no se pueden enviar para obtener 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 en el Developer Console de la pestaña Prueba 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 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 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 versión de la integración, que se administra en la pestaña Desarrollar.

En otras palabras, en Matter > Test en la 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 superior a cualquier versión numerada existente.
    • Si no existen versiones numeradas, se crea la versión v.1.
    • Si la versión v.1 existe, 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 obtener una versión numerada de la integración (por ejemplo, v.1), no se creará una nueva. En su lugar, la versión v.1 se vuelve a probar.

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

Cree un plan de prueba

Las versiones de integración son un resumen de una integración sin versión. 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 hecho lo siguiente:

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

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

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

Para crear un plan de prueba, haz lo siguiente:

Ir a Developer 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. Haga clic en Probar para la versión N/A de la integración que desea probar. Esta acción crea una versión nueva de integración.

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

    • Selecciona Prueba de certificación si quieres prepararte 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 Test. Si ves la pantalla de error No device found, significa que un dispositivo para esta integración aún no se encargó en el ecosistema. Consulta Solución de problemas de sincronización para obtener más información.

  6. En la pantalla Configura tu prueba, proporciona un nombre para la prueba y selecciona los dispositivos que deseas 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.

Cree un plan de prueba

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

Ejecuta el plan de prueba

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

Los resultados de la prueba aparecerán una vez que se completen. El estado de cada ejecución del conjunto de pruebas aparece al lado (aprobada, con errores).

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

Resultados de la prueba

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

Una vez finalizado:

Cómo ver e interpretar los resultados de tu prueba

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

Historial de pruebas

En el plan de certificación que enviaste, 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 pruebas para una versión de integración en la pestaña Test de Developer Console. Haz clic en View (Vista) para ver el Historial de pruebas de cualquier versión de integración incluida en esa página y acceder a la página Test history en el Test Suite.

Estados de la consola

Los siguientes estados de Console se encuentran en la fase de prueba:

Section Estado Descripción Requisito Qué hacer después
Listo para la prueba Listo Esta versión de la integración está lista para la prueba. N/A Prueba esta versión de la integración.
Listo para la certificación Listo Se probó esta versión de la integración y se puede enviar para una prueba de campo o una certificación.

La versión se probó y se guardó.

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 conjunto de pruebas

Si sincronizaste 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 conjunto de pruebas en Developer Console, es probable que esto se deba a la combinación del mismo VID y PID de prueba en varias integraciones.

Para solucionar el problema, quita todos los dispositivos de prueba de Developer Console y vincula el dispositivo que quieras probar de nuevo.

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

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

Verifica el VID o PID de tu dispositivo

Si deseas comenzar a desarrollar tu integración con Google, debes crear un proyecto y una integración en Google Home Console.

Solución de problemas del detector de Bluetooth

El valor de VID/PID que usa tu dispositivo en el pixel contador debe coincidir con el VID/PID que ingresaste en tu proyecto Developer Console. - VID 0xFFF1-0xFFF4 está reservado para pruebas. Se puede usar para pruebas básicas de control y puesta en marcha, pero no se puede usar para el conjunto de pruebas. - Pruebas de campo - inalámbrico.

Mediante una app de ingeniería de Bluetooth, como nRF Connect for Mobile, puedes ver el VID/PID del dispositivo contador de píxeles en el campo Datos de servicio.

En esta captura de pantalla de Android version of nRF Connect, you'll see the VID/PID is listed as 5A23FFFE in the last four bytes of the Service Data field. This indicates a VID of 5A23 and a PID of FFFE — both in little endian format.

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

Valida que se hayan ingresado los valores y el formato correctos en tu proyecto de la Consola de Actions según lo que muestra el detector de Bluetooth.

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