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. Ampliaremos 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 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 que se describen en la documentación de Matter, ten en cuenta lo siguiente:
- Recomendamos que la cuenta que se usa para el desarrollo solo tenga conectado un único concentrador habilitado con Matter para las pruebas. Varios concentradores habilitados para Matter conectados al mismo tiempo o conectados a la misma estructura durante las pruebas pueden 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 con macOS son compatibles, se recomienda Linux. Las instrucciones específicas de Mac se llaman en los procedimientos según sea necesario.
Cómo compilar
Para compilar un dispositivo compatible con Matter que se integre con el ecosistema de Google Home, deberás trabajar con una placa de desarrollo compatible con Matter y el SDK de Matter.
La forma más fácil de comenzar es revisando 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 planeas 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
Los siguientes términos se usan en toda esta documentación:
- Router de borde
- Un concentrador que implementa un router de borde Thread de uso general para dispositivos habilitados para Thread.
- Hub
- 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 escrito en la memoria flash con una compilación o una app de ejemplo habilitada para Matter
- En dispositivos móviles
- El teléfono de prueba que se usa para ayudar con la vinculación. Actualmente, es un teléfono Android.
Requisitos previos
Para integrar por completo un dispositivo compatible con Matter en el ecosistema de Google Home, el desarrollador debe contar con lo siguiente:
- Un concentrador de Google compatible con Thread que funcione como router de borde para dispositivos habilitados para Thread y como ruta de entrega local para enrutar intents de casa inteligente
- Un dispositivo móvil (teléfono de prueba) que cumpla con los requisitos mínimos:
- Android O (8.1, nivel de API 27 o posterior)
- iOS (v16.5 o posterior)
- Función BLE
- Un ID del proveedor (VID) y un ID del producto (PID) para el dispositivo habilitado para Matter.
- Un dispositivo compatible con Matter Este dispositivo debe ser uno de los tipos de dispositivos Matter admitidos en el ecosistema de Google Home y puede ser uno de los siguientes:
- Tu propio producto con firmware compatible con Matter.
- Uno de los siguientes dispositivos Matter para usar para la verificación de extremo a extremo:
Proveedor | Plataforma | Asistencia de Thread | Guía |
---|---|---|---|
Laboratorio Bouffalo | BL602 | ||
BL702 | |||
Espressif | ESP32 | Pruebas OTA | |
Semiconductor nórdico | nRF52840 DK | Pruebas OTA | |
NXP | Kit de desarrollo IITZTB-DK006 | ||
Realtek | Ameba Serie D | ||
Silicon Labs | Kit para desarrolladores EFR32MG24 | ||
EFR32MG Zigbee and Thread Starter Kit | |||
Telink | TLSR9518 | ||
Instrumentos de Texas | Kit de desarrollo CC2652R7 LaunchPad |
ID del proveedor
De forma predeterminada, puedes usar uno de los VID asignados por la CSA para realizar pruebas. Selecciona una de las siguientes opciones: 0xFFF1
, 0xFFF2
, 0xFFF3
o 0xFFF4
.
Si quieres usar un VID de producción para que tu integración pueda certificarse y lanzarse, primero debes verificar que Google lo verifique para asegurarte de que la CSA te lo haya emitido.
Este VID debe implementarse 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.
- Tu VID de producción debe emitirlo el Connectivity Standards Alliance (Alliance). 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 el 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 la Alliance.
¿Qué tipos de usuarios pueden enviar 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) |
Prueba | No hay integración en Developer Console (no se puede certificar) | ||
Prueba | 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 | Certificada en la DCL Alliance, la integración no existe en el Developer Console | ||
Producción | Certificado en la DCL Alliance 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 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 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 son visibles para los usuarios finales:
Cluster Type | Clusters |
---|---|
Core |
|
Application |
|
1 Consulta Interruptores de luz de encendido/apagado para conocer cómo afecta esto a los interruptores de luz de encendido/apagado.