Solución de problemas de Matter

Compilando

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.

Cómo configurar Android Debug Bridge

Android Debug Bridge (adb) debe configurarse antes de solucionar problemas. To set it up:

  1. Instala "adb" en tu computadora.
  2. Activa las Opciones para desarrolladores y la depuración por USB en el teléfono Android.

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

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

  1. Configura Android Debug Bridge.
  2. Usa un cable USB para conectar tu teléfono Android a la computadora.
  3. Ejecuta este comando en una terminal para verificar que los módulos necesarios de Matter estén instalados:
      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 de Matter:
    com.google.android.gms.home [v222110900]
    . Ten en cuenta que el número de versión anterior puede ser diferente al de tu dispositivo.
  4. Ejecuta este comando en una terminal para verificar que los módulos necesarios de Thread estén instalados:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
    . Si ves un resultado similar al siguiente, tienes instalados los módulos de Thread:
    com.google.android.gms.threadnetwork [v222106301]
    . Ten en cuenta que el número de versión anterior puede ser diferente al de tu dispositivo.

Si los módulos no aparecen en la lista, significa que:

  1. Tienes una versión desactualizada de Android. Asegúrate de que sea de Android (0.8) o una superior.
  2. Aún no se descargaron los módulos 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 la descarga no se retrase. Si no recibes 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 estos.

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.

Solución de problemas del detector de Bluetooth

El valor de VID/PID que asigna tu baliza al dispositivo debe coincidir con el VID/PID que ingresaste en tu proyecto Google Home Developer Console.

  • Los VID 0xFFF1 y 0xFFF4 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.

Cómo verificar que tu dispositivo se compiló mediante una rama del SDK de Matter compatible

Actualmente, los concentradores Matter de Google 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úblicas para conocer las confirmaciones específicas que se recomiendan usar con cada versión nueva del concentrador.

Sincronizando

Verifica las credenciales de tu dispositivo

Cuando uses tu propio VID asignado por Alliance, asegúrate de tener las credenciales correctas en el dispositivo:

  • Declaración de certificación (CD)
  • Certificado de certificació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 núcleos compatibles con Google. También debe estar en una compilación compatible con Matter.

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

La compilación de tu concentrador se puede verificar con lo siguiente: Deslizando hacia abajo desde el borde superior > Rueda de configuración > Información del dispositivo > Información técnica > Versión de firmware de Chromecast

La comisión falla con el mensaje de error "No se pudo establecer contacto con Google"

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

La puesta en marcha falla con el mensaje de error "No se puede acceder al dispositivo"

Si recibes un mensaje de error que indica que no puedes acceder al dispositivo cuando le encargas un dispositivo Thread y agotaste todas las opciones de depuración disponibles, te recomendamos borrar las credenciales Thread almacenadas en tu teléfono Android para una configuración limpia en Configuración > Apps > Apps de apps > Servicios de Google Play > Almacenamiento y caché > Administrar espacio > BORRAR TODOS LOS DATOS.

Prueba

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.

Si las cosas siguen saliendo mal

Si después de seguir todos los pasos para solucionar problemas aún no se resolvió el problema, no hay problema.

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