¡Atención! Pronto se lanzarán nuevos programas de vista previa para desarrolladores. Postúlate aquí y sé una de las primeras personas en probar herramientas nuevas y enviar comentarios.

Comenzar con Matter

  Versión de Vista previa para desarrolladores  

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

En esta documentación, se describe cómo comenzar a compilar y a 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 usa para el desarrollo solo debe tener un único concentrador habilitado para Matter conectado a fin de realizar pruebas. Varios concentradores habilitados para Matter conectados al mismo tiempo o conectados a la misma estructura durante la prueba podrían generar un comportamiento impredecible.
  • Todos los procedimientos suponen el uso de una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir muestras de Matter, que Google probó. Si bien se admiten máquinas macOS, se recomienda Linux. En los procedimientos, se solicitan instrucciones específicas de Mac, según sea necesario.

Definiciones

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

Router de borde
Un concentrador que implementa un router de borde de uso general Thread para los dispositivos habilitados para Thread.
Concentrador
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 actualizaron en la memoria flash de una app de compilación o muestra habilitada para Matter.
En dispositivos móviles
Se usó el teléfono de prueba para la vinculación. Actualmente, este es un teléfono Android.

Requisitos previos

Extensiones de IDE recomendadas para el desarrollo de Matter

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 para enrutar intents de casa inteligente.
  2. Un dispositivo móvil (teléfono de prueba) que cumpla con los siguientes requisitos mínimos:
    • Android O (8.1, nivel de API 27 o versiones posteriores)
    • iOS (v16.5 o posterior)
    • 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 debe ser uno de los tipos de dispositivos Matter que se admiten actualmente en el ecosistema de Google Home y podría ser:
    • 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
BL702 Inicio rápido
Espressif ESP32 Inicio rápido
Pruebas inalámbricas
Semiconductor nórdico nRF52840 DK Inicio rápido
Pruebas inalámbricas
NXP Kit de desarrollo IOTZTB-DK006 Inicio rápido
Realtek Ameba D Series Inicio rápido
Silicon Labs Kit para desarrolladores EFR32MG24 Inicio rápido
Kit básico de Eig32MG Zigbee y Thread Inicio rápido
Telink TLSR9518 Inicio rápido
Instrumentos de Texas Kit de desarrollo del LaunchPad CC2652R7 Inicio rápido

ID de proveedor

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

Si quieres usar un VID de producción para que tu integración pueda certificarse y lanzarse, primero debes verificarla con Google a fin de asegurarte de que la CSA la emitió.

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.
  • El CSA debe emitir el VID de producción. Google validará que eres el propietario de ese VID antes de que puedas usarlo en Google Home Developer Console. Una vez que eso suceda, podrás crear integraciones para ese VID.
  • Para fines de desarrollo y prueba de campo, se debe crear en Developer Console un proyecto y una integración con la combinación de VID y PID correspondiente. El usuario que le encarga el dispositivo debe ser miembro del proyecto o estar incluido en la lista de usuarios de prueba de campo.
  • Los usuarios consumidores solo pueden usar tu producto una vez que cuente con la certificación de la CSA.
Tabla: ID de proveedor (VID) y situaciones de vinculación de tipos de dispositivos
¿Qué tipos de usuarios pueden asignar el dispositivo al ecosistema de Google Home?
Tipo de VID Certificación de VID y estado de integración de la consola Producción
(usuarios consumidores)
Desarrollo
(Desarrolladores, usuarios de pruebas de campo)
Realiza pruebas Sin integración en Developer Console (no se puede certificar)
Realiza pruebas La integración existe en Developer Console (no se puede certificar)
Producción Sin certificación, la integración no existe en Developer Console
Producción Sin certificación, la integración existe en Developer Console
Producción Certificado en CSA DCL, la integración no existe en Developer Console
Producción Certificado en el DCL de CSA, y la integración existe en el Developer Console

ID del producto

La información sobre el dispositivo se lee desde el clúster de información básica de Matter. El ID de producto codificado en el firmware de tu dispositivo debe coincidir con el ID del producto de la integración Matter en Developer Console.

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 expuestos a los usuarios en el ecosistema de Google Home
Tipo de clúster Clústeres
Core
  • Vinculación 1
  • 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 de Thread, diagnóstico de red Wi-Fi, diagnóstico de red Ethernet)
  • Sincronización de tiempo
  • Seleccionar modo
Aplicación
  • Los grupos y las escenas no son compatibles de forma directa. La funcionalidad equivalente está disponible a través de las Rutinas.
  • Todos los clústeres de contenido multimedia. La funcionalidad equivalente está disponible a través de Google Cast.

1 Consulta Interruptores de luz de encendido/apagado para conocer cómo afecta esto a los interruptores de luz de encendido/apagado.