El Google Home Developer Console proporciona una página de Prueba en la que puedes configurar y ejecutar pruebas en tu Matter integración con el Google Home Test Suite. El Test Suite es una aplicación independiente integrada en el Developer Console que controla todas las pruebas de integración.
Los dispositivos para el ID de proveedor y el ID de producto de la integración deben estar comisionados y disponibles en Google Home app (GHA) para la cuenta que se usa con el Developer Console para poder probarlos. Consulta Cómo vincular un dispositivo Matter device para obtener más información.
El 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 el Test Suite en tus integraciones para asegurarte de que todo funcione correctamente.
En la página Prueba, las integraciones Matter que están completas y listas para probar se muestran en Lista para probar.
Las integraciones Matter que se probaron se muestran en la sección Probado.
Tipos de planes de prueba
Estos tipos de planes de prueba están disponibles:
Los planes de prueba de desarrollo se usan para probar el control de dispositivos con Matter. Se pueden editar, pero no se pueden enviar para Matter certificación.
Los planes de prueba de certificación son específicamente para Matter certificación y no se pueden editar. Si seleccionas esta opción, se creará una versión nueva de tu Matter integración.
Los planes de prueba de Interop de CSA te permiten omitir la etapa de prueba y usar los resultados de Interop Test Lab Connectivity Standards Alliance (Alliance). Esta opción de prueba está disponible para todos los tipos de dispositivos compatibles.
Usa el Test Suite en el Developer Console para enviar los resultados de las pruebas para la certificación. Si quieres ejecutar el 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 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 desde la pestaña Prueba en adelante.
Nunca se crean versiones nuevas 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, esta versión se basa en la instancia sin versión 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 > Prueba en el Developer Console:
- Si haces clic en Prueba para la versión N/A de la integración, se crea una versión nueva. El número de versión será uno más que 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 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 Prueba para una versión numerada de la integración (por ejemplo, v.1), no se crea una versión nueva. En cambio, 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.
- Configuraste la configuración y la marca.
Si no completaste todo esto para tu integración, no se puede certificar una versión de integración creada para las pruebas de certificación. Tendrás que crear una versión nueva, lo que significa volver a realizar los pasos de prueba, prueba de campo y certificación.
También tendrás que crear una versión nueva y volver a comenzar 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:
En la lista de proyectos, haz clic en Abrir junto al proyecto con el que quieres trabajar.
En el menú de navegación del lado izquierdo de la página, ve a Matter > Prueba.
Haz clic en Prueba para la versión N/A de la integración que quieres probar. Esta acción crea una versión de integración nueva.
Selecciona un tipo de prueba y haz clic en Prueba.
- 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.
- Selecciona Prueba de interoperabilidad de CSA para usar los resultados de Alliance Interop Test Lab y omitir las etapas de prueba y prueba de campo en el flujo de integración de Matter.
En la pantalla Configura tu prueba, proporciona un nombre para la prueba y haz clic en Vincular dispositivo automáticamente para seleccionar un dispositivo para vincular.
Para un dispositivo Android:
- Asegúrate de haber instalado GHA en tu teléfono.
- Conecta el teléfono con un cable USB a la máquina host.
- Debes
habilitar la depuración por USB en tu dispositivo
Se descargará
e instalará automáticamente el
APKcom.chip.interop.moblysnippet. - Una vez que el teléfono esté conectado, ingresa el código de vinculación y el nombre del dispositivo para vincularlo automáticamente.
Para un dispositivo iOS:
- Deberás vincular el dispositivo de forma manual. Consulta la sección de la app de Google Home para obtener instrucciones sobre la vinculación manual.
- Si tienes un dispositivo existente, es posible que se te pida que lo desvincules y lo vuelvas a vincular, o que vincules un dispositivo nuevo.
Haz clic en el botón Siguiente: Plan de prueba.
En la página Crea un plan de prueba, en la sección Paquetes de pruebas, selecciona los paquetes de pruebas que quieres ejecutar.
Si quieres salir de Test Suite, haz clic en
Volver a Developer
Center.
Ejecuta el plan de prueba
En el Test Suite, desde la página Crea 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 las pruebas. El estado de cada ejecución del paquete de pruebas aparece junto a él (Aprobado, Falló).
El panel Registros 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.
Una vez que 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 las pruebas para la certificación.
Consulta e interpreta los resultados de las pruebas
En la página Historial de pruebas del Test Suite, puedes ver los resultados de pruebas anteriores de un plan de desarrollo o un plan de prueba de certificación no enviado . Para ello, haz clic en Volver a probar para el plan de prueba deseado en la sección Planes de prueba . Esto te lleva a la página Entorno de prueba , que muestra los resultados de esa prueba.
Para un plan de certificación enviado, 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 para una versión de integración desde la pestaña Prueba en Developer Console. Haz clic en Ver para el Historial de pruebas de cualquier versión de integración que aparezca en esa página para ir a la página Historial de pruebas en el Test Suite.
Estados de la consola
Los siguientes estados de la consola se encuentran en la fase de prueba:
| Sección | Estado | Descripción | Requisito | Próximos pasos |
|---|---|---|---|---|
| Lista para probar | Listo | Esta versión de integration está lista para probar. | N/A | Prueba esta versión de la integration. |
| Probado | Listo | Se probó esta versión de integration y se puede enviar para Field Trial o la certificación. |
Se probó y guardó la versión. Todos los casos de prueba fallidos incluyen justificaciones para que Google los revise. |
Vuelve a probar si lo deseas. |
Volver a probar
Certificación
Si necesitas volver a realizar la prueba para la certificación, debes vincular tu dispositivo después de comenzar a volver a realizar la prueba.
Desarrollo
Si necesitas volver a realizar la prueba para el desarrollo, puedes usar el dispositivo existente sin volver a vincularlo.
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 se deba a que usas 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 el 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/PID de tu dispositivo
Si quieres comenzar a desarrollar tu integración con Google, debes crear un proyecto y una integración en Google Home Console.
El valor de VID/PID que transmite tu dispositivo debe coincidir con el VID/PID ingresado en tu Developer Console proyecto.
- Los VID
0xFFF1—0xFFF4están reservados para pruebas. Se pueden usar para pruebas básicas de comisión y control, pero no se pueden usar 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 transmisión 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, ambos en formato little-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 muestra el analizador de Bluetooth.
Para los valores de la captura de pantalla de ejemplo, el VID y el PID en el
Developer Console serían 235A y FEFF, respectivamente.