El programa Developer Program de Google permite que los fabricantes de dispositivos conecten sus dispositivos inteligentes para la casa con el ecosistema de Google Home. Estamos expandiendo la ruta de entrega local de Acciones de casa inteligente con la capacidad de agregar dispositivos compatibles con Matter para la configuración con el Google Home app (GHA) y controlarlos con Google Assistant, GHA o pantallas inteligentes, como el 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
En relación con los procedimientos descritos en la documentación de Matter, ten en cuenta lo siguiente:
- Recomendamos que la cuenta que se use para el desarrollo solo tenga un concentrador habilitado para Matter conectado para realizar pruebas. Si se conectan varios concentradores compatibles con Matter al mismo tiempo o a la misma estructura durante las pruebas, se podría producir 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 muestras de Matter, que Google probó. Si bien se admiten máquinas con macOS, se recomienda usar Linux. Las instrucciones específicas para Mac se indican en los procedimientos según sea necesario.
Cómo compilar
Para compilar un dispositivo compatible con Matter que se integre en el 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 con nuestros codelabs. Te recomendamos que completes, 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 para 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
- Un concentrador que implementa un router de borde de Thread de uso general para dispositivos compatibles con Thread.
- Hub
- Un dispositivo Google Nest compatible, como el 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, la GHA y las pantallas inteligentes.
- Dispositivo compatible con Matter
- Un dispositivo o una placa de desarrollo en los que se haya instalado una compilación o una app de ejemplo habilitadas para Matter
- Dispositivo móvil
- Es el teléfono de prueba que se usa para ayudar con la vinculación. Actualmente, este es un teléfono Android.
Requisitos previos
Para integrar por completo un dispositivo compatible con Matter en el ecosistema de Google Home, un desarrollador debe tener lo siguiente:
- Una unidad central de Google compatible con Thread que funcione como border router para dispositivos compatibles con 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)
- Capacidad de BLE
- Un ID de proveedor (VID) y un ID de producto (PID) para el dispositivo compatible con Matter
- Un dispositivo compatible con Matter Este dispositivo debe ser uno de
los tipos de dispositivos de Matter compatibles con el
ecosistema de Google Home, y podría ser:
- Tu propio producto con firmware compatible con Matter
- Uno de los siguientes dispositivos Matter para usar en la verificación de extremo a extremo:
| Proveedor | Plataforma | Asistencia de Thread | Guía |
|---|---|---|---|
| Bouffalo Lab | BL602 | ||
| BL702 | |||
| Espressif | ESP32 | Pruebas de OTA | |
| Nordic Semiconductor | nRF52840 DK | Pruebas de OTA | |
| NXP | Kit de desarrollo IOTZTB-DK006 | ||
| Realtek | Ameba D Series | ||
| Silicon Labs | Kit de desarrollo EFR32MG24 | ||
| Kit de inicio de Zigbee y Thread para EFR32MG | |||
| Telink | TLSR9528 | Guía para desarrolladores de Telink Matter | |
| Texas Instruments | Kit de desarrollo LaunchPad CC2652R7 |
ID del proveedor
De forma predeterminada, puedes usar uno de los VID asignados por Alliance para
fines de prueba. Selecciona una de las siguientes opciones:
0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Para usar un VID de producción de modo que tu integración se pueda certificar y lanzar, primero debes hacer que Google lo verifique para garantizar que la Alianza te lo haya emitido.
Este VID se debe implementar en el firmware de tu dispositivo.
Un dispositivo Matter solo se puede vincular en el ecosistema de Google Home en ciertas situaciones de ID de proveedor y tipo de dispositivo.
- No se puede usar un VID de prueba en un dispositivo de consumidor.
- El VID de producción debe emitirlo el Connectivity Standards Alliance (Alliance). Google validará que seas el propietario de ese VID antes de que puedas usarlo en el Google Home Developer Console. Una vez que esto suceda, podrás crear integraciones para ese VID.
- Para fines de desarrollo y Field Trial, 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 Field Trial.
- Los usuarios consumidores solo pueden usar tu producto una vez que lo haya certificado la Alliance.
El VID y el PID solo se pueden usar una vez para una integración. Si quieres usar el mismo VID o PID en tu integración, debes hacer lo siguiente:
- Edita la integración que usa el VID o PID para que use un VID o PID diferente.
- Borra la integración con el VID o el PID.
| ¿Qué tipos de usuarios pueden comisionar el dispositivo en el ecosistema de Google Home? | |||
|---|---|---|---|
| Tipo de VID | Certificación de VID y estado de la integración de la consola | Producción
(usuarios consumidores) |
Desarrollo
(desarrolladores, Field Trial usuarios) |
| 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 | No está certificada, la integración no existe en Developer Console | ||
| Producción | No está certificada, pero la integración existe en el Developer Console | ||
| Producción | Certificado en la DCL de Alliance, la integración no existe en Developer Console | ||
| Producción | Certificado en la 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 la Consola para desarrolladores.
Características no compatibles
Sin embargo, algunos clústeres de Matter aún no se exponen 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 |
|
¹ Consulta Interruptores de luz de encendido/apagado para saber cómo afecta a estos interruptores.