Comienza a usar Matter

El programa para desarrolladores de Google Home permite a los fabricantes de dispositivos conectar sus dispositivos de casa inteligente con el ecosistema de Google Home. Ampliamos la ruta de entrega local de Acciones de casa inteligente con la capacidad de agregar dispositivos habilitados para Matter para su configuración mediante Google Home app (GHA) 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 e integrar una plataforma compatible con Matter en el ecosistema de Google Home.

Renuncias de responsabilidad

Con respecto a los procedimientos descritos en la documentación de Matter, ten en cuenta lo siguiente:

  • Recomendamos que la cuenta que se usa para el desarrollo tenga solo un único concentrador habilitado para Matter conectado a fin de realizar pruebas. Varios concentradores habilitados para Matter conectados al mismo tiempo o a la misma estructura durante las pruebas podrían generar un comportamiento impredecible.
  • En todos los procedimientos, se supone el uso de una máquina Linux que ejecuta Ubuntu 20.04 para compilar y escribir en la memoria flash muestras de Matter que Google probó. Si bien las máquinas macOS son compatibles, se recomienda Linux. En los procedimientos, se mencionan las instrucciones específicas de Mac según sea necesario.

Cómo crear

Para compilar un dispositivo compatible con Matter que se integre al ecosistema de Google Home, trabajarás con una placa de desarrollo compatible con Matter y el SDK de Matter.

La forma más fácil de comenzar es a través de nuestros codelabs. Te recomendamos realizar al menos uno de los siguientes codelabs:

Luego, consulta nuestra lista de dispositivos compatibles para asegurarte de que lo que tienes pensado integrar sea compatible con el ecosistema de Google Home. Luego, lee la lista de tareas para desarrolladores a fin de comprender todo el flujo de desarrollo, desde la creación del proyecto hasta el lanzamiento.

Dispositivos compatibles Lista de tareas para desarrolladores

Definiciones

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

Router de borde
Es un concentrador que implementa un router de borde Thread de uso general para dispositivos compatibles con Thread.
Concentrador
Un dispositivo Google Nest compatible, como Google Nest Hub (2nd gen). Se requiere una unidad central para controlar los dispositivos compatibles con Matter a través de otras plataformas, como Assistant, GHA y pantallas inteligentes.
Dispositivo compatible con Matter
Un dispositivo o una placa de desarrollo en la que se haya escrito una compilación o app de ejemplo habilitadas para Matter.
En dispositivos móviles
El teléfono de prueba que se usa para asistir 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 compatible con Matter en el ecosistema de Google Home, un desarrollador debe contar con lo siguiente:

  1. Una unidad central de Google compatible con Thread que funciona 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 requisitos mínimos:
    • Android O (8.1, nivel de API 27 o versiones posteriores)
    • iOS (v16.5 o versiones posteriores)
    • Capacidad BLE
  3. Un ID de proveedor (VID) y un ID del 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 compatibles con el ecosistema de Google Home y puede ser de los siguientes tipos:
    • Tu propio producto con firmware compatible con Matter
    • Uno de los siguientes dispositivos Matter para usar en la verificación de extremo a extremo:
Tabla: Matter ejemplos de proveedores de silicio
Proveedor Plataforma Asistencia de Thread Guía
Bouffalo Lab BL602
BL702
Espressif ESP32 Pruebas OTA
Semiconductor nórdico nRF52840 DK Pruebas OTA
NXP Kit de desarrollo de IoTTZTB-DK006
Realtek Ameba D Series
Silicon Labs Kit para desarrolladores EFR32MG24
Kit básico de Zigbee y Thread para EFR32MG
Telink TLSR9518
Instrumentos de Texas Kit de desarrollo CC2652R7 LaunchPad

ID del proveedor

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

Si quieres usar un VID de producción para que se pueda certificar y lanzar tu integración, primero Google debe verificarlo para asegurarte de que te lo emitió la CSA.

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 consumidores.
  • Connectivity Standards Alliance (Alliance) debe emitir tu 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 un proyecto y una integración con la combinación de VID y PID correspondiente en Developer Console. El usuario que encarga el dispositivo debe ser miembro del proyecto o estar incluido en la lista de usuarios de la prueba de campo.
  • Los usuarios consumidores solo pueden usar tu producto una vez que esté certificado por Alliance.
Tabla: Situaciones de vinculación de tipo de dispositivo y ID de proveedor (VID)
¿Qué tipos de usuarios pueden enviar el dispositivo al ecosistema de Google Home?
Tipo de VID Estado de la integración de la consola y la certificación de VID Producción
(usuarios consumidores)
Desarrollo
(Desarrolladores y usuarios de la prueba de campo)
Probarla No hay integración en Developer Console (no se puede certificar)
Probarla 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 Está certificada en la DCL de Alliance; la integración no existe en Developer Console
Producción Tienen la certificación en el DCL de Alliance y la integración existe en 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 del producto codificado en el firmware de tu dispositivo debe coincidir con el ID del producto de la integración de Matter en Play Console.

Funciones no admitidas

Algunos clústeres 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 son visibles para los usuarios finales:

Table: Matter clusters not exposed to users in the Google Home ecosystem
Cluster Type Clusters
Core
  • Binding ¹
  • Label
  • Fixed Label
  • User Label
  • Actions
  • Group Key
  • Localization Configuration
  • Time Format Localization
  • Unit Localization
  • Power Source Configuration
  • Power Source
  • Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics)
  • Time Synchronization
  • Mode Select
Application
  • Groups and Scenes are not directly supported. Equivalent functionality is available via Routines.
  • All Media clusters. Equivalent functionality is available via Google Cast.

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