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 comprobar si tu teléfono tiene los módulos necesarios.

Cómo configurar Android Debug Bridge

Se debe configurar Android Debug Bridge (adb) 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 tu teléfono Android.

Verifica tus 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 el teléfono Android a la computadora.
  3. Ejecuta este comando en una terminal para verificar que los módulos Matter necesarios 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, significa que 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 al de tu dispositivo.
  4. Ejecuta este comando en una terminal para verificar que los módulos Thread necesarios 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 del siguiente ejemplo, significa que tienes los módulos Thread instalados: 
    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 ocurrió una de las siguientes situaciones:

  1. Tienes una versión desactualizada de Android. Asegúrate de que sea Android O (8.1) o una versión posterior.
  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 restablecer la configuración de fábrica del dispositivo para forzar la descarga de los módulos.

Registros del dispositivo del concentrador de Fuchsia

Para habilitar un concentrador para la recuperación de registros locales, haz lo siguiente:

  1. Envía un correo electrónico con el número de serie y el modelo de tus dispositivos a tu Technical Account Manager (TAM) de Google. Se pueden encontrar en letras pequeñas debajo del dispositivo.
  2. Una vez que se te incluya en la lista de entidades permitidas, debes habilitar la función siguiendo estos pasos:
    • Desde el centro, haz lo siguiente:
      1. Desliza el dedo hacia abajo desde la parte superior de la pantalla.
      2. Presiona el ícono de Configuración .
      3. Busca la versión de Fuchsia: En un Google Nest Hub (2nd gen), ve a Información del dispositivo > Información técnica > Versión de Fuchsia.
      4. Presiona "Versión de Fuchsia" 7 veces. Esto habilitará las opciones para desarrolladores.
      5. Regresa al menú de nivel superior
      6. Presiona "Opciones para desarrolladores".
      7. Presiona "Registro de socios".
    • La función estará habilitada durante 24 horas. Después de eso, vuelve a habilitar la función de registro desde el paso 5 en adelante.
  3. Obtén la dirección IP de tu concentrador:
    • Desde el concentrador, si tiene una pantalla, haz lo siguiente:
      1. Desliza el dedo hacia abajo desde la parte superior de la pantalla.
      2. Presiona el ícono de Configuración .
      3. Busca la dirección IP del dispositivo: En un Nest Hub (2nd gen), ve a Información del dispositivo > Información técnica > Dirección IP.
    • En Google Home app (GHA) en tu teléfono, haz lo siguiente:
      1. Presiona el dispositivo para abrir la página de detalles.
      2. Presiona el ícono de Configuración para abrir la página de configuración.
      3. Busca la dirección IP del dispositivo: ve a Información del dispositivo > Información técnica > Dirección IP.
  4. Para recuperar registros del concentrador, realizarás una solicitud HTTP GET al concentrador desde una computadora conectada a la misma red Wi-Fi.
    • Anota el puerto y la ruta de acceso del extremo: 
      curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
    • La conexión se puede mantener abierta solo durante un minuto, pero los datos recuperados del búfer suelen tener entre 20 y 30 minutos de eventos anteriores.
      • Idealmente, los registros se extraen con este método inmediatamente después de completar un procedimiento de prueba para garantizar que el búfer contenga contenido relevante para la prueba (similar a los informes de errores de Android).

Inhabilita la ocultación de registros de Android

  • Por motivos de privacidad y seguridad, esta función solo debe usarse para realizar pruebas de ingeniería.
  • No uses esta opción con dispositivos o usuarios de producción.
  • Pasos:
    1. Envía las Cuentas de Google de los usuarios que tendrán registros sin censurar a tu TAM de Google.
    2. Después de confirmar que tu cuenta se agregó a la lista de entidades permitidas, reinicia el teléfono.

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.

Soluciona problemas relacionados con el sniffer de Bluetooth

El valor de VID/PID que envía tu dispositivo debe coincidir con el VID/PID que ingresaste en tu proyecto Google Home Developer Console.

  • Los VIDs 0xFFF1 a 0xFFF4 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.

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

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ública para conocer los compromisos específicos 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 de dispositivos (DAC) y su cadena de certificados

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

Verifica que tu concentrador sea 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, por lo que te permiten desarrollar y probar dispositivos Thread. Otros concentradores solo admiten dispositivos Matter 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.

La comisión falla con el mensaje de error "No se pudo comunicar 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 con Matter para obtener más información.

La comisión falla con el mensaje de error "No se puede conectar con el dispositivo".

Si sigues recibiendo el mensaje de error "No se puede conectar con el dispositivo" cuando comisionas un dispositivo Thread y agotaste todas las opciones de depuración disponibles, te recomendamos que borres las credenciales 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.

Prueba

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 de 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.

Si el problema persiste

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 en mente, 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.