Google Home Developer Console proporciona una página de prueba en la que puedes configurar y ejecutar pruebas en tu integración Matter mediante Google Home Test Suite. Test Suite es una aplicación separada integrada en Developer Console que controla todas las pruebas de integración.
A fin de realizar la prueba, se deben configurar los dispositivos para el ID de producto y el ID de proveedor de la integración, que deben estar disponibles en Google Home app (GHA) para la cuenta que se usa con Developer Console. Para obtener más información, consulta Cómo vincular un dispositivo Matter.
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 Test Suite en tus integraciones para asegurarte de que todo funcione correctamente.
En la página Test, las integraciones Matter que están completas y listas para probar se enumeran en Ready to test.
Las integraciones de Matter que se probaron se muestran en la sección Verificado.
Tipo de planes de prueba
Existen dos tipos de planes de prueba:
Los planes de prueba de desarrollo se usan para probar dispositivos de control mediante Matter. Se pueden editar, pero no se pueden enviar para la certificación de Matter.
Los planes de prueba de Certificación son específicamente para la certificación de Matter y no se pueden editar. Si seleccionas esta opción, se creará una versión nueva de tu 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 la Developer Console desde 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 versión no se basará en v.1. En cambio, 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 versión de la integración, que se administra en la pestaña Desarrollo.
En otras palabras, en Matter > Probar en Developer Console:
- Si haces clic en Probar para ver la versión N/A de la integración, se creará una nueva. El número de versión será superior a cualquier versión numerada existente.
- Si no existen versiones numeradas, se creará la versión v.1.
- Si existe la versión v.1, se creará la versión v.2. Si existe la versión v.2, se creará la versión v.3, y así sucesivamente.
- Si haces clic en Probar para ver una versión numerada de la integración (por ejemplo, v.1), no se creará una 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.
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 iniciada.
Antes de crear un plan de prueba para la certificación, asegúrate de haber hecho lo siguiente:
- Crear un perfil de la empresa.
- Ingresado el ID del proveedor de producción (VID) de la integración.
- Configuración de marca y configuración.
Si no completaste todos los pasos de la integración, no se podrá certificar una versión de integración creada para las pruebas de certificación. Tendrá que 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 comenzar si deseas actualizar tu marca antes de que se certifique una versión de integración.
Para crear un plan de prueba, siga estos pasos:
Ir a la Consola para desarrolladores
En la lista de proyectos, haz clic en Open junto al proyecto con el que deseas trabajar.
En el menú de navegación que se encuentra en el lado izquierdo de la página, ve a Matter > Test.
Haz clic en Probar para ver la versión N/A de la integración que quieres probar. Esta acción crea una versión nueva de integración.
Selecciona un tipo de prueba de Prueba de desarrollo o Prueba de certificación.
- 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.
Haga clic en Probar. Si se muestra la pantalla de error No device found, significa que todavía no se encargó un dispositivo para esta integración en el ecosistema. Consulta Solución de problemas de vinculación para obtener más información.
En la pantalla Configure your test, proporciona un nombre para la prueba y selecciona los dispositivos que quieres probar de la lista.
Haz clic en el botón Next: Test plan.
En la página Crear un plan de prueba, en la sección Conjuntos de pruebas, selecciona los conjuntos de pruebas que deseas ejecutar.
Si deseas salir de Test Suite, haz clic en Volver al Centro de desarrolladores.
Ejecuta el plan de prueba
En la página Crear un plan de prueba de Test Suite, haz clic en Ejecutar prueba. Aparecerá la página Entorno de prueba con el estado y los registros de todas las pruebas.
Los resultados aparecerán una vez que se completen las pruebas. El estado de la ejecución de cada conjunto de pruebas aparece junto a él (Aprobado, Error).
En el panel Registros (Logs), se muestra el estado de cada ejecución de prueba individual.
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 una vez que se complete la ejecución.Cuando termines, haz lo siguiente:
- Haga clic en Listo para ir a la página Historial de pruebas.
- Haz clic en Enviar a fin de enviar los resultados de la prueba para la certificación.
Cómo ver e interpretar los resultados de la prueba
En la página Historial de pruebas de Test Suite, puedes ver los resultados de las pruebas anteriores de un plan de desarrollo o de una certificación no enviada. Para ello, haz clic en Volver a probar, en la sección Planes de prueba. Esta acción te llevará a la página Entorno de prueba, en la que se muestran los resultados de esa prueba.
En el caso de un plan de certificación enviado, haz clic en Resultados en la sección Guardados para certificar a fin de ver el informe de resultados de la prueba.
También se puede acceder a los resultados de las pruebas para una versión de integración desde la pestaña Test de Developer Console. Haz clic en View en el Historial de pruebas de cualquier versión de integración que se muestre en la página para acceder a la página Test history en Test Suite.
Estados de la consola
Los siguientes estados de Console se encuentran en la fase de prueba:
Sección | Estado | Descripción | Requisito | Qué hacer después |
---|---|---|---|---|
Listo para la prueba | Listo | Ya puedes probar esta versión de la integración. | N/A | Prueba esta versión de la integración. |
Lista 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. |
Se probó y guardó la versión. Todos los casos de prueba con errores incluyen justificaciones para que Google las revise. |
Vuelve a probar, si lo deseas. |
Solución de problemas
El dispositivo solicitado no aparece en el conjunto de pruebas
Si vinculaste un dispositivo con un ID de proveedor (PID) 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 que usas el mismo conjunto 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 quieras probar.
Para validar que vinculaste el correcto, puedes configurar la información del fabricante y del modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*
) del dispositivo con 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.
El valor de VID/PID que asigna tu baliza al dispositivo debe coincidir con el VID/PID que ingresaste en tu proyecto Developer Console.
- Los VID
0xFFF1
y0xFFF4
están reservados para pruebas. Se pueden usar para las pruebas básicas de control y puesta en marcha, pero no se pueden usar durante las siguientes fases de desarrollo:
Mediante una aplicación de ingeniería de Bluetooth, como nRF Connect para dispositivos móviles, puede ver el VID/PID del dispositivo con píxeles contadores 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 del campo Service Data. Esto indica un VID de 5A23
y un PID de FFFE
, ambos en formato pequeño de endian.
La app de BLE muestra los valores en little endian, pero los valores de VID/PID que ingresas en tu proyecto Developer Console están en big endian.
Valida que se hayan ingresado los valores y el formato correctos en tu proyecto de Actions Console según lo que muestre 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.