Google Home Developer Console proporciona una página Test en la que puedes configurar y ejecutar pruebas en tu integración de Matter con Google Home Test Suite. Test Suite es una aplicación independiente integrada en Developer Console que controla todas las pruebas de integración.
Para que se puedan probar, los dispositivos del ID de proveedor y el ID de producto de la integración deben estar encargados y disponibles en Google Home app (GHA) para la cuenta que se usa con Developer Console. 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 Prueba, las integraciones de Matter que están completas y listas para probar se enumeran en Listo para probar.
Las integraciones de Matter que se probaron se enumeran en la sección Probadas.
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. 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 tu integración con Matter.
Usa el Test Suite en el Developer Console para enviar los resultados de las pruebas para la certificación. Si quieres ejecutar Test Suite con fines de prueba durante el desarrollo, consulta la página del paquete de pruebas de Google Home para obtener la versión independiente.
Versiones de integraciones
Cuando creas un plan de pruebas para la certificación, se crea una versión nueva de la integración. Esta versión con número se muestra 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 versión 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 lo hacía 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 Desarrollar.
En otras palabras, en Matter > Pruebas en 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 más alto que cualquier versión con número existente.
- 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 ejemplo, v.1), no 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 integración.
Crea un plan de prueba
Las versiones de integración son una instantánea 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:
- Creaste un perfil de empresa.
- Ingresaste el ID de proveedor (VID) de producción para la integración.
- Configuración y desarrollo de la marca configurados.
Si no completaste todos estos pasos para tu integración, no se podrá certificar una versión de integración creada para las pruebas de certificación. Deberás crear una versión nueva, lo que significa que deberás volver a realizar los pasos de prueba, prueba de campo y certificación.
También deberás crear una versión nueva y comenzar de nuevo si deseas actualizar 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:
En la lista de proyectos, haz clic en Abrir junto al proyecto con el que deseas trabajar.
En el menú de navegación del lado izquierdo de la página, ve a Matter > Pruebas.
Haz clic en Probar para la versión N/A de la integración que deseas probar. Esta acción crea una nueva versión de la 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 aparece una pantalla de error que indica que No se encontró ningún dispositivo, significa que aún no se comisionó 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 Configurar la prueba, proporciona un nombre para la prueba y selecciona los dispositivos que deseas probar en la lista de dispositivos.
Haz clic en el botón Siguiente: Plan de prueba.
En la página Crear un plan de prueba, en la sección Paquetes de pruebas, selecciona los paquetes de pruebas que deseas ejecutar.
Ejecuta el plan de pruebas
En Test Suite, en la página Create a test plan, haz clic en Run Test. Aparece la página Entorno de pruebas, con el estado y los registros de todas las pruebas.
Los resultados de las pruebas aparecerán una vez que estas 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.
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:
- Haz clic en Listo para ir a la página Historial de pruebas.
- Haz clic en Enviar para enviar los resultados de la prueba para la certificación.
Cómo ver y, luego, interpretar los resultados de la prueba
En la página Historial de pruebas de Test Suite, puedes ver los resultados de pruebas anteriores de un plan de desarrollo o un plan de pruebas de certificación no enviado. Para ello, haz clic en Repetir en el plan de prueba deseado en la sección Planes de prueba. Esto te llevará a la página Entorno de prueba, que muestra los resultados de esa prueba.
Si enviaste un plan de certificación, haz clic en Resultados en la sección Guardado para la certificación para 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 desde la pestaña Test de Developer Console. Haz clic en Ver para que el historial de pruebas de cualquier versión de integración que aparezca en esa página te dirija a la página Historial de pruebas en 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 de 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 que fallaron incluyen justificaciones para que Google los revise. |
Vuelve a realizar la prueba si lo deseas. |
Solución de problemas
El dispositivo comisionado no aparece en la suite 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 se deba a que estás usando 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 establecer la información del fabricante y del modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*
) del dispositivo en valores únicos en el firmware de prueba.
Consulta Información del dispositivo para obtener más información.
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 envía tu dispositivo debe coincidir con el VID/PID que ingresaste en tu proyecto Developer Console.
- Los VIDs
0xFFF1
a0xFFF4
están reservados para pruebas. Se pueden usar para pruebas de control y puesta en marcha básicas, pero no durante las siguientes fases de desarrollo:
Con una app de ingeniería de Bluetooth, como nRF Connect for Mobile, puedes ver el VID/PID del dispositivo de balizas 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 little-endian.
La app de BLE muestra los valores en formato little endian, pero los valores de VID/PID que ingresas en tu proyecto Developer Console están en formato big endian.
Valida que se hayan ingresado los valores y el formato correctos en tu proyecto de Acciones Console según lo que muestra el sniffer de Bluetooth.
Para los valores de la captura de pantalla de ejemplo, el VID y el PID en Developer Console serían 235A
y FEFF
, respectivamente.