A partir de 2026, todas las integraciones y pruebas de Matter requerirán la prueba de interoperabilidad de la Alianza. Para obtener más información, consulta la página de transición de Alliance Interop Test Lab.

Solución de problemas de Matter

Edificio

Verifica que tu teléfono sea compatible

Todos los dispositivos Android O (8.1, nivel de API 27) y versiones posteriores son compatibles con Matter. Sigue los pasos que se indican a continuación para verificar si tu teléfono tiene los módulos necesarios.

Configura Android Debug Bridge

Se debe configurar Android Debug Bridge (adb) antes de solucionar problemas. Para ello, haz lo siguiente:

Verifica los módulos de Matter de los Servicios de Google Play (GPS)

Para verificar si tienes los Google Play services Matter módulos, haz lo siguiente:

Configura Android Debug Bridge.
Conecta tu teléfono Android a tu computadora con un cable USB.
Ejecuta este comando en una terminal para verificar que estén instalados los módulos necesarios Matter:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
  
```
Si ves un resultado similar al siguiente, tienes instalados los módulos Matter:
```
com.google.android.gms.home [v222110900]
```
Ten en cuenta que el número de versión anterior puede ser diferente en tu dispositivo.
Ejecuta este comando en una terminal para verificar que estén instalados los módulos Thread necesarios:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
  
```
Si ves un resultado similar al del siguiente ejemplo, tienes instalados los módulos de Thread:
```
com.google.android.gms.threadnetwork [v222106301]
```
Ten en cuenta que el número de versión de tu dispositivo puede ser diferente.

Si los módulos no aparecen en la lista, significa que ocurre una de las siguientes situaciones:

Tienes una versión Android desactualizada. Asegúrate de que sea Android O (8.1) o una versión posterior.
Aún no se descargaron los módulos de Matter. Espera al menos 24 horas para que se descarguen. Asegúrate de que el dispositivo esté encendido y cargándose durante este tiempo para que no se demore la descarga. Si no recibiste los módulos en un plazo de 24 horas, puedes intentar restablecer la configuración de fábrica del dispositivo para forzar la descarga de los módulos.

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.

Solución de problemas del Bluetooth Sniffer

El valor de VID/PID que transmite tu dispositivo debe coincidir con el VID/PID ingresado en tu Google Home Developer Console proyecto.

Los VID 0xFFF1 — 0xFFF4 están reservados para pruebas. Se pueden usar para pruebas básicas de aprovisionamiento 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 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 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.

Nota: El VID de 235A ya no se debe usar en tu proyecto y se usa aquí con fines ilustrativos. Asegúrate de usar un VID según la Matter especificación o uno de los VIDs de prueba como se indica en la página Crea una integración de Matter.

Verifica que tu dispositivo se haya compilado con una rama compatible del SDK de Matter

Los concentradores de Google Matter son compatibles con Matter 1.0 y se probaron con compilaciones que usaban confirmaciones de la rama estable v1.0-branch. Consulta las notas de la versión pública para conocer las confirmaciones específicas recomendadas para usar con cada nueva versión del concentrador.

Sincronizando

Verifica las credenciales de tu dispositivo

Cuando uses tu propio Alliance-assigned VID, asegúrate de que tengas las credenciales correctas en el dispositivo:

Declaración de certificación (CD)
Certificado de atestación del dispositivo (DAC) y su cadena de certificados

Para obtener más información, consulta Cómo crear certificados de prueba de dispositivos Matter.

Verifica tu concentrador compatible con Matter

Tu concentrador Matter debe ser uno de los concentradores compatibles con Google. También debe estar en una compilación compatible con Matter.

Algunos concentradores también son routers de borde de Thread y, por lo tanto, te permiten desarrollar y probar dispositivos Thread. Otros concentradores solo admiten dispositivos Matter de Wi-Fi y Ethernet, a menos que tengas otro router de borde en tu red para habilitar la conectividad de Thread.

Para verificar la compilación del concentrador, haz lo siguiente: Desliza el dedo hacia abajo desde el borde superior > Rueda de configuración > Información del dispositivo > Información técnica > Versión de firmware de Chromecast.

El aprovisionamiento falla y se muestra el mensaje de error "No se pudo contactar a Google"

Asegúrate de haber creado una integración con la combinación correcta de VID/PID en el Developer Console. Consulta Crea una integración de Matter para obtener más información.

El aprovisionamiento falla y se muestra el mensaje de error "No se puede acceder al dispositivo"

Si sigues recibiendo el mensaje de error "No se puede acceder al dispositivo" cuando aprovisionas un Thread dispositivo, y agotaste todas las opciones de depuración disponibles, es posible que quieras borrar las credenciales de Thread preferidas almacenadas en tu teléfono Android para realizar una configuración limpia a través de Configuración > Apps > Apps de la app > Servicios de Google Play > Almacenamiento y caché > Administrar espacio > BORRAR TODOS LOS DATOS.Thread

Prueba

El dispositivo aprovisionado no aparece en Test Suite

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 Test Suite 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 configurar 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.

Si las cosas siguen saliendo mal

Si después de seguir todos los pasos para solucionar problemas que se indican aquí, el problema aún no se resuelve, no te preocupes.

En los pasos para solucionar problemas, recopilaste datos importantes sobre tu dispositivo, proyecto de consola y entorno. Con esos datos, consulta la página de asistencia para saber cómo compartir mejor tu problema con la comunidad y el equipo de asistencia de Google Home.