Comenzar con Matter

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Versión preliminar para desarrolladores

El programa de Desarrolladores del hogar de Google permite a los fabricantes de dispositivos conectar sus dispositivos del hogar inteligente con el ecosistema de Google Home. Expandiremos la ruta de entrega local de las Acciones para casa inteligente con la capacidad de agregar dispositivos habilitados con Matter para la configuración mediante Google Home app (GHA) en Android y controlarlos con Google Assistant, GHA o pantallas inteligentes como Google Nest Hub (2nd gen).

En esta documentación, se describe cómo comenzar a compilar y, luego, integrar una plataforma compatible con Matter en el ecosistema de Google Home.

Renuncias de responsabilidad

Con respecto a los procedimientos descritos en esta Vista previa para desarrolladores de Matter, ten en cuenta lo siguiente:

  • La cuenta que se use en el desarrollo debe tener un solo concentrador habilitado para Matter conectado a fin de realizar pruebas. Varios centros habilitados para Matter conectados al mismo tiempo o conectados a la misma estructura durante las pruebas pueden generar un comportamiento impredecible.
  • Todos los procedimientos suponen el uso de una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir en la memoria flash las muestras Matter, que Google probó. Si bien las máquinas de MacOS son compatibles, se recomienda Linux. En los procedimientos, se indican las instrucciones específicas de Mac.
  • Solo se admite la versión de GHA de Android.

Definiciones

En esta documentación, se usan los siguientes términos:

Router de borde
Un concentrador que implementa un router de borde Thread de uso general para dispositivos habilitados para Thread.
Contenido central
Un dispositivo Google Nest compatible, como Google Nest Hub (2nd gen). Se requiere un concentrador para controlar los dispositivos habilitados para Matter a través de otras plataformas, como Assistant, GHA y pantallas inteligentes.
Dispositivo compatible con Matter
Un dispositivo o una placa de desarrollo que se haya actualizado una app de compilación o de muestra habilitada para Matter.
En dispositivos móviles
El teléfono de prueba que se utiliza para facilitar la sincronización. Actualmente, este es un teléfono Android.

Requisitos previos

Para integrar por completo un dispositivo habilitado para Matter con el ecosistema de Google Home, un desarrollador debe tener lo siguiente:

  1. Un centro de Google compatible con Thread que funcione como router de borde para dispositivos compatibles con Thread y como ruta de entrega local a fin de enrutar intents de casa inteligente.
  2. Un dispositivo móvil (teléfono de prueba) que cumpla con los requisitos mínimos:
    • Android O (8.1, nivel de API 27) o versiones posteriores (se admitirá iOS más adelante)
    • Capacidad BLE
  3. Un ID de proveedor (VID) y un ID de producto (PID) para el dispositivo habilitado para Matter.
  4. Un dispositivo compatible con Matter Este dispositivo debería ser uno de los tipos de dispositivos Matter que se admiten actualmente en el ecosistema de Google Home y podría ser uno de los siguientes:
    • Tu propio producto con firmware compatible con Matter
    • Una placa de desarrollo de una plataforma de proveedor compatible que puede funcionar como un dispositivo habilitado para Matter para la verificación de extremo a extremo. Se admiten las siguientes plataformas:
Tabla: Matter ejemplos de proveedores de silicio
Proveedor Plataforma Guías Asistencia de Thread
Bouffalo Lab BL602 Inicio rápido
BL-702 Inicio rápido
Espressif ESP32 Guía de inicio rápido
Pruebas inalámbricas
Semiconductor nórdico nRF52840 Guía de inicio rápido
Pruebas inalámbricas
NXP, Kit de desarrollo de IOTZTB-DK006 Inicio rápido
Realtek Ameba D Series Inicio rápido
Silicon Labs Kit de inicio EFR32MG Zigbee y Thread Inicio rápido
Kit de desarrollo de EFR32MG24 Inicio rápido
Telink TLS 9518 Inicio rápido

ID de proveedor

De forma predeterminada, puedes usar uno de los VID que asigna la CSA para realizar pruebas. Selecciona una de las siguientes opciones: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

Si quieres usar un VID de producción para que se pueda certificar y lanzar tu integración, primero debes verificarlo con Google a fin de asegurarte de que la CSA te haya emitido.

Debes implementar este VID en el firmware de tu dispositivo.

Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en determinadas situaciones de ID de proveedor y tipo de dispositivo.

  • No se puede usar un VID de prueba en un dispositivo de consumidor.
  • Para que un dispositivo de producción (consumidor) sea emparejado, debe estar certificado en el DCL de CSA.
  • Para fines de desarrollo y prueba de campo, un dispositivo debe estar registrado en Google Home Developer Console.
Tabla: ID de proveedores (VID) y situaciones de vinculación del tipo de dispositivo
¿Qué tipos de usuarios pueden poner el dispositivo en el ecosistema de Google Home?
Tipo de VID Certificación de VID y estado de registro Producción
(usuarios consumidores)
Desarrollo
(Desarrolladores, usuarios de pruebas de campo)
Probar No registrado (no se puede certificar) N/A N/A
Probar Registrado en Developer Console (no se puede certificar) N/A
Producción Sin certificación ni registro N/A
Producción Sin certificación, registrado en el Developer Console
Producción Certificado por la CSA DCL, no registrado N/A
Producción Certificado por la CSA DCL y registrado en el Developer Console

ID del producto

La información sobre el dispositivo se lee mediante los clústeres del Matter Descriptor, en lugar del ID del producto. Puedes asignar cualquier ID de producto durante el desarrollo, según el esquema de numeración de tu empresa, siempre y cuando coincida con el ID de producto de tu integración de Matter, si se especifica.

Funciones no admitidas

Algunos clústeres de Matter aún no están expuestos a los usuarios, aunque el sistema puede usarlos. En la mayoría de los casos, esto significa que los atributos expuestos a través de estos clústeres no serán visibles para los usuarios finales:

Tabla: Matter clústeres no están expuestos a usuarios en el ecosistema de Google Home
Tipo de clúster Clústeres
Núcleo
  • Vinculación
  • Etiqueta
  • Etiqueta fija
  • Etiqueta de usuario
  • Acciones
  • Clave del grupo
  • Configuración de localización
  • Localización del formato de hora
  • Localización de unidades
  • Configuración de la fuente de alimentación
  • Fuente de alimentación
  • Clústeres de diagnóstico (registros de diagnóstico, diagnóstico general, diagnóstico de software, diagnóstico de red Thread, diagnóstico de red Wi-Fi y diagnóstico de red Ethernet)
  • Sincronización de tiempo
  • Selección de modo
Aplicación
  • No se admiten grupos ni las escenas directamente. Hay una funcionalidad equivalente disponible a través de Rutinas.
  • Todos los clústeres de medios. Las funciones equivalentes están disponibles mediante Google Cast.