El programa de 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 la casa inteligente con la capacidad de agregar dispositivos compatibles con Matter para configurarlos con 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
En relación con los procedimientos que se describen en la documentación de Matter, ten en cuenta lo siguiente:
- Recomendamos que la cuenta que se use para el desarrollo solo tenga un único conmutador habilitado para Matter conectado para las pruebas. Si se conectan varios concentradores compatibles con Matter al mismo tiempo o a la misma estructura durante las pruebas, es posible que se produzca un comportamiento impredecible.
- En todos los procedimientos, se supone que se usa una máquina Linux que ejecuta Ubuntu 20.04 para compilar y actualizar muestras de Matter, que Google probó. Si bien se admiten máquinas 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 con el ecosistema de Google Home, trabajarás con una placa de desarrollo compatible con Matter y el SDK de Matter.
La forma más sencilla de comenzar es revisar nuestros codelabs. Te recomendamos que realices 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 del desarrollador 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 Thread de uso general para dispositivos compatibles con Thread.
- Hub
- Un dispositivo Google Nest compatible, como Google Nest Hub (2nd gen). Se requiere una unidad central para controlar 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 que se haya actualizado con una compilación o una app de ejemplo habilitada para Matter.
- Dispositivo móvil
- El teléfono de prueba que se usa para ayudar con la vinculación. Actualmente, es un teléfono Android.
Requisitos previos
Para integrar completamente un dispositivo compatible con Matter con el ecosistema de Google Home, un desarrollador debe tener lo siguiente:
- Un concentrador 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.
- 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)
- Función BLE
- Un ID de proveedor (VID) y un ID de producto (PID) para el dispositivo habilitado para Matter
- 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 uno de los siguientes:
- Tu propio producto con firmware habilitado para 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 OTA | |
| Nordic Semiconductor | nRF52840 DK | Pruebas 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 | TLSR9518 | ||
| Texas Instruments | Kit de desarrollo de LaunchPad CC2652R7 |
ID del proveedor
De forma predeterminada, puedes usar uno de los VID que asignó CSA con fines de prueba. Selecciona una de las siguientes opciones: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.
Para usar un VID de producción de modo que se pueda certificar y lanzar tu integración, primero debes verificarlo con Google 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 ciertas situaciones de ID de proveedor y tipo de dispositivo.
- No se puede usar un VID de prueba en un dispositivo para consumidores.
- El VID de producción debe ser emitido por Connectivity Standards Alliance (Alliance). Google verificará 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 pruebas de campo, se deben crear un proyecto y una integración con la combinación de VID y PID correspondiente en Developer Console. El usuario que comisiona 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 Alliance lo haya certificado.
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 con el VID o PID a un VID o PID diferente.
- Borra la integración con el VID o el PID.
| ¿Qué tipos de usuarios pueden encargar el dispositivo en el 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 la prueba 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 | No está certificada, la integración no existe en Developer Console | ||
| Producción | No está certificada, pero la integración existe en Developer Console | ||
| Producción | Certificado en la DCL de Alliance, la integración no existe en Developer Console | ||
| Producción | Está certificado en el DCL de Alliance y la integración existe en Developer Console | ||
ID del producto
La información sobre el dispositivo se lee del clúster de información básica Matter. El ID de producto codificado en el firmware del dispositivo debe coincidir con el ID de producto de la integración de Matter en Play Console.
Características no compatibles
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 |
|
¹ Consulta Interruptores de luz de encendido y apagado para ver cómo esto afecta a los interruptores de luz de encendido y apagado.