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 tienen compatible con Matter. Sigue los pasos que se indican a continuación para comprobar si tu teléfono tenga los módulos necesarios.

Cómo configurar Android Debug Bridge

Debes configurar Android Debug Bridge (adb) antes de solucionar el problema. To set it up:

  1. Instala "adb" en tu computadora.
  2. Cómo activar las Opciones para desarrolladores y la conexión USB Depuración en tu teléfono Android.

Cómo verificar los módulos de Matter de los Servicios de Google Play (GPS)

Para comprobar si tienes la Google Play services Matter módulos, haz lo siguiente:

  1. Configura Android Debug Bridge.
  2. Usa un cable USB para conectar tu teléfono Android a tu que ya almacenaste en tu computadora.
  3. Ejecuta este comando en una terminal para verificar que se hayan Se instalaron Matter módulos:
      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, entonces tienes Se instalaron Matter módulos:
    com.google.android.gms.home [v222110900]
    Ten en cuenta que el número de versión anterior puede ser diferente del número de tu dispositivo.
  4. Ejecuta este comando en una terminal para verificar que se hayan Se instalaron Thread módulos:
      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 la siguiente información: Se instalaron Thread módulos:
    com.google.android.gms.threadnetwork [v222106301]
    Ten en cuenta que el número de versión en tu dispositivo puede ser diferente.

Si los módulos no están en la lista, significa que:

  1. Tienes una versión de Android desactualizada. Asegúrate de que Android O (8.1) o 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 cargando durante este tiempo, para que la descarga no se retrase. Si aún no lo hiciste los módulos en un plazo de 24 horas, puedes intentar restablecer la configuración de fábrica del el dispositivo para forzar la descarga de los módulos.

Registros del dispositivo concentrador de Fuchsia

A fin de 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 minúsculas debajo del dispositivo.
  2. Una vez que esté en la lista de entidades permitidas, sigue estos pasos para habilitar la función:
    • Desde el concentrador:
      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. Regresar al menú de nivel superior
      6. Presiona "Opciones para desarrolladores".
      7. Presiona “Registro de socios”.
    • La función se habilitará durante 24 horas. Luego, vuelve a habilitar la función de registro a partir del paso 5.
  3. Obtén la dirección IP de tu concentrador:
    • Desde la unidad central, si tiene 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. Encuentra 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
    • Desde Google Home app (GHA) en tu teléfono:
      1. Toca el dispositivo para que aparezca la página de detalles del dispositivo.
      2. Presiona el ícono de configuración para que aparezca la página de configuración
      3. Encuentra la dirección IP del dispositivo: ve a Dispositivo información > Información técnica > Dirección IP
  4. Para recuperar registros del concentrador, deberás realizar una solicitud HTTP GET al concentrador desde una computadora que esté conectada a la misma red Wi-Fi.
    • Toma nota del 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 generalmente tienen entre 20 y 30 minutos de eventos pasados.
      • Lo ideal es que los registros se extraigan con este método inmediatamente después de completar un procedimiento de prueba para garantizar que el búfer incluya 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 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 ocultar a tu TAM de Google.
    2. Después de que se confirme 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 una y una integración en la consola de Google Home.

Solución de problemas del Sniffer de Bluetooth

El valor de VID/PID que envía el dispositivo contador debe coincidir con el valor del VID/PID se ingresó en tu proyecto de Google Home Developer Console.

  • Los VID 0xFFF1: 0xFFF4 están reservados para pruebas. Pueden usarse para pruebas básicas de puesta en servicio y control, pero no se pueden utilizar durante el las siguientes fases de desarrollo:

Usar una aplicación de ingeniería de Bluetooth, como nRF Connect para dispositivos móviles, podrás consultar el VID/PID del dispositivo de baliza 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: ambas en formato Little endian.

La app BLE muestra los valores en formato Little Endian,pero los valores de VID/PID que ingreses a tu proyecto Developer Console están en big endian.

Verifica que se hayan ingresado los valores y el formato correctos en tus Acciones de consola de Cloud según lo que muestra el detector de Bluetooth.

Para los valores de la captura de pantalla de ejemplo, el VID y el PID del Developer Console sería 235A y FEFF, respectivamente.

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

Las unidades centrales de 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 la versión pública notas sobre las confirmaciones específicas que se recomiendan para su uso con cada nueva versión del concentrador.

Sincronizando

Verifica las credenciales del 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).
  • El certificado de certificación del dispositivo (DAC) y su cadena de certificados

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

Cómo verificar tu unidad compatible con Matter

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

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

La compilación del concentrador puede verificarse de la siguiente manera: Desliza el dedo 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 y aparece el mensaje "No se pudo establecer contacto con Google" mensaje de error

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

No se puede realizar la comisión debido al mensaje "No se puede acceder al dispositivo" mensaje de error

Si sigues recibiendo el mensaje "No se puede establecer conexión con el dispositivo" mensaje de error cuando se solicita Thread dispositivo y agotaron toda la información de depuración disponible puedes borrar los Thread preferidos credenciales en tu teléfono Android para una configuración limpia a través de Configuración > Aplicaciones > Aplicaciones de la aplicación > Servicios de Google Play > Almacenamiento y Caché > Administrar el espacio > BORRAR TODOS LOS DATOS

Prueba

El dispositivo encargado no aparece en el paquete de pruebas

Si vinculaste un dispositivo con un ID del proveedor (VID) y un ID del producto (PID) de prueba, pero no aparece cuando intentas probar el dispositivo con el Suite en Developer Console, es probable que esto se deba a con 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 vincúlalos el dispositivo que quieres volver a probar.

Para validar que vinculó el dispositivo correcto, puede configurar el valor de Fabricante y Información del modelo (valores CHIP_DEVICE_CONFIG_DEVICE_*) del dispositivo valores únicos en el firmware de prueba.

Consulta Información del dispositivo para obtener más información. información.

Si algo sale mal

Si, después de seguir todos los pasos para solucionar problemas, sigue sin aparecer resuelto, no hay problema.

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